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.

<p>The following examples demonstrate how to configure Resin 3.0.15 to start in <code>target/resin3x</code> and deploy a WAR located in <code>path/to/simple.war</code> using the Java API. The default port is 8080. Please note that the <code>container.start()</code> and <code>container.stop()</code> methods wait until the container is fully started and fully stopped before continuing. Thus, for any action you are executing after, you are assured the container is completely operational.</p>

<table class="wysiwyg-macro" data-macro-name="info" data-macro-parameters="title=ANT tasks and Maven2 plugin" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2luZm86dGl0bGU9QU5UIHRhc2tzIGFuZCBNYXZlbjIgcGx1Z2lufQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body">
<p>CARGO can be used using its Java API as it is shown here. In addition to a Java API, CARGO also has ANT tasks and a Maven2 plugin:</p>
<ul>
	<li>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 contains the Quick Start for the CARGO ANT tasks</li>
	<li>The <a class="confluence-link" href="/display/CARGO/Maven2+plugin#Maven2plugin-Maven2plugin-gettingstarted" data-anchor="Maven2plugin-gettingstarted" data-linked-resource-id="34460" data-linked-resource-type="page" data-linked-resource-default-alias="Maven2 plugin#Maven2plugin-gettingstarted" data-base-url="http://docs.codehaus.org">Getting started with the CARGO Maven2 plugin</a> contains the Quick Start for the CARGO Maven2 plugin</li>
</ul>
</td></tr></table>

<h3>Static deployment</h3>

<p>Static deployment means that the <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> is deployed before the container is started. Here's an example using the strongly typed Java API:</p>
<table class="wysiwyg-macro" data-macro-name="unmigrated-inline-wiki-markup" data-macro-parameters="atlassian-macro-output-type=BLOCK" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e3VubWlncmF0ZWQtaW5saW5lLXdpa2ktbWFya3VwOmF0bGFzc2lhbi1tYWNyby1vdXRwdXQtdHlwZT1CTE9DS30&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>{snippet:lang=java|id=qs-typed|url=http://svn.codehaus.org/cargo/core/trunk/documentation/src/main/java/org/codehaus/cargo/documentation/Snippets.java}</pre></td></tr></table>
<p>Here's the same example using the generic untyped API (which we recommend as it leads to more generic code):</p>
<table class="wysiwyg-macro" data-macro-name="unmigrated-inline-wiki-markup" data-macro-parameters="atlassian-macro-output-type=BLOCK" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e3VubWlncmF0ZWQtaW5saW5lLXdpa2ktbWFya3VwOmF0bGFzc2lhbi1tYWNyby1vdXRwdXQtdHlwZT1CTE9DS30&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>{snippet:lang=java|id=qs-untyped|url=http://svn.codehaus.org/cargo/core/trunk/documentation/src/main/java/org/codehaus/cargo/documentation/Snippets.java}</pre></td></tr></table>

<h3>Hot deployment</h3>

<p><a class="confluence-link" href="/display/CARGO/Hot+Deployment" data-linked-resource-id="24490" data-linked-resource-type="page" data-linked-resource-default-alias="Hot Deployment" data-base-url="http://docs.codehaus.org">Hot deployment</a> means that the Deployable is deployed after the container is started.</p>
<table class="wysiwyg-macro" data-macro-name="unmigrated-inline-wiki-markup" data-macro-parameters="atlassian-macro-output-type=BLOCK" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e3VubWlncmF0ZWQtaW5saW5lLXdpa2ktbWFya3VwOmF0bGFzc2lhbi1tYWNyby1vdXRwdXQtdHlwZT1CTE9DS30&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>{snippet:lang=java|id=qs-deploy|url=http://svn.codehaus.org/cargo/core/trunk/documentation/src/main/java/org/codehaus/cargo/documentation/Snippets.java}</pre></td></tr></table>

<h3>Functional tests</h3>

<p>For a detailed documentation on how to use Cargo for executing functional tests on a container, directly from your Java unit test classes (JUnit, TestNG, etc), read our <a class="confluence-link" href="/display/CARGO/Functional+testing" data-linked-resource-id="49249" data-linked-resource-type="page" data-linked-resource-default-alias="Functional testing" data-base-url="http://docs.codehaus.org">Functional testing</a> page.</p>