Container Instantiation

Definition

Create a container instance

Support Matrix

Java

Ant

Maven 3

(tick)

(tick)

(tick)

Java API

If you're using the Java API there are 2 solutions to instantiate a container:

  • by instantiating the Java object implementing the container and passing a Configuration object to it. For example:
Container container = new Orion2xLocalContainer(configuration);
[...]
Container container = new Resin3xLocalContainer(configuration);
[...]
Container container = new Weblogic8xLocalContainer(configuration);
[...]
Container container = new TomcatRemoteContainer(configuration);
  • by using the DefaultContainerFactory class. The advantage is that you can instantiate the container by name and thus your code can be generic which is nice if you plan to run the same code with different containers. For example, to instantiate a Resin 3.x installed local container:
ContainerFactory factory = new DefaultContainerFactory();
Container container = factory.createContainer("resin3x", ContainerType.INSTALLED, configuration);

In general we recommend that you use the factory method to instantiate a container as this makes your code more flexible.

The class or container id to use for instantiating a container can be found on each container's documentation page:

Example using Cargo extensions

If you're using a Cargo extension you'll use the way defined by the extension to instantiate a container. Underneath, all extensions use the factory method to instantiate containers.