Package cloud.piranha.server

The Piranha Server package delivers you with a Servlet container that is capable of hosting several web applications.

Installing Piranha Server

Download the ZIP file from Maven Central and unzip it in a directory of your choice.

Start the server

Starting the server is done by issuing the command line below from the bin directory.

 start.sh
 

Stop the server

Stopping the server is done by issuing the command line below from the bin directory.

 stop.sh
 

Deploying a web application

Deploying a web application is a simple as copying your WAR file to the webapps directory. Note if the server is already running you will need to stop and start the server.

Architecture diagram

The image below illustrates how the request and response handling is done by Piranha Server. When a request comes in to the HTTP server it dispatches it to the WebApplicationServer which uses a WebApplicationServerRequestMapper to determine which web application needs to serve the request and it the dispatches to it and then in turn the WebApplication uses WebApplicationRequestMapper to determine which FilterChain needs to process the incoming request and it dispatches to it.

Maven coordinates

 <dependency>
   <groupId>cloud.piranha</groupId>
   <artifactId>piranha-server</artifactId>
   <version>y.m.p</version>
   <version>y.m.p</version>
 <dependency>
 

where y is the year, m is the month and p is the patch version of the release you want to use.