Blog

AssertJ LocalDateTime Assertions - AssertJ 155

AssertJ LocalDateTime Assertions – AssertJ 155

AssertJ LocalDateTime Assertions

提供驗證日期時間近似比較等方法， AssertJ 是一個 Java 庫，提供了一組豐富的斷言和真正有用的錯誤訊息，類似的流暢或鍊式寫法，語法跟自然語言相近，對於編寫測試時力求容易閱讀及維護這之上提供了相當大的改進， Asserting LocalDateTime with AssertJ 使用流式斷言，並透過單元測試來驗證產出結果。

檔案目錄

./
   +- src
       +- test
       |   +- org
       |       +- ruoxue
       |           +- spring_boot_168
       |               +- test
       |                   +- assertj
       |                       +- localdatetime
       |                           +- AssertJLocalDateTimeAssertionsTest.java

單元測試

LocalDateTime Elements with AssertJ 斷言日期時間的主要目的是取得日期時間以進行斷言。

isCloseTo

驗證日期時間近似偏移指定值，若不成立，則會拋出 AssertionError 。

	@Test
	public void isCloseTo() {
		LocalDateTime value = LocalDateTime.of(2023, 10, 31, 5, 6, 7);
		System.out.println(value);
		assertThat(value).isCloseTo(LocalDateTime.of(2023, 10, 31, 5, 6, 2),
				new TemporalUnitWithinOffset(5, ChronoUnit.SECONDS));
		assertThat(value).isCloseTo(LocalDateTime.of(2023, 10, 31, 5, 6, 12),
				new TemporalUnitWithinOffset(5, ChronoUnit.SECONDS));
	}
2023-10-31T05:06:07

isCloseToWithin

LocalDateTime Elements with AssertJ 驗證日期時間近似偏移指定值，若不成立，則會拋出 AssertionError 。

	@Test
	public void isCloseToWithin() {
		LocalDateTime value = LocalDateTime.of(2023, 10, 31, 5, 6, 7);
		System.out.println(value);
		assertThat(value).isCloseTo(LocalDateTime.of(2023, 10, 31, 5, 6, 2), within(5, ChronoUnit.SECONDS));
		assertThat(value).isCloseTo(LocalDateTime.of(2023, 10, 31, 5, 6, 12), within(5, ChronoUnit.SECONDS));
	}
2023-10-31T05:06:07

isCloseToWithString

LocalDateTime Elements with AssertJ 驗證日期時間近似偏移指定值，若不成立，則會拋出 AssertionError 。

	@Test
	public void isCloseToWithString() {
		LocalDateTime value = LocalDateTime.parse("2023-10-31T05:06:07");
		System.out.println(value);
		assertThat(value).isCloseTo("2023-10-31T05:06:02", within(5, ChronoUnit.SECONDS));
		assertThat(value).isCloseTo("2023-10-31T05:06:12", within(5, ChronoUnit.SECONDS));
	}
2023-10-31T05:06:07

isCloseToByLessThan

Testing Java LocalDateTime with AssertJ 驗證日期時間近似偏移指定值，若不成立，則會拋出 AssertionError 。

	@Test
	public void isCloseToByLessThan() {
		LocalDateTime value = LocalDateTime.parse("2023-10-31T05:06:07");
		System.out.println(value);
		assertThat(value).isCloseTo("2023-10-31T05:06:02", byLessThan(6, ChronoUnit.SECONDS));
		assertThat(value).isCloseTo("2023-10-31T05:06:12", byLessThan(6, ChronoUnit.SECONDS));
	}
2023-10-31T05:06:07

isCloseToUtcNow

Testing Java LocalDateTime with AssertJ 驗證日期時間近似偏移 UTC 時間，若不成立，則會拋出 AssertionError 。

	@Test
	public void isCloseToUtcNow() {
		LocalDateTime value = LocalDateTime.now(Clock.systemUTC());
		System.out.println(value);
		assertThat(value).isCloseToUtcNow(within(1, ChronoUnit.SECONDS));

		LocalDateTime value2 = LocalDateTime.now(ZoneId.of("UTC+8"));
		System.out.println(value2);
		assertThat(value2).isCloseToUtcNow(within(8, ChronoUnit.HOURS));
	}
2023-09-03T05:24:47.304
2023-09-03T13:24:47.361

isCloseToThrowError

Testing Java LocalDateTime with AssertJ 驗證日期時間近似偏移指定值，若不成立，則會拋出 AssertionError 。

	@Test
	public void isCloseToThrowError() {
		assertThatCode(() -> {
			LocalDateTime value = LocalDateTime.parse("2023-10-31T05:06:07");
			System.out.println(value);
			assertThat(value).isCloseTo("2023-10-31T05:06:01", within(5, ChronoUnit.SECONDS));
		}).isInstanceOf(AssertionError.class);
	}
2023-10-31T05:06:07

isCloseToThrownBy

Testing Java LocalDateTime with AssertJ 驗證日期時間近似偏移指定值，若不成立，則會拋出 AssertionError 。

	@Test
	public void isCloseToThrownBy() {
		assertThatThrownBy(() -> {
			LocalDateTime value = LocalDateTime.parse("2023-10-31T05:06:07");
			System.out.println(value);
			assertThat(value).isCloseTo("2023-10-31T05:06:01", within(5, ChronoUnit.SECONDS));
		}).isInstanceOf(AssertionError.class);
	}  
2023-10-31T05:06:07

AssertJLocalDateTimeAssertionsTest.java

Testing Java LocalDateTime with AssertJ 新增單元測試，驗證是否符合預期。

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

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

import java.time.Clock;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.temporal.ChronoUnit;

import org.assertj.core.data.TemporalUnitWithinOffset;
import org.junit.jupiter.api.Test;

public class AssertJLocalDateTimeAssertionsTest {

	@Test
	public void isCloseTo() {
		LocalDateTime value = LocalDateTime.of(2023, 10, 31, 5, 6, 7);
		System.out.println(value);
		assertThat(value).isCloseTo(LocalDateTime.of(2023, 10, 31, 5, 6, 2),
				new TemporalUnitWithinOffset(5, ChronoUnit.SECONDS));
		assertThat(value).isCloseTo(LocalDateTime.of(2023, 10, 31, 5, 6, 12),
				new TemporalUnitWithinOffset(5, ChronoUnit.SECONDS));
	}

	@Test
	public void isCloseToWithin() {
		LocalDateTime value = LocalDateTime.of(2023, 10, 31, 5, 6, 7);
		System.out.println(value);
		assertThat(value).isCloseTo(LocalDateTime.of(2023, 10, 31, 5, 6, 2), within(5, ChronoUnit.SECONDS));
		assertThat(value).isCloseTo(LocalDateTime.of(2023, 10, 31, 5, 6, 12), within(5, ChronoUnit.SECONDS));
	}

	@Test
	public void isCloseToWithString() {
		LocalDateTime value = LocalDateTime.parse("2023-10-31T05:06:07");
		System.out.println(value);
		assertThat(value).isCloseTo("2023-10-31T05:06:02", within(5, ChronoUnit.SECONDS));
		assertThat(value).isCloseTo("2023-10-31T05:06:12", within(5, ChronoUnit.SECONDS));
	}

	@Test
	public void isCloseToByLessThan() {
		LocalDateTime value = LocalDateTime.parse("2023-10-31T05:06:07");
		System.out.println(value);
		assertThat(value).isCloseTo("2023-10-31T05:06:02", byLessThan(6, ChronoUnit.SECONDS));
		assertThat(value).isCloseTo("2023-10-31T05:06:12", byLessThan(6, ChronoUnit.SECONDS));
	}

	@Test
	public void isCloseToUtcNow() {
		LocalDateTime value = LocalDateTime.now(Clock.systemUTC());
		System.out.println(value);
		assertThat(value).isCloseToUtcNow(within(1, ChronoUnit.SECONDS));

		LocalDateTime value2 = LocalDateTime.now(ZoneId.of("UTC+8"));
		System.out.println(value2);
		assertThat(value2).isCloseToUtcNow(within(8, ChronoUnit.HOURS));
	}

	@Test
	public void isCloseToThrowError() {
		assertThatCode(() -> {
			LocalDateTime value = LocalDateTime.parse("2023-10-31T05:06:07");
			System.out.println(value);
			assertThat(value).isCloseTo("2023-10-31T05:06:01", within(5, ChronoUnit.SECONDS));
		}).isInstanceOf(AssertionError.class);
	}

	@Test
	public void isCloseToThrownBy() {
		assertThatThrownBy(() -> {
			LocalDateTime value = LocalDateTime.parse("2023-10-31T05:06:07");
			System.out.println(value);
			assertThat(value).isCloseTo("2023-10-31T05:06:01", within(5, ChronoUnit.SECONDS));
		}).isInstanceOf(AssertionError.class);
	}
}

心得分享

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

原碼下載

Tags: , , , , ,

發佈留言