Static deployment of RAR
Definition
Deploy a Java EE resource adapter (RAR) that will be started when the container startsDataSource and Resource Support
An alternative to using RARs is to use the DataSource and Resource Support provided by CARGO.
Example using the Java API
Starting JOnAS 5.x with a RAR to deploy:
InstalledLocalContainer container = new Jonas5xInstalledLocalContainer( new Jonas5xStandaloneLocalConfiguration("target/jonas5x")); container.setHome("c:/jonas/jonas-5.1.2"); Deployable rar = new RAR("src/data/mysql-5.1-localhost.rar"); container.getConfiguration().addDeployable(rar); container.start();
Example using the Ant tasks
Starting JOnAS 5.x with a RAR to deploy:
<cargo containerId="jonas5x" home="c:/jonas/jonas-5.1.2" action="start"> <configuration> <deployable type="rar" file="src/data/src/data/mysql-5.1-localhost.rar"/> </configuration> </cargo>
Example using the Maven 3 plugin
Here is the plugin configuration defining a JOnAS 5.x container with a RAR to deploy:
<dependencies> <dependency> <groupId>com.myProject</groupId> <artifactId>mysql-5.1-localhost</artifactId> <version>${rar.version}</version> <type>rar</type> </dependency> </dependencies> <plugins> <plugin> <groupId>org.codehaus.cargo</groupId> <artifactId>cargo-maven3-plugin</artifactId> <version>${cargo.version}</version> <configuration> <containerId>jonas5x</containerId> <artifactInstaller> <groupId>org.ow2.jonas.assemblies.profiles</groupId> <artifactId>jonas-full</artifactId> <version>5.2.1</version> <classifier>bin</classifier> </artifactInstaller> <deployables> <deployable> <groupId>com.myProject</groupId> <artifactId>mysql-5.1-localhost</artifactId> <type>rar</type> </deployable> </deployables> </configuration> </plugin> </plugins>
For more information...
For more information about how deployment in Codehaus Cargo works, please read:
- How deployables work, which explains how to instanciate and personalize deployables.
- How deployers work, which explains how the different deployers work.