qileilove

為了使項(xiàng)目結(jié)構(gòu)保持清晰，主代碼與測(cè)試代碼應(yīng)該分別位于獨(dú)立的目錄中。3.2節(jié)講過(guò)Maven項(xiàng)目中默認(rèn)的主代碼目錄是src/main/java，對(duì)應(yīng)地，Maven項(xiàng)目中默認(rèn)的測(cè)試代碼目錄是src/test/java。因此，在編寫測(cè)試用例之前，我們先創(chuàng)建該目錄。

在Java世界中，由Kent Beck和Erich Gamma建立的JUnit是事實(shí)上的單元測(cè)試標(biāo)準(zhǔn)。要使用JUnit，我們首先需要為Hello World項(xiàng)目添加一個(gè)JUnit依賴，修改項(xiàng)目的POM如代碼清單3-3：

代碼清單3-3：為Hello World的POM添加依賴

Java代碼  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <project xmlns="http://maven.apache.org/POM/4.0.0"  
3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0  
5. http://maven.apache.org/maven-v4_0_0.xsd">  
6.   <modelVersion>4.0.0</modelVersion>  
7.   <groupId>com.juvenxu.mvnbook</groupId>  
8.   <artifactId>hello-world</artifactId>  
9.   <version>1.0-SNAPSHOT</version>  
10.   <name>Maven Hello World Project</name>  
11.   <dependencies>  
12.     <dependency>  
13.        <groupId>junit</groupId>  
14.        <artifactId>junit</artifactId>  
15.        <version>4.7</version>  
16.        <scope>test</scope>  
17.     </dependency>  
18.   </dependencies>  
19. </project>    

     代碼中添加了dependencies元素，該元素下可以包含多個(gè)dependency元素以聲明項(xiàng)目的依賴，這里我們添加了一個(gè)依賴——groupId是junit，artifactId是junit，version是4.7。前面我們提到groupId、artifactId和version是任何一個(gè)Maven項(xiàng)目最基本的坐標(biāo)，JUnit也不例外，有了這段聲明，Maven就能夠自動(dòng)下載junit-4.7.jar。也許你會(huì)問，Maven從哪里下載這個(gè)jar呢？在Maven之前，我們可以去JUnit的官網(wǎng)下載分發(fā)包。而現(xiàn)在有了Maven，它會(huì)自動(dòng)訪問中央倉(cāng)庫(kù)（http://repo1.maven.org/maven2/），下載需要的文件。讀者也可以自己訪問該倉(cāng)庫(kù)，打開路徑j(luò)unit/junit/4.7/，就能看到j(luò)unit-4.7.pom和junit-4.7.jar。本書第6章會(huì)詳細(xì)介紹Maven倉(cāng)庫(kù)及中央倉(cāng)庫(kù)。

上述POM代碼中還有一個(gè)值為test的元素scope，scope為依賴范圍，若依賴范圍為test則表示該依賴只對(duì)測(cè)試有效，換句話說(shuō)，測(cè)試代碼中的import JUnit代碼是沒有問題的，但是如果我們?cè)谥鞔a中用import JUnit代碼，就會(huì)造成編譯錯(cuò)誤。如果不聲明依賴范圍，那么默認(rèn)值就是compile，表示該依賴對(duì)主代碼和測(cè)試代碼都有效。

配置了測(cè)試依賴，接著就可以編寫測(cè)試類，回顧一下前面的HelloWorld類，現(xiàn)在我們要測(cè)試該類的sayHello()方法，檢查其返回值是否為“Hello Maven”。在src/test/java目錄下創(chuàng)建文件，其內(nèi)容如代碼清單3-4：

代碼清單3-4：Hello World的測(cè)試代碼

Java代碼  

1. package com.juvenxu.mvnbook.helloworld;  
2. import static org.junit.Assert.assertEquals;  
3. import org.junit.Test;  
4.   
5. public class HelloWorldTest  
6. {  
7.     @Test  
8.     public void testSayHello()  
9.     {  
10.         HelloWorld helloWorld = new HelloWorld();  
11.   
12.         String result = helloWorld.sayHello();  
13.   
14.         assertEquals( "Hello Maven", result );  
15.     }  
16. }   

一個(gè)典型的單元測(cè)試包含三個(gè)步驟：一，準(zhǔn)備測(cè)試類及數(shù)據(jù)；二，執(zhí)行要測(cè)試的行為；三，檢查結(jié)果。上述樣例中，我們首先初始化了一個(gè)要測(cè)試的HelloWorld實(shí)例，接著執(zhí)行該實(shí)例的sayHello()方法并保存結(jié)果到result變量中，最后使用JUnit框架的Assert類檢查結(jié)果是否為我們期望的”Hello Maven”。在JUnit 3中，約定所有需要執(zhí)行測(cè)試的方法都以test開頭，這里我們使用了JUnit 4，但我們?nèi)匀蛔裱@一約定，在JUnit 4中，需要執(zhí)行的測(cè)試方法都應(yīng)該以@Test進(jìn)行標(biāo)注。

測(cè)試用例編寫完畢之后就可以調(diào)用Maven執(zhí)行測(cè)試，運(yùn)行 mvn clean test ：

Java代碼  

1. [INFO] Scanning for projects...  
2. [INFO] ------------------------------------------------------------------------  
3. [INFO] Building Maven Hello World Project  
4. [INFO]    task-segment: [clean, test]  
5. [INFO] ------------------------------------------------------------------------  
6. [INFO] [clean:clean {execution: default-clean}]  
7. [INFO] Deleting directory D:\git-juven\mvnbook\code\hello-world\target  
8. [INFO] [resources:resources {execution: default-resources}]  
9. …  
10. Downloading: http://repo1.maven.org/maven2/junit/junit/4.7/junit-4.7.pom  
11. 1K downloaded  (junit-4.7.pom)  
12. [INFO] [compiler:compile {execution: default-compile}]  
13. [INFO] Compiling 1 source file to D: \code\hello-world\target\classes  
14. [INFO] [resources:testResources {execution: default-testResources}]  
15. …  
16. Downloading: http://repo1.maven.org/maven2/junit/junit/4.7/junit-4.7.jar  
17. 226K downloaded  (junit-4.7.jar)  
18. [INFO] [compiler:testCompile {execution: default-testCompile}]  
19. [INFO] Compiling 1 source file to D:\ code\hello-world\target\test-classes  
20. [INFO] ------------------------------------------------------------------------  
21. [ERROR] BUILD FAILURE  
22. [INFO] ------------------------------------------------------------------------  
23. [INFO] Compilation failure  
24. D:\code\hello-world\src\test\java\com\juvenxu\mvnbook\helloworld\HelloWorldTest.java:[8,5] -source 1.3 中不支持注釋  
25. （請(qǐng)使用 -source 5 或更高版本以啟用注釋）  
26.     @Test  
27. [INFO] ------------------------------------------------------------------------  
28. [INFO] For more information, run Maven with the -e switch  
29.   …  

不幸的是構(gòu)建失敗了，不過(guò)我們先耐心分析一下這段輸出（為了本書的簡(jiǎn)潔，一些不重要的信息我用省略號(hào)略去了）。命令行輸入的是mvn clean test，而Maven實(shí)際執(zhí)行的可不止這兩個(gè)任務(wù)，還有clean:clean、resources:resources、compiler:compile、resources:testResources以及compiler:testCompile。暫時(shí)我們需要了解的是，在Maven執(zhí)行測(cè)試（test）之前，它會(huì)先自動(dòng)執(zhí)行項(xiàng)目主資源處理，主代碼編譯，測(cè)試資源處理，測(cè)試代碼編譯等工作，這是Maven生命周期的一個(gè)特性，本書后續(xù)章節(jié)會(huì)詳細(xì)解釋Maven的生命周期。

從輸出中我們還看到：Maven從中央倉(cāng)庫(kù)下載了junit-4.7.pom和junit-4.7.jar這兩個(gè)文件到本地倉(cāng)庫(kù)（~/.m2/repository）中，供所有Maven項(xiàng)目使用。

構(gòu)建在執(zhí)行compiler:testCompile任務(wù)的時(shí)候失敗了，Maven輸出提示我們需要使用-source 5或更高版本以啟動(dòng)注釋，也就是前面提到的JUnit 4的@Test注解。這是Maven初學(xué)者常常會(huì)遇到的一個(gè)問題。由于歷史原因，Maven的核心插件之一compiler插件默認(rèn)只支持編譯Java 1.3，因此我們需要配置該插件使其支持Java 5，見代碼清單3-5：

代碼清單3-5：配置maven-compiler-plugin支持Java 5

Java代碼  

1. <project>  
2. …  
3.   <build>  
4.     <plugins>  
5.        <plugin>  
6.          <groupId>org.apache.maven.plugins</groupId>  
7.          <artifactId>maven-compiler-plugin</artifactId>  
8.          <configuration>  
9.            <source>1.5</source>  
10.            <target>1.5</target>  
11.          </configuration>  
12.        </plugin>  
13.     </plugins>  
14.   </build>  
15. …  
16. </project>    

該P(yáng)OM省略了除插件配置以外的其他部分，我們暫且不去關(guān)心插件配置的細(xì)節(jié)，只需要知道compiler插件支持Java 5的編譯。現(xiàn)在再執(zhí)行mvn clean test，輸出如下：

Java代碼  

1. …  
2. [INFO] [compiler:testCompile {execution: default-testCompile}]  
3. [INFO] Compiling 1 source file to D: \code\hello-world\target\test-classes  
4. [INFO] [surefire:test {execution: default-test}]  
5. [INFO] Surefire report directory: D:\code\hello-world\target\surefire-reports  
6. -------------------------------------------------------  
7.  T E S T S  
8. -------------------------------------------------------  
9. Running com.juvenxu.mvnbook.helloworld.HelloWorldTest  
10. Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.055 sec  
11. Results :  
12. Tests run: 1, Failures: 0, Errors: 0, Skipped: 0  
13. [INFO] ------------------------------------------------------------------------  
14. [INFO] BUILD SUCCESSFUL  
15. [INFO] ------------------------------------------------------------------------  
16. …  

我們看到compiler:testCompile任務(wù)執(zhí)行成功了，測(cè)試代碼通過(guò)編譯之后在target/test-classes下生成了二進(jìn)制文件，緊接著surefire:test任務(wù)運(yùn)行測(cè)試，surefire是Maven世界中負(fù)責(zé)執(zhí)行測(cè)試的插件，這里它運(yùn)行測(cè)試用例HelloWorldTest，并且輸出測(cè)試報(bào)告，顯示一共運(yùn)行了多少測(cè)試，失敗了多少，出錯(cuò)了多少，跳過(guò)了多少。顯然，我們的測(cè)試通過(guò)了——BUILD SUCCESSFUL。