• mvn编写主代码与测试代码

    maven编写主代码与测试代码

    3.2 编写主代码 

    项目主代码和测试代码不同，项目的主代码会被打包到最终的构件中（比如jar），而测试代码只在运行测试时用到，不会被打包。默认情况下，Maven假设项目主代码位于src/main/java目录，我们遵循Maven的约定，创建该目录，然后在该目录下创建文件com/juvenxu/mvnbook/helloworld/HelloWorld.java，其内容如代码清单3-2：

    代码清单3-2：Hello World的主代码

    Java代码  收藏代码
    1. <span style="font-size: small;">package com.juvenxu.mvnbook.helloworld;  
    2.    
    3. public class HelloWorld  
    4. {  
    5.    public String sayHello()  
    6.    {  
    7.      return "Hello Maven";  
    8.    }  
    9.   
    10.   public static void main(String[] args)  
    11.    {  
    12.      System.out.print( new HelloWorld().sayHello() );  
    13.    }  
    14. }  
    15. </span>  

           这是一个简单的Java类，它有一个sayHello()方法，返回一个String。同时这个类还带有一个main方法，创建一个HelloWorld实例，调用sayHello()方法，并将结果输出到控制台。

    关于该Java代码有两点需要注意。首先，在95%以上的情况下，我们应该把项目主代码放到src/main/java/目录下（遵循Maven的约定），而无须额外的配置，Maven会自动搜寻该目录找到项目主代码。其次，该Java类的包名是com.juvenxu.mvnbook.helloworld，这与我们之前在POM中定义的groupId和artifactId相吻合。一般来说，项目中Java类的包都应该基于项目的groupId和artifactId，这样更加清晰，更加符合逻辑，也方便搜索构件或者Java类。

    代码编写完毕后，我们使用Maven进行编译，在项目根目录下运行命令 mvn clean compile ，我们会得到如下输出：

    Java代码  收藏代码
    1. <span style="font-size: small;">[INFO] Scanning for projects...  
    2. [INFO] ------------------------------------------------------------------------  
    3. [INFO] Building Maven Hello World Project  
    4. [INFO]    task-segment: [clean, compile]  
    5. [INFO] ------------------------------------------------------------------------  
    6. [INFO] [clean:clean {execution: default-clean}]  
    7. [INFO] Deleting directory D:codehello-world arget  
    8. [INFO] [resources:resources {execution: default-resources}]  
    9. [INFO] skip non existing resourceDirectory D: codehello-worldsrcmain esources  
    10. [INFO] [compiler:compile {execution: default-compile}]  
    11. [INFO] Compiling 1 source file to D: codehello-world argetclasses  
    12. [INFO] ------------------------------------------------------------------------  
    13. [INFO] BUILD SUCCESSFUL  
    14. [INFO] ------------------------------------------------------------------------  
    15. [INFO] Total time: 1 second  
    16. [INFO] Finished at: Fri Oct 09 02:08:09 CST 2009  
    17. [INFO] Final Memory: 9M/16M  
    18. [INFO] ------------------------------------------------------------------------  
    19. </span>  

    clean告诉Maven清理输出目录target/，compile告诉Maven编译项目主代码，从输出中我们看到Maven首先执行了clean:clean任务，删除target/目录，默认情况下Maven构建的所有输出都在target/目录中；接着执行resources:resources任务（未定义项目资源，暂且略过）；最后执行compiler:compile任务，将项目主代码编译至target/classes目录(编译好的类为com/juvenxu/mvnbook/helloworld/HelloWorld.Class）。

    上文提到的clean:clean、resources:resources，以及compiler:compile对应了一些Maven插件及插件目标，比如clean:clean是clean插件的clean目标，compiler:compile是compiler插件的compile目标，后文会详细讲述Maven插件及其编写方法。

    至此，Maven在没有任何额外的配置的情况下就执行了项目的清理和编译任务，接下来，我们编写一些单元测试代码并让Maven执行自动化测试。

    3.3 编写测试代码 Top

    为了使项目结构保持清晰，主代码与测试代码应该分别位于独立的目录中。3.2节讲过Maven项目中默认的主代码目录是src/main/java，对应地，Maven项目中默认的测试代码目录是src/test/java。因此，在编写测试用例之前，我们先创建该目录。

    在Java世界中，由Kent Beck和Erich Gamma建立的JUnit是事实上的单元测试标准。要使用JUnit，我们首先需要为Hello World项目添加一个JUnit依赖，修改项目的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元素，该元素下可以包含多个dependency元素以声明项目的依赖，这里我们添加了一个依赖——groupId是junit，artifactId是junit，version是4.7。前面我们提到groupId、artifactId和version是任何一个Maven项目最基本的坐标，JUnit也不例外，有了这段声明，Maven就能够自动下载junit-4.7.jar。也许你会问，Maven从哪里下载这个jar呢？在Maven之前，我们可以去JUnit的官网下载分发包。而现在有了Maven，它会自动访问中央仓库（http://repo1.maven.org/maven2/），下载需要的文件。读者也可以自己访问该仓库，打开路径junit/junit/4.7/，就能看到junit-4.7.pom和junit-4.7.jar。本书第6章会详细介绍Maven仓库及中央仓库。

    上述POM代码中还有一个值为test的元素scope，scope为依赖范围，若依赖范围为test则表示该依赖只对测试有效，换句话说，测试代码中的import JUnit代码是没有问题的，但是如果我们在主代码中用import JUnit代码，就会造成编译错误。如果不声明依赖范围，那么默认值就是compile，表示该依赖对主代码和测试代码都有效。

    配置了测试依赖，接着就可以编写测试类，回顾一下前面的HelloWorld类，现在我们要测试该类的sayHello()方法，检查其返回值是否为“Hello Maven”。在src/test/java目录下创建文件，其内容如代码清单3-4：

    代码清单3-4：Hello World的测试代码

    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. }   

    一个典型的单元测试包含三个步骤：一，准备测试类及数据；二，执行要测试的行为；三，检查结果。上述样例中，我们首先初始化了一个要测试的HelloWorld实例，接着执行该实例的sayHello()方法并保存结果到result变量中，最后使用JUnit框架的Assert类检查结果是否为我们期望的”Hello Maven”。在JUnit 3中，约定所有需要执行测试的方法都以test开头，这里我们使用了JUnit 4，但我们仍然遵循这一约定，在JUnit 4中，需要执行的测试方法都应该以@Test进行标注。

    测试用例编写完毕之后就可以调用Maven执行测试，运行 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-juvenmvnbookcodehello-world arget  
    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: codehello-world argetclasses  
    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: codehello-world arget est-classes  
    20. [INFO] ------------------------------------------------------------------------  
    21. [ERROR] BUILD FAILURE  
    22. [INFO] ------------------------------------------------------------------------  
    23. [INFO] Compilation failure  
    24. D:codehello-worldsrc estjavacomjuvenxumvnbookhelloworldHelloWorldTest.java:[8,5] -source 1.3 中不支持注释  
    25. （请使用 -source 5 或更高版本以启用注释）  
    26.     @Test  
    27. [INFO] ------------------------------------------------------------------------  
    28. [INFO] For more information, run Maven with the -e switch  
    29.   …  
     

    不幸的是构建失败了，不过我们先耐心分析一下这段输出（为了本书的简洁，一些不重要的信息我用省略号略去了）。命令行输入的是mvn clean test，而Maven实际执行的可不止这两个任务，还有clean:clean、resources:resources、compiler:compile、resources:testResources以及compiler:testCompile。暂时我们需要了解的是，在Maven执行测试（test）之前，它会先自动执行项目主资源处理，主代码编译，测试资源处理，测试代码编译等工作，这是Maven生命周期的一个特性，本书后续章节会详细解释Maven的生命周期。

    从输出中我们还看到：Maven从中央仓库下载了junit-4.7.pom和junit-4.7.jar这两个文件到本地仓库（~/.m2/repository）中，供所有Maven项目使用。

    构建在执行compiler:testCompile任务的时候失败了，Maven输出提示我们需要使用-source 5或更高版本以启动注释，也就是前面提到的JUnit 4的@Test注解。这是Maven初学者常常会遇到的一个问题。由于历史原因，Maven的核心插件之一compiler插件默认只支持编译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>    

    该POM省略了除插件配置以外的其他部分，我们暂且不去关心插件配置的细节，只需要知道compiler插件支持Java 5的编译。现在再执行mvn clean test，输出如下：

    Java代码  收藏代码
    1. …  
    2. [INFO] [compiler:testCompile {execution: default-testCompile}]  
    3. [INFO] Compiling 1 source file to D: codehello-world arget est-classes  
    4. [INFO] [surefire:test {execution: default-test}]  
    5. [INFO] Surefire report directory: D:codehello-world argetsurefire-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任务执行成功了，测试代码通过编译之后在target/test-classes下生成了二进制文件，紧接着surefire:test任务运行测试，surefire是Maven世界中负责执行测试的插件，这里它运行测试用例HelloWorldTest，并且输出测试报告，显示一共运行了多少测试，失败了多少，出错了多少，跳过了多少。显然，我们的测试通过了——BUILD SUCCESSFUL。
  • 相关阅读:
    DataGridView编辑后立即更新到数据库的两种方法
    DataTable 转换成 Json的3种方法
    C# 应用程序配置文件App.Config和web.config
    C#中使用JsonConvert解析JSON
    C#JsonConvert.DeserializeObject反序列化json字符
    WIN10远程桌面、常用命令
    control[控制面板]的参数
    win10企业版变成win10专业版的设置教程
    DLL加密
    微信小程序顶部tab
  • 原文地址：https://www.cnblogs.com/hoobey/p/6071182.html
Copyright © 2020-2023  润新知