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>Definition</h3>
<p><table class="wysiwyg-macro" data-macro-name="excerpt" data-macro-parameters="atlassian-macro-output-type=BLOCK" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2V4Y2VycHQ6YXRsYXNzaWFuLW1hY3JvLW91dHB1dC10eXBlPUJMT0NLfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body"><p>How to configure the executing container's classpath</p></td></tr></table></p>
<table class="wysiwyg-macro" data-macro-name="info" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2luZm99&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body">
<p>This feature is only available for <a class="confluence-link" href="/display/CARGO/Local+Container" data-linked-resource-id="45798" data-linked-resource-type="page" data-linked-resource-default-alias="Local Container" data-base-url="http://docs.codehaus.org">local containers</a></p></td></tr></table>

<h3>Explanation</h3>

<p>This topic is not about the classpath requirements to run Cargo (see the <a class="confluence-link" href="/display/CARGO/Installation" data-linked-resource-id="17486" data-linked-resource-type="page" data-linked-resource-default-alias="Installation" data-base-url="http://docs.codehaus.org">Installation</a> page for this); it's about configuring the classpath for the executing container. You can therefore add custom JARs (code instrumentation, DataSource JARs, security-related libraries, etc.) to the container's execution classpath as shown below.</p>

<p>Note that some containers also support adding custom JARs to the applications' classpath only: see <a class="confluence-link" href="/display/CARGO/Application+Classpath" data-linked-resource-id="195330135" data-linked-resource-type="page" data-linked-resource-default-alias="Application Classpath" data-base-url="http://docs.codehaus.org">Application Classpath</a> for details.</p>

<h3>Example using the Java API</h3>

<p>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.</p>

<table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="java" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6amF2YX0&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
InstalledLocalContainer container = new Orion1xInstalledLocalContainer(
    new OrionStandaloneLocalConfiguration("target/orion1x"));
container.setHome("c:/apps/orion-1.6.0b");

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

container.start();
</pre></td></tr></table>

<h3>Example using the Ant API</h3>

<p>Starting Orion 1.x with some additional classpath entries:</p>
<table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&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;cargo containerId="orion1x" home="c:/apps/orion-1.6.0b" action="start">
  &lt;extraClasspath>
    &lt;pathelement location="libs/clover.jar"/>
  &lt;/extraClasspath>
&lt;/cargo>
</pre></td></tr></table>

<h3>Example using the Maven 2 Plugin</h3>

<p>See <a href="http://cargo.codehaus.org/Starting+and+stopping+a+container#Startingandstoppingacontainer-extrajars">Starting and stopping a container - Adding jars to a container's classpath</a></p>