Adding Maven dependencies to Arquillian test

By default, Arquillian won’t pack the Maven dependencies into the micro deployment files.

If the classes your are testing depend on external dependencies managed by Maven, follow the steps described below to ensure the Maven dependencies will be packed into the Arquillian micro deployments, avoiding ClassNotFoundExceptions:

Adding Arquillian dependencies #

Add Arquillian dependencies to your pom.xml:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.jboss.arquillian</groupId>
            <artifactId>arquillian-bom</artifactId>
            <version>1.1.8.Final</version>
            <scope>import</scope>
            <type>pom</type>
        </dependency>
    </dependencies>
</dependencyManagement>

Add the ShrinkWrap resolver (Maven implementation) to your pom.xml:

<dependency>
    <groupId>org.jboss.shrinkwrap.resolver</groupId>
    <artifactId>shrinkwrap-resolver-impl-maven</artifactId>
    <scope>test</scope>
</dependency>

If you are using JUnit, add the Arquillian JUnit container to your pom.xml:

<dependency>
    <groupId>org.jboss.arquillian.junit</groupId>
    <artifactId>arquillian-junit-container</artifactId>
    <scope>test</scope>
</dependency>

Importing Maven dependencies #

In your test class, within the method annotated with @Deployment, import the runtime dependencies with the following line:

File[] files = Maven.resolver().loadPomFromFile("pom.xml")
        .importRuntimeDependencies().resolve().withTransitivity().asFile();

And then add the dependencies to your deploy using the addAsLibraries(files) method:

ShrinkWrap.create(WebArchive.class)
          .addClass(MyClass1.class)
          .addClass(MyClass2.class)
          .addClass(MyClass3.class)
          .addAsLibraries(files);

This is how your test class will look like if you are using JUnit:

import java.io.File;

import org.jboss.arquillian.container.test.api.Deployment;
import org.jboss.arquillian.junit.Arquillian;
import org.jboss.shrinkwrap.api.ShrinkWrap;
import org.jboss.shrinkwrap.api.asset.EmptyAsset;
import org.jboss.shrinkwrap.api.spec.WebArchive;
import org.jboss.shrinkwrap.resolver.api.maven.Maven;
import org.junit.Test;
import org.junit.runner.RunWith;
import static org.junit.Assert.*;

@RunWith(Arquillian.class)
public class MyTestClassWithMavenDependencies {

    @Deployment
    public static WebArchive createDeployment() {

        // Import Maven runtime dependencies
        File[] files = Maven.resolver().loadPomFromFile("pom.xml")
                .importRuntimeDependencies().resolve().withTransitivity().asFile();

        // Create deploy file
        WebArchive war = ShrinkWrap.create(WebArchive.class)
                .addClass(MyClass1.class)
                .addClass(MyClass2.class)
                .addClass(MyClass3.class)
                .addAsLibraries(files);

        // Show the deploy structure
        System.out.println(war.toString(true));

        return war;
    }

    // Create your tests here
}

Note 1: The above solution was tested with Arquillian 1.1.8.Final. Check the most recent version of Arquillian artifacts on the documentation.

Note 2: For more details on how to resolve dependencies, have a look at the ShrinkWrap Resolvers documentation.