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.

<h3>Java API</h3><p>Cargo offers primarily a Java API. It is meant to be embedded in your application. You'll need Java SE version 5 or greater.</p><p>You have two choices to pick from the <a class="confluence-link" href="/display/CARGO/Downloads" data-linked-resource-id="10844" data-linked-resource-type="page" data-linked-resource-default-alias="Downloads" data-base-url="http://docs.codehaus.org">Downloads</a> page:</p><ul><li>the <code>cargo-core-api-*</code> jars and the container implementations you wish to use (<code>cargo-core-container-*</code> jars)</li><li><strong>or</strong> the <code>cargo-core-uberjar</code> jar which aggregates all the required jars</li></ul><p>CARGO's base dependencies are as follows:</p><ul><li><a href="http://www.ibiblio.org/maven/ant/jars/ant-1.5.4.jar">Ant 1.5.4</a> or greater.</li><li><a href="http://repo1.maven.org/maven2/commons-discovery/commons-discovery/0.4/commons-discovery-0.4.jar">Commons discovery 0.4</a> or greater.</li><li><a href="http://repo1.maven.org/maven2/commons-logging/commons-logging/1.1.1/commons-logging-1.1.1.jar">Commong logging 1.1.1</a> or greater.</li></ul><p>If you want to deploy datasources (database, resources, etc.) with CARGO, you also need:</p><ul><li><a href="http://repo1.maven.org/maven2/dom4j/dom4j/1.4/dom4j-1.4.jar">dom4j 1.4</a> or greater.</li><li>JAXB 2.1 (both the <a href="http://repo1.maven.org/maven2/javax/xml/bind/jaxb-api/2.1/jaxb-api-2.1.jar">API</a> and the <a href="http://repo1.maven.org/maven2/com/sun/xml/bind/jaxb-impl/2.1.13/jaxb-impl-2.1.13.jar">implementation</a>) or greater.</li></ul><p>Finally, some specific deployables (for example, Tomcat WARs) require the following:</p><ul><li><a href="http://repo1.maven.org/maven2/jdom/jdom/1.0/jdom-1.0.jar">jdom 1.0</a> or greater.</li></ul><p>In the case you're running on Java 5, you will also need <a href="http://www.ibiblio.org/maven/xerces/jars/xercesImpl-2.4.0.jar">Xerces 2.4.0</a> or greater.</p><h3>Ant</h3><p>If you want use the Cargo Ant tasks, add the following JARs to ANT's classpath:</p><ul><li>The same jars as for the Java API (i.e., either the API JARs + the container(s) <strong>or</strong> the uberjar)</li><li>The <code>cargo-ant</code> JAR, containing the <code>&lt;taskdef&gt;</code> definition (see the <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 support</a> page)</li></ul><h3>Maven2 and Maven2</h3><p>Maven2/Maven3 will automatically download all required dependencies: see the <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">Maven2 plugin</a> page. As a result, no installation is required for Maven2 nor Maven3.</p><p>If you are creating a Java applications which use the CARGO via API, you need to add as dependency either the artifact for your favorite container or the uberjar (which contains all containers). See below</p><table class="wysiwyg-macro" data-macro-name="code" data-macro-parameters="language=html/xml|title=Example for adding the CARGO uberjar as dependency" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6dGl0bGU9RXhhbXBsZSBmb3IgYWRkaW5nIHRoZSBDQVJHTyB1YmVyamFyIGFzIGRlcGVuZGVuY3l8bGFuZ3VhZ2U9aHRtbC94bWx9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>&lt;dependency>
  &lt;groupId>org.codehaus.cargo&lt;/groupId>
  &lt;artifactId>cargo-core-uberjar&lt;/artifactId>
  &lt;version>${cargo.version}&lt;/version>
&lt;/dependency></pre></td></tr></table><table class="wysiwyg-macro" data-macro-name="code" data-macro-parameters="language=html/xml|title=Example for adding the CARGO Tomcat container as dependency" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6dGl0bGU9RXhhbXBsZSBmb3IgYWRkaW5nIHRoZSBDQVJHTyBUb21jYXQgY29udGFpbmVyIGFzIGRlcGVuZGVuY3l8bGFuZ3VhZ2U9aHRtbC94bWx9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>&lt;dependency>
  &lt;groupId>org.codehaus.cargo&lt;/groupId>
  &lt;artifactId>cargo-core-container-tomcat&lt;/artifactId>
  &lt;version>${cargo.version}&lt;/version>
&lt;/dependency></pre></td></tr></table>