原文鏈接:https://www.cnblogs.com/pixy/p/4718176.html
對maven-surefire-plugin有想了解的,看這篇:https://www.cnblogs.com/lvchengda/p/13048191.html
基本配置
如下,下文中的配置項如無特殊說明,都位於pom文件的<configuration>節點中。
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>2.18.1</version> <configuration> ...... 配置內容 ...... </configuration> </plugin>
常用通用配置
跳過測試階段
<skipTests>true</skipTests>
或者
mvn install -DskipTests
或者 (Compliler插件也會根據該參數跳過編譯測試類)
mvn install -Dmaven.test.skip=true
忽略測試失敗
Maven在測試階段出現失敗的用例時,默認的行為是停止當前構建,構建過程也會以失敗結束。有時候(如測試驅動開發模式)即使測試出現失敗用例,仍然希望能繼續構建項目。
<testFailureIgnore>true</testFailureIgnore>
或者
mvn test -Dmaven.test.failure.ignore=true
包含和排除特定的測試類
surefire默認的查找測試類的模式如下:
**/Test*.java **/*Test.java **/*TestCase.java
自定義包含和排除模式,支持ant-style表達式和 正則表達式(%regex[...], 按.class文件匹配而不是.java)
<includes> <include>Sample.java</include> <include>%regex[.*[Cat|Dog].*Test.*]</include> </includes>
<excludes> <exclude>**/TestCircle.java</exclude> <exclude>**/TestSquare.java</exclude> </excludes>
運行指定的用例
指定測試類
mvn -Dtest=TestClassName test mvn -Dtest=TestCi*le test mvn -Dtest=TestSquare,TestCi*le test
指定單個測試類中的多個方法(Junit4+, TestNG)
mvn -Dtest=TestCircle#mytest test mvn -Dtest=TestCircle#test* test mvn -Dtest=TestCircle#testOne+testTwo test #(Surefire2.12.1+, Junit4.x+)
並發執行測試
(mvn命令加-T選項,多模塊項目的各個模塊可以並行構建。)
兩個方式:
方法一是使用parallel 參數,在一個進程中執行多個線程。
Junit4.7+可用值有:
methods, classes, both(classesAndMethods), suites, suitesAndClasses, suitesAndMethods, classAndMethods, all。
Junit Runner必須繼承自orig.junit.runners.ParentRunner或為指定@org.junit.runner.RunWith。
線程數配置:
useUnlimitedThreads 為true,不限制線程數。 useUnlimitedThreads 為false時可以使用threadCount和perCoreThreadCount參數。 還可以通過threadCountSuites,threadCountClasses,threadCountMethods在不同粒度限制線程。 parallelTestsTimeoutInSeconds和parallelTestsTimeoutForcedInSeconds參數設置線程的超時時間。 Junit中@NotThreadSafe注解的內容會單線程執行,避免並發。
方法二是使用forkCount參數,創建多個測試進程。
如果forkCount參數值后加C,表示乘以CPU核數(如forkCount=2.5C)。 reuseForks表示一個測試進程執行完了之后是殺掉還是重用來繼續執行后續的測試。 默認配置為forkCount=1/reuseForks=true。進程的測試單元是class,逐個class的傳遞給測試進程。 可以用systemPropertyVariables 傳入系統參數(mvn test -D...或配置元素),也可以使用argLine傳入JVM選項。 argLine或者systemPropertyVariables配置里中也能用${surefire.forkNumber}占位符,代表每個進程自己的fork編號(1...n),用來向每個進程傳入獨立的資源配置(forkCount=0時,該占位符值為1)。 如果使用-T n同時執行多個mvn模塊,每個模塊都會有forkCount個進程,${surefire.forkNumber}的值為1..n*forkCount。
surefire2.14之前的版本使用forkMode進行配置,對應關系如下。
Old Setting | New Setting |
forkMode=once (default) | forkCount=1 (default), reuseForks=true (default) |
forkMode=always | forkCount=1 (default), reuseForks=false |
forkMode=never | forkCount=0 |
forkMode=perthread, threadCount=N | forkCount=N, (reuseForks=false, if you did not had that one set) |
多種並行方式組合
只要forkCount不為0,就可以和-T組合。 forkCount=0, 或forkCount=1/reuseForks=true,可以和parallel自由組合。 forkCount的測試進程是按類為單位執行的,測試類整個整個的傳到測試進程中執行。 reuseForks=false或forkCount>1時,就會使用獨立的測試進程,所以parallel=classes就失效了。 但是還是可以組合parallel=methods/threadCount=n指定每個測試進程里的並發線程數。
POJO測試
- 不使用測試框架,直接編寫名稱為**/*Test類,其中的test*方法也會被surefire執行。
- 類中定義的public void setUp()和public void tearDown()方法也會被surefire識別。
- 驗證可使用JAVA assert關鍵字。
- 無法並發執行。
TestNG
- TestNG默認查找執行test包下的*Test.java。Pom.xml中添加TestNG依賴就能執行testng測試。
- 指定SuiteXML文件
<suiteXmlFiles> <suiteXmlFile>testng.xml</suiteXmlFile> </suiteXmlFiles>
- 為TestNG @Parameters 注解提供參數
<build> <pluginManagement> <plugins> <!-- 添加maven-surefire-plugins插件--> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>2.18.1</version> <configuration> <!-- 設置參數--> <systemPropertyVariables> <phone>123456789</phone> <pwd>abcd1234</pwd> <propertyName>${phone}</propertyName> <propertyName>${pwd}</propertyName> </systemPropertyVariables> <suiteXmlFiles> <!--此處testng.xml即為要運行的testng.xml文件 --> <suiteXmlFile>testng.xml</suiteXmlFile> </suiteXmlFiles> </configuration> </plugin> </plugins> </pluginManagement> </build>
testNG通過@Parameters({ “phone”, “pwd” })獲取參數
@Test @Parameters({ "phone", "pwd" }) public void test(String phone, String pwd) { System.out.println("phone:"+phone); System.out.println("pwd:"+pwd); }
- 指定group
<groups>functest,perftest</groups>
- 指定Listeners和Reporters
TestNG支持在測試時附加自定義的listener, reporter, annotation transformer, method interceptor。默認會使用基本的listener生成HTML和XML報告。
Listener實現org.testng.ITestListener接口,會在測試開始、通過、失敗等時刻實時發送通知。
Reporter實現org.testng.IReporter接口,在整個測試運行完畢之后才會發送通知,參數為對象列表,包含整個測試的執行結果狀況。
<properties> <property> <name>usedefaultlisteners</name> <value>false</value> <!-- disabling default listeners is optional --> </property> <property> <name>listener</name> <value>com.mycompany.MyResultListener,com.mycompany.MyAnnotationTransformer,com.mycompany.MyMethodInterceptor</value> </property> <property> <name>reporter</name> <value>listenReport.Reporter</value> </property> </properties>
JUnit
- 指定Listener(JUnit4+)
<properties> <property> <name>listener</name> <value>com.mycompany.MyResultListener,com.mycompany.MyResultListener2</value> </property> </properties>
- 指定Categories(Junit4.8+)。分組可以用在測試方法或測試類上。Junit使用接口和類的類型分組,選擇注解為@Category(基類)的分組時,所有注解了@Category(子類)的分組也會被選中。
<groups>com.mycompany.SlowTests</groups>
public interface SlowTests{} public interface SlowerTests extends SlowTests{} public class AppTest { @Test @Category(com.mycompany.SlowTests.class) public void testSlow() { System.out.println("slow"); } @Test @Category(com.mycompany.SlowerTests.class) public void testSlower() { System.out.println("slower"); } @Test @Category(com.cmycompany.FastTests.class) public void testSlow() { System.out.println("fast"); } }
- Security Manager
<argLine>-Djava.security.manager -Djava.security.policy=${basedir}/src/test/resources/java.policy</argLine>
Junit3還可以如下配置(forkCount為0時):
<systemPropertyVariables> <surefire.security.manager>java.lang.SecurityManager</surefire.security.manager> </systemPropertyVariables>
其他不常用的通用配置
- 失敗重跑
mvn -Dsurefire.rerunFailingTestsCount=2 test #(JUnit需要4.x版本)
- 指定VM參數
<argLine>-Djava.endorsed.dirs=...</argLine>
- 調試
默認情況下,surefire在新的進程中執行,命令mvn -Dmaven.surefire.debug test創建的測試進程會等待遠程調試器(Eclipse)連接到5005端口。要配置不同的端口命令為:
mvn -Dmaven.surefire.debug="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 -Xnoagent -Djava.compiler=NONE" test
如果forkCount選項配置為0(mvn -DforkCount=0 test),不會創建新的測試進程,測試在maven主線程中執行。命令mvnDebug -DforkCount=0 test會使maven以調試模式運行,可以將遠程調試器連接到maven進程。