Adding Resources Examples
The add-resources goal allows you to add resources such as datsources etc to a running AS7 instance.
Adding datasources
This can be combined with the add-resource goal to automatically deploy the datasource drivers.
The example below shows how to add a datasource that uses the default h2 database:
<project>
...
<build>
...
<plugins>
...
<plugin>
<groupId>org.jboss.as.plugins</groupId>
<artifactId>jboss-as-maven-plugin</artifactId>
<version>7.7.Final</version>
<executions>
<execution>
<id>add-datasource</id>
<phase>package</phase>
<goals>
<goal>add-resource</goal>
</goals>
<configuration>
<address>subsystem=datasources,data-source=java:jboss/myDs</address>
<resource>
<enable-resource>true</enable-resource>
<properties>
<jndi-name>java:jboss/myDs</jndi-name>
<enabled>true</enabled>
<connection-url>jdbc:h2:mem:test;DB_CLOSE_DELAY=-1</connection-url>
<driver-class>org.h2.Driver</driver-class>
<driver-name>h2</driver-name>
<user-name>sa</user-name>
<password>sa</password>
<pool-name>mypool</pool-name>
</properties>
</resource>
</configuration>
</execution>
</executions>
</plugin>
...
</plugins>
...
</build>
...
</project>The example below shows how to configure a postgresql XA data source, including deploying the driver. The postgresql driver module must be listed in the dependencies section of the pom.
<project>
...
<build>
...
<plugins>
...
<plugin>
<groupId>org.jboss.as.plugins</groupId>
<artifactId>jboss-as-maven-plugin</artifactId>
<version>7.7.Final</version>
<executions>
<execution>
<id>deploy-postgresql</id>
<phase>package</phase>
<goals>
<goal>deploy-artifact</goal>
</goals>
<configuration>
<groupId>postgresql</groupId>
<artifactId>postgresql</artifactId>
<name>postgresql.jar</name>
</configuration>
</execution>
<execution>
<id>add-datasource</id>
<phase>install</phase>
<goals>
<goal>add-resource</goal>
</goals>
<configuration>
<address>subsystem=datasources</address>
<resources>
<resource>
<address>xa-data-source=java:jboss/datasources/postgresDS</address>
<enable-resource>true</enable-resource>
<properties>
<xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class>
<jndi-name>java:jboss/datasources/postgresDS</jndi-name>
<enabled>true</enabled>
<pool-name>myPool</pool-name>
<driver-name>postgresql.jar</driver-name>
</properties>
<resources>
<resource>
<address>xa-datasource-properties=DatabaseName</address>
<properties>
<value>myDatabase</value>
</properties>
</resource>
<resource>
<address>xa-datasource-properties=ServerName</address>
<properties>
<value>localhost</value>
</properties>
</resource>
<resource>
<address>xa-datasource-properties=User</address>
<properties>
<value>dbuser</value>
</properties>
</resource>
<resource>
<address>xa-datasource-properties=Password</address>
<properties>
<value>supersecret</value>
</properties>
</resource>
</resources>
</resource>
</resources>
</configuration>
</execution>
</executions>
</plugin>
...
</plugins>
...
</build>
...
</project>The xml tags in the properties element correspond directly to the DMR nodes in the corresponding management operation. If you need to use DMR nodes of a non-primitive type then you must prefix the value with the !! escape sequence, which will cause the value to be interpreted as a string representation of a DMR node. For example in the xa-data-source-properties element about xa-datasource-properties is a DMR property list.
Adding other resources
It is also possible to deploy resources other than datasources, the example below shows how to deploy a JMS queue:
<project>
...
<build>
...
<plugins>
...
<plugin>
<groupId>org.jboss.as.plugins</groupId>
<artifactId>jboss-as-maven-plugin</artifactId>
<version>7.7.Final</version>
<executions>
<execution>
<id>add-jms-queue</id>
<phase>install</phase>
<goals>
<goal>add-resource</goal>
</goals>
<configuration>
<resource>
<address>subsystem=messaging,hornetq-server=default,jms-queue=myJmsQueue</address>
<properties>
<durable>true</durable>
<entries>!!["java:jboss/myJmsQueue", "java:jboss/myJmsQueueAlias"]</entries>
</properties>
</resource>
</configuration>
</execution>
</executions>
</plugin>
...
</plugins>
...
</build>
...
</project>Adding resources in domain mode
Adding resources in domain mode works the same as the examples above, except you need to add the domain tag as well as specify at least one profile.
<project>
...
<build>
...
<plugins>
...
<plugin>
<groupId>org.jboss.as.plugins</groupId>
<artifactId>jboss-as-maven-plugin</artifactId>
<version>7.7.Final</version>
<executions>
<execution>
<id>add-datasource</id>
<phase>package</phase>
<goals>
<goal>add-resource</goal>
</goals>
<configuration>
<domain>
<profiles>
<profile>default</profile>
</profiles>
</domain>
<address>subsystem=datasources,data-source=java:jboss/myDs</address>
<resource>
<enable-resource>true</enable-resource>
<properties>
<jndi-name>java:jboss/myDs</jndi-name>
<enabled>true</enabled>
<connection-url>jdbc:h2:mem:test;DB_CLOSE_DELAY=-1</connection-url>
<driver-class>org.h2.Driver</driver-class>
<driver-name>h2</driver-name>
<user-name>sa</user-name>
<password>sa</password>
<pool-name>mypool</pool-name>
</properties>
</resource>
</configuration>
</execution>
</executions>
</plugin>
...
</plugins>
...
</build>
...
</project>