assertThat用法

通常匹配符
一、assertThat( testedNumber, allOf( greaterThan(8), lessThan(16) ) );

註釋： allOf匹配符代表若是接下來的全部條件必須都成立測試才經過，至關於「與」（&&）

二、assertThat( testedNumber, anyOf( greaterThan(16), lessThan(8) ) );

註釋：anyOf匹配符代表若是接下來的全部條件只要有一個成立則測試經過，至關於「或」（||）
三、assertThat( testedNumber, anything() );

註釋：anything匹配符代表不管什麼條件，永遠爲true
四、assertThat( testedString, is( "developerWorks" ) );

註釋： is匹配符代表若是前面待測的object等於後面給出的object，則測試經過
五、assertThat( testedString, not( "developerWorks" ) );

註釋：not匹配符和is匹配符正好相反，代表若是前面待測的object不等於後面給出的object，則測試經過

字符串相關匹配符

一、assertThat( testedString, containsString( "developerWorks" ) );

註釋：containsString匹配符代表若是測試的字符串testedString包含子字符串"developerWorks"則測試經過

二、assertThat( testedString, endsWith( "developerWorks" ) ); 

註釋：endsWith匹配符代表若是測試的字符串testedString以子字符串"developerWorks"結尾則測試經過

三、assertThat( testedString, startsWith( "developerWorks" ) ); 

註釋：startsWith匹配符代表若是測試的字符串testedString以子字符串"developerWorks"開始則測試經過

四、assertThat( testedValue, equalTo( expectedValue ) ); 

註釋： equalTo匹配符代表若是測試的testedValue等於expectedValue則測試經過，equalTo能夠測試數值之間，字
符串之間和對象之間是否相等，至關於Object的equals方法

五、assertThat( testedString, equalToIgnoringCase( "developerWorks" ) ); 

註釋：equalToIgnoringCase匹配符代表若是測試的字符串testedString在忽略大小寫的狀況下等於"developerWorks"則測試經過

六、assertThat( testedString, equalToIgnoringWhiteSpace( "developerWorks" ) );

註釋：equalToIgnoringWhiteSpace匹配符代表若是測試的字符串testedString在忽略頭尾的任意個空格的狀況下等

於"developerWorks"則測試經過，注意：字符串中的空格不能被忽略

數值相關匹配符

一、assertThat( testedDouble, closeTo( 20.0, 0.5 ) );

註釋：closeTo匹配符代表若是所測試的浮點型數testedDouble在20.0±0.5範圍以內則測試經過

二、assertThat( testedNumber, greaterThan(16.0) );

註釋：greaterThan匹配符代表若是所測試的數值testedNumber大於16.0則測試經過

三、assertThat( testedNumber, lessThan (16.0) );

註釋：lessThan匹配符代表若是所測試的數值testedNumber小於16.0則測試經過

四、assertThat( testedNumber, greaterThanOrEqualTo (16.0) );

註釋： greaterThanOrEqualTo匹配符代表若是所測試的數值testedNumber大於等於16.0則測試經過

五、assertThat( testedNumber, lessThanOrEqualTo (16.0) );

註釋：lessThanOrEqualTo匹配符代表若是所測試的數值testedNumber小於等於16.0則測試經過

collection相關匹配符

一、assertThat( mapObject, hasEntry( "key", "value" ) );

註釋：hasEntry匹配符代表若是測試的Map對象mapObject含有一個鍵值爲"key"對應元素值爲"value"的Entry項則測試經過

二、assertThat( iterableObject, hasItem ( "element" ) );

註釋：hasItem匹配符代表若是測試的迭代對象iterableObject含有元素「element」項則測試經過

三、assertThat( mapObject, hasKey ( "key" ) );

註釋： hasKey匹配符代表若是測試的Map對象mapObject含有鍵值「key」則測試經過

四、assertThat( mapObject, hasValue ( "key" ) );

註釋：hasValue匹配符代表若是測試的Map對象mapObject含有元素值「value」則測試經過

 

-------------------------------------------------------------------------------------------------------------------------------

 

JUnit4.4引入了Hamcrest框架，Hamcest提供了一套匹配符Matcher，這些匹配符更接近天然語言，可讀性高，更加靈活

/**equalTo匹配符斷言被測的testedValue等於expectedValue，
* equalTo能夠斷言數值之間，字符串之間和對象之間是否相等，至關於Object的equals方法
*/
assertThat(testedValue, equalTo(expectedValue));

/**equalToIgnoringCase匹配符斷言被測的字符串testedString
*在忽略大小寫的狀況下等於expectedString
*/
assertThat(testedString, equalToIgnoringCase(expectedString));

/**equalToIgnoringWhiteSpace匹配符斷言被測的字符串testedString
*在忽略頭尾的任意個空格的狀況下等於expectedString，
*注意：字符串中的空格不能被忽略
*/
assertThat(testedString, equalToIgnoringWhiteSpace(expectedString);

/**containsString匹配符斷言被測的字符串testedString包含子字符串subString**/
assertThat(testedString, containsString(subString) );

/**endsWith匹配符斷言被測的字符串testedString以子字符串suffix結尾*/
assertThat(testedString, endsWith(suffix));

/**startsWith匹配符斷言被測的字符串testedString以子字符串prefix開始*/
assertThat(testedString, startsWith(prefix));

 

/**nullValue()匹配符斷言被測object的值爲null*/
assertThat(object,nullValue());

/**notNullValue()匹配符斷言被測object的值不爲null*/
assertThat(object,notNullValue());

/**is匹配符斷言被測的object等於後面給出匹配表達式*/
assertThat(testedString, is(equalTo(expectedValue)));

/**is匹配符簡寫應用之一，is(equalTo(x))的簡寫，斷言testedValue等於expectedValue*/
assertThat(testedValue, is(expectedValue));

/**is匹配符簡寫應用之二，is(instanceOf(SomeClass.class))的簡寫，
*斷言testedObject爲Cheddar的實例
*/
assertThat(testedObject, is(Cheddar.class));

/**not匹配符和is匹配符正好相反，斷言被測的object不等於後面給出的object*/
assertThat(testedString, not(expectedString));

/**allOf匹配符斷言符合全部條件，至關於「與」（&&）*/
assertThat(testedNumber, allOf( greaterThan(8), lessThan(16) ) );

/**anyOf匹配符斷言符合條件之一，至關於「或」（||）*/
assertThat(testedNumber, anyOf( greaterThan(16), lessThan(8) ) );

/**closeTo匹配符斷言被測的浮點型數testedDouble在20.0¡À0.5範圍以內*/
assertThat(testedDouble, closeTo( 20.0, 0.5 ));

/**greaterThan匹配符斷言被測的數值testedNumber大於16.0*/
assertThat(testedNumber, greaterThan(16.0));

/** lessThan匹配符斷言被測的數值testedNumber小於16.0*/
assertThat(testedNumber, lessThan (16.0));

/** greaterThanOrEqualTo匹配符斷言被測的數值testedNumber大於等於16.0*/
assertThat(testedNumber, greaterThanOrEqualTo (16.0));

/** lessThanOrEqualTo匹配符斷言被測的testedNumber小於等於16.0*/
assertThat(testedNumber, lessThanOrEqualTo (16.0));

/**hasEntry匹配符斷言被測的Map對象mapObject含有一個鍵值爲"key"對應元素值爲"value"的Entry項*/
assertThat(mapObject, hasEntry("key", "value" ) );

/**hasItem匹配符代表被測的迭代對象iterableObject含有元素element項則測試經過*/
assertThat(iterableObject, hasItem (element));

/** hasKey匹配符斷言被測的Map對象mapObject含有鍵值「key」*/
assertThat(mapObject, hasKey ("key"));

/** hasValue匹配符斷言被測的Map對象mapObject含有元素值value*/
assertThat(mapObject, hasValue(value));

 

---------------------------------------------------------------------------------------------------------------------------

 

待測試的方法

//Get number from [p, r]
int getRandomFrom(int p, int r){
    int chooes = r-p+1;
    return (int) Math.floor(Math.random() * chooes + p);
}

第一步：引入類或static方法

import static org.junit.Assert.*;
import static org.hamcrest.CoreMatchers.*;
import static org.junit.matchers.JUnitMatchers.*;

第二步：些測試方法

@Test
public void testGetRandomFrom(){
   for(int i=0 ; i<100 ; i++){
        assertThat(quickSort.getRandomFrom(5, 10),  anyOf(equalTo(5),equalTo(6),equalTo(7),equalTo(8),equalTo(9),equalTo(10)));
   }
}

如下是引用別人的總結：

1.JUnit4.4引入了Hamcrest框架，Hamcest提供了一套匹配符Matcher，這些匹配符更接近天然語言，可讀性高，更加靈活；
2.使用全新的斷言語法：assertThat，結合Hamcest提供的匹配符，只用這一個方法，就能夠實現全部的測試；
3.assertThat語法以下：
     assertThat(T actual, Matcher<T> matcher);
     assertThat(String reason, T actual, Matcher<T> matcher);
     其中actual爲須要測試的變量，matcher爲使用Hamcrest的匹配符來表達變量actual指望值的聲明；
4.注意事項：
     a.必須導入JUnit4.4以後的版本才能使用assertThat方法；
     b.不須要繼承TestCase類，可是須要測試方法前必須加「@Test」。
實例：

public class C {

public int add(int a, int b) {

   return a + b;
}

public double div(double a, double b) {

   return a / b;
}

public String getName(String name) {

   return name;
}

public List<String> getList(String item) {

   List<String> l = new ArrayList<String>();
   l.add(item);
   return l;
}

public Map<String, String> getMap(String key, String value) {

   Map<String, String> m = new HashMap<String, String>();
   m.put(key, value);
   return m;
}
}

import static org.junit.Assert.*;
import static org.hamcrest.Matchers.*;

import java.util.List;
import java.util.Map;
import org.junit.Test;

public class CTest {

@Test
public void testAdd() {

   //通常匹配符
   int s = new C().add(1, 1);
   //allOf：全部條件必須都成立，測試才經過
   assertThat(s, allOf(greaterThan(1), lessThan(3)));
   //anyOf：只要有一個條件成立，測試就經過
   assertThat(s, anyOf(greaterThan(1), lessThan(1)));
   //anything：不管什麼條件，測試都經過
   assertThat(s, anything());
   //is：變量的值等於指定值時，測試經過
   assertThat(s, is(2));
   //not：和is相反，變量的值不等於指定值時，測試經過
   assertThat(s, not(1));

   //數值匹配符
   double d = new C().div(10, 3);
   //closeTo：浮點型變量的值在3.0±0.5範圍內，測試經過
   assertThat(d, closeTo(3.0, 0.5));
   //greaterThan：變量的值大於指定值時，測試經過
   assertThat(d, greaterThan(3.0));
   //lessThan：變量的值小於指定值時，測試經過
   assertThat(d, lessThan(3.5));
   //greaterThanOrEuqalTo：變量的值大於等於指定值時，測試經過
   assertThat(d, greaterThanOrEqualTo(3.3));
   //lessThanOrEqualTo：變量的值小於等於指定值時，測試經過
   assertThat(d, lessThanOrEqualTo(3.4));

   //字符串匹配符
   String n = new C().getName("Magci");
   //containsString：字符串變量中包含指定字符串時，測試經過
   assertThat(n, containsString("ci"));
   //startsWith：字符串變量以指定字符串開頭時，測試經過
   assertThat(n, startsWith("Ma"));
   //endsWith：字符串變量以指定字符串結尾時，測試經過
   assertThat(n, endsWith("i"));
   //euqalTo：字符串變量等於指定字符串時，測試經過
   assertThat(n, equalTo("Magci"));
   //equalToIgnoringCase：字符串變量在忽略大小寫的狀況下等於指定字符串時，測試經過
   assertThat(n, equalToIgnoringCase("magci"));
   //equalToIgnoringWhiteSpace：字符串變量在忽略頭尾任意空格的狀況下等於指定字符串時，測試經過
   assertThat(n, equalToIgnoringWhiteSpace(" Magci   "));

   //集合匹配符
   List<String> l = new C().getList("Magci");
   //hasItem：Iterable變量中含有指定元素時，測試經過
   assertThat(l, hasItem("Magci"));

   Map<String, String> m = new C().getMap("mgc", "Magci");
   //hasEntry：Map變量中含有指定鍵值對時，測試經過
   assertThat(m, hasEntry("mgc", "Magci"));
   //hasKey：Map變量中含有指定鍵時，測試經過
   assertThat(m, hasKey("mgc"));
   //hasValue：Map變量中含有指定值時，測試經過
   assertThat(m, hasValue("Magci"));
}
}

 

轉自：http://langgufu.iteye.com/blog/1893927