JarCastingSpock Arquillian Extension
BDD Testing in the container!
What is it?
Arquillian is testing framework, developed at JBoss.org, that empowers developers to write integration tests for business objects that are executed inside of an embedded or remote container--options include a servlet container, a Java EE application server or a Java SE CDI environment.
Spock is a testing and specification framework for Java and Groovy applications. What makes it stand out from the crowd is its beautiful and highly expressive specification language. Thanks to its JUnit runner, Spock is compatible with most IDEs, build tools, and continuous integration servers. Spock is inspired from JUnit, jMock, RSpec, Groovy, Scala, Vulcans, and other fascinating life forms.
The Spock Arquillian Extension opens up for the beauty of Spock tests running in-container using Arquillian with full EJB, Resource and CDI injection.
Example
@Deployment
def static JavaArchive "create deployment"() {
return ShrinkWrap.create(JavaArchive.class)
.addClasses(AccountService.class, Account.class, SecureAccountService.class)
.addAsManifestResource(EmptyAsset.INSTANCE, "beans.xml");
}
@Inject
AccountService service
def "transferring between accounts should result in account withdrawal and deposit"() {
when:
service.transfer(from, to, amount)
then:
from.balance == fromBalance
to.balance == toBalance
where:
from << [new Account(100), new Account(10)]
to << [new Account(50), new Account(90)]
amount << [50, 10]
fromBalance << [50, 0]
toBalance << [100, 100]
}
Usage
The Spock Arquillian Extension supports both Groovy major versions supported by Spock Framework. In order to select proper versions, you need to put following dependencies into your section:
<dependency>
<groupId>org.jboss.arquillian.spock</groupId>
<!-- replace * with standalone or container, according to your needs -->
<artifactId>arquillian-spock-*</artifactId>
<version>${project.version}</version>
<scope>test</scope>
</dependency>
<!-- External Projects -->
<dependency>
<groupId>org.spockframework</groupId>
<artifactId>spock-core</artifactId>
<version>${version.spock}</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.codehaus.groovy</groupId>
<artifactId>groovy-all</artifactId>
<version>${version.groovy}</version>
<scope>test</scope>
</dependency>
For Groovy 2.x, use spock 0.7-groovy-2.0 or later and Groovy 2.1.4 or later
You must annotate the JUnit Runner with the ArquillianSputnik runner.
@RunWith(ArquillianSputnik.class)
Build
Regular mvn clean install will run tests against Wildfly 8.0.0.Final. Others containers can be used by defining container variable, for example
mvn clean install -Dcontainer="JBoss AS:7.1.1.Final:managed"
This flexibility and is provided by Arquillian Chameleon. For more available containers see default list.
Contents of repository
core/ The Spock Extension itself.
standalone/ Standalone Arquillian test executor.
container/ Container extension which bundles all Spock-related dependencies required while running Spock specifications using Arquillian.
examples/ Sample tests written using Spock BDD framework.
Licensing
This distribution, as a whole, is licensed under the terms of the Apache License, Version 2.0 (see license.txt).
