Add File

agents-flex-core/src/main/java/com/agentsflex/core/util/ArrayUtil.java

@@ -0,0 +1,132 @@
+/*
+ *  Copyright (c) 2023-2025, Agents-Flex (fuhai999@gmail.com).
+ *  <p>
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *  <p>
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *  <p>
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+package com.agentsflex.core.util;
+
+import java.util.Arrays;
+import java.util.Objects;
+
+public class ArrayUtil {
+
+    private ArrayUtil() {
+    }
+
+
+    /**
+     * 判断数组是否为空
+     *
+     * @param array 数组
+     * @param <T>   数组类型
+     * @return {@code true} 数组为空，{@code false} 数组不为空
+     */
+    public static <T> boolean isEmpty(T[] array) {
+        return array == null || array.length == 0;
+    }
+
+
+    /**
+     * 判断数组是否不为空
+     *
+     * @param array 数组
+     * @param <T>   数组类型
+     * @return {@code true} 数组不为空，{@code false} 数组为空
+     */
+    public static <T> boolean isNotEmpty(T[] array) {
+        return !isEmpty(array);
+    }
+
+
+    /**
+     * 合并两个数组为一个新的数组
+     *
+     * @param first  第一个数组
+     * @param second 第二个数组
+     * @param <T>
+     * @return 新的数组
+     */
+    public static <T> T[] concat(T[] first, T[] second) {
+        if (first == null && second == null) {
+            throw new IllegalArgumentException("not allow first and second are null.");
+        } else if (isEmpty(first) && second != null) {
+            return second;
+        } else if (isEmpty(second)) {
+            return first;
+        } else {
+            T[] result = Arrays.copyOf(first, first.length + second.length);
+            System.arraycopy(second, 0, result, first.length, second.length);
+            return result;
+        }
+    }
+
+
+    public static <T> T[] concat(T[] first, T[] second, T[] third, T[]... others) {
+        T[] results = concat(first, second);
+        results = concat(results, third);
+
+        if (others != null && others.length > 0) {
+            for (T[] other : others) {
+                results = concat(results, other);
+            }
+        }
+        return results;
+    }
+
+
+    /**
+     * 可变长参形式数组
+     *
+     * @param first  第一个数组
+     * @param second 第二个数组
+     * @param <T>
+     * @return 新的数组
+     */
+    @SafeVarargs
+    public static <T> T[] append(T[] first, T... second) {
+        if (first == null && second == null) {
+            throw new IllegalArgumentException("not allow first and second are null.");
+        } else if (isEmpty(first) && second != null) {
+            return second;
+        } else if (isEmpty(second)) {
+            return first;
+        } else {
+            T[] result = Arrays.copyOf(first, first.length + second.length);
+            System.arraycopy(second, 0, result, first.length, second.length);
+            return result;
+        }
+    }
+
+
+    /**
+     * 查看数组中是否包含某一个值
+     *
+     * @param arrays 数组
+     * @param object 用于检测的值
+     * @param <T>
+     * @return true 包含
+     */
+    public static <T> boolean contains(T[] arrays, T object) {
+        if (isEmpty(arrays)) {
+            return false;
+        }
+        for (T array : arrays) {
+            if (Objects.equals(array, object)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+
+}