wildfly-arquillian icon indicating copy to clipboard operation
wildfly-arquillian copied to clipboard

The Wildfly Arquillian adaptor

= WildFly Arquillian Adapter :toc:

The WildFly Arquillian Adapter can be used to test your application with https://wildfly.org[WildFly Application Server] or https://www.redhat.com/en/technologies/jboss-middleware/application-platform[JBoss EAP]. It works with both managed and unmanaged standalone and domain servers. As of 3.0.0 there is also a bootable JAR adapter as well.

Versions under 3.0.0 should work with any version of WildFly and JBoss EAP 7.0 and higher. Version 3.0.0 requires a minimum of WildFly 13 or JBoss EAP 7.2. Versions 5.0 for for Jakarta EE 10 and work with WildFly 27 and higher and JBoss EAP 8.0 and higher.

Found a bug or want a new feature? Please file a bug on the https://issues.redhat.com/browse/WFARQ[issue tracker].

== Building

The current minimum is Java 11 and Maven 3.8.0. To build execute the following command.


mvn clean install

== Usage

=== BOM Usage

You can import the org.wildfly.arquillian:wildfly-arquillian-bom to easily include the dependencies you'd need.

[source,xml]

org.wildfly.arquillian wildfly-arquillian-bom ${version.org.wildfly.arquillian} pom import ----

=== Standalone

The WildFly Arquillian Adapter can manage the container process with the following dependency.

[source,xml]

org.wildfly.arquillian wildfly-arquillian-container-managed test ----

If you'd to manage the container process via a different method use the following dependency.

[source,xml]

org.wildfly.arquillian wildfly-arquillian-container-remote test ----

=== Domain

The WildFly Arquillian Adapter can manage the container process with the following dependency.

[source,xml]

org.wildfly.arquillian wildfly-arquillian-container-domain-managed test ----

If you'd to manage the container process via a different method use the following dependency.

[source,xml]

org.wildfly.arquillian wildfly-arquillian-container-domain-remote test ----

=== Bootable JAR

Since version 3.0.0 of the adapter you can now use Arquillian to test your bootable JAR's.

[source,xml]

org.wildfly.arquillian wildfly-arquillian-container-bootable test ----