JUnit之斷言assert

一、簡介

1. JUnit4.4引入了Hamcrest框架，Hamcest提供了一套匹配符Matcher，這些匹配符更接近自然語言，可讀性高，更加靈活；
2. 使用全新的斷言語法：assertThat，結合Hamcest提供的匹配符，只用這一個方法，就可以實現所有的測試；

二、語法介紹

assertThat語法如下：

    assertThat(T actual, Matcher<T> matcher);
    assertThat(String reason, T actual, Matcher<T> matcher);

其中actual為需要測試的變量，matcher為使用Hamcrest的匹配符來表達變量actual期望值的聲明；

實例：

assertThat(frank.changeUserInfo(),equalTo("男"));

注意事項：

1. 必須導入JUnit4.4之后的版本才能使用assertThat方法；
2. 不需要繼承TestCase類，但是需要測試方法前必須加“@Test”

三、Assert類的類圖結構

四、一般匹配方法

1. 要求所有的條件都要通過測試才算成功
   assertThat( testedNumber, allOf( greaterThan(8), lessThan(16) ) );
   配符表明如果接下來的所有條件必須都成立測試才通過，相當於“與”（&&）
2. 接下來的所有條件只要有一個成立則測試通過
   assertThat( testedNumber, anyOf( greaterThan(16), lessThan(8) ) );
   注釋：anyOf匹配符表明如果接下來的所有條件只要有一個成立則測試通過，相當於“或”（||）
3. 無論什么條件，永遠為true
   assertThat( testedNumber, anything() );
   注釋：anything匹配符表明無論什么條件，永遠為true
4. 等於判斷
   assertThat( testedString, is( “developerWorks” ) );
   注釋： is匹配符表明如果前面待測的object等於后面給出的object，則測試通過
5. 取反判斷
   assertThat( testedString, not( “developerWorks” ) );
   注釋：not匹配符和is匹配符正好相反，表明如果前面待測的object不等於后面給出的object，則測試通過

四、字符串相關匹配符

1. 包含字符串
   assertThat( testedString, containsString( “developerWorks” ) );
   注釋：containsString匹配符表明如果測試的字符串testedString包含子字符串”developerWorks”則測試通過
2. 以指定字符串結尾
   assertThat( testedString, endsWith( “developerWorks” ) );
   注釋：endsWith匹配符表明如果測試的字符串testedString以子字符串”developerWorks”結尾則測試通過
3. 以指定字符串開始
   assertThat( testedString, startsWith( “developerWorks” ) );
   注釋：startsWith匹配符表明如果測試的字符串testedString以子字符串”developerWorks”開始則測試通過
4. 字符串相等測試
   assertThat( testedValue, equalTo( expectedValue ) );
   注釋： equalTo匹配符表明如果測試的testedValue等於expectedValue則測試通過，equalTo可以測試數值之間，字符串之間和對象之間是否相等，相當於Object的equals方法
5. 忽略大小寫判斷是否相等
   assertThat( testedString, equalToIgnoringCase( “developerWorks” ) );
   注釋：equalToIgnoringCase匹配符表明如果測試的字符串testedString在忽略大小寫的情況下等於”developerWorks”則測試通過
6. 忽略頭尾的任意個空格的情況下等於待測字符串
   assertThat( testedString, equalToIgnoringWhiteSpace( “developerWorks” ) );
   注釋：equalToIgnoringWhiteSpace匹配符表明如果測試的字符串testedString在忽略頭尾的任意個空格的情況下等於”developerWorks”則測試通過，注意：字符串中的空格不能被忽略

五、數值相關匹配符

1. 范圍測試
   assertThat( testedDouble, closeTo( 20.0, 0.5 ) );
   注釋：closeTo匹配符表明如果所測試的浮點型數testedDouble在20.0±0.5范圍之內則測試通過
2. 大於判斷
   assertThat( testedNumber, greaterThan(16.0) );
   注釋：greaterThan匹配符表明如果所測試的數值testedNumber大於16.0則測試通過
3. 小於判斷
   assertThat( testedNumber, lessThan (16.0) );
   注釋：lessThan匹配符表明如果所測試的數值testedNumber小於16.0則測試通過
4. 大於等於
   assertThat( testedNumber, greaterThanOrEqualTo (16.0) );
   注釋： greaterThanOrEqualTo匹配符表明如果所測試的數值testedNumber大於等於16.0則測試通過
5. 小於等於
   assertThat( testedNumber, lessThanOrEqualTo (16.0) );
   注釋：lessThanOrEqualTo匹配符表明如果所測試的數值testedNumber小於等於16.0則測試通過

六、collection相關匹配符

1. map包含測試
   assertThat( mapObject, hasEntry( “key”, “value” ) );
   注釋：hasEntry匹配符表明如果測試的Map對象mapObject含有一個鍵值為”key”對應元素值為”value”的Entry項則測試通過
2. 迭代對象包含測試
   assertThat( iterableObject, hasItem ( “element” ) );
   注釋：hasItem匹配符表明如果測試的迭代對象iterableObject含有元素“element”項則測試通過
3. map包含key測試
   assertThat( mapObject, hasKey ( “key” ) );
   注釋： hasKey匹配符表明如果測試的Map對象mapObject含有鍵值“key”則測試通過
4. map包含value測試
   assertThat( mapObject, hasValue ( “key” ) );
   注釋：hasValue匹配符表明如果測試的Map對象mapObject含有元素值“value”則測試通過

七、使用示例

示例采用spring3.0來做測試，junit使用junit4.4，IDE為IDEA2016.1

applicationContext.xml中的內容

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd">
    <context:annotation-config></context:annotation-config>
    <bean name="user" class="com.frank.spring.model.User">

    </bean>
    <bean name="frank" class="com.frank.spring.model.Frank">

    </bean>
</beans>

User類的聲明

package com.frank.spring.model;

/** * Created by WHUER on 2016/5/24 0024. */
public class User {
    private int id;
    private String name;
    private String sex;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }
    public User()
    {
        this.setId(1);
        this.setName("frank");
        this.setSex("male");
    }
    @Override
    public String toString()
    {
       return "id:"+this.getId()+"\n"
               +"name:"+this.getName()+"\n"
               +"sex:"+this.getSex();
    }
}

Frank類聲明

package com.frank.spring.model;

import org.springframework.beans.factory.annotation.Autowired;

/** * Created by WHUER on 2016/5/24 0024. */
public class Frank {
    private User user;

    public User getUser() {
        return user;
    }
    @Autowired
    public void setUser(User user) {
        this.user = user;
    }
    //這里還是使用autowired，它也可以用於普通的方法之上
    @Autowired
    public void initUser(User user)
    {
        this.setUser(user);
    }
    public String changeUserInfo()
    {
        user.setSex("男");
        return user.getSex();
    }
}

JUnit測試類示例

package com.frank.spring.test;

import com.frank.spring.model.Frank;
import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import static org.hamcrest.CoreMatchers.equalTo;
import static org.junit.Assert.*;

/** * Created by WHUER on 2016/5/24 0024. */
public class FrankTest {

    ApplicationContext ctx;
    @org.junit.Before
    public void setUp() throws Exception {
        ctx = new ClassPathXmlApplicationContext("applicationContext.xml");
    }

    @org.junit.After
    public void tearDown() throws Exception {
        System.out.println("測試結束");
    }

    /** * 這個注解采用的是AutoWired * @throws Exception */
    @org.junit.Test
    public void getUser() throws Exception {

        Frank frank = (Frank) ctx.getBean("frank");
        System.out.println(frank.getUser().toString());
    }
    @Test
    public void changeUserInfo() throws Exception {
        Frank frank = (Frank) ctx.getBean("frank");
        assertSame("測試通過","男",frank.changeUserInfo());
        assertThat(frank.changeUserInfo(),equalTo("男"));
    }

}

八、項目使用lib詳情

    commons-beanutils-1.8.0.jar
    commons-codec-1.9.jar
    commons-collections-3.1.jar
    commons-fileupload-1.3.1.jar
    commons-io-2.2.jar
    commons-lang3-3.2.jar
    commons-lang-2.4.jar
    commons-logging-1.1.3.jar
    commons-logging-api-1.1.jar
    commons-net-3.4.jar
    org.springframework.aop-3.0.1.RELEASE-A.jar
    org.springframework.asm-3.0.1.RELEASE-A.jar
    org.springframework.aspects-3.0.1.RELEASE-A.jar
    org.springframework.beans-3.0.1.RELEASE-A.jar
    org.springframework.context.support-3.0.1.RELEASE-A.jar
    org.springframework.context-3.0.1.RELEASE-A.jar
    org.springframework.core-3.0.1.RELEASE-A.jar
    org.springframework.expression-3.0.1.RELEASE-A.jar
    org.springframework.instrument.tomcat-3.0.1.RELEASE-A.jar
    org.springframework.instrument-3.0.1.RELEASE-A.jar
    org.springframework.jdbc-3.0.1.RELEASE-A.jar
    org.springframework.jms-3.0.1.RELEASE-A.jar
    org.springframework.orm-3.0.1.RELEASE-A.jar
    org.springframework.oxm-3.0.1.RELEASE-A.jar
    org.springframework.test-3.0.1.RELEASE-A.jar
    org.springframework.transaction-3.0.1.RELEASE-A.jar
    org.springframework.web.portlet-3.0.1.RELEASE-A.jar
    org.springframework.web.servlet-3.0.1.RELEASE-A.jar
    org.springframework.web.struts-3.0.1.RELEASE-A.jar
    org.springframework.web-3.0.1.RELEASE-A.jar

九、運行結果

根據上圖的結果，我們可以看到green ,證明junit測試通過了