From ee7213a687036a9b20281fb78dc73dd9b033559a Mon Sep 17 00:00:00 2001 From: ZhouXY108 Date: Tue, 29 Apr 2025 11:26:12 +0800 Subject: [PATCH] =?UTF-8?q?refactor(util):=20`ArrayTools`=20=E4=B8=AD?= =?UTF-8?q?=E7=9A=84=20`isNullOrEmpty`=20=E9=87=8D=E5=91=BD=E5=90=8D?= =?UTF-8?q?=E4=B8=BA=20`isEmpty`?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 保持方法命名的一致性 BREAKING CHANGE: `ArrayTools#isNullOrEmpty` 重命名为 `ArrayTools#isEmpty` --- .../plusone/commons/util/ArrayTools.java | 34 +++++----- .../plusone/commons/util/BigDecimals.java | 2 +- .../zhouxy/plusone/commons/util/Numbers.java | 2 +- .../plusone/commons/util/ArrayToolsTests.java | 64 +++++++++---------- 4 files changed, 51 insertions(+), 51 deletions(-) diff --git a/src/main/java/xyz/zhouxy/plusone/commons/util/ArrayTools.java b/src/main/java/xyz/zhouxy/plusone/commons/util/ArrayTools.java index 0363eec..cb4b54b 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/util/ArrayTools.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/util/ArrayTools.java @@ -54,9 +54,9 @@ public class ArrayTools { public static final int NOT_FOUND_INDEX = -1; - // #region - isNullOrEmpty + // #region - isEmpty - // isNullOrEmpty + // isEmpty /** * 检查给定数组是否为空 @@ -65,84 +65,84 @@ public class ArrayTools { * @param 数组中元素的类型 * @return 如果数组为 {@code null} 或长度为 0，则返回 {@code true}；否则返回 {@code false} */ - public static boolean isNullOrEmpty(@Nullable T[] arr) { + public static boolean isEmpty(@Nullable T[] arr) { return arr == null || arr.length == 0; } - // isNullOrEmpty - char + // isEmpty - char /** * 检查给定数组是否为空 * * @param arr 待检查的数组，可以为 {@code null} * @return 如果数组为 {@code null} 或长度为 0，则返回 {@code true}；否则返回 {@code false} */ - public static boolean isNullOrEmpty(@Nullable char[] arr) { + public static boolean isEmpty(@Nullable char[] arr) { return arr == null || arr.length == 0; } - // isNullOrEmpty - byte + // isEmpty - byte /** * 检查给定数组是否为空 * * @param arr 待检查的数组，可以为 {@code null} * @return 如果数组为 {@code null} 或长度为 0，则返回 {@code true}；否则返回 {@code false} */ - public static boolean isNullOrEmpty(@Nullable byte[] arr) { + public static boolean isEmpty(@Nullable byte[] arr) { return arr == null || arr.length == 0; } - // isNullOrEmpty - short + // isEmpty - short /** * 检查给定数组是否为空 * * @param arr 待检查的数组，可以为 {@code null} * @return 如果数组为 {@code null} 或长度为 0，则返回 {@code true}；否则返回 {@code false} */ - public static boolean isNullOrEmpty(@Nullable short[] arr) { + public static boolean isEmpty(@Nullable short[] arr) { return arr == null || arr.length == 0; } - // isNullOrEmpty - int + // isEmpty - int /** * 检查给定数组是否为空 * * @param arr 待检查的数组，可以为 {@code null} * @return 如果数组为 {@code null} 或长度为 0，则返回 {@code true}；否则返回 {@code false} */ - public static boolean isNullOrEmpty(@Nullable int[] arr) { + public static boolean isEmpty(@Nullable int[] arr) { return arr == null || arr.length == 0; } - // isNullOrEmpty - long + // isEmpty - long /** * 检查给定数组是否为空 * * @param arr 待检查的数组，可以为 {@code null} * @return 如果数组为 {@code null} 或长度为 0，则返回 {@code true}；否则返回 {@code false} */ - public static boolean isNullOrEmpty(@Nullable long[] arr) { + public static boolean isEmpty(@Nullable long[] arr) { return arr == null || arr.length == 0; } - // isNullOrEmpty - float + // isEmpty - float /** * 检查给定数组是否为空 * * @param arr 待检查的数组，可以为 {@code null} * @return 如果数组为 {@code null} 或长度为 0，则返回 {@code true}；否则返回 {@code false} */ - public static boolean isNullOrEmpty(@Nullable float[] arr) { + public static boolean isEmpty(@Nullable float[] arr) { return arr == null || arr.length == 0; } - // isNullOrEmpty - double + // isEmpty - double /** * 检查给定数组是否为空 * * @param arr 待检查的数组，可以为 {@code null} * @return 如果数组为 {@code null} 或长度为 0，则返回 {@code true}；否则返回 {@code false} */ - public static boolean isNullOrEmpty(@Nullable double[] arr) { + public static boolean isEmpty(@Nullable double[] arr) { return arr == null || arr.length == 0; } diff --git a/src/main/java/xyz/zhouxy/plusone/commons/util/BigDecimals.java b/src/main/java/xyz/zhouxy/plusone/commons/util/BigDecimals.java index 5f4b0fe..26b512e 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/util/BigDecimals.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/util/BigDecimals.java @@ -105,7 +105,7 @@ public class BigDecimals { * @return 求和结果 */ public static BigDecimal sum(final BigDecimal... numbers) { - if (ArrayTools.isNullOrEmpty(numbers)) { + if (ArrayTools.isEmpty(numbers)) { return BigDecimal.ZERO; } BigDecimal result = BigDecimals.nullToZero(numbers[0]); diff --git a/src/main/java/xyz/zhouxy/plusone/commons/util/Numbers.java b/src/main/java/xyz/zhouxy/plusone/commons/util/Numbers.java index 89c6570..f5486af 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/util/Numbers.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/util/Numbers.java @@ -108,7 +108,7 @@ public class Numbers { * @return 求和结果 */ public static BigInteger sum(final BigInteger... numbers) { - if (ArrayTools.isNullOrEmpty(numbers)) { + if (ArrayTools.isEmpty(numbers)) { return BigInteger.ZERO; } BigInteger result = Numbers.nullToZero(numbers[0]); diff --git a/src/test/java/xyz/zhouxy/plusone/commons/util/ArrayToolsTests.java b/src/test/java/xyz/zhouxy/plusone/commons/util/ArrayToolsTests.java index 7bd5067..610b061 100644 --- a/src/test/java/xyz/zhouxy/plusone/commons/util/ArrayToolsTests.java +++ b/src/test/java/xyz/zhouxy/plusone/commons/util/ArrayToolsTests.java @@ -57,53 +57,53 @@ public class ArrayToolsTests { static final double[] EMPTY_DOUBLE_ARRAY = {}; // ================================ - // #region - isNullOrEmpty + // #region - isEmpty // ================================ @Test - void isNullOrEmpty_NullArray_ReturnsTrue() { + void isEmpty_NullArray_ReturnsTrue() { assertAll( - () -> assertTrue(ArrayTools.isNullOrEmpty(NULL_STRING_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(NULL_INTEGER_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(NULL_CHAR_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(NULL_BYTE_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(NULL_SHORT_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(NULL_INT_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(NULL_LONG_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(NULL_FLOAT_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(NULL_DOUBLE_ARRAY))); + () -> assertTrue(ArrayTools.isEmpty(NULL_STRING_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(NULL_INTEGER_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(NULL_CHAR_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(NULL_BYTE_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(NULL_SHORT_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(NULL_INT_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(NULL_LONG_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(NULL_FLOAT_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(NULL_DOUBLE_ARRAY))); } @Test - void isNullOrEmpty_EmptyArray_ReturnsTrue() { + void isEmpty_EmptyArray_ReturnsTrue() { assertAll( - () -> assertTrue(ArrayTools.isNullOrEmpty(EMPTY_STRING_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(EMPTY_INTEGER_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(EMPTY_CHAR_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(EMPTY_BYTE_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(EMPTY_SHORT_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(EMPTY_INT_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(EMPTY_LONG_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(EMPTY_FLOAT_ARRAY)), - () -> assertTrue(ArrayTools.isNullOrEmpty(EMPTY_DOUBLE_ARRAY))); + () -> assertTrue(ArrayTools.isEmpty(EMPTY_STRING_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(EMPTY_INTEGER_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(EMPTY_CHAR_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(EMPTY_BYTE_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(EMPTY_SHORT_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(EMPTY_INT_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(EMPTY_LONG_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(EMPTY_FLOAT_ARRAY)), + () -> assertTrue(ArrayTools.isEmpty(EMPTY_DOUBLE_ARRAY))); } @Test - void isNullOrEmpty_NonEmptyArray_ReturnsFalse() { + void isEmpty_NonEmptyArray_ReturnsFalse() { assertAll( - () -> assertFalse(ArrayTools.isNullOrEmpty(new String[] { "a" })), - () -> assertFalse(ArrayTools.isNullOrEmpty(new Integer[] { 1 })), - () -> assertFalse(ArrayTools.isNullOrEmpty(new char[] { 'a' })), - () -> assertFalse(ArrayTools.isNullOrEmpty(new byte[] { 1 })), - () -> assertFalse(ArrayTools.isNullOrEmpty(new short[] { 1 })), - () -> assertFalse(ArrayTools.isNullOrEmpty(new int[] { 1 })), - () -> assertFalse(ArrayTools.isNullOrEmpty(new long[] { 1 })), - () -> assertFalse(ArrayTools.isNullOrEmpty(new float[] { 1 })), - () -> assertFalse(ArrayTools.isNullOrEmpty(new double[] { 1 }))); + () -> assertFalse(ArrayTools.isEmpty(new String[] { "a" })), + () -> assertFalse(ArrayTools.isEmpty(new Integer[] { 1 })), + () -> assertFalse(ArrayTools.isEmpty(new char[] { 'a' })), + () -> assertFalse(ArrayTools.isEmpty(new byte[] { 1 })), + () -> assertFalse(ArrayTools.isEmpty(new short[] { 1 })), + () -> assertFalse(ArrayTools.isEmpty(new int[] { 1 })), + () -> assertFalse(ArrayTools.isEmpty(new long[] { 1 })), + () -> assertFalse(ArrayTools.isEmpty(new float[] { 1 })), + () -> assertFalse(ArrayTools.isEmpty(new double[] { 1 }))); } // ================================ - // #endregion - isNullOrEmpty + // #endregion - isEmpty // ================================ // ================================