2. 程式人生 > >Arquillian測試框架快速上手教程 （一）

Arquillian測試框架快速上手教程 （一）

阿新 • • 發佈：2019-02-10

本系列教程共五篇，分別是：

二、JBoss Forge、ShrinkWrap快速指南

五、使用 Arquillian 在雲端進行測試

其中，Web容器以JBoss-as-7.1.1為例，工程以maven目錄結構為準。

本文所涉及到的內容有：

1. Arquillian

2. Maven

3. JUnit

4. Seam Framework

5. ShrinkWrap

6. JBoss Forge

Arquillian簡介

Arquillian是一個基於JUnit，由JBoss開發的新型測試框架，其主要目的是簡化Java專案整合測試和功能測試的編寫，讓它們能像單元測試一樣簡單。Arquillian能真正在Web容器中執行測試，它主要通過三種方式與容器進行互動： 1.  嵌入式(embedded)。Arquillian和Web容器在同一個JVM中執行。 2. 受管理的(managed)。由Arquillian決定何時啟動、關閉Web容器以便向容器中部署、執行測試。 3. 遠端的(remote)。開發者事先啟動Web容器，Arquillian連線該容器並將測試部署到容器中執行。

一個最簡單的單元測試

建立maven工程

這裡我們使用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，寫錯了也能第一時間得到錯誤提示。

新增Arquillian相關依賴

開啟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包，稍等即可。

編寫Bean和測試類

我們首先編寫一個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 {
	@Inject
	private Hello helloBean; // 注入一個Hello物件
	
	@Deployment
	public static JavaArchive createDeployment() {
		return ShrinkWrap.create(JavaArchive.class).addClass(Hello.class)
				.addAsManifestResource(EmptyAsset.INSTANCE, "beans.xml");
	}

	@Test
	public 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)

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
注: -Dmaven.test.skip=true 的意思是讓maven在執行clean install指令時不要進行測試。 
mvn test -Parq-jbossas-remote

輸出結果如下，則測試成功。（別忘了要事先啟動JBoss！）

以managed方式執行測試

前面說過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/arquillian
        http://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：

在我們的ftc的seam專案中如何使用Arquillian？

事實上，seam-2.3已經在pom檔案自動加入Arquillian的相關依賴了。我們可以直接在 ftc-test 模組中寫測試類，然後執行 
mvn test -P你起的profile名

即可進行測試。但seam-2.3中預設使用TestNG而不是JUnit，所以還需要對pom檔案進行修改。直接把ftc聚合模組的pom.xml改成下面的內容即可： 
<?xml version="1.0" encoding="UTF-8"?>
4.0.0cnftc1.0-SNAPSHOTpomrailway safety monitorrailway safety monitorhttp://dz.sdut.edu.cn/redmineftc-ejbftc-webftc-earftc-testsJBoss repositoryhttp://repository.jboss.org/nexus/content/groups/public/phantomjsftcslow12.01.6.17.1.1.Final0.5.8.2012071112201.6.2*firefoxproxyhttp://localhost:8080http://localhost:818014444localhost030000false${project.build.directory}/ftest-logs${project.build.directory}/ftest-output300truesrc/test/resources-ftestlocalhost/${project.build.finalName}/${env.JBOSS_HOME}/server/all${env.JBOSS_HOME}default${env.CATALINA_HOME}falseUTF-81.61.6${maven.compiler.target}${maven.compiler.source}postgresqlpostgresql9.1-901-1.jdbc44.111.1.2.Finalorg.jboss.arquillianarquillian-bom1.1.2.Finalpomimportorg.jboss.arquillian.extensionarquillian-drone-bom1.2.3.Finalpomimportorg.jboss.arquillian.seleniumselenium-bom2.39.0pomimportcn.ftcftc-ejb${project.version}ejbcn.ftcftc-web${project.version}warcn.ftcftc-ear${project.version}org.jboss.seambom2.3.0.Finalpomimportcommons-loggingcommons-logging1.1.1providedcommons-collectionscommons-collections3.2providedcom.google.guavaguava${guava.version}org.slf4jslf4j-log4j12${slf4j.version}${jdbc.groupId}${jdbc.artifactId}${jdbc.version}testjavax.enterprisecdi-apiprovidedorg.jboss.spec.javax.annotationjboss-annotations-api_1.1_specprovidedjunitjunittestorg.jboss.arquillian.junitarquillian-junit-containertestorg.jboss.arquillian.graphenegraphene-webdriver2.0.1.Finalpomtestarquillian-demomaven-compiler-plugin3.11.61.6UTF-8maven-ear-plugin2.7org.codehaus.mojobuild-helper-maven-plugin1.7maven-resources-plugin2.5org.jboss.as.pluginsjboss-as-maven-plugin7.3.Finaldeploymaven-ejb-plugin2.33.0maven-war-plugin2.1.1truefalse${project.build.finalName}firefoxfirefoxchromechromearq-jboss-as-remoteorg.jboss.asjboss-as-arquillian-container-remote7.1.1.Finaltestorg.jboss.arquillian.protocolarquillian-protocol-servlettestarq-jboss_as_managed_7.xmaven-surefire-plugin2.14.1JBOSS_AS_MANAGED_7.Xorg.jboss.asjboss-as-arquillian-container-managed7.1.1.Final

然後將ftc-test 模組中的pom.xml 檔案修改為以下內容： 
<?xml version="1.0" encoding="UTF-8"?>
4.0.0ftccn1.0-SNAPSHOTcn.ftcftc-testsftc Integration Tests Module (EE6)cn.ftcftc-ejbejbtestorg.slf4jslf4j-log4j12testorg.hibernate.javax.persistencehibernate-jpa-2.0-apiorg.jboss.spec.javax.facesjboss-jsf-api_2.1_specsrc/test/resources

以上修改在後續的功能測試中會用到。

相關推薦

Arquillian測試框架快速上手教程 （一）

本系列教程共五篇，分別是： 二、JBoss Forge、ShrinkWrap快速指南 五、使用 Arquillian 在雲端進行測試 其中，Web容器以JBoss-as-7.1.1為例，工程以maven目錄結構為準。 本文所涉及到的內容有： 1. Arquillia

Yii2框架RESTful API教程（一） - 快速入門

比較 exp values cnblogs -- restful extends .cn pat 前不久做一個項目，是用Yii2框架寫一套RESTful風格的API，就去查了下《Yii 2.0 權威指南 》，發現上面寫得比較簡略。所以就在這裏寫一篇教程貼，希望幫助剛接觸Yi

ThinkJS框架入門詳細教程（一）開發環境

install devel 版本 開發 conf doc 瀏覽器 打開 變量 一、前端標配環境 1、nodeJS正確安裝，可以參考：http://www.cnblogs.com/chengxs/p/6221393.html 2、git正確安裝，可以參考：http://w

Koa快速入門教程（一）

Koa 是由 Express 原班人馬打造的，致力於成為一個更小、更富有表現力、更健壯的 Web 框架，採用了async和await的方式執行非同步操作。 Koa有v1.0與v2.0兩個版本，隨著node對async和await的支援，Koa2的正式釋出，本文Koa均

聯盛德WIFI模組 山景語音Codec 智慧音箱開發板、智慧語音玩具開發板 上手教程（一）

新板子除錯步驟 接線如圖： 連線JLINK，開啟板子， 開啟keil工程：e:\work\智慧硬體\軟硬體\聯盛德-wifi模組\音訊AP8048c\MVs18_01_07\Examples\SpiFlash\SpiFlashExample.uvproj 之後點

Rancher及Docker快速上手指南（一）

Rancher是一個開源的企業級全棧化容器部署及管理平臺，目前我們使用的是穩定釋出的版本V1.6（2017年釋出），其中Rancher2.0也於2018年釋出，Rancher 2.0是一個簡化、加速企業Kubernetes（K8S）快速落地的產品，由於2.0版本變動太大，不便於我們入門應用，而且

WIFI模組+語音Codec智慧音箱、智慧語音兒童玩具開發板上手教程（一）

新板子除錯步驟 接線如圖： 連線JLINK，開啟板子， 開啟keil工程：e:\work\智慧硬體\軟硬體\聯盛德-wifi模組\音訊AP8048c\MVs18_01_07\Examples\Sp

Scala快速學習教程（一）

    在學習spark時使用到了scala語言進行程式設計，特編寫此部落格，已儘量精簡的方式對scala語言進行總結學習（在至少會一門程式語言的基礎上看此篇部落格會比較容易）。Scala運行於Java平臺（JVM，Java 虛擬機器）上，併兼容現有的Java程式，Scala

模糊測試框架 Sulley 使用手記 （一）

在最近專案的測試中，我們引入了模糊測試（Fuzz testing)。在這個過程中，接觸到了Sulley，一款用Python實現的用於網路協議fuzz testing的開源測試框架。跟其他的開源工具比起

python之lxml快速上手_Element（一）

The Element class 對於使用任何一種程式語言的開發人員來說，xml的處理總是不可避免，甚至是非常常見的。而lxml則是在python語言中，功能最豐富、最易於使用，同時效能也相當不錯的xml、html處理庫。雖然網上也有許多介紹lxml用法的文

jQuery EasyUI快速入門實戰教程（一）-入門

jquery javascript easyui 1、jQuery EasyUI概述jQuery EasyUI是一組基於jQuery的UI插件集合體，而jQuery EasyUI的目標就是幫助web開發者更輕松的打造出功能豐富並且美觀的UI界面。開發者不需要編寫復雜的javascript，也不需要

Java NIO框架Netty教程（一） – Hello Netty

tex highlight bsp ret 開發 包括 tor 習慣 事件機制 先啰嗦兩句，如果你還不知道Netty是做什麽的能做什麽。那可以先簡單的搜索了解一下。我只能說Netty是一個NIO的框架，可以用於開發分布式的Java程序。具體能做什麽，各位可以盡量發揮想象。技

快速開發框架SpringBoot-學習日記（一）

第1章 Spring Boot基礎 1Spring Boot簡介 Spring Boot是由Pivotal團隊提供的全新框架，其設計目的是用來簡化新Spring應用的初始搭建以及開發過程。該框架使用了特定的方式來進行配置，從而使開發人員不再需要定義樣板化的

Spring框架入門教程（一）——框架簡介

介紹 Spring是一個分層的(一站式) 輕量級開源框架 Spring的核心是控制反轉（IoC）和麵向切面（AOP） 為什麼說分層一站式呢？ javaEE分三層開發 WEB層，業務層，持久層。在ssh整合框架中s == Struts2， s == spring，h

Curator教程（一）快速入門

Curator是Netflix公司開源的一個Zookeeper客戶端，與Zookeeper提供的原生客戶端相比，Curator的抽象層次更高，簡化了Zookeeper客戶端程式設計。 Maven依賴   <dependency>    

大資料學習初級入門教程（一） —— Hadoop 2.x 的安裝、啟動和測試

大資料最基礎的就是資料的儲存和計算，而 Hadoop 就是為儲存和計算而生，是最基礎的大資料處理工具。這篇簡單寫寫 Hadoop 2.x 的安裝，啟動和測試。 一、準備環境 大資料環境的部署，一般都是叢集，機器數量為奇數，這裡以 5 臺機器為例，作業系統為 CentOS 6.9_x64；

軟體測試學習教程（一）-學習路線圖

寫這些，一些是個人總結與學習，一些是彙總他人經驗與智慧，他山之石可以攻玉，無論如何，知識共享才是最終目的，希望可以為想入軟體測試行業的小白明確學習的方向，也可以幫助工作多年的中高階工程師能查漏補缺，更歡迎能對文章體現的不當之處予以糾正，對不足之處加以補充，為後來者開闢道路，指

flask框架系列教程（一） flask簡介及虛擬環境搭建

flask簡介      博主快兩個月沒更新了，原因是私下學了前端，奈何前端東西太多，即便以後想去做後端，也要明白JS jquery，這個有時間再發自己的理解，最近開始學習flask了，希望與諸位看客共同進步。前期先講基礎，過一段時間會把整個網站的建設過程發出來。  

【selenium3+JAVA】介面自動化測試教程（一）——瀏覽器的啟動之IE瀏覽器的啟動

前言 同chrome、firefox，ie瀏覽器的啟動一樣需要driver，但是IEDriver不像chromeDriver一樣有多個版本，不同版本對應不同的chrome版本，它只有32位版本和64位版本兩種； 下載地址為：https://www.seleniu

nightwatch + selenium 瀏覽器自動化測試 教程（一）

什麼是nightwatch Nightwatch.js 是一個用於web網站或應用的自動化測試框架，使用node.js和W3C WebDriver API （熟知的selenium） 它是一個完整的瀏覽器自動化測試解決方案，能夠簡化持續整合及自動化測試編寫工作。當然它也可