Table of Contents
ToggleAssert Array Value in Java
驗證所有屬性,符合或不符合 Null 值,並透過 JUnit 5 單元測試來驗證產出結果,使用 Java Assert Array Value 流式斷言,可以大幅提升斷言效率,減少程式碼的撰寫,讓開發者體驗更流暢的驗證斷言。
檔案目錄
./
+- src
+- test
| +- org
| +- ruoxue
| +- spring_boot_168
| +- test
| +- assertj
| +- array
| +- AssertArrayValueTest.java
單元測試
Assertions Array Value in Java 斷言陣列的主要目的是取得陣列的正確元素以進行斷言。
Fruit
Assertions Array Value in Java 建立 Fruit 類別,覆寫 toString ,定義屬性和方法,用來建立一個物件。
@NoArgsConstructor
@Getter
@Setter
public static class Fruit {
private String name;
private double quantity;
private int type;
private List<String> origins = new ArrayList<>();
public Fruit(String name, double quantity, int type) {
this.name = name;
this.quantity = quantity;
this.type = type;
}
public String toString() {
ToStringBuilder builder = new ToStringBuilder(this, ToStringStyle.JSON_STYLE);
builder.appendSuper(super.toString());
builder.append("name", name);
builder.append("quantity", quantity);
builder.append("type", type);
builder.append("origins", origins);
return builder.toString();
}
}
SimpleFruit
Assertions Array Value in Java 建立 SimpleFruit 類別,覆寫 toString ,定義屬性和方法,用來建立一個物件。
@Getter
@Setter
public static class SimpleFruit {
private String name;
private List<String> origins;
public SimpleFruit() {
}
public String toString() {
ToStringBuilder builder = new ToStringBuilder(this, ToStringStyle.JSON_STYLE);
builder.appendSuper(super.toString());
builder.append("name", name);
builder.append("origins", origins);
return builder.toString();
}
}
matches
Assertions Array Value in Java 驗證符合條件的元素,若不成立,則會拋出 AssertionError 。
@Test
public void matches() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
Fruit guava = new Fruit("Guava", 1, 2);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).matches(a -> a.length > 2);
}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":1,"origins":[]}, {"name":"Guava","quantity":1.0,"type":2,"origins":[]}, {"name":"Pitaya","quantity":-1.0,"type":3,"origins":[]}]
satisfies
Assertions Array Value in Java 驗證符合條件的元素,若不成立,則會拋出 AssertionError 。
@Test
public void satisfies() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
Fruit guava = new Fruit("Guava", 1, 2);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).satisfies(a -> {
assertThat(a[0].getName().equals("Durian"));
assertThat(a[1]).isNotNull();
});
}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":1,"origins":[]}, {"name":"Guava","quantity":1.0,"type":2,"origins":[]}, {"name":"Pitaya","quantity":-1.0,"type":3,"origins":[]}]
satisfiesAnyOf
Assertions Array Value in Java 驗證任一符合條件的元素,若不成立,則會拋出 AssertionError 。
@Test
public void satisfiesAnyOf() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
Fruit guava = new Fruit("Guava", 1, 2);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).satisfiesAnyOf(a -> {
assertThat(a[0].getName().equals("Durian"));
}, a -> {
assertThat(a[1]).isNull();
});
}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":1,"origins":[]}, {"name":"Guava","quantity":1.0,"type":2,"origins":[]}, {"name":"Pitaya","quantity":-1.0,"type":3,"origins":[]}]
hasAllNullFieldsOrProperties
Assertions Array Value in Java 驗證所有屬性,符合 Null 值,若不成立,則會拋出 AssertionError 。
@Test
public void hasAllNullFieldsOrProperties() {
SimpleFruit durian = new SimpleFruit();
SimpleFruit guava = new SimpleFruit();
SimpleFruit pitaya = new SimpleFruit();
SimpleFruit[] array = new SimpleFruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).allSatisfy(e -> {
assertThat(e).hasAllNullFieldsOrProperties();
});
}
[{"name":null,"origins":null}, {"name":null,"origins":null}, {"name":null,"origins":null}]
hasAllNullFieldsOrPropertiesExcept
Asserting Array Value with Examples 驗證除了指定屬性之外,符合 Null 值,若不成立,則會拋出 AssertionError 。
@Test
public void hasAllNullFieldsOrPropertiesExcept() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
durian.setOrigins(null);
Fruit guava = new Fruit("Guava", 1, 2);
guava.setOrigins(null);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
pitaya.setOrigins(null);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).allSatisfy(e -> {
assertThat(e).hasAllNullFieldsOrPropertiesExcept("name", "type", "quantity");
});
}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":1,"origins":null}, {"name":"Guava","quantity":1.0,"type":2,"origins":null}, {"name":"Pitaya","quantity":-1.0,"type":3,"origins":null}]
hasNoNullFieldsOrProperties
Asserting Array Value with Examples 驗證所有屬性,符合非 Null 值,若不成立,則會拋出 AssertionError 。
@Test
public void hasNoNullFieldsOrProperties() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
Fruit guava = new Fruit("Guava", 1, 2);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).allSatisfy(e -> {
assertThat(e).hasNoNullFieldsOrProperties();
});
}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":1,"origins":[]}, {"name":"Guava","quantity":1.0,"type":2,"origins":[]}, {"name":"Pitaya","quantity":-1.0,"type":3,"origins":[]}]
hasNoNullFieldsOrPropertiesExcept
Asserting Array Value with Examples 驗證除了指定屬性之外,符合非 Null 值,若不成立,則會拋出 AssertionError 。
@Test
public void hasNoNullFieldsOrPropertiesExcept() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
durian.setOrigins(null);
Fruit guava = new Fruit("Guava", 1, 2);
guava.setOrigins(null);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
pitaya.setOrigins(null);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).allSatisfy(e -> {
assertThat(e).hasNoNullFieldsOrPropertiesExcept("origins");
});
}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":1,"origins":null}, {"name":"Guava","quantity":1.0,"type":2,"origins":null}, {"name":"Pitaya","quantity":-1.0,"type":3,"origins":null}]
AssertArrayValueTest.java
Asserting Array Value with Examples 新增單元測試,驗證 Testing Java Array Value with AssertJ 是否符合預期。
package org.ruoxue.spring_boot_168.test.assertj.array;
import static org.assertj.core.api.Assertions.assertThat;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import org.apache.commons.lang3.builder.ToStringBuilder;
import org.apache.commons.lang3.builder.ToStringStyle;
import org.junit.jupiter.api.Test;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
public class AssertArrayValueTest {
@NoArgsConstructor
@Getter
@Setter
public static class Fruit {
private String name;
private double quantity;
private int type;
private List<String> origins = new ArrayList<>();
public Fruit(String name, double quantity, int type) {
this.name = name;
this.quantity = quantity;
this.type = type;
}
public String toString() {
ToStringBuilder builder = new ToStringBuilder(this, ToStringStyle.JSON_STYLE);
builder.appendSuper(super.toString());
builder.append("name", name);
builder.append("quantity", quantity);
builder.append("type", type);
builder.append("origins", origins);
return builder.toString();
}
}
@Getter
@Setter
public static class SimpleFruit {
private String name;
private List<String> origins;
public SimpleFruit() {
}
public String toString() {
ToStringBuilder builder = new ToStringBuilder(this, ToStringStyle.JSON_STYLE);
builder.appendSuper(super.toString());
builder.append("name", name);
builder.append("origins", origins);
return builder.toString();
}
}
@Test
public void matches() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
Fruit guava = new Fruit("Guava", 1, 2);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).matches(a -> a.length > 2);
}
@Test
public void satisfies() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
Fruit guava = new Fruit("Guava", 1, 2);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).satisfies(a -> {
assertThat(a[0].getName().equals("Durian"));
assertThat(a[1]).isNotNull();
});
}
@Test
public void satisfiesAnyOf() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
Fruit guava = new Fruit("Guava", 1, 2);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).satisfiesAnyOf(a -> {
assertThat(a[0].getName().equals("Durian"));
}, a -> {
assertThat(a[1]).isNull();
});
}
@Test
public void hasAllNullFieldsOrProperties() {
SimpleFruit durian = new SimpleFruit();
SimpleFruit guava = new SimpleFruit();
SimpleFruit pitaya = new SimpleFruit();
SimpleFruit[] array = new SimpleFruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).allSatisfy(e -> {
assertThat(e).hasAllNullFieldsOrProperties();
});
}
@Test
public void hasAllNullFieldsOrPropertiesExcept() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
durian.setOrigins(null);
Fruit guava = new Fruit("Guava", 1, 2);
guava.setOrigins(null);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
pitaya.setOrigins(null);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).allSatisfy(e -> {
assertThat(e).hasAllNullFieldsOrPropertiesExcept("name", "type", "quantity");
});
}
@Test
public void hasNoNullFieldsOrProperties() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
Fruit guava = new Fruit("Guava", 1, 2);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).allSatisfy(e -> {
assertThat(e).hasNoNullFieldsOrProperties();
});
}
@Test
public void hasNoNullFieldsOrPropertiesExcept() {
Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 1);
durian.setOrigins(null);
Fruit guava = new Fruit("Guava", 1, 2);
guava.setOrigins(null);
Fruit pitaya = new Fruit("Pitaya", -1, 3);
pitaya.setOrigins(null);
Fruit[] array = new Fruit[] { durian, guava, pitaya };
System.out.println(Arrays.deepToString(array));
assertThat(array).allSatisfy(e -> {
assertThat(e).hasNoNullFieldsOrPropertiesExcept("origins");
});
}
}
心得分享
Testing Java Array Value with AssertJ 除了提供流式判斷,還針對 Array 做特殊判斷,在許多測試驗證的場景,讓開發者使用更流暢的驗證,不需要再寫迴圈, Asserting Array Value with Examples 將有助於驗證效率的提升。