Java API
Cargo offers primarily a Java API. It is meant to be embedded in your application. You'll need Java SE version 7 or greater.
You have two choices to pick from the Downloads page:
- the
cargo-core-api-*
jars and the container implementations you wish to use (cargo-core-container-*
jars) - or the
cargo-core-uberjar
jar which aggregates all the required jars
Cargo's base dependencies are as follows:
- Ant 1.5.4 or greater
- Commons discovery 0.5 or greater
- Commons logging 1.2 or greater
In addition, some specific containers (for example, JRun) and some deployables (for example, Tomcat WARs) require the following:
- jdom 1.1.3 (not any jdom2 version)
- jaxen 1.1.6 or greater
Apache Ant
If you want use the Cargo Ant tasks, add the following JARs to ANT's classpath:
- The same jars as for the Java API (i.e., either the API JARs + the container(s) or the uberjar)
- The
cargo-ant
JAR, containing the<taskdef>
definition (see the Ant support page)
Apache Maven 2 / Maven 3
Maven 2 / Maven 3 will automatically download all required dependencies: see the Maven2 plugin page. As a result, no installation is required for Maven 2 / Maven 3.
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
<dependency> <groupId>org.codehaus.cargo</groupId> <artifactId>cargo-core-uberjar</artifactId> <version>${cargo.version}</version> </dependency>
<dependency> <groupId>org.codehaus.cargo</groupId> <artifactId>cargo-core-container-tomcat</artifactId> <version>${cargo.version}</version> </dependency>