Arquillian测试框架快速上手教程 （一） - 环境搭建、容器适配、单元测试

Arquillian是一个基于JUnit，由JBoss开发的新型测试框架，其主要目的是简化Java项目集成测试和功能测试的编写，让它们能像单元测试一样简单。Arquillian能真正在Web容器中运行测试，它主要通过三种方式与容器进行交互：

1.  嵌入式(embedded)。Arquillian和Web容器在同一个JVM中运行。

2. 受管理的(managed)。由Arquillian决定何时启动、关闭Web容器以便向容器中部署、运行测试。

3. 远程的(remote)。开发者事先启动Web容器，Arquillian连接该容器并将测试部署到容器中运行。

这里我们使用JBoss Forge来帮助我们快速创建maven标准目录和基本的pom.xml文件。

首先启动Forge：

forge

新建项目 arquillian-demo，指定包名为cn.demo：

new-project --named arquillian-demo --topLevelPackage cn.demo

这里就用这2条命令，我们将会手动编辑pom文件来添加arquillian的相关依赖。关于Forge的详细安装、使用方法，参见我另一篇文章： Debian-7.1下JBoss Forge + Arquillian测试环境搭建

为了方便编辑，我们将该项目导入至eclipse中：

在eclipse菜单栏中选择 File --> Import，在弹出的对话框中选择 "Existing Maven Project"。这样导入的好处是Eclipse会自动分析pom.xml文件，自动根据依赖设置classpath，写错了也能第一时间得到错误提示。

打开pom.xml，我们能看到Forge已经为我们自动生成了以下内容：

<modelVersion>4.0.0</modelVersion><groupId>cn.demo</groupId><artifactId>arquillian-demo</artifactId><version>1.0.0-SNAPSHOT</version><repositories><repository><id>JBOSS_NEXUS</id><url>http://repository.jboss.org/nexus/content/groups/public</url></repository></repositories><build><finalName>arquillian-demo</finalName><plugins><plugin><artifactId>maven-compiler-plugin</artifactId><version>3.1</version><configuration><source>1.6</source><target>1.6</target><encoding>UTF-8</encoding></configuration></plugin></plugins></build>

我们需要添加 dependency 和 dependencyManagement节点，修改完成后内容如下：

<modelVersion>4.0.0</modelVersion><groupId>cn.demo</groupId><artifactId>arquillian-demo</artifactId><version>1.0.0-SNAPSHOT</version><repositories><repository><id>JBOSS_NEXUS</id><url>http://repository.jboss.org/nexus/content/groups/public</url></repository></repositories><build><finalName>arquillian-demo</finalName><plugins><plugin><artifactId>maven-compiler-plugin</artifactId><version>3.1</version><configuration><source>1.6</source><target>1.6</target><encoding>UTF-8</encoding></configuration></plugin></plugins></build><!-- newly add starts --><dependencies><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.8.1</version><scope>test</scope></dependency><dependency><groupId>org.jboss.arquillian.junit</groupId><artifactId>arquillian-junit-container</artifactId><scope>test</scope></dependency></dependencies><dependencyManagement><dependencies><dependency><groupId>org.jboss.arquillian</groupId><artifactId>arquillian-bom</artifactId><version>1.1.3.Final</version><scope>import</scope><type>pom</type></dependency></dependencies></dependencyManagement><!-- newly add ends -->

保存后，eclipse会自动从远程仓库中下载相关jar包，稍等即可。

我们首先编写一个Hello类，内容如下：

package cn.demo;public class Hello {public String sayHello(String name) {return "hello," + name;}
}

该类的功能非常简单，传入一个名字，然后输出 hello + 名字。下面我们为这个类写单元测试。

新建HelloTest类，代码如下：

package cn.demo;import javax.inject.Inject;import org.jboss.arquillian.container.test.api.Deployment;
import org.jboss.arquillian.junit.Arquillian;
import org.jboss.shrinkwrap.api.ShrinkWrap;
import org.jboss.shrinkwrap.api.asset.EmptyAsset;
import org.jboss.shrinkwrap.api.spec.JavaArchive;
import org.junit.Assert;
import org.junit.Test;
import org.junit.runner.RunWith;@RunWith(Arquillian.class)
public class HelloTest {@Injectprivate Hello helloBean; // 注入一个Hello对象@Deploymentpublic static JavaArchive createDeployment() {return ShrinkWrap.create(JavaArchive.class).addClass(Hello.class).addAsManifestResource(EmptyAsset.INSTANCE, "beans.xml");}@Testpublic void isHelloValid() {Assert.assertNotNull(helloBean); // 判断注入是否成功Assert.assertEquals("hello,Neo", helloBean.sayHello("Neo")); // 判断返回值是否正确}
}

代码说明：

一个Arquillian测试必须有三部分内容，分别是：

1. @RunWith(Arquillian.class)注解。

2. 一个公有的、静态的、标注了@Deployment注解并返回一个Test Archive（稍后说明）的方法。

3. 至少有一个方法标有@Test注解。

@RunWith(Arquillian.class)注解的功能是通知 JUnit 让 Arquillian 接过控制权，做为测试的控制器(Test Controller)。那@Deployment是做什么用的呢？前面说过，Arquillian可以将测试直接部署到JBoss中运行，那怎么部署，部署哪些内容，就由这个标有@Deployment注解的方法来决定。Arquillian使用 ShrinkWrap API 来创建jar包、向jar包中添加资源(比如一个类)，然后 ShrinWrap 会根据我们定义好的jar包生成一个真正的jar文件，最后由Arquillian把这个jar包部署到JBoss中去。本例中，首先调用ShrinkWrap类的静态方法 create()，传递 JavaArchive.class 以指定我们要创建的是jar类型的文件，然后调用 addClass() 方法向jar文件中添加类，调用 addAsManifectResource() 方法向jar中添加一个空的 beans.xml，最后将结果返回。关于ShrinkWarp的详细使用方法，参见官方的 快速指南。

Container Adapter是沟通 Arquillian 和 Web容器的桥梁，Arquillian 通过不同的 Container Adapter 来判断到底在哪种Web容器上运行测试，并通过它来控制容器。只要一个Web容器有其对应的Container Adapter，那么这个容器说可以运行 Arquillian测试。我们以remote方式的 JBoss-As-7.1.1（即开发者需事先启动JBoss，Arquillian会自动连接这个JBoss以运行测试）为例：

首先向pom.xml中添加profiles节点，内容如下：

<profiles><profile><id>arq-jbossas-remote</id><dependencies><dependency><groupId>org.jboss.spec</groupId><artifactId>jboss-javaee-6.0</artifactId><version>1.0.0.Final</version><type>pom</type><scope>provided</scope></dependency><dependency><groupId>org.jboss.as</groupId><artifactId>jboss-as-arquillian-container-remote</artifactId><version>7.1.1.Final</version><scope>test</scope></dependency><dependency><groupId>org.jboss.arquillian.protocol</groupId><artifactId>arquillian-protocol-servlet</artifactId><scope>test</scope></dependency></dependencies></profile></profiles>

这里用profile的一大好处是，我们可以灵活的切换不同的Web服务器。比如，我们想在JBoss上跑测试，就执行

mvn test -Parq-jbossas-remote

如果我们想在GlassFish上运行测试，就可以定义一个名为 arq-glassfish-remote的profile，然后执行：

mvn test -Parq-glassfish-remote

切换到工程根目录下，执行

mvn clean install -Dmaven.test.skip=true

mvn test -Parq-jbossas-remote

输出结果如下，则测试成功。（别忘了要事先启动JBoss！）

前面说过Arquillian可以以managed 的方式与JBoss进行交互，特点是我们不必事先启动JBoss，而在运行测试时，Arquillian会自动启动JBoss，并在完成测试后自动关闭JBoss。下面举例说明如何操作。 

首先，新建一个profile节点，内容如下：

<profile><id>arquillian-jbossas-managed</id><dependencies><dependency><groupId>org.jboss.spec</groupId><artifactId>jboss-javaee-6.0</artifactId><version>1.0.0.Final</version><type>pom</type><scope>provided</scope></dependency><dependency><groupId>org.jboss.as</groupId><artifactId>jboss-as-arquillian-container-managed</artifactId> <!-- 注意这里换成了managed而不是remote --><version>7.1.1.Final</version><scope>test</scope></dependency><dependency><groupId>org.jboss.arquillian.protocol</groupId><artifactId>arquillian-protocol-servlet</artifactId><scope>test</scope></dependency></dependencies></profile>

然后，为了让Arquillian “知道” 我们的JBoss放在哪， 我们需要在 main/src/resource 目录下创建一个名为 arquillian.xml的文件，通过这个文件我们可以设置 arquillian 的很多属性，类似于 web.xml 的功能。

arquillian.xml内容如下：

<arquillian xmlns="http://jboss.org/schema/arquillian"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://jboss.org/schema/arquillianhttp://jboss.org/schema/arquillian/arquillian_1_0.xsd"><container qualifier="jbossas-managed" default="true"><configuration><property name="jbossHome">你的JBoss安装目录</property></configuration></container>
</arquillian>

切换到项目根目录下，运行

mvn test -Parquillian-jbossas-managed

从控制台输出可以看到，到 test 阶段时，Arquillian 会启动JBoss :

然后部署并运行测试，最后undeploy并关闭JBoss：

事实上，seam-2.3已经在pom文件自动加入Arquillian的相关依赖了。我们可以直接在 ftc-test 模块中写测试类，然后执行

mvn test -P你起的profile名

即可进行测试。但seam-2.3中默认使用TestNG而不是JUnit，所以还需要对pom文件进行修改。直接把ftc聚合模块的pom.xml改成下面的内容即可：

然后将ftc-test 模块中的pom.xml 文件修改为以下内容：

以上修改在后续的功能测试中会用到。