Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<h2>Architecture</h2><img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2dhbGxlcnk6Y29sdW1ucz0yfQ&amp;locale=en_GB&amp;version=2" data-macro-name="gallery" data-macro-parameters="columns=2"> Cargo offers differents ways of using it at different levels:<ul><li>Module Java API: A Java API to parse/create/merge J2EE Modules (WAR, EAR, etc)</li><li>Container Java API: A Java API to start/stop/configure Java Containers and deploy modules into them.</li><li>Generic Java API: A Java API that sits on top of the Container API but allows writing generic code that works with any container. It consists mostly in a set of Factory classes to instantiate Container API objects by name.</li><li>Build and IDE plugins<ul><li><a class="confluence-link" href="/display/CARGO/Ant+support" data-linked-resource-id="13120" data-linked-resource-type="page" data-linked-resource-default-alias="Ant support" data-base-url="http://docs.codehaus.org">Ant tasks</a>: A set of Ant tasks that wrap the Generic Java API</li><li><a class="confluence-link" href="/display/CARGO/Maven2+plugin" data-linked-resource-id="34460" data-linked-resource-type="page" data-linked-resource-default-alias="Maven2 plugin" data-base-url="http://docs.codehaus.org">Maven 2</a>: A Maven2/Maven3 plugin</li></ul></li></ul>The main Container API objects are:<ul><li>The <a class="confluence-link" href="/display/CARGO/Container" data-linked-resource-id="38535" data-linked-resource-type="page" data-linked-resource-default-alias="Container" data-base-url="http://docs.codehaus.org">Container</a> is the top level interface wrapping a real physical container. Cargo supports <a class="confluence-link" href="/display/CARGO/Container" data-linked-resource-id="38535" data-linked-resource-type="page" data-linked-resource-default-alias="Container" data-base-url="http://docs.codehaus.org">local</a> and <a class="confluence-link" href="/display/CARGO/Container" data-linked-resource-id="38535" data-linked-resource-type="page" data-linked-resource-default-alias="Container" data-base-url="http://docs.codehaus.org">remote</a> containers. A Container is composed of a <a class="confluence-link" href="/display/CARGO/Configuration" data-linked-resource-id="13113" data-linked-resource-type="page" data-linked-resource-default-alias="Configuration" data-base-url="http://docs.codehaus.org">Configuration</a>.</li><li>A <a class="confluence-link" href="/display/CARGO/Configuration" data-linked-resource-id="13113" data-linked-resource-type="page" data-linked-resource-default-alias="Configuration" data-base-url="http://docs.codehaus.org">Configuration</a> tells Cargo how the container is to be configured (whether it should create a <a class="confluence-link" href="/display/CARGO/Standalone+Local+Configuration" data-linked-resource-id="13087" data-linked-resource-type="page" data-linked-resource-default-alias="Standalone Local Configuration" data-base-url="http://docs.codehaus.org">standalone</a> setup, whether it should be based on an <a class="confluence-link" href="/display/CARGO/Existing+Local+Configuration" data-linked-resource-id="13089" data-linked-resource-type="page" data-linked-resource-default-alias="Existing Local Configuration" data-base-url="http://docs.codehaus.org">existing</a> configuration, etc). A Configuration can be configured to install <a class="confluence-link" href="/display/CARGO/Deployable" data-linked-resource-id="13115" data-linked-resource-type="page" data-linked-resource-default-alias="Deployable" data-base-url="http://docs.codehaus.org">Deployable</a>s before the Container is started.</li><li>You can use a <a class="confluence-link" href="/display/CARGO/Deployer" data-linked-resource-id="22203" data-linked-resource-type="page" data-linked-resource-default-alias="Deployer" data-base-url="http://docs.codehaus.org">Deployer</a> to hot-deploy <a class="confluence-link" href="/display/CARGO/Deployable" data-linked-resource-id="13115" data-linked-resource-type="page" data-linked-resource-default-alias="Deployable" data-base-url="http://docs.codehaus.org">Deployable</a>s (i.e. after the Container is started).</li><li><a class="confluence-link" href="/display/CARGO/Deployable" data-linked-resource-id="13115" data-linked-resource-type="page" data-linked-resource-default-alias="Deployable" data-base-url="http://docs.codehaus.org">Deployable</a>s are archives to be deployed in the Container. They are WAR, EAR, EJBs, etc.</li></ul>