ingwarsw / arquillian-suite-extension

Arquillian extension that will force single deployment for all tests
Apache License 2.0
67 stars 20 forks source link
arquillian arquillian-extension java

The Arquillian Suite Extension

Build Status Coverage Status Maven Central

The Extension will force all Classes in a Module into a TestSuite running from the same DeploymentScenario.

Class marked with @ArquillianSuiteDeployment will be used as a 'template' for all other TestClass scenarios.

Deploy will occur only once on first test witch require Arquillian.

So far tested on:

From version 1.1.0 working with domain mode (see extended usage).

Basic Usage

Add module to test classpath.

<dependency>
    <groupId>org.eu.ingwar.tools</groupId>
    <artifactId>arquillian-suite-extension</artifactId>
    <version>1.2.0</version>
    <scope>test</scope>
</dependency>

Mark one of your test classes with annotation @ArquillianSuiteDeployment along with usual @Deployment annotation on method.

@ArquillianSuiteDeployment
public class Deployments {

    @Deployment
    public static WebArchive deploy() {
        return ShrinkWrap.create(WebArchive.class)
            .addAsWebInfResource(EmptyAsset.INSTANCE, "beans.xml")
            .addPackage(Deployments.class.getPackage());
    }
}

Remember! Always include test classes in your deployment.

Run test either from IDE or gradle/maven.

Make sure you use servlet protocol!

To do that add following to arquillian.xml:

<defaultProtocol type="Servlet 3.0"/>

Or mark your deployments with annotation @OverProtocol("Servlet 3.0")

Extended usage

Configuring deployment suite class by in arquillian.xml

Global deployment class can be configured on arquillian.xml file witch makes things bit faster at runtime and may help with finding right class on complicated projects.

<extension qualifier="suite">
    <property name="deploymentClass">org.eu.ingwar.tools.arquillian.extension.suite.Deployments</property>
</extension>

Generic builder

That project contains generic builder with should work for most simple J2EE cases. You dont need to define deployment yourself but you can use generic builder to do work for you.

Basic usage for EJB module looks like.

    @Deployment
    public static EnterpriseArchive generateAutogeneratedDeployment() {
        EnterpriseArchive ear = EarGenericBuilder.getModuleDeployment(ModuleType.EJB);
        return ear;
    }

Multi deployment

As with normal arquillian you can define more than one deployment and then force tests to run on one of them. You can run them in order you like adding order attribute to @Dployment annotation.

@ArquillianSuiteDeployment
public class Deployments {

    @Deployment(name = "normal", order = 2)
    public static Archive<?> generateDefaultDeployment() {
        return ShrinkWrap.create(WebArchive.class, "normal.war")
            .addAsWebInfResource(EmptyAsset.INSTANCE, "beans.xml")
            .addClass(Deployments.class)
            .addClass(InjectedObject.class)
            .addPackage(Extension1Test.class.getPackage());
    }

    @Deployment(name = "extra", order = 1)
    public static Archive<?> generateExtraDeployment() {
        Archive<?> ejb = ShrinkWrap.create(WebArchive.class, "extra_ejb.war")
            .addAsWebInfResource(EmptyAsset.INSTANCE, "beans.xml")
            .addClass(Deployments.class)
            .addClass(InjectedObject.class)
            .addPackage(ExtensionExtra1Test.class.getPackage());
        return ejb;
    }
}

Then at test methods you need to add annotation @OperateOnDeployment("name")

@Test
@OperateOnDeployment("normal")
public void testNormal() {
    // Test on normal deployment
}

@Test
@OperateOnDeployment("extra")
public void testExtra() {
    // Test on extra deployment
}

Domain deployment

To use domain to test classes you need to do few extra steps.

All of that + extra switching between standalone/domain is done in that project itself.

Easiest way to move to suite:

That way if you will ever wonder if suite is failing your build only thing you will need to do is comment out @ArquillianSuiteDeployment and checks if its working then. If not its not suite related problem.

Extra info

Credits

Most work was done by Aslak Knutsen

I just mixed things up..

Continuous integration

Travis CI builds the plugin with Oracle and Open JDK 7. Jacoco is used to gather coverage metrics and the report is submitted to Coveralls.

License

The project is licensed under the Apache License, Version 2.0.