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:
- Jboss 7.1, Jboss 7.2
- EAP 6.1, EAP 6.2
- Wildfly 8.0, Wildfly 10.0
- Glassfish 3.2.2
- Should work on other servers too
From version 1.1.0 working with domain mode (see extended 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")
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>
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;
}
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
}
To use domain to test classes you need to do few extra steps.
-
Mark your deployment with @TargetsContainer("container-name")
-
Change arquillian container to domain one.
-
And add group for container in arquillian.xml
All of that + extra switching between standalone/domain is done in that project itself.
- Move all deployments to one class and make all your tests extend that class..
- If you have more than one deployment name them and add everywhere in your tests @OperateOnDeployment
- Check if everything is working
- Don't go further unless your tests are not working at that moment (probably will work much slower then normally)
- Add arquillian-suite as dependency
- Check if its working (should work slow as before)
- Add @ArquillianSuiteDeployment annotation on your deployment class
- Now check if your deployments deploy only once.
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.
Most work was done by Aslak Knutsen
- https://gist.github.com/aslakknutsen/3975179
- Part was added by ItCrowd team.
I just mixed things up..
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.
The project is licensed under the Apache License, Version 2.0.