JBoss.orgCommunity Documentation

Arquillian: An integration testing framework for Containers

Reference Guide

by Dan Allen, Aslak Knutsen, Pete Muir, Andrew Rubinger, and Karel Piwko
Preface: Test in the container!
1. Introduction
1.1. Mission statement
1.2. Architecture overview
1.3. Integration testing in Java EE
1.3.1. Testing the real component
1.3.2. Finding a happy medium
1.3.3. Controlling the test classpath
1.4. Usage scenarios
2. Introductory examples
2.1. Testing an EJB
2.2. Testing CDI beans
2.3. Testing JPA
2.4. Testing JMS
3. Getting started
3.1. Setting up Arquillian in a Maven project
3.2. Writing your first Arquillian test
3.3. Setting up and running the test in Maven
3.4. Setting up and running the test in Eclipse
3.5. Setting up and running the test in NetBeans
4. Target containers
4.1. Container varieties
4.2. Container management
4.3. Supported containers
4.4. Container configuration
5. Test enrichment
5.1. Injection into the test case
5.2. Active scopes
6. Test execution
6.1. Anatomy of a test
6.2. ShrinkWrap packaging
6.3. Test archive deployment
6.4. Enriching the test class
6.5. Negotiating test execution
6.6. Test run modes
6.6.1. Mode: in-container
6.6.2. Mode: as-client
6.6.3. Mode: mixed
7. Debugging remote tests
7.1. Debugging in Eclipse
7.1.1. Attaching the IDE debugger to the container
7.1.2. Launching the test in debug mode
7.1.3. Stepping into external libraries
7.2. Assertions in remote tests
7.2.1. Enabling assertions in JBoss AS
8. Build system integration
8.1. Arquillian's active build ingredient
8.2. Integrating Arquillian into a Gradle build
8.2.1. apply from: common
8.2.2. Strategy #1: Container-specific test tasks
8.2.3. Strategy #2: Test profiles
8.3. Integrating Arquillian into an Ant (+Ivy) build
9. Advanced use cases
9.1. Descriptor deployment
9.2. Resource injection
9.3. Multiple Deployments
9.4. Multiple Containers
9.5. Protocol selection
10. Extending Arquillian
11. Complete Extension/Framework Reference
11.1. Performance
11.2. JSFUnit
11.3. Drone
12. Complete Container Reference
12.1. JBoss AS 5 - Remote
12.1.1. Configuration
12.2. JBoss AS 5.1 - Remote
12.2.1. Configuration
12.3. JBoss AS 5.1 - Managed
12.3.1. Configuration
12.4. JBoss AS 6.0 - Remote
12.4.1. Configuration
12.5. JBoss AS 6.0 - Managed
12.5.1. Configuration
12.6. JBoss AS 6.0 - Embedded
12.6.1. Configuration
12.7. JBoss Reloaded 1.0 - Embedded
12.7.1. Configuration
12.8. GlassFish 3.1 - Embedded
12.8.1. Configuration
12.9. GlassFish 3.1 - Remote
12.9.1. Configuration
12.10. Tomcat 6.0 - Embedded
12.10.1. Configuration
12.11. Jetty 6.1 - Embedded
12.11.1. Configuration
12.12. Jetty 7.0 - Embedded
12.12.1. Configuration
12.13. Weld SE 1.0 - Embedded
12.13.1. Configuration
12.14. Weld SE 1.1 - Embedded
12.14.1. Configuration
12.15. Weld EE 1.1 - Embedded
12.15.1. Configuration
12.16. Apache OpenWebBeans 1.0 - Embedded
12.16.1. Configuration
12.17. Apache OpenEJB 3.1 - Embedded
12.17.1. Configuration
13. Complete Protocol Reference
13.1. Local
13.1.1. Configuration
13.2. Servlet 2.5
13.2.1. Configuration
13.3. Servlet 3.0
13.3.1. Configuration