From 5b10fedfef936594ad156f9de282d7a0d37e5f97 Mon Sep 17 00:00:00 2001
From: baofeidyz <baofeidyz@gmail.com>
Date: Thu, 29 May 2025 11:19:01 +0800
Subject: [PATCH] =?UTF-8?q?Assert=E6=96=B0=E5=A2=9E=E6=96=AD=E8=A8=80?=
 =?UTF-8?q?=E7=BB=99=E5=AE=9A=E9=9B=86=E5=90=88=E4=B8=BA=E7=A9=BA=E7=9A=84?=
 =?UTF-8?q?=E6=96=B9=E6=B3=95=E4=BB=A5=E5=8F=8A=E5=8D=95=E5=85=83=E6=B5=8B?=
 =?UTF-8?q?=E8=AF=95=E7=94=A8=E4=BE=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../main/java/cn/hutool/core/lang/Assert.java | 62 +++++++++++++++++++
 .../java/cn/hutool/core/lang/AssertTest.java  | 12 ++++
 2 files changed, 74 insertions(+)

diff --git a/hutool-core/src/main/java/cn/hutool/core/lang/Assert.java b/hutool-core/src/main/java/cn/hutool/core/lang/Assert.java
index ec0b69b27..9f21ff305 100644
--- a/hutool-core/src/main/java/cn/hutool/core/lang/Assert.java
+++ b/hutool-core/src/main/java/cn/hutool/core/lang/Assert.java
@@ -539,6 +539,68 @@ public class Assert {
 		return noNullElements(array, "[Assertion failed] - this array must not contain any null elements");
 	}
 
+	/**
+	 * 断言给定集合为空
+	 * 并使用指定的函数获取错误信息返回
+	 * <pre class="code">
+	 * Assert.empty(collection, ()-&gt;{
+	 *      // to query relation message
+	 *      return new IllegalArgumentException("relation message to return");
+	 *  });
+	 * </pre>
+	 *
+	 * @param <E>           集合元素类型
+	 * @param <T>           集合类型
+	 * @param <X>           异常类型
+	 * @param collection    被检查的集合
+	 * @param errorSupplier 错误抛出异常附带的消息生产接口
+	 * @throws X if the collection is not {@code null} or has elements
+	 * @see CollUtil#isEmpty(Iterable)
+	 * @since 5.8.39
+	 */
+	public static <E, T extends Iterable<E>, X extends Throwable> void empty(T collection, Supplier<X> errorSupplier) throws X {
+		if (CollUtil.isNotEmpty(collection)) {
+			throw errorSupplier.get();
+		}
+	}
+
+
+	/**
+	 * 断言给定集合为空
+	 *
+	 * <pre class="code">
+	 * Assert.empty(collection, "Collection must have no elements");
+	 * </pre>
+	 *
+	 * @param <E>              集合元素类型
+	 * @param <T>              集合类型
+	 * @param collection       被检查的集合
+	 * @param errorMsgTemplate 异常时的消息模板
+	 * @param params           参数列表
+	 * @throws IllegalArgumentException if the collection is not {@code null} or has elements
+	 * @since 5.8.39
+	 */
+	public static <E, T extends Iterable<E>> void empty(T collection, String errorMsgTemplate, Object... params) throws IllegalArgumentException {
+		empty(collection, () -> new IllegalArgumentException(StrUtil.format(errorMsgTemplate, params)));
+	}
+
+	/**
+	 * 断言给定集合为空
+	 *
+	 * <pre class="code">
+	 * Assert.empty(collection);
+	 * </pre>
+	 *
+	 * @param <E>        集合元素类型
+	 * @param <T>        集合类型
+	 * @param collection 被检查的集合
+	 * @throws IllegalArgumentException if the collection is not {@code null} or has elements
+	 * @since 5.8.39
+	 */
+	public static <E, T extends Iterable<E>> void empty(T collection) throws IllegalArgumentException {
+		empty(collection, "[Assertion failed] - this collection must be empty");
+	}
+
 	/**
 	 * 断言给定集合非空
 	 * 并使用指定的函数获取错误信息返回
diff --git a/hutool-core/src/test/java/cn/hutool/core/lang/AssertTest.java b/hutool-core/src/test/java/cn/hutool/core/lang/AssertTest.java
index 63b73eb5a..337f437f4 100755
--- a/hutool-core/src/test/java/cn/hutool/core/lang/AssertTest.java
+++ b/hutool-core/src/test/java/cn/hutool/core/lang/AssertTest.java
@@ -4,6 +4,9 @@ import cn.hutool.core.util.StrUtil;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
+import java.util.ArrayList;
+import java.util.List;
+
 public class AssertTest {
 
 	@Test
@@ -68,4 +71,13 @@ public class AssertTest {
 
 	}
 
+	@Test
+	public void emptyCollectionTest() {
+		List<Object> testList = new ArrayList<>();
+		Assertions.assertDoesNotThrow(() -> Assert.empty(null));
+		Assertions.assertDoesNotThrow(() -> Assert.empty(testList));
+		testList.add(new Object());
+		Assertions.assertThrows(IllegalArgumentException.class, () -> Assert.empty(testList));
+	}
+
 }