Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
io.polaris.core.collection.ObjectArrays Maven / Gradle / Ivy
package io.polaris.core.collection;
import io.polaris.core.assertion.Assertions;
import io.polaris.core.collection.comparator.Comparators;
import io.polaris.core.consts.StdConsts;
import io.polaris.core.consts.SymbolConsts;
import io.polaris.core.converter.Converters;
import io.polaris.core.lang.Objs;
import io.polaris.core.random.Randoms;
import io.polaris.core.string.Strings;
import java.lang.reflect.Array;
import java.nio.ByteBuffer;
import java.util.*;
import java.util.function.Function;
import java.util.function.Predicate;
import java.util.stream.Collectors;
/**
* @author Qt
*/
public class ObjectArrays extends PrimitiveArrays {
public static final Object[] EMPTY = StdConsts.EMPTY_ARRAY;
public static List toList(Object array) {
List c = new ArrayList<>();
int len = Array.getLength(array);
for (int i = 0; i < len; i++) {
Object next = Array.get(array, i);
c.add(next);
}
return c;
}
public static Set toSet(Object array) {
Set c = new HashSet<>();
int len = Array.getLength(array);
for (int i = 0; i < len; i++) {
Object next = Array.get(array, i);
c.add(next);
}
return c;
}
/**
* 数组是否为空
*
* @param 数组元素类型
* @param array 数组
* @return 是否为空
*/
public static boolean isEmpty(T[] array) {
return array == null || array.length == 0;
}
/**
* 如果给定数组为空，返回默认数组
*
* @param 数组元素类型
* @param array 数组
* @param defaultArray 默认数组
* @return 非空（empty）的原数组或默认数组
*/
public static T[] defaultIfEmpty(T[] array, T[] defaultArray) {
return isEmpty(array) ? defaultArray : array;
}
/**
* 数组是否为空 数组元素类型
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(T[] array) {
return (null != array && array.length != 0);
}
/**
* 数组是否为非空 数组元素类型
* @param array 被检查的数组
* @return 是否包含{@code null}元素
*/
@SuppressWarnings("unchecked")
public static boolean hasNull(T... array) {
if (isNotEmpty(array)) {
for (T element : array) {
if (Objs.isNull(element)) {
return true;
}
}
}
return array == null;
}
/**
* 多个字段是否全为null
*
* @param 数组元素类型
* @param array 被检查的数组
* @return 多个字段是否全为null
*/
@SuppressWarnings("unchecked")
public static boolean isAllNull(T... array) {
return null == firstNonNull(array);
}
/**
* 返回数组中第一个非空元素
*
* @param 数组元素类型
* @param array 数组
* @return 非空元素，如果不存在非空元素或数组为空，返回{@code null}
*/
@SuppressWarnings("unchecked")
public static T firstNonNull(T... array) {
return firstMatch(Objs::isNotNull, array);
}
/**
* 返回数组中第一个匹配规则的值
*
* @param 数组元素类型
* @param matcher 匹配接口，实现此接口自定义匹配规则
* @param array 数组
* @return 匹配元素，如果不存在匹配元素或数组为空，返回 {@code null}
*/
@SuppressWarnings("unchecked")
public static T firstMatch(Predicate matcher, T... array) {
final int index = matchIndex(matcher, array);
if (index < 0) {
return null;
}
return array[index];
}
/**
* 返回数组中第一个匹配规则的值的位置
*
* @param 数组元素类型
* @param matcher 匹配接口，实现此接口自定义匹配规则
* @param array 数组
* @return 匹配到元素的位置，-1表示未匹配到
*/
@SuppressWarnings("unchecked")
public static int matchIndex(Predicate matcher, T... array) {
return matchIndex(matcher, 0, array);
}
/**
* 返回数组中第一个匹配规则的值的位置
*
* @param 数组元素类型
* @param matcher 匹配接口，实现此接口自定义匹配规则
* @param beginIndexInclude 检索开始的位置
* @param array 数组
* @return 匹配到元素的位置，-1表示未匹配到
*/
@SuppressWarnings("unchecked")
public static int matchIndex(Predicate matcher, int beginIndexInclude, T... array) {
if (isNotEmpty(array)) {
for (int i = beginIndexInclude; i < array.length; i++) {
if (matcher.test(array[i])) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 新建一个空数组
*
* @param 数组元素类型
* @param componentType 元素类型
* @param newSize 大小
* @return 空数组
*/
@SuppressWarnings("unchecked")
public static T[] newArray(Class componentType, int newSize) {
return (T[]) Array.newInstance(componentType, newSize);
}
/**
* 新建一个空数组
*
* @param newSize 大小
* @return 空数组
*/
public static Object[] newArray(int newSize) {
return new Object[newSize];
}
/**
* 获取数组对象的元素类型
*
* @param array 数组对象
* @return 元素类型
*/
public static Class getComponentType(Object array) {
return null == array ? null : array.getClass().getComponentType();
}
/**
* 获取数组对象的元素类型
*
* @param arrayClass 数组类
* @return 元素类型
*/
public static Class getComponentType(Class arrayClass) {
return null == arrayClass ? null : arrayClass.getComponentType();
}
/**
* 根据数组元素类型，获取数组的类型 数组元素类型
* @param buffer 已有数组
* @param newElements 新元素
* @return 新数组
*/
@SafeVarargs
public static T[] append(T[] buffer, T... newElements) {
if (isEmpty(buffer)) {
return newElements;
}
return insert(buffer, buffer.length, newElements);
}
/**
* 将新元素添加到已有数组中 数组元素类型
* @param array 已有数组
* @param newElements 新元素
* @return 新数组
*/
@SafeVarargs
public static Object append(Object array, T... newElements) {
if (isEmpty(array)) {
return newElements;
}
return insert(array, length(array), newElements);
}
/**
* 将元素值设置为数组的某个位置，当给定的index大于数组长度，则追加
*
* @param 数组元素类型
* @param buffer 已有数组
* @param index 位置，大于长度追加，否则替换
* @param value 新值
* @return 新数组或原有数组
*/
public static T[] setOrAppend(T[] buffer, int index, T value) {
if (index < buffer.length) {
Array.set(buffer, index, value);
return buffer;
} else {
if (ObjectArrays.isEmpty(buffer)) {
// issue#I5APJE
// 可变长类型在buffer为空的情况下，类型会被擦除，导致报错，此处修正
final T[] values = newArray(value.getClass(), 1);
values[0] = value;
return append(buffer, values);
}
return append(buffer, value);
}
}
/**
* 将元素值设置为数组的某个位置，当给定的index大于数组长度，则追加 数组元素类型
* @param buffer 已有数组
* @param index 位置，大于长度追加，否则替换，<0表示从头部追加
* @param values 新值
* @return 新数组或原有数组
*/
@SuppressWarnings({"unchecked"})
public static T[] replace(T[] buffer, int index, T... values) {
if (isEmpty(values)) {
return buffer;
}
if (isEmpty(buffer)) {
return values;
}
if (index < 0) {
// 从头部追加
return insert(buffer, 0, values);
}
if (index >= buffer.length) {
// 超出长度，尾部追加
return append(buffer, values);
}
if (buffer.length >= values.length + index) {
System.arraycopy(values, 0, buffer, index, values.length);
return buffer;
}
// 替换长度大于原数组长度，新建数组
int newArrayLength = index + values.length;
final T[] result = newArray(buffer.getClass().getComponentType(), newArrayLength);
System.arraycopy(buffer, 0, result, 0, index);
System.arraycopy(values, 0, result, index, values.length);
return result;
}
/**
* 将新元素插入到到已有数组中的某个位置 数组元素类型
* @param buffer 已有数组
* @param index 插入位置，此位置为对应此位置元素之前的空档
* @param newElements 新元素
* @return 新数组
*/
@SuppressWarnings("unchecked")
public static T[] insert(T[] buffer, int index, T... newElements) {
return (T[]) insert((Object) buffer, index, newElements);
}
/**
* 将新元素插入到到已有数组中的某个位置 数组元素类型
* @param array 已有数组
* @param index 插入位置，此位置为对应此位置元素之前的空档
* @param newElements 新元素
* @return 新数组
*/
@SuppressWarnings({"unchecked", "SuspiciousSystemArraycopy"})
public static Object insert(Object array, int index, T... newElements) {
if (isEmpty(newElements)) {
return array;
}
if (isEmpty(array)) {
return newElements;
}
final int len = length(array);
if (index < 0) {
index = (index % len) + len;
}
// 已有数组的元素类型
final Class originComponentType = array.getClass().getComponentType();
Object newEleArr = newElements;
// 如果 已有数组的元素类型是 原始类型，则需要转换 新元素数组 为该类型，避免ArrayStoreException
if (originComponentType.isPrimitive()) {
newEleArr = Converters.convert(array.getClass(), newElements);
}
final Object result = Array.newInstance(originComponentType, Math.max(len, index) + newElements.length);
System.arraycopy(array, 0, result, 0, Math.min(len, index));
System.arraycopy(newEleArr, 0, result, index, newElements.length);
if (index < len) {
System.arraycopy(array, index, result, index + newElements.length, len - index);
}
return result;
}
/**
* 生成一个新的重新设置大小的数组 数组元素类型
* @param data 原数组
* @param newSize 新的数组大小
* @param componentType 数组元素类型
* @return 调整后的新数组
*/
public static T[] resize(T[] data, int newSize, Class componentType) {
if (newSize < 0) {
return data;
}
final T[] newArray = newArray(componentType, newSize);
if (newSize > 0 && isNotEmpty(data)) {
System.arraycopy(data, 0, newArray, 0, Math.min(data.length, newSize));
}
return newArray;
}
/**
* 生成一个新的重新设置大小的数组 数组元素类型
* @param buffer 原数组
* @param newSize 新的数组大小
* @return 调整后的新数组
*/
public static T[] resize(T[] buffer, int newSize) {
return resize(buffer, newSize, buffer.getClass().getComponentType());
}
/**
* 将多个数组合并在一起 数组元素类型
* @param arrays 数组集合
* @return 合并后的数组
*/
@SafeVarargs
public static T[] addAll(T[]... arrays) {
if (arrays.length == 1) {
return arrays[0];
}
int length = 0;
for (final T[] array : arrays) {
if (isNotEmpty(array)) {
length += array.length;
}
}
final T[] result = newArray(arrays.getClass().getComponentType().getComponentType(), length);
length = 0;
for (final T[] array : arrays) {
if (isNotEmpty(array)) {
System.arraycopy(array, 0, result, length, array.length);
length += array.length;
}
}
return result;
}
/**
* 包装 {@link System#arraycopy(Object, int, Object, int, int)} 数组元素类型
* @param array 被克隆的数组
* @return 新数组
*/
public static T[] clone(T[] array) {
if (array == null) {
return null;
}
return array.clone();
}
/**
* 克隆数组，如果非数组返回{@code null}
*
* @param 数组元素类型
* @param obj 数组对象
* @return 克隆后的数组对象
*/
@SuppressWarnings("unchecked")
public static T clone(final T obj) {
if (null == obj) {
return null;
}
if (isArray(obj)) {
final Object result;
final Class componentType = obj.getClass().getComponentType();
if (componentType.isPrimitive()) {// 原始类型
int length = Array.getLength(obj);
result = Array.newInstance(componentType, length);
while (length-- > 0) {
Array.set(result, length, Array.get(obj, length));
}
} else {
result = ((Object[]) obj).clone();
}
return (T) result;
}
return null;
}
/**
* 编辑数组
* 1、过滤出需要的对象，如果返回{@code null}表示这个元素对象抛弃
* 2、修改元素对象，返回集合中为修改后的对象
*
*
*
* @param 数组元素类型
* @param array 数组
* @param editor 编辑器接口，{@code null}返回原集合
* @return 编辑后的数组
*/
public static T[] edit(T[] array, Function editor) {
if (null == editor) {
return array;
}
final ArrayList list = new ArrayList<>(array.length);
T modified;
for (T t : array) {
modified = editor.apply(t);
if (null != modified) {
list.add(modified);
}
}
final T[] result = newArray(array.getClass().getComponentType(), list.size());
return list.toArray(result);
}
/**
* 过滤
* 1、过滤出需要的对象，{@link Predicate#test(Object)}方法返回true的对象将被加入结果集合中
*
*
* @param 数组元素类型
* @param array 数组
* @param filter 过滤器接口，用于定义过滤规则，{@code null}返回原集合
* @return 过滤后的数组
*/
public static T[] filter(T[] array, Predicate filter) {
if (null == array || null == filter) {
return array;
}
return edit(array, t -> filter.test(t) ? t : null);
}
/**
* 去除{@code null} 元素
*
* @param 数组元素类型
* @param array 数组
* @return 处理后的数组
*/
public static T[] removeNull(T[] array) {
return edit(array, t -> {
// 返回null便不加入集合
return t;
});
}
/**
* 去除{@code null}或者"" 元素
*
* @param 数组元素类型
* @param array 数组
* @return 处理后的数组
*/
public static T[] removeEmpty(T[] array) {
return filter(array, Strings::isNotEmpty);
}
/**
* 去除{@code null}或者""或者空白字符串 元素
*
* @param 数组元素类型
* @param array 数组
* @return 处理后的数组
*/
public static T[] removeBlank(T[] array) {
return filter(array, Strings::isNotBlank);
}
/**
* 数组元素中的null转换为""
*
* @param array 数组
* @return 新数组
*/
public static String[] nullToEmpty(String[] array) {
return edit(array, t -> null == t ? SymbolConsts.EMPTY : t);
}
/**
* 映射键值（参考Python的zip()函数） Key类型
* @param Value类型
* @param keys 键列表
* @param values 值列表
* @param isOrder 是否有序
* @return Map
*/
public static Map zip(K[] keys, V[] values, boolean isOrder) {
if (isEmpty(keys) || isEmpty(values)) {
return null;
}
final int size = Math.min(keys.length, values.length);
final Map map = isOrder ? new LinkedHashMap<>(size) : new HashMap<>(size);
for (int i = 0; i < size; i++) {
map.put(keys[i], values[i]);
}
return map;
}
/**
* 映射键值（参考Python的zip()函数），返回Map无序 Key类型
* @param Value类型
* @param keys 键列表
* @param values 值列表
* @return Map
*/
public static Map zip(K[] keys, V[] values) {
return zip(keys, values, false);
}
// ------------------------------------------------------------------- indexOf and lastIndexOf and contains
/**
* 返回数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
*
* @param 数组类型
* @param array 数组
* @param value 被检查的元素
* @param beginIndexInclude 检索开始的位置
* @return 数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
*/
public static int indexOf(T[] array, Object value, int beginIndexInclude) {
return matchIndex((obj) -> Objs.equals(value, obj), beginIndexInclude, array);
}
/**
* 返回数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
*
* @param 数组类型
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
*/
public static int indexOf(T[] array, Object value) {
return matchIndex((obj) -> Objs.equals(value, obj), array);
}
/**
* 返回数组中指定元素所在位置，忽略大小写，未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
*/
public static int indexOfIgnoreCase(CharSequence[] array, CharSequence value) {
if (null != array) {
for (int i = 0; i < array.length; i++) {
if (Strings.equalsIgnoreCase(array[i], value)) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在最后的位置，未找到返回{@link #INDEX_NOT_FOUND}
*
* @param 数组类型
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
*/
public static int lastIndexOf(T[] array, Object value) {
if (isEmpty(array)) {
return INDEX_NOT_FOUND;
}
return lastIndexOf(array, value, array.length - 1);
}
/**
* 返回数组中指定元素所在最后的位置，未找到返回{@link #INDEX_NOT_FOUND}
*
* @param 数组类型
* @param array 数组
* @param value 被检查的元素
* @param endInclude 查找方式为从后向前查找，查找的数组结束位置，一般为array.length-1
* @return 数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
*/
public static int lastIndexOf(T[] array, Object value, int endInclude) {
if (isNotEmpty(array)) {
for (int i = endInclude; i >= 0; i--) {
if (Objs.equals(value, array[i])) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 数组中是否包含元素
*
* @param 数组元素类型
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
*/
public static boolean contains(T[] array, T value) {
return indexOf(array, value) > INDEX_NOT_FOUND;
}
/**
* 数组中是否包含指定元素中的任意一个
*
* @param 数组元素类型
* @param array 数组
* @param values 被检查的多个元素
* @return 是否包含指定元素中的任意一个
*/
@SuppressWarnings("unchecked")
public static boolean containsAny(T[] array, T... values) {
for (T value : values) {
if (contains(array, value)) {
return true;
}
}
return false;
}
/**
* 数组中是否包含指定元素中的全部
*
* @param 数组元素类型
* @param array 数组
* @param values 被检查的多个元素
* @return 是否包含指定元素中的全部
*/
@SuppressWarnings("unchecked")
public static boolean containsAll(T[] array, T... values) {
for (T value : values) {
if (false == contains(array, value)) {
return false;
}
}
return true;
}
/**
* 数组中是否包含元素，忽略大小写
*
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
*/
public static boolean containsIgnoreCase(CharSequence[] array, CharSequence value) {
return indexOfIgnoreCase(array, value) > INDEX_NOT_FOUND;
}
// ------------------------------------------------------------------- Wrap and unwrap
/**
* 包装数组对象
*
* @param obj 对象，可以是对象数组或者基本类型数组
* @return 包装类型数组或对象数组
*/
public static Object[] wrap(Object obj) {
if (null == obj) {
return null;
}
if (isArray(obj)) {
try {
return (Object[]) obj;
} catch (Exception e) {
final String className = obj.getClass().getComponentType().getName();
switch (className) {
case "long":
return wrap((long[]) obj);
case "int":
return wrap((int[]) obj);
case "short":
return wrap((short[]) obj);
case "char":
return wrap((char[]) obj);
case "byte":
return wrap((byte[]) obj);
case "boolean":
return wrap((boolean[]) obj);
case "float":
return wrap((float[]) obj);
case "double":
return wrap((double[]) obj);
default:
throw new IllegalArgumentException(e);
}
}
}
throw new IllegalArgumentException(Strings.format("[{}] is not Array!", obj.getClass()));
}
/**
* 对象是否为数组对象
*
* @param obj 对象
* @return 是否为数组对象，如果为{@code null} 返回false
*/
public static boolean isArray(Object obj) {
return null != obj && obj.getClass().isArray();
}
/**
* 获取数组对象中指定index的值，支持负数，例如-1表示倒数第一个值 数组元素类型
* @param array 数组对象
* @param index 下标，支持负数
* @return 值
*/
@SuppressWarnings("unchecked")
public static T get(Object array, int index) {
if (null == array) {
return null;
}
if (index < 0) {
index += Array.getLength(array);
}
try {
return (T) Array.get(array, index);
} catch (ArrayIndexOutOfBoundsException e) {
return null;
}
}
/**
* 获取数组中指定多个下标元素值，组成新数组
*
* @param 数组元素类型
* @param array 数组，如果提供为{@code null}则返回{@code null}
* @param indexes 下标列表
* @return 结果
*/
public static T[] getAny(Object array, int... indexes) {
if (null == array) {
return null;
}
if (null == indexes) {
return newArray(array.getClass().getComponentType(), 0);
}
final T[] result = newArray(array.getClass().getComponentType(), indexes.length);
for (int i = 0; i < indexes.length; i++) {
result[i] = ObjectArrays.get(array, indexes[i]);
}
return result;
}
/**
* 获取子数组
*
* @param 数组元素类型
* @param array 数组
* @param start 开始位置（包括）
* @param end 结束位置（不包括）
* @return 新的数组
* @see Arrays#copyOfRange(Object[], int, int)
*/
public static T[] sub(T[] array, int start, int end) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return newArray(array.getClass().getComponentType(), 0);
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return newArray(array.getClass().getComponentType(), 0);
}
end = length;
}
return Arrays.copyOfRange(array, start, end);
}
/**
* 获取子数组
*
* @param array 数组
* @param start 开始位置（包括）
* @param end 结束位置（不包括）
* @return 新的数组
*/
public static Object[] sub(Object array, int start, int end) {
return sub(array, start, end, 1);
}
/**
* 获取子数组
*
* @param array 数组
* @param start 开始位置（包括）
* @param end 结束位置（不包括）
* @param step 步进
* @return 新的数组
*/
public static Object[] sub(Object array, int start, int end, int step) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return new Object[0];
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return new Object[0];
}
end = length;
}
if (step <= 1) {
step = 1;
}
final ArrayList list = new ArrayList<>();
for (int i = start; i < end; i += step) {
list.add(get(array, i));
}
return list.toArray();
}
/**
* 数组或集合转String
*
* @param obj 集合或数组对象
* @return 数组字符串，与集合转字符串格式相同
*/
public static String toString(Object obj) {
if (null == obj) {
return null;
}
if (obj instanceof long[]) {
return Arrays.toString((long[]) obj);
} else if (obj instanceof int[]) {
return Arrays.toString((int[]) obj);
} else if (obj instanceof short[]) {
return Arrays.toString((short[]) obj);
} else if (obj instanceof char[]) {
return Arrays.toString((char[]) obj);
} else if (obj instanceof byte[]) {
return Arrays.toString((byte[]) obj);
} else if (obj instanceof boolean[]) {
return Arrays.toString((boolean[]) obj);
} else if (obj instanceof float[]) {
return Arrays.toString((float[]) obj);
} else if (obj instanceof double[]) {
return Arrays.toString((double[]) obj);
} else if (ObjectArrays.isArray(obj)) {
// 对象数组
try {
return Arrays.deepToString((Object[]) obj);
} catch (Exception ignore) {
//ignore
}
}
return obj.toString();
}
/**
* 获取数组长度
* ObjectArrays.length(null) = 0
* ObjectArrays.length([]) = 0
* ObjectArrays.length([null]) = 1
* ObjectArrays.length([true, false]) = 2
* ObjectArrays.length([1, 2, 3]) = 3
* ObjectArrays.length(["a", "b", "c"]) = 3
*
*
* @param array 数组对象
* @return 数组长度
* @throws IllegalArgumentException 如果参数不为数组，抛出此异常
* @see Array#getLength(Object)
*/
public static int length(Object array) throws IllegalArgumentException {
if (null == array) {
return 0;
}
return Array.getLength(array);
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param 被处理的集合
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(T[] array, CharSequence conjunction) {
return join(array, conjunction, null, null);
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param 被处理的集合
* @param array 数组
* @param delimiter 分隔符
* @param prefix 每个元素添加的前缀，null表示不添加
* @param suffix 每个元素添加的后缀，null表示不添加
* @return 连接后的字符串
*/
public static String join(T[] array, CharSequence delimiter, String prefix, String suffix) {
if (null == array) {
return null;
}
StringJoiner joiner = new StringJoiner(delimiter);
joinAll(joiner, o -> prefix + o + suffix, array);
return joiner.toString();
}
private static void joinAll(StringJoiner joiner, Function converter, Object array) {
if (array == null) {
joiner.add(converter.apply(null));
} else if (array instanceof Iterable) {
((Iterable) array).forEach(o -> joinAll(joiner, converter, o));
} else if (array instanceof Iterator) {
((Iterator) array).forEachRemaining(o -> joinAll(joiner, converter, o));
} else if (array.getClass().isArray()) {
int length = Array.getLength(array);
for (int i = 0; i < length; i++) {
joinAll(joiner, converter, Array.get(array, i));
}
} else {
joiner.add(converter.apply(array));
}
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param 被处理的集合
* @param array 数组
* @param conjunction 分隔符
* @param editor 每个元素的编辑器，null表示不编辑
* @return 连接后的字符串
*/
public static String join(T[] array, CharSequence conjunction, Function editor) {
StringJoiner joiner = new StringJoiner(conjunction);
joinAll(joiner, o -> String.valueOf(editor.apply((T) o)), array);
return joiner.toString();
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(Object array, CharSequence conjunction) {
if (null == array) {
return null;
}
StringJoiner joiner = new StringJoiner(conjunction);
joinAll(joiner, String::valueOf, array);
return joiner.toString();
}
/**
* {@link ByteBuffer} 转byte数组
*
* @param bytebuffer {@link ByteBuffer}
* @return byte数组
*/
public static byte[] toArray(ByteBuffer bytebuffer) {
if (bytebuffer.hasArray()) {
return Arrays.copyOfRange(bytebuffer.array(), bytebuffer.position(), bytebuffer.limit());
} else {
int oldPosition = bytebuffer.position();
bytebuffer.position(0);
int size = bytebuffer.limit();
byte[] buffers = new byte[size];
bytebuffer.get(buffers);
bytebuffer.position(oldPosition);
return buffers;
}
}
/**
* 将集合转为数组
*
* @param 数组元素类型
* @param iterator {@link Iterator}
* @param componentType 集合元素类型
* @return 数组
*/
public static T[] toArray(Iterator iterator, Class componentType) {
List list = Iterables.asList(iterator);
return toArray(list, componentType);
}
/**
* 将集合转为数组
*
* @param 数组元素类型
* @param iterable {@link Iterable}
* @param componentType 集合元素类型
* @return 数组
*/
public static T[] toArray(Iterable iterable, Class componentType) {
Collection collection = (iterable instanceof Collection) ? (Collection) iterable : Iterables.asList(iterable.iterator());
return toArray(collection, componentType);
}
/**
* 将集合转为数组
*
* @param 数组元素类型
* @param collection 集合
* @param componentType 集合元素类型
* @return 数组
*/
public static T[] toArray(Collection collection, Class componentType) {
return collection.toArray(newArray(componentType, 0));
}
// ---------------------------------------------------------------------- remove
/**
* 移除数组中对应位置的元素 数组元素类型
* @param array 数组对象，可以是对象数组，也可以原始类型数组
* @param index 位置，如果位置小于0或者大于长度，返回原数组
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
*/
@SuppressWarnings("unchecked")
public static T[] remove(T[] array, int index) throws IllegalArgumentException {
return (T[]) remove((Object) array, index);
}
// ---------------------------------------------------------------------- removeEle
/**
* 移除数组中指定的元素 数组元素类型
* @param array 数组对象，可以是对象数组，也可以原始类型数组
* @param element 要移除的元素
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
*/
public static T[] removeEle(T[] array, T element) throws IllegalArgumentException {
return remove(array, indexOf(array, element));
}
// ---------------------------------------------------------------------- Reverse array
/**
* 反转数组，会变更原数组
*
* @param 数组元素类型
* @param array 数组，会变更
* @param startIndexInclusive 开始位置（包含）
* @param endIndexExclusive 结束位置（不包含）
* @return 变更后的原数组
*/
public static T[] reverse(T[] array, final int startIndexInclusive, final int endIndexExclusive) {
if (isEmpty(array)) {
return array;
}
int i = Math.max(startIndexInclusive, 0);
int j = Math.min(array.length, endIndexExclusive) - 1;
T tmp;
while (j > i) {
tmp = array[j];
array[j] = array[i];
array[i] = tmp;
j--;
i++;
}
return array;
}
/**
* 反转数组，会变更原数组
*
* @param 数组元素类型
* @param array 数组，会变更
* @return 变更后的原数组
*/
public static T[] reverse(T[] array) {
return reverse(array, 0, array.length);
}
// ------------------------------------------------------------------------------------------------------------ min and max
/**
* 取最小值
*
* @param 元素类型
* @param numberArray 数字数组
* @return 最小值
*/
public static > T min(T[] numberArray) {
return min(numberArray, null);
}
/**
* 取最小值
*
* @param 元素类型
* @param numberArray 数字数组
* @param comparator 比较器，null按照默认比较
* @return 最小值
*/
public static > T min(T[] numberArray, Comparator comparator) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
T min = numberArray[0];
for (T t : numberArray) {
if (Comparators.compare(min, t, comparator) > 0) {
min = t;
}
}
return min;
}
/**
* 取最大值
*
* @param 元素类型
* @param numberArray 数字数组
* @return 最大值
*/
public static > T max(T[] numberArray) {
return max(numberArray, null);
}
/**
* 取最大值
*
* @param 元素类型
* @param numberArray 数字数组
* @param comparator 比较器，null表示默认比较器
* @return 最大值
*/
public static > T max(T[] numberArray, Comparator comparator) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
T max = numberArray[0];
for (int i = 1; i < numberArray.length; i++) {
if (Comparators.compare(max, numberArray[i], comparator) < 0) {
max = numberArray[i];
}
}
return max;
}
// 使用Fisher–Yates洗牌算法，以线性时间复杂度打乱数组顺序
/**
* 打乱数组顺序，会变更原数组
*
* @param 元素类型
* @param array 数组，会变更
* @return 打乱后的数组
*/
public static T[] shuffle(T[] array) {
return shuffle(array, Randoms.getRandom());
}
/**
* 打乱数组顺序，会变更原数组
*
* @param 元素类型
* @param array 数组，会变更
* @param random 随机数生成器
* @return 打乱后的数组
*/
public static T[] shuffle(T[] array, Random random) {
if (array == null || random == null || array.length <= 1) {
return array;
}
for (int i = array.length; i > 1; i--) {
swap(array, i - 1, random.nextInt(i));
}
return array;
}
/**
* 交换数组中两个位置的值
*
* @param 元素类型
* @param array 数组
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组，与传入数组为同一对象
*/
public static T[] swap(T[] array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Array must not empty !");
}
T tmp = array[index1];
array[index1] = array[index2];
array[index2] = tmp;
return array;
}
/**
* 交换数组中两个位置的值
*
* @param array 数组对象
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组，与传入数组为同一对象
*/
public static Object swap(Object array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Array must not empty !");
}
Object tmp = get(array, index1);
Array.set(array, index1, Array.get(array, index2));
Array.set(array, index2, tmp);
return array;
}
/**
* 计算{@code null}或空元素对象的个数，通过{@link Objs#isEmpty(Object)} 判断元素
*
* @param args 被检查的对象,一个或者多个
* @return 存在{@code null}的数量
*/
public static int emptyCount(Object... args) {
int count = 0;
if (isNotEmpty(args)) {
for (Object element : args) {
if (Objs.isEmpty(element)) {
count++;
}
}
}
return count;
}
/**
* 是否存在{@code null}或空对象，通过{@link Objs#isEmpty(Object)} 判断元素
*
* @param args 被检查对象
* @return 是否存在
*/
public static boolean hasEmpty(Object... args) {
if (isNotEmpty(args)) {
for (Object element : args) {
if (Objs.isEmpty(element)) {
return true;
}
}
}
return false;
}
/**
* 是否存都为{@code null}或空对象，通过{@link Objs#isEmpty(Object)} 判断元素
*
* @param args 被检查的对象,一个或者多个
* @return 是否都为空
*/
public static boolean isAllEmpty(Object... args) {
for (Object obj : args) {
if (false == Objs.isEmpty(obj)) {
return false;
}
}
return true;
}
/**
* 是否存都不为{@code null}或空对象，通过{@link Objs#isEmpty(Object)} 判断元素
*
* @param args 被检查的对象,一个或者多个
* @return 是否都不为空
*/
public static boolean isAllNotEmpty(Object... args) {
return false == hasEmpty(args);
}
/**
* 多个字段是否全部不为null
*
* @param 数组元素类型
* @param array 被检查的数组
* @return 多个字段是否全部不为null
*/
@SuppressWarnings("unchecked")
public static boolean isAllNotNull(T... array) {
return false == hasNull(array);
}
/**
* 去重数组中的元素，去重后生成新的数组，原数组不变 数组元素类型
* @param array 数组
* @return 去重后的数组
*/
@SuppressWarnings("unchecked")
public static T[] distinct(T[] array) {
if (isEmpty(array)) {
return array;
}
final Set set = new LinkedHashSet<>(array.length, 1);
Collections.addAll(set, array);
return toArray(set, (Class) getComponentType(array));
}
/**
* 去重数组中的元素，去重后生成新的数组，原数组不变 数组元素类型
* @param 唯一键类型
* @param array 数组
* @param uniqueGenerator 唯一键生成器
* @param override 是否覆盖模式，如果为{@code true}，加入的新值会覆盖相同key的旧值，否则会忽略新加值
* @return 去重后的数组
*/
@SuppressWarnings("unchecked")
public static T[] distinct(T[] array, Function uniqueGenerator, boolean override) {
if (isEmpty(array)) {
return array;
}
Map map = new HashMap<>();
if (override) {
for (T t : array) {
map.put(uniqueGenerator.apply(t), t);
}
} else {
for (T t : array) {
map.putIfAbsent(uniqueGenerator.apply(t), t);
}
}
return toArray(map.values(), (Class) getComponentType(array));
}
/**
* 按照指定规则，将一种类型的数组转换为另一种类型
*
* @param array 被转换的数组
* @param targetComponentType 目标的元素类型
* @param func 转换规则函数
* @param 原数组类型
* @param 目标数组类型
* @return 转换后的数组
*/
public static R[] map(T[] array, Class targetComponentType, Function func) {
final R[] result = newArray(targetComponentType, array.length);
for (int i = 0; i < array.length; i++) {
result[i] = func.apply(array[i]);
}
return result;
}
/**
* 按照指定规则，将一种类型的数组转换为另一种类型
*
* @param array 被转换的数组
* @param targetComponentType 目标的元素类型
* @param func 转换规则函数
* @param 原数组类型
* @param 目标数组类型
* @return 转换后的数组
*/
public static R[] map(Object array, Class targetComponentType, Function func) {
final int length = length(array);
final R[] result = newArray(targetComponentType, length);
for (int i = 0; i < length; i++) {
result[i] = func.apply(get(array, i));
}
return result;
}
/**
* 按照指定规则，将一种类型的数组元素提取后转换为{@link List}
*
* @param array 被转换的数组
* @param func 转换规则函数
* @param 原数组类型
* @param 目标数组类型
* @return 转换后的数组
*/
public static List map(T[] array, Function func) {
return Arrays.stream(array).map(func).collect(Collectors.toList());
}
/**
* 按照指定规则，将一种类型的数组元素提取后转换为{@link Set}
*
* @param array 被转换的数组
* @param func 转换规则函数
* @param 原数组类型
* @param 目标数组类型
* @return 转换后的数组
*/
public static Set mapToSet(T[] array, Function func) {
return Arrays.stream(array).map(func).collect(Collectors.toSet());
}
/**
* 判断两个数组是否相等，判断依据包括数组长度和每个元素都相等。
*
* @param array1 数组1
* @param array2 数组2
* @return 是否相等
*/
public static boolean equals(Object array1, Object array2) {
if (array1 == array2) {
return true;
}
if (hasNull(array1, array2)) {
return false;
}
Assertions.assertTrue(isArray(array1), "First is not a Array !");
Assertions.assertTrue(isArray(array2), "Second is not a Array !");
if (array1 instanceof long[]) {
return Arrays.equals((long[]) array1, (long[]) array2);
} else if (array1 instanceof int[]) {
return Arrays.equals((int[]) array1, (int[]) array2);
} else if (array1 instanceof short[]) {
return Arrays.equals((short[]) array1, (short[]) array2);
} else if (array1 instanceof char[]) {
return Arrays.equals((char[]) array1, (char[]) array2);
} else if (array1 instanceof byte[]) {
return Arrays.equals((byte[]) array1, (byte[]) array2);
} else if (array1 instanceof double[]) {
return Arrays.equals((double[]) array1, (double[]) array2);
} else if (array1 instanceof float[]) {
return Arrays.equals((float[]) array1, (float[]) array2);
} else if (array1 instanceof boolean[]) {
return Arrays.equals((boolean[]) array1, (boolean[]) array2);
} else {
// Not an array of primitives
return Arrays.deepEquals((Object[]) array1, (Object[]) array2);
}
}
/**
* 查找子数组的位置
*
* @param array 数组
* @param subArray 子数组
* @param 数组元素类型
* @return 子数组的开始位置，即子数字第一个元素在数组中的位置
*/
public static boolean isSub(T[] array, T[] subArray) {
return indexOfSub(array, subArray) > INDEX_NOT_FOUND;
}
/**
* 查找子数组的位置
*
* @param array 数组
* @param subArray 子数组
* @param 数组元素类型
* @return 子数组的开始位置，即子数字第一个元素在数组中的位置
*/
public static int indexOfSub(T[] array, T[] subArray) {
return indexOfSub(array, 0, subArray);
}
/**
* 查找子数组的位置
*
* @param array 数组
* @param beginInclude 查找开始的位置（包含）
* @param subArray 子数组
* @param 数组元素类型
* @return 子数组的开始位置，即子数字第一个元素在数组中的位置
*/
public static int indexOfSub(T[] array, int beginInclude, T[] subArray) {
if (isEmpty(array) || isEmpty(subArray) || subArray.length > array.length) {
return INDEX_NOT_FOUND;
}
int firstIndex = indexOf(array, subArray[0], beginInclude);
if (firstIndex < 0 || firstIndex + subArray.length > array.length) {
return INDEX_NOT_FOUND;
}
for (int i = 0; i < subArray.length; i++) {
if (!Objs.equals(array[i + firstIndex], subArray[i])) {
return indexOfSub(array, firstIndex + 1, subArray);
}
}
return firstIndex;
}
/**
* 查找最后一个子数组的开始位置
*
* @param array 数组
* @param subArray 子数组
* @param 数组元素类型
* @return 最后一个子数组的开始位置，即子数字第一个元素在数组中的位置
*/
public static int lastIndexOfSub(T[] array, T[] subArray) {
if (isEmpty(array) || isEmpty(subArray)) {
return INDEX_NOT_FOUND;
}
return lastIndexOfSub(array, array.length - 1, subArray);
}
/**
* 查找最后一个子数组的开始位置
*
* @param array 数组
* @param endInclude 查找结束的位置（包含）
* @param subArray 子数组
* @param 数组元素类型
* @return 最后一个子数组的开始位置，即子数字第一个元素在数组中的位置
*/
public static int lastIndexOfSub(T[] array, int endInclude, T[] subArray) {
if (isEmpty(array) || isEmpty(subArray) || subArray.length > array.length || endInclude < 0) {
return INDEX_NOT_FOUND;
}
int firstIndex = lastIndexOf(array, subArray[0]);
if (firstIndex < 0 || firstIndex + subArray.length > array.length) {
return INDEX_NOT_FOUND;
}
for (int i = 0; i < subArray.length; i++) {
if (!Objs.equals(array[i + firstIndex], subArray[i])) {
return lastIndexOfSub(array, firstIndex - 1, subArray);
}
}
return firstIndex;
}
// O(n)时间复杂度检查数组是否有序
/**
* 检查数组是否有序，即comparator.compare(array[i], array[i + 1]) <= 0，若传入空数组或空比较器，则返回false
*
* @param array 数组
* @param comparator 比较器
* @param 数组元素类型
* @return 数组是否有序
*/
public static boolean isSorted(T[] array, Comparator comparator) {
if (array == null || comparator == null) {
return false;
}
for (int i = 0; i < array.length - 1; i++) {
if (comparator.compare(array[i], array[i + 1]) > 0) {
return false;
}
}
return true;
}
/**
* 检查数组是否升序，即array[i].compareTo(array[i + 1]) <= 0，若传入空数组，则返回false
*
* @param 数组元素类型，该类型需要实现Comparable接口
* @param array 数组
* @return 数组是否升序
*/
public static > boolean isSorted(T[] array) {
return isSortedAsc(array);
}
/**
* 检查数组是否升序，即array[i].compareTo(array[i + 1]) <= 0，若传入空数组，则返回false
*
* @param 数组元素类型，该类型需要实现Comparable接口
* @param array 数组
* @return 数组是否升序
*/
public static > boolean isSortedAsc(T[] array) {
if (array == null) {
return false;
}
for (int i = 0; i < array.length - 1; i++) {
if (array[i].compareTo(array[i + 1]) > 0) {
return false;
}
}
return true;
}
/**
* 检查数组是否降序，即array[i].compareTo(array[i + 1]) >= 0，若传入空数组，则返回false
*
* @param 数组元素类型，该类型需要实现Comparable接口
* @param array 数组
* @return 数组是否降序
*/
public static > boolean isSortedDesc(T[] array) {
if (array == null) {
return false;
}
for (int i = 0; i < array.length - 1; i++) {
if (array[i].compareTo(array[i + 1]) < 0) {
return false;
}
}
return true;
}
}
