Package cloud.piranha.embedded

Piranha Embedded delivers you with an embeddable implementation of a Servlet container.

See: Description

Class Summary

Class	Description
EmbeddedPiranha	The embeddable servlet container version of Piranha.
EmbeddedPiranhaBuilder	The builder so you can easily build instances of EmbeddedPiranha.
EmbeddedRequest	The WebApplicationRequest class used by EmbeddedPiranha
EmbeddedRequestBuilder	The builder so you can easily build instances of EmbeddedRequest.
EmbeddedResponse	The WebApplicationResponse class used by EmbeddedPiranha
EmbeddedResponseBuilder	The builder so you can easily build instances of EmbeddedResponse.

Package cloud.piranha.embedded Description

Piranha Embedded delivers you with an embeddable implementation of a Servlet container. It is used extensively within the Piranha project itself to test all the Servlet functionality.

The image below illustrates how the request and response handling is done by Piranha Embedded. When an EmbeddedRequest comes in it uses a WebApplicationRequestMapper to determine which FilterChain needs to process the incoming request.

Recommendation

We recommend using EmbeddedPiranhaBuilder to create your instances of EmbeddedPiranha..

Expectations and assumptions

• You take care of class loading (if more isolation is needed)
• You setup the request object
• You setup the response object

Limitations

• Only supports one web application per EmbeddedPiranha instance.

Maven coordinates

Please use the following dependency.

 <dependency>
   <groupId>cloud.piranha</groupId>
   <artifactId>piranha-embedded</artifactId>
   <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.

Author:

Manfred Riem (mriem@manorrock.com)

See Also:

EmbeddedPiranhaBuilder