lsm/hutool
1
0
Fork 0
mirror of https://gitee.com/dromara/hutool.git synced 2025-06-28 04:35:14 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #3952 from baofeidyz/v5-dev

Browse Source 
Assert新增断言给定集合为空的方法以及单元测试用例
This commit is contained in:
Golden Looly 2025-06-09 12:20:53 +08:00 committed by GitHub
commit d786c8e62d
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 74 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

62
hutool-core/src/main/java/cn/hutool/core/lang/Assert.java
View File

@ -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");
}
/**
* 断言给定集合非空
* 并使用指定的函数获取错误信息返回

12
hutool-core/src/test/java/cn/hutool/core/lang/AssertTest.java
View File

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