斷言(assertion)是一種在程式中的一階邏輯(如:一個結果為真或假的邏輯判斷式),目的為了表示與驗證軟體開發者預期的結果——當程式執行到斷言的位置時,對應的斷言應該為真。若斷言不為真時,程式會中止執行,並給出錯誤資訊。
這裡我們直接上例子
import static org.junit.Assert.assertArrayEquals;
import static org.junit.Assert.assertEquals;
import static org.junit.Assert.assertFalse;
import static org.junit.Assert.assertNotNull;
import static org.junit.Assert.assertNotSame;
import static org.junit.Assert.assertNull;
import static org.junit.Assert.assertSame;
import static org.junit.Assert.assertThat;
import static org.junit.Assert.assertTrue;
import java.util.Arrays;
import org.junit.Test;
public class AssertTests {
@Test
public void testAssertArrayEquals() {
byte[] expected = "trial".getBytes();
byte[] actual = "trial".getBytes();
assertArrayEquals("failure - byte arrays not same", expected, actual);
}
@Test
public void testAssertEquals() {
assertEquals("failure - strings are not equal", "text", "text");
}
@Test
public void testAssertFalse() {
assertFalse("failure - should be false", false);
}
@Test
public void testAssertNotNull() {
assertNotNull("should not be null", new Object());
}
@Test
public void testAssertNotSame() {
assertNotSame("should not be same Object", new Object(), new Object());
}
@Test
public void testAssertNull() {
assertNull("should be null", null);
}
@Test
public void testAssertSame() {
Integer aNumber = Integer.valueOf(768);
assertSame("should be same", aNumber, aNumber);
}
@Test
public void testAssertTrue() {
assertTrue("failure - should be true", true);
}
}
接下來我們來介紹下他們
方法 | 介紹 |
---|---|
assertEquals(expected, actual) | 檢查斷言兩個值相等 |
assertTrue(condition) | 檢查條件為真 |
assertFalse(condition) | 檢查條件為假 |
assertNotNull(object) | 檢查不為空 |
assertNull(object) | 檢查為空 |
assertNotSame(expected, actual) | 檢查兩個相關物件是否不指向同一個物件 |
assertSame(expected, actual) | 檢查兩個相關物件是否指向同一個物件 |
assertArrayEquals(expectedArray, resultArray) | 檢查兩個陣列是否相等 |
JUnit 4 結合 Hamcrest 提供了一個全新的斷言語法——assertThat。程式設計師可以只使用 assertThat 一個斷言語句,結合 Hamcrest 提供的匹配符,就可以表達全部的測試思想
方法 | 介紹 |
---|---|
assertThat("myValue", allOf(startsWith("my"), containsString("Val"))) | allOf匹配符表明如果接下來的所有條件必須都成立測試才通過,相當於「與」(&&) |
assertThat("myValue", anyOf(startsWith("foo"), containsString("Val"))) | anyOf匹配符表明如果接下來的所有條件只要有一個成立則測試通過,相當於「或」( |
assertThat( "myValue", anything() ) | anything匹配符表明無論什麼條件,永遠為true |
assertThat( "myValue", is( "myValue" ) ) | is匹配符表明如果前面待測的值等於後面給出的值,則測試通過 |
assertThat( "myValue", not("foo")) | not匹配符和is匹配符正好相反,表明如果前面待測的值不等於後面給出的值,則測試通過 |
方法 | 介紹 |
---|---|
assertThat("myStringOfNote", containsString("ring")) | containsString匹配符表明如果測試的字串包含子字串則測試通過 |
assertThat("myStringOfNote", endsWith("Note")) | endsWith匹配符表明如果測試的字串以子字串結尾則測試通過 |
assertThat("myStringOfNote", startsWith("my")) | startsWith匹配符表明如果測試的字串以子字串開始則測試通過 |
assertThat("foo", equalTo("foo")) | equalTo匹配符表明如果測試的資料等於則測試通過,equalTo可以測試數值之間,字串之間和物件之間是否相等,相當於Object的equals方法 |
assertThat("Foo", equalToIgnoringCase("FOO")) | equalToIgnoringCase匹配符表明如果測試的字串在忽略大小寫的情況下等於則測試通過 |
assertThat(" my\tfoo bar ", equalToIgnoringWhiteSpace(" my foo bar")) | equalToIgnoringWhiteSpace匹配符表明如果測試的字串在忽略頭尾的任意個空格的情況下等於則測試通過,注意:字串中的空格不能被忽略 |
方法 | 介紹 |
---|---|
assertThat(1.03, is(closeTo(1.0, 0.03))) | closeTo匹配符表明如果所測試的浮點型數在1.0±0.03範圍之內則測試通過 |
assertThat(2, greaterThan(1)) | greaterThan匹配符表明如果所測試的數值大於1則測試通過 |
assertThat(1, lessThan(2)) | lessThan匹配符表明如果所測試的數值小於2則測試通過 |
assertThat(1, greaterThanOrEqualTo(1)) | greaterThanOrEqualTo匹配符表明如果所測試的數值大於等於1則測試通過 |
assertThat(1, lessThanOrEqualTo(1)) | lessThanOrEqualTo匹配符表明如果所測試的數值小於等於1則測試通過 |
方法 | 介紹 |
---|---|
assertThat(myMap, hasEntry("bar", "foo")) | hasEntry匹配符表明如果測試的Map物件含有一個鍵值為"bar"對應元素值為"foo"的Entry項則測試通過 |
ssertThat(Arrays.asList("foo", "bar"), hasItem(startsWith("ba"))) | hasItem匹配符表明如果測試的迭代物件含有元素以ba開頭項則測試通過 |
assertThat(myMap, hasKey("bar")) | hasKey匹配符表明如果測試的Map物件含有鍵值「bar」則測試通過 |
assertThat(myMap, hasValue("foo")) | hasValue匹配符表明如果測試的Map物件含有元素值「foo」則測試通過 |
Cs.java
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class Cs {
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;
}
}
CsTest.java
import static org.hamcrest.MatcherAssert.*;
import static org.hamcrest.Matchers.*;
import java.util.List;
import java.util.Map;
import org.junit.Test;
public class CsTest {
@Test
public void testAdd() {
//一般匹配符
int s = new Cs().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 Cs().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 Cs().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 Cs().getList("Magci");
//hasItem:Iterable變數中含有指定元素時,測試通過
assertThat(l, hasItem("Magci"));
Map<String, String> m = new Cs().getMap("mgc", "Magci");
//hasEntry:Map變數中含有指定鍵值對時,測試通過
assertThat(m, hasEntry("mgc", "Magci"));
//hasKey:Map變數中含有指定鍵時,測試通過
assertThat(m, hasKey("mgc"));
//hasValue:Map變數中含有指定值時,測試通過
assertThat(m, hasValue("Magci"));
}
}
在這裡大家可能會出現一些問題:
那是因為我們之前匯入了eclipse內建的jar包,eclipse內建的junit的jar包有髒東西,會導致包衝突
解決辦法:
去下個純淨版的安裝上就行了
下載連結: