This page last changed on Jul 17, 2005 by vmassol.

Definition

How to configure the executing container's classpath

Explanation

This topic is not about the classpath requirements to run Cargo (see the Installation page for this); it's about configuring the classpath for the executing container. For most containers, Cargo automatically manages the container's classpath by adding the required container jars to it. However, some containers supports being embedded. This is the case of Jetty and the Jetty4xEmbeddedContainer implementation class simply starts the container in the running JVM. Thus you'll need to ensure to have the jetty jar + all the other related jars required (jasper-compiler and jasper-runtime jars specifically).

In addition, for all non-embedded container implementations it is possible to add custom jars to the container's execution classpath as shown below.

Example using the Java API

Starting Orion 1.x with Clover jar added to its classpath. For example if you have instrumented your source code with Clover you'll need to add the Clover jar to the classpath.

Container container = new Orion1xContainer(
    new OrionStandaloneConfiguration("target/orion1x");
container.setHomeDir("c:/apps/orion-1.6.0b");

container.setExtraClasspath(new String[] { "libs/clover.jar" });

container.start();

Example using the Ant API

Starting Orion 1.x with some additional classpath entries:

<cargo-orion1x homeDir="c:/apps/orion-1.6.0b" action="start">
  <extraClasspath>
    <pathelement location="libs/clover.jar"/>
  </extraClasspath>
</cargo-orion1x>
Document generated by Confluence on Jul 21, 2005 06:52