Cargo : Container Instantiation This page last changed on Mar 09, 2006 by vmassol. ### Definition Create a container instance ### Example using the 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: Geronimo 1.x JBoss 3.x JBoss 4.x Jetty 4.x Jetty 5.x Jetty 6.x jo 1.x Oc4J 9.x Orion 1.x Orion 2.x Resin 2.x Resin 3.x Tomcat 3.x Tomcat 4.x Tomcat 5.x WebLogic 8.x ### 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.

Document generated by Confluence on Mar 22, 2006 15:28