Asserting Arrays in Java with Examples - AssertJ 155

Asserting Arrays in Java with Examples – AssertJ 155

Asserting Arrays in Java with Examples

提供了一組豐富的斷言和真正有用的錯誤訊息,提高了測試程式碼的可讀性,驗證符合、滿足條件的元素, Asserting Arrays in Java 提供常見的方法,如: allMatch 、 allSatisfy 等,本篇增加了範例,並透過單元測試來驗證產出結果。

檔案目錄

./
   +- src
       +- test
       |   +- org
       |       +- ruoxue
       |           +- spring_boot_168
       |               +- test
       |                   +- assertj
       |                       +- array
       |                           +- AssertingArraysWithExamplesTest.java   

單元測試

Asserting Arrays Java 斷言陣列的主要目的是取得陣列的正確元素以進行斷言。

Fruit

Asserting Arrays Java 建立 Fruit 類別,覆寫 toString ,定義屬性和方法,用來建立一個物件。

	@NoArgsConstructor
	@Getter
	@Setter
	@Builder
	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, List<String> origins) {
			this.name = name;
			this.quantity = quantity;
			this.type = type;
			this.origins = origins;
		}

		public Fruit(String name, double quantity, int type) {
			this(name, quantity, type, new ArrayList<>());
		}

		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();
		}
	}

allMatch

Asserting Arrays Java 驗證所有符合條件的元素,若不成立,則會拋出 AssertionError 。

	@Test
	public void allMatch() {
		Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 2);
		Fruit guava = new Fruit("Guava", 1, 2);
		Fruit pitaya = new Fruit("Pitaya", -1, 2);
		Fruit[] array = new Fruit[] { durian, guava, pitaya };
		System.out.println(Arrays.deepToString(array));
		assertThat(array).allMatch(e -> e.getName().length() > 4).contains(durian, guava, pitaya);
		assertThat(array).allMatch(e -> e.getType() == 2).hasSize(3);
	}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":2}, {"name":"Guava","quantity":1.0,"type":2}, {"name":"Pitaya","quantity":-1.0,"type":2}]

anyMatch

Asserting Arrays Java 驗證任一符合條件的元素,若不成立,則會拋出 AssertionError 。

	@Test
	public void anyMatch() {
		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).anyMatch(e -> e.getName().equals("Durian")).contains(durian);
		assertThat(array).anyMatch(e -> e.getType() > 2).hasSize(3);
	}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":2}, {"name":"Guava","quantity":1.0,"type":2}, {"name":"Pitaya","quantity":-1.0,"type":2}]

noneMatch

Assertions Arrays in Java 驗證不符合條件的元素,若不成立,則會拋出 AssertionError 。

	@Test
	public void noneMatch() {
		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).noneMatch(e -> e.getName().length() > 7).contains(durian, guava, pitaya);
		assertThat(array).noneMatch(e -> e.getType() == 0).hasSize(3);
	}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":1}, {"name":"Guava","quantity":1.0,"type":2}, {"name":"Pitaya","quantity":-1.0,"type":3}]

allSatisfy

Java Asserting Arrays 驗證所有滿足條件的元素,若不成立,則會拋出 AssertionError 。

	@Test
	public void allSatisfy() {
		Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 2);
		Fruit guava = new Fruit("Guava", 1, 2);
		Fruit pitaya = new Fruit("Pitaya", -1, 2);
		Fruit[] array = new Fruit[] { durian, guava, pitaya };
		System.out.println(Arrays.deepToString(array));
		assertThat(array).allSatisfy(e -> {
			assertThat(e.getType()).isEqualTo(2);
			assertThat(e.getName().length()).isGreaterThan(4);
		});
	}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":2}, {"name":"Guava","quantity":1.0,"type":2}, {"name":"Pitaya","quantity":-1.0,"type":2}]

anySatisfy

Java Asserting Arrays 驗證任一滿足條件的元素,若不成立,則會拋出 AssertionError 。

	@Test
	public void anySatisfy() {
		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).anySatisfy(e -> {
			assertThat(e.getType()).isEqualTo(2);
			assertThat(e.getName()).isEqualTo("Guava");
		});
	}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":1}, {"name":"Guava","quantity":1.0,"type":2}, {"name":"Pitaya","quantity":-1.0,"type":3}]

noneSatisfy

Java Asserting Arrays 驗證不滿足條件的元素,若不成立,則會拋出 AssertionError 。

	@Test
	public void noneSatisfy() {
		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).noneSatisfy(e -> {
			assertThat(e.getType()).isEqualTo(0);
			assertThat(e.getName().length()).isLessThan(5);
		});
	}
[{"name":"Durian","quantity":1.7976931348623157E308,"type":1}, {"name":"Guava","quantity":1.0,"type":2}, {"name":"Pitaya","quantity":-1.0,"type":3}]

AssertingArraysWithExamplesTest.java

Java Asserting Arrays 新增單元測試,驗證是否符合預期。

package org.ruoxue.spring_boot_168.test.assertj.array;

import static org.assertj.core.api.Assertions.*;

import java.util.Arrays;

import org.apache.commons.lang3.builder.ToStringBuilder;
import org.apache.commons.lang3.builder.ToStringStyle;
import org.junit.jupiter.api.Test;

import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;

public class AssertingArraysWithExamplesTest {

	@NoArgsConstructor
	@Getter
	@Setter
	@Builder
	public static class Fruit {
		private String name;
		private double quantity;
		private int type;

		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);
			return builder.toString();
		}
	}

	@Test
	public void allMatch() {
		Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 2);
		Fruit guava = new Fruit("Guava", 1, 2);
		Fruit pitaya = new Fruit("Pitaya", -1, 2);
		Fruit[] array = new Fruit[] { durian, guava, pitaya };
		System.out.println(Arrays.deepToString(array));
		assertThat(array).allMatch(e -> e.getName().length() > 4).contains(durian, guava, pitaya);
		assertThat(array).allMatch(e -> e.getType() == 2).hasSize(3);
	}

	@Test
	public void anyMatch() {
		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).anyMatch(e -> e.getName().equals("Durian")).contains(durian);
		assertThat(array).anyMatch(e -> e.getType() > 2).hasSize(3);
	}

	@Test
	public void noneMatch() {
		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).noneMatch(e -> e.getName().length() > 7).contains(durian, guava, pitaya);
		assertThat(array).noneMatch(e -> e.getType() == 0).hasSize(3);
	}

	@Test
	public void allSatisfy() {
		Fruit durian = new Fruit("Durian", Double.MAX_VALUE, 2);
		Fruit guava = new Fruit("Guava", 1, 2);
		Fruit pitaya = new Fruit("Pitaya", -1, 2);
		Fruit[] array = new Fruit[] { durian, guava, pitaya };
		System.out.println(Arrays.deepToString(array));
		assertThat(array).allSatisfy(e -> {
			assertThat(e.getType()).isEqualTo(2);
			assertThat(e.getName().length()).isGreaterThan(4);
		});
	}

	@Test
	public void anySatisfy() {
		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).anySatisfy(e -> {
			assertThat(e.getType()).isEqualTo(2);
			assertThat(e.getName()).isEqualTo("Guava");
		});
	}

	@Test
	public void noneSatisfy() {
		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).noneSatisfy(e -> {
			assertThat(e.getType()).isEqualTo(0);
			assertThat(e.getName().length()).isLessThan(5);
		});
	}
}

心得分享

Java Asserting Arrays Example 除了提供流式判斷,還針對 Array 做特殊判斷,在許多測試驗證的場景,讓開發者使用更流暢的驗證,不需要再寫迴圈,善用 Java Asserting Arrays 將有助於驗證效率的提升。

發佈留言