As glitches may happen even after a container is released for the first time, e.g. if a new feature is added to the framework, but not supported by all containers, we encourage you to report your success/failures in the Tested on section.

Feature list

Provides a Java API to:

Start containers

Stop containers

Configure containers for deployment in any user-specified directory

Wait for containers to be started

Wait for containers to be stopped

Supports WAR and EAR static deployments

Provides Ant tasks that wraps the Java API.

In addition the Cargo project also offers a Java API to manipulate J2EE descriptors (currently web.xml and application.xml). Most notably the API allows merging two web.xml files.

Quick Start

The following piece of code demonstrates how to configure Resin 3.0.8 to start in target/resin3x and deploy a WAR located in src/testinput/simple.war. The default port is 8080. Please note that the container.start() and container.stop() methods wait until the container is fully started and fully stopped before continuing. Thus, for any action you are executing after, you are assured the container is completely operational.