Chapter 9. Complete Container Reference

A DeployableContainer implementation that can connect and run against a remote(different JVM, different machine) running JBoss AS 5.1 instance. This implementation has no lifecycle support, so it can not be started or stopped.

Warning

This container needs a jndi.properties file on classpath to be able to connect to the remote running instance.

Table 9.1. Container Injection Support Matrix

@EJB	@EJB (no-interface)	@Inject (CDI)	@Inject (MC)	@PersistenceContext @PersistenceUnit

9.1.1. Configuration

Namespace: urn:arq:org.jboss.arquillian.jbossas.remote51

Table 9.2. Container Configuration Options

Name	Type	Default	Description
profileName	String	default	ProfileService profileKey. Used to load the correct profile into the DeploymentManager.
remoteServerAddress	String	localhost	Used by Servlet Protocol to connect to the remote server.
remoteServerHttpPort	int	8080	Used by Servlet Protocol to connect to the remote server.
localDeploymentBindAddress	String	localhost	Bind Address for the HTTP server serving deployments to the remote server. Address must be reachable from remote server.
localDeploymentBindPort	int	9999	Bind Port for the HTTP server serving deployments to the remote server. Port must be reachable from remote server.

Example of Maven profile setup


<profile>

    <id>jbossas-remote-51</id>

    <dependencies>

        <dependency>

            <groupId>org.jboss.arquillian.container</groupId>

            <artifactId>arquillian-jbossas-remote-51</artifactId>

            <version>1.0.0.Alpha2</version>

        </dependency>

        <dependency>

            <groupId>org.jboss.jbossas</groupId>

            <artifactId>jboss-as-client</artifactId>

            <version>5.1.0.GA</version>

            <type>pom</type>

        </dependency>

    </dependencies>

</profile>

9.2. JBoss AS 5.1 - Remote + Lifecycle

A DeployableContainer implementation that can run and connect to a remote(different JVM, same machine) JBoss AS 5.1 instance. This implementation has lifecycle support, so the container will be started and stopped as part of the test run.

Table 9.3. Container Injection Support Matrix

@EJB	@EJB (no-interface)	@Inject (CDI)	@Inject (MC)	@PersistenceContext @PersistenceUnit

9.2.1. Configuration

Namespace: urn:arq:org.jboss.arquillian.jbossas.local51

Table 9.4. Container Configuration Options

Name	Type	Default	Description
profileName	String	default	ProfileService profileKey. Used to load the correct profile into the DeploymentManager.
bindAddress	String	localhost	The Address the server should bind to.
httpPort	int	8080	Used by Servlet Protocol to connect to the server.
jbossHome	String	$JBOSS_HOME	The JBoss configuration to start.
javaHome	String	$JAVA_HOME	The Java runtime to use to start the server.

Example of Maven profile setup


<profile>

    <id>jbossas-local-60</id>

    <dependencies>

        <dependency>

            <groupId>org.jboss.arquillian.container</groupId>

            <artifactId>arquillian-jbossas-remote-60</artifactId>

            <version>1.0.0.Alpha2</version>

        </dependency>

        <dependency>

            <groupId>org.jboss.jbossas</groupId>

            <artifactId>jboss-server-manager</artifactId>

            <version>1.0.3.GA</version>

        </dependency>

        <dependency>

            <groupId>org.jboss.jbossas</groupId>

            <artifactId>jboss-as-client</artifactId>

            <version>5.1.0.GA</version>

            <type>pom</type>

        </dependency>

    </dependencies>

</profile>

9.3. JBoss AS 6.0 - Remote

A DeployableContainer implementation that can connect and run against a remote(different JVM, different machine) running JBoss AS 6.0 instance. This implementation has no lifecycle support, so it can not be started or stopped.

Warning

This container needs a jndi.properties file on classpath to be able to connect to the remote running instance.

Table 9.5. Container Injection Support Matrix

@EJB	@EJB (no-interface)	@Inject (CDI)	@Inject (MC)	@PersistenceContext @PersistenceUnit

9.3.1. Configuration

Namespace: urn:arq:org.jboss.arquillian.jbossas.remote60

Table 9.6. Container Configuration Options

Name	Type	Default	Description
profileName	String	default	ProfileService profileKey. Used to load the correct profile into the DeploymentManager.
remoteServerAddress	String	localhost	Used by Servlet Protocol to connect to the remote server.
remoteServerHttpPort	int	8080	Used by Servlet Protocol to connect to the remote server.
localDeploymentBindAddress	String	localhost	Bind Address for the HTTP server serving deployments to the remote server. Address must be reachable from remote server.
localDeploymentBindPort	int	9999	Bind Port for the HTTP server serving deployments to the remote server. Port must be reachable from remote server.

Example of Maven profile setup


<profile>

    <id>jbossas-remote-60</id>

    <dependencies>

        <dependency>

            <groupId>org.jboss.arquillian.container</groupId>

            <artifactId>arquillian-jbossas-remote-60</artifactId>

            <version>1.0.0.Alpha2</version>

        </dependency>

        <dependency>

            <groupId>org.jboss.jbossas</groupId>

            <artifactId>jboss-as-client</artifactId>

            <version>6.0.0.20100429-M3</version>

            <type>pom</type>

        </dependency>

    </dependencies>

</profile>

9.4. JBoss AS 6.0 - Remote + Lifecycle

A DeployableContainer implementation that can run and connect to a remote(different JVM, same machine) JBoss AS 6.0 instance. This implementation has lifecycle support, so the container will be started and stopped as part of the test run.

Table 9.7. Container Injection Support Matrix

@EJB	@EJB (no-interface)	@Inject (CDI)	@Inject (MC)	@PersistenceContext @PersistenceUnit

9.4.1. Configuration

Namespace: urn:arq:org.jboss.arquillian.jbossas.local60

Table 9.8. Container Configuration Options

Name	Type	Default	Description
profileName	String	default	ProfileService profileKey. Used to load the correct profile into the DeploymentManager.
bindAddress	String	localhost	The Address the server should bind to.
httpPort	int	8080	Used by Servlet Protocol to connect to the server.
jbossHome	String	$JBOSS_HOME	The JBoss configuration to start.
javaHome	String	$JAVA_HOME	The Java runtime to use to start the server.

Example of Maven profile setup


<profile>

    <id>jbossas-local-60</id>

    <dependencies>

        <dependency>

            <groupId>org.jboss.arquillian.container</groupId>

            <artifactId>arquillian-jbossas-remote-60</artifactId>

            <version>1.0.0.Alpha2</version>

        </dependency>

        <dependency>

            <groupId>org.jboss.jbossas</groupId>

            <artifactId>jboss-server-manager</artifactId>

            <version>1.0.3.GA</version>

        </dependency>

        <dependency>

            <groupId>org.jboss.jbossas</groupId>

            <artifactId>jboss-as-client</artifactId>

            <version>6.0.0.20100429-M3</version>

            <type>pom</type>

        </dependency>

    </dependencies>

</profile>

9.5. JBoss Embedded AS 6.0 - Embedded

A DeployableContainer implementation that can run and connect to a embedded(same JVM) JBoss AS 6.0 instance. This implementation has lifecycle support, so the container will be started and stopped as part of the test run.

Table 9.9. Container Injection Support Matrix

@EJB	@EJB (no-interface)	@Inject (CDI)	@Inject (MC)	@PersistenceContext @PersistenceUnit

9.5.1. Configuration

Namespace: urn:arq:org.jboss.arquillian.jbossas.embedded60

Table 9.10. Container Configuration Options

Name	Type	Default	Description
profileName	String	default	ProfileService profileKey. Used to load the correct profile into the DeploymentManager.
bindAddress	String	localhost	The Address the server should bind to.
httpPort	int	8080	Used by Servlet Protocol to connect to the server.

Example of Maven profile setup


<profile>

    <id>jbossas-embedded-60</id>

    <dependencies>

        <dependency>

            <groupId>org.jboss.arquillian.container</groupId>

            <artifactId>arquillian-jbossas-embedded-60</artifactId>

            <version>${project.version}</version>

        </dependency>

        <dependency>

            <groupId>org.jboss.jbossas</groupId>

            <artifactId>jboss-as-depchain</artifactId>

            <version>6.0.0.20100429-M3</version>

            <type>pom</type>

        </dependency>

    </dependencies>

    <dependencyManagement>

        <dependencies>

            <dependency>

                <groupId>org.jboss.jbossas</groupId>

                <artifactId>jboss-as-depchain</artifactId>

                <version>6.0.0.20100429-M3</version>

                <type>pom</type>

                <scope>import</scope>

            </dependency>

        </dependencies>

    </dependencyManagement>

    <build>

        <plugins>

            <plugin>

                <artifactId>maven-surefire-plugin</artifactId>

                <configuration>

                    <additionalClasspathElements>

                        <additionalClasspathElement>${env.JBOSS_HOME}/client/jbossws-native-client.jar</additionalClasspathElement>

                        <!--

                            Because jbossweb.sar contains shared web.xml, which must be

                            visible from same CL as TomcatDeployer.class.getClassLoader

                        -->

                        <additionalClasspathElement>${env.JBOSS_HOME}/server/default/deploy/jbossweb.sar</additionalClasspathElement>

                    </additionalClasspathElements>



                    <redirectTestOutputToFile>true</redirectTestOutputToFile>

                    <trimStackTrace>false</trimStackTrace>

                    <printSummary>true</printSummary>

                    <forkMode>once</forkMode>



                    <!--

                        MaxPermSize Required to bump the space for relective data like

                        classes, methods, etc. EMB-41. Endorsed required for things like

                        WS support (EMB-61)

                    -->

                    <argLine>-Xmx512m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=true -Djava.util.logging.manager=org.jboss.logmanager.LogManager -Djava.endorsed.dirs=${env.JBOSS_HOME}/lib/endorsed -Djboss.home=${env.JBOSS_HOME} -Djboss.boot.server.log.dir=${env.JBOSS_HOME}</argLine>

                </configuration>

            </plugin>

        </plugins>

    </build>

</profile>

9.6. JBoss Reloaded - Embedded

A DeployableContainer implementation that can run and connect to a embedded(same JVM) JBoss Reloaded(MicroContainer + VirtualDeploymentFramework) instance. This implementation has lifecycle support, so the container will be started and stopped as part of the test run.

Table 9.11. Container Injection Support Matrix

@EJB	@EJB (no-interface)	@Inject (CDI)	@Inject (MC)	@PersistenceContext @PersistenceUnit

9.7. GlassFish 3.0 - Embedded

A DeployableContainer implementation that can run and connect to a embedded(same JVM) GlassFish 3.0 instance. This implementation has lifecycle support, so the container will be started and stopped as part of the test run.

Table 9.12. Container Injection Support Matrix

@EJB	@EJB (no-interface)	@Inject (CDI)	@Inject (MC)	@PersistenceContext @PersistenceUnit

9.7.1. Configuration

Namespace: urn:arq:org.jboss.arquillian.glassfish.embedded60

Table 9.13. Container Configuration Options

Name	Type	Default	Description
bindPort	int	8181	The port the server should bind to.
instanceRoot	String	target/glassfish_(RANDOM)	The instanceRoot to use for booting the server. If it does not exist, a default structure will be created.
autoDelete	boolean	true	Should the deployments be deleted on shutdown.

Example of Maven profile setup


<profile>

    <id>glassfish-embedded-30</id>

    <dependencies>

        <dependency>

            <groupId>org.jboss.arquillian.container</groupId>

            <artifactId>arquillian-glassfish-embedded-30</artifactId>

            <version>1.0.0.Alpha2</version>

        </dependency>

        <dependency>

            <groupId>org.glassfish.extras</groupId>

            <artifactId>glassfish-embedded-all</artifactId>

            <version>3.0.1-b02</version>

        </dependency>

    </dependencies>

</profile>

9.8. Weld SE - Embedded

A DeployableContainer implementation that can run and connect to a embedded(same JVM) Weld(CDI reference implementation) SE edition. No EE APIs are available. This implementation has lifecycle support, so the container will be started and stopped as part of the test run.

Table 9.14. Container Injection Support Matrix

@EJB	@EJB (no-interface)	@Inject (CDI)	@Inject (MC)	@PersistenceContext @PersistenceUnit

Warning

Local EJBs only, which get treated as managed beans. Transactions, security and EJB context injection are not applied.


<profile>

    <id>weld-embedded</id>

    <dependencies>

        <dependency>

            <groupId>org.jboss.arquillian.container</groupId>

            <artifactId>arquillian-weld-embedded</artifactId>

            <version>1.0.0.Alpha2</version>

        </dependency>

        <dependency>

            <groupId>org.jboss.weld</groupId>

            <artifactId>weld-core</artifactId>

        </dependency>

        <dependency>

            <groupId>org.jboss.weld</groupId>

            <artifactId>weld-api</artifactId>

        </dependency>

        <dependency>

            <groupId>org.slf4j</groupId>

            <artifactId>slf4j-simple</artifactId>

        </dependency>

    </dependencies>

    <dependencyManagement>

        <dependencies>

            <dependency>

                <groupId>org.jboss.weld</groupId>

                <artifactId>weld-core-bom</artifactId>

                <version>1.0.1-SP1</version>

                <type>pom</type>

                <scope>import</scope>

            </dependency>

        </dependencies>

    </dependencyManagement>

</profile>

9.9. Apache OpenWebBeans - Embedded

A DeployableContainer implementation that can run and connect to a embedded(same JVM) WeldApache OpenWebBeans(CDI) instance. No EE APIs are available. This implementation has lifecycle support, so the container will be started and stopped as part of the test run.

Table 9.15. Container Injection Support Matrix

@EJB	@EJB (no-interface)	@Inject (CDI)	@Inject (MC)	@PersistenceContext @PersistenceUnit

Warning

Local EJBs only, which get treated as managed beans. Transactions, security and EJB context injection are not applied.

Example of Maven profile setup


<profile>

    <id>openwebbeans-embedded</id>

    <dependencies>

        <dependency>

            <groupId>org.jboss.arquillian.container</groupId>

            <artifactId>arquillian-openwebbeans-embedded</artifactId>

            <version>1.0.0.Alpha2</version>

        </dependency>

        <dependency>

            <groupId>org.apache.openwebbeans</groupId>

            <artifactId>openwebbeans-spi</artifactId>

        </dependency>

        <dependency>

            <groupId>org.apache.openwebbeans</groupId>

            <artifactId>openwebbeans-impl</artifactId>

        </dependency>

        <dependency>

            <groupId>org.apache.geronimo.specs</groupId>

            <artifactId>geronimo-el_2.2_spec</artifactId>

        </dependency>

        <dependency>

            <groupId>org.apache.geronimo.specs</groupId>

            <artifactId>geronimo-jta_1.1_spec</artifactId>

        </dependency>

        <dependency>

            <groupId>org.apache.geronimo.specs</groupId>

            <artifactId>geronimo-validation_1.0_spec</artifactId>

        </dependency>

        <dependency>

            <groupId>org.apache.geronimo.specs</groupId>

            <artifactId>geronimo-interceptor_1.1_spec</artifactId>

        </dependency>

        <dependency>

            <groupId>org.apache.geronimo.specs</groupId>

            <artifactId>geronimo-jcdi_1.0_spec</artifactId>

        </dependency>

        <dependency>

            <groupId>org.apache.geronimo.specs</groupId>

            <artifactId>geronimo-atinject_1.0_spec</artifactId>

        </dependency>

        <dependency>

            <groupId>org.apache.geronimo.specs</groupId>

            <artifactId>geronimo-servlet_2.5_spec</artifactId>

        </dependency>

    </dependencies>

    <dependencyManagement>

        <dependencies>

            <dependency>

                <groupId>org.apache.openwebbeans</groupId>

                <artifactId>openwebbeans</artifactId>   

                <version>1.0.0-M4</version>

                <type>pom</type>

                <scope>import</scope>

            </dependency>

        </dependencies>

    </dependencyManagement>

</profile>

9.10. Apache OpenEJB - Embedded

A DeployableContainer implementation that can run and connect to a embedded(same JVM) Apache OpenEJB instance. EJB 3.0 APIs are available, but no JMS. This implementation has lifecycle support, so the container will be started and stopped as part of the test run.

Table 9.16. Container Injection Support Matrix

@EJB	@EJB (no-interface)	@Inject (CDI)	@Inject (MC)	@PersistenceContext @PersistenceUnit

Example of Maven profile setup


<profile>

    <id>openejb</id>

    <dependencies>

        <dependency>

            <groupId>org.jboss.arquillian.container</groupId>

            <artifactId>arquillian-openejb</artifactId>

            <version>1.0.0.Alpha2</version>

        </dependency>

        <dependency>

            <groupId>org.apache.openejb</groupId>

            <artifactId>openejb-core</artifactId>

            <version>3.1.2</version>

        </dependency>

    </dependencies>

</profile>