Jenkins +JUnit

1.环境

　　windows10 专业版

　　Jenkins 2.7

　　apache-ant-1.9.6

　　JDK1.8.0_20

2.整体思路

　　jdk：支持ant脚本中的编译、测试等target。

　　ant脚本：负责java代码的编译、JUnit。

　　Jenkins：调度触发ant脚本的执行。

　　

 

3.开始练兵

　　3.1 项目整体结构

com.java.src下面放源码  MessageUtil.java

com.java.test目录下放JUnit测试文件 TestMessageUtil.java

build.xml文件放在根目录下，即位于AntJunit-v1.0目录下，和src位于同一级别。

3.2 项目源码

package com.java.src;

public class MessageUtil {
    private String message;

       //Constructor
       //@param message to be printed
       public MessageUtil(String message){
          this.message = message; 
       }

       // prints the message
       public String printMessage(){
          System.out.println(message);
          return message;
       }   

       // add "Hi!" to the message
       public String salutationMessage(){
          message = "Hi!" + message;
          System.out.println(message);
          return message;
       }   
}

package com.java.test;




import static org.junit.Assert.*;

import org.junit.Test;

import com.java.src.MessageUtil;

public class TestMessageUtil {
    String message = "Robert";   
       MessageUtil messageUtil = new MessageUtil(message);

       @Test
       public void testPrintMessage() { 
          System.out.println("Inside testPrintMessage()");     
          assertTrue(message.equals(messageUtil.printMessage()));
       }

       @Test
       public void testSalutationMessage() {
          System.out.println("Inside testSalutationMessage()");
          message = "Hi!" + "Robert";
          assertTrue(message.equals(messageUtil.salutationMessage()));
       }
}

<?xml version="1.0" encoding="utf-8"?>
<project name="test" default="test" basedir=".">
 
       <!--配置基本属性-->
       <property name="src" value="src"/>
       <property name="build" value="build"/>
       <property name="lib" value="lib" />
       <property name="dist" value="dist"/>
       <property name="classpath" location="${build}"/>
      
       <!--配置测试报告的属性-->
       <property name="report"   value="report"/>
       <property name="report.xml"  value="${report}/junit/xml"/>
       <property name="report.html" value="${report}/junit/html"/>
 
       <!--配置运行时classpath-->
       <path id="classpath.run">
              <pathelement path="${classpath}"/>
              <fileset dir="${lib}">
                     <include name="*.jar"/>
              </fileset>
       </path>
 
  <!--配置测试时classpath-->
       <path id="classpath.test">
              <path refid="classpath.run"/>
              <path location="${dist}/lib/test-${DSTAMP}.jar"/>
       </path>
      
       <!--任务初始化-->
       <target name="init" >
              <tstamp/>
              <delete dir="${build}"/>
              <delete dir="${report}"/>
              <delete dir="${dist}"/>
              <delete file="${lib}/test-*.jar"/>
              <mkdir dir="${build}"/>
              <mkdir dir="${lib}"/>
              <mkdir dir="${dist}"/>
              <mkdir dir="${report}"/>
       </target>
      
       <!--配置编译任务-->
       <target name="compile" depends="init">
              <javac srcdir="${src}" destdir="${build}">
              <classpath refid="classpath.run" />
              </javac>
       </target>
           
       <!--配置运行任务-->
       <target name="run" depends="compile, dist">
         <java classname="com.test.TestCalculator">
             <classpath>
                     <path refid="classpath.run"/>
              </classpath>
         </java>
       </target>
      
       <!--配置JUnit测试，打印测试结果-->
       <target name="test" depends="compile, dist">
              <mkdir dir="${report.xml}"/>
              <mkdir dir="${report.html}"/>
              <junit printsummary="yes" haltonfailure="no">
                     <classpath refid="classpath.run"/>
                     <formatter type="xml"/>
                     <batchtest fork="yes" todir="${report.xml}">
                            <fileset dir="${src}" includes="**/Test*.java"/>
                     </batchtest>
              </junit>
              <junitreport todir="${report.html}">
                     <fileset dir="${report.xml}">
                            <include name="*.xml"/>
                     </fileset>
                     <report format="frames" todir="${report.html}"/>
              </junitreport>
       </target>
 
</project>

3.3 必要的环境配置

将junit-4.10.jar 复制到%ANT_HOME%lib目录下。例如，我需复制到D:SoftInstallapache-ant-1.9.6lib下。

这一步很有必要，否则正式运行会报错。

　　3.4 配置Jenkins

　　新建一个自由风格的job，名字为AntJunit-V1.0。

　　源码管理：选择No。利用SVN或git对源码进行管理时，Jenkins总是会把代码拷贝一份到自己的工作空间，然后对备份进行操作，因此本demo忽略源码管理，直接将代码拷贝到Jenkins工作区。

　　增加构建步骤：选择Invoke Ant。Targets的名字test来自build.xml中的target名字test（test在build.xml中也是默认执行的target）。

　　另外，这里的构建可以用windows脚本执行。二者效果完全一样。

 

 　　构建后操作：选择Publish JUnit test result report。测试报告xml填：report/junit/html/TESTS-TestSuites.xml  。

　　　　

　　点击「保存」。

4.构建结果

 　　点击中间的「最新测试结果」，查看详情：

　　

5.总结

 ①完全可以在ant环境下调试好结果再放到jenkins工作空间。因为起实质作用的是ant，jenkins仅仅是调度。ant和jenkins天然有着密切的联系。

 ②这个demo中ant脚本模拟的是手动编译、测试java代码的过程。ant典型应用还有对Java程序的打包、部署等。当然，ant还有更多应用，有兴趣的童鞋可以搜索ant学习。

6.致谢

本文参考了参考一 和 参考二 ，在此对原作者表示感谢。　

7.在ubuntu14.04下遇到的问题（2016.8.16，jenkins版本为2.7.2）

　　上述作业在windows下没有任何问题。但是移植到ubuntu14.04虽然能够构建，但查看详情发现报错：Error Message:org/hamcrest/SelfDescribing 。

　　原来是由于Junit4.10.jar中不包含hamcrest-core-1.3.jar（参考这里）。

　　将hamcrest-core-1.3.jar添加到${JENKINS_HOME}/workspace/AntJunit/lib目录下，重新构建，成功！