Lambda表达式统一封实现api

50 阅读17分钟
  1. 定义一个克隆的接口
/**
 * 框架操作实现entity 参数克隆实现接口类
 */
public interface IBeanClone {
     <T extends IBeanClone> T clone(Object source) ;


}

2.定义一个对象id类型

import java.io.Serializable;

/**
 * 框架操作实现entity 实现接口类
 */
public interface IBaseApi<ID extends Serializable> extends IBeanClone {

    public ID getId();

    public void setId(ID id);

}

3.具体的lambda表达式工具实现

import com.google.common.collect.ArrayListMultimap;
import com.google.common.collect.ImmutableMap;
import com.google.common.collect.Lists;
import com.google.common.collect.Multimap;
import org.apache.commons.lang3.reflect.FieldUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.Serializable;
import java.lang.reflect.Array;
import java.lang.reflect.Field;
import java.util.*;
import java.util.function.*;
import java.util.stream.Collectors;
import java.util.stream.IntStream;
import java.util.stream.Stream;

import static java.util.Arrays.asList;

/**
 * @author 作者 : suven
 * @date 创建时间: 2023-11-30
 * @version 版本: v1.0.0
 * <pre>
 *
 *  @description (说明):

 * </pre>
 * <pre>
 * 修改记录
 *    修改后版本:     修改人:  修改日期:     修改内容:
 * </pre>
 **/
public class IterableConvert {


    private static Logger log = LoggerFactory.getLogger(IterableConvert.class);

    /**
     * 将 object 和 newElements 合并成一个数组
     *
     * @param object 对象
     * @param newElements 数组
     * @param <T> 泛型
     * @return 结果数组
     */
    @SafeVarargs
    public static <T> Consumer<T>[] append(Consumer<T> object, Consumer<T>... newElements) {
        if (object == null) {
            return newElements;
        }
        Consumer<T>[] result = (Consumer<T>[]) Array.newInstance(Consumer.class, 1 + newElements.length);
        result[0] = object;
        System.arraycopy(newElements, 0, result, 1, newElements.length);
        return result;
    }

    public static <T> void addIfNotNull(Collection<T> coll, T item) {
        if (item == null) {
            return;
        }
        coll.add(item);
    }



    /**
     * 判断集合中是否存在满足条件的元素。
     * long spuId = 1L, 商品supId
     * List<Item> itemList = null
     * anyMatch(itemList, item -> ObjectUtil.equal(item.getSpuId(), spuId))
     * @param from      源集合
     * @param predicate 条件判断函数
     * @return 如果集合中存在满足条件的元素,则返回 true;否则返回 false。
     */
    public static <T> boolean anyMatch(Collection<T> from, Predicate<T> predicate) {
        return from.stream().anyMatch(predicate);
    }





    /**
     * List 以ID分组 Map<Long,List<T>>
     * Map<Integer, List<T>> groupBy = appleList.stream().collect(Collectors.groupingBy(T::getId));
     *
     * @param list
     * @return
     */
    public static < T extends IBaseApi<Long>> Map<Long, T> convertMap(List<T> list){
        if(ObjectTrue.isEmpty(list)){
            return Collections.emptyMap();
        }
        Map<Long,T> map = list.stream().collect(Collectors.toMap(T::getId, entity -> entity));
        return  map;
    }


    /**
     * List 以ID分组 Map<Long,List<T>>
     * Map<Integer, List<T>> groupBy = appleList.stream().collect(Collectors.groupingBy(T::getId));
     * @param list
     * @return
     */
    public static  < I extends Serializable, T extends IBaseApi<I>,V extends IBeanClone>  Map<I,V > convertMap(Collection<T> list, Class<V> clazz){
        if(ObjectTrue.isEmpty(list)){
            return Collections.emptyMap();
        }
        return list.stream().collect(Collectors.toMap(T::getId, entity ->{
            try {
                return  clazz.newInstance().clone(entity);
            } catch (Exception e) {
                e.printStackTrace();
            }
            return null;
        }));

    }

    /**
     * T extends Serializable 为系列化对象
     * K extends Serializable 为T对象具体的属性值;存储在map集合的Key属性,但不能有重复key
     * V extends IBeanClone 为返回map存储结果对象
     *
     * List 以keyMapper属性分组 Map<Long,List<T>>
     * <p> 备注:但不能有重复key <p/>
     *  1.使用例子:
     *   List list = Arrays.asList( new BaseEntity().toId(1l), new BaseEntity().toId(2l));
     *   Map<Long,BaseStatusEntity> map =  converterMap(list,BaseEntity::getId, BaseStatusEntity.class);
     *
     *   Map<Integer, List<T>> groupBy = appleList.stream().collect(Collectors.groupingBy(T::getId));
     *   And the following produces a Map mapping a unique identifier to students:
     *   Map<String, Student> studentIdToStudent
     *   students.stream().collect(toMap(Student::getId,Functions.identity());
     * @param list
     *
     * @return
     */
    public static <T,K, V extends IBeanClone> Map<K, V> convertMap(Collection<T> list, Function<T,K> keyMapper, Class<V> clazz){
        if(ObjectTrue.isEmpty(list)){
            return Collections.emptyMap();
        }
        return list.stream().collect(Collectors.toMap(keyMapper, entity ->{
            try {
                V value =  clazz.newInstance().clone(entity);
                return value;
            } catch (Exception e) {
                e.printStackTrace();
            }
            return null;
        }));

    }

    /**
     * T extends Serializable 为系列化对象
     * K extends Serializable 为T对象具体的属性值;存储在map集合的Key属性,但有重复key,后面的值 value2 会覆盖前端的value1值
     * V extends IBeanClone 为返回map存储结果对象
     *
     * List 以keyMapper属性分组 Map<Long,List<T>>
     * <p> 备注:但有重复key,后面的值 value2 会覆盖前端的value1值<p/>
     *  1.使用例子:
     *   List list = Arrays.asList( new BaseEntity().toId(1l), new BaseEntity().toId(2l));
     *   Map<Long,BaseStatusEntity> map =  converterMap(list,BaseEntity::getId, BaseStatusEntity.class);
     *
     *   Map<Integer, List<T>> groupBy = appleList.stream().collect(Collectors.groupingBy(T::getId));
     *   And the following produces a Map mapping a unique identifier to students:
     *   Map<String, Student> studentIdToStudent
     *   students.stream().collect(toMap(Student::getId,Functions.identity());
     * @param list
     *
     * @return
     */
    public static <T,K, V extends IBeanClone> Map<K, V> convertMapSame(Collection<T> list, Function<T,K> keyMapper, Class<V> clazz) {
        if(ObjectTrue.isEmpty(list)){
            return Collections.emptyMap();
        }
        Map<K,V> map = list.stream().collect(Collectors.toMap(keyMapper, entity -> {
            try {
                return clazz.newInstance().clone(entity);
            } catch (Exception e) {
                e.printStackTrace();
            }
            return null;
        },(value1, value2) ->{
            value1= null;
            return value2;
        }));
        return map;

    }



    /**
     * T extends Serializable 为系列化对象或Object对象
     * K extends Serializable 为T对象主键ID属性值;存储在map集合的Key属性
     * V extends IBeanClone 必须是IBeanClone接口实现业,值为克隆后的对象
     *
     * List 以keyMapper属性分组 Map<K,List<T>>
     * Map<Integer, List<T>> groupBy = appleList.stream().collect(Collectors.groupingBy(T::getId));
     *  1.使用例子:
     *  List list = Arrays.asList( new BaseEntity().toId(1l), new BaseEntity().toId(3l),new BaseEntity().toId(2l));
     *  Map<Long,BaseEntity> map =  convertMapGroup(list,BaseEntity::getId);
     * @param list
     * @return Map
     */
    public static <T,K>  Map<K,List<T>> convertMapGroup(List<T> list,Function<T,K> keyMapper){
        if(ObjectTrue.isEmpty(list)){
            return Collections.emptyMap();
        }
        return list.stream().collect(Collectors.groupingBy(keyMapper));
    }


    /**
     * 将map<K,V> 集合转换成List<V>集合实现方法
     * Map<Long,T> map --> list<T>
     * @param map
     * @return
     */
    public static <T>  List<T> convertMapToList(Map<Serializable,T> map){
        if(null ==map){
            return Collections.emptyList();
        }
        List<T> result = map.values().stream().collect(Collectors.toList());
        return result;
    }


    /** List<A> list --> list<B>
     * T extends Serializable 为系列化对象或Object对象
     * V extends IBeanClone 必须是IBeanClone接口实现业,值为克隆后的对象
     *
     * List 以为V为对象基于T做克隆属性后的对象的集合;
     *
     *  1.使用例子:
     *  List list = Arrays.asList( new BaseEntity().toId(1l), new BaseEntity().toId(3l),new BaseEntity().toId(2l));
     *  List<BaseStatusEntity> resultList =  convertList(list, BaseStatusEntity.class);
     * @param list
     * @return   List<B>
     */
    public static < T, V extends IBeanClone>  List<V> convertList(Collection<T> list, Class<V> clazz){
        if(ObjectTrue.isEmpty(list)){
            return Collections.emptyList();
        }
        List<V> result =  list.stream().map(entity -> {
              try {
                  return  (V)clazz.newInstance().clone(entity);
              } catch (Exception e) {
                  e.printStackTrace();
              }
              return null;
          }).collect(Collectors.toList());
        return result;
    }

    /**
     * T extends Serializable 为系列化对象或Object对象
     * K extends Serializable 为T对象主键ID属性值;存储在map集合的Key属性
     * V extends IBeanClone 为返回map存储结果对象
     *
     * List 以keyMapper属性分组 Map<Long,List<T>>
     *
     *  1.使用例子:
     *  List list = Arrays.asList( new BaseEntity().toId(1l), new BaseEntity().toId(3l),new BaseEntity().toId(2l));
     *  Map<Long,BaseStatusEntity> map =  convertLinkedHashMap(list,BaseEntity::getId, BaseStatusEntity.class);
     * @param list
     * @return
     */
    public  static <I extends Serializable,T extends IBaseApi<I>,V extends IBeanClone> Map<I, V> convertLinkedHashMap(Collection<T> list, Class<V> clazz){
        if(ObjectTrue.isEmpty(list)){
            return Collections.emptyMap();
        }
        Map<I,V > map =   new LinkedHashMap<>();
        list.forEach(entity ->{
            try {
                I key = entity.getId();
                V vo =  clazz.newInstance().clone(entity);
                map.put(key,vo);
            } catch (Exception e) {
                e.printStackTrace();
            }
        });
        return map;
    }

    /**
     * T extends Serializable 为系列化对象或Object对象
     * K extends Serializable 为T对象具体的属性值;存储在map集合的Key属性
     * V extends IBeanClone 为返回map存储结果对象
     *
     * List 以keyMapper属性分组 Map<Long,List<T>>
     *
     *  1.使用例子:
     *  List list = Arrays.asList( new BaseEntity().toId(1l), new BaseEntity().toId(3l),new BaseEntity().toId(2l));
     *  Map<Long,BaseStatusEntity> map =  convertLinkedHashMap(list,BaseEntity::getId, BaseStatusEntity.class);
     * @param list
     * @return
     */
    public  static <T,K,V extends IBeanClone> Map<K, V> convertLinkedHashMap(Collection<T> list, Function<T,K> keyMapper, Class<V> clazz){
        if(ObjectTrue.isEmpty(list)){
            return Collections.emptyMap();
        }
        Map<K,V > map =   new LinkedHashMap<>();
        list.forEach(entity ->{
            try {
                K key = keyMapper.apply(entity);
                V vo =  clazz.newInstance().clone(entity);
                map.put(key,vo);
            } catch (Exception e) {
                e.printStackTrace();
            }
        });
        return map;
    }


    /**
     * T extends Serializable 为系列化对象或Object对象
     * K extends Serializable 为T对象具体的属性值;存储在map集合的Key属性
     * V extends IBeanClone 为返回map存储结果对象
     *
     * List 以keyMapper属性分组 Map<Long,List<T>>
     *
     *  1.使用例子:
     *  List list = Arrays.asList( new BaseEntity().toId(1l), new BaseEntity().toId(3l),new BaseEntity().toId(2l));
     *  Map<Long,BaseStatusEntity> map =  convertGroupMap(list, BaseStatusEntity.class);
     * @param list
     * @return
     */
    public  static <K extends IBaseApi,V extends IBeanClone>   Map<Long, Collection<V>> convertGroupMap(Collection<K> list, Class<V> clazz){
        if(ObjectTrue.isEmpty(list)){
            return Collections.emptyMap();
        }
        Multimap<Long,V > map =   ArrayListMultimap.create();
        list.forEach(entity ->{
            try {
                V vo =  clazz.newInstance().clone(entity);
                map.put(entity.groupId() ,vo);
            } catch (Exception e) {
                e.printStackTrace();
            }
        });
        Map<Long,Collection<V>> mapList =  map.asMap();
        return mapList;

    }

    /**
     * T extends Serializable 为系列化对象或Object对象
     * K extends Serializable 为T对象具体的属性值;存储在map集合的Key属性
     * V extends IBeanClone 为返回map存储结果对象
     *
     * List 以keyMapper属性分组 Map<Long,List<T>>
     *
     *  1.使用例子:
     *  List list = Arrays.asList( new BaseEntity().toId(1l), new BaseEntity().toId(3l),new BaseEntity().toId(2l));
     *  Multimap<Serializable,BaseStatusEntity> map =  convertMultimap(list,BaseEntity::getId, BaseStatusEntity.class);
     * @param list
     * @return
     */
    public  static <T,K , V extends IBeanClone> Multimap<K, V> convertMultimap(Collection<T> list, Function<T,K> keyMapper, Class<V> clazz){

        Multimap<K,V > map =   ArrayListMultimap.create();
        if(ObjectTrue.isEmpty(list)){
            return map;
        }
        list.forEach(entity ->{
            try {
                V vo =  clazz.newInstance().clone(entity);
                K key =  keyMapper.apply(entity);
                map.put(key,vo);
            } catch (Exception e) {
                e.printStackTrace();
            }
        });
        return map;

    }

    /**
     * T extends Serializable 为系列化对象或Object对象
     * V 为T(Object)对象的指定属性的类型,返回指定属性的类型的值
     *
     * List 以keyMapper属性的值的集合
     *  1.使用例子:
     *  List list = Arrays.asList( new BaseEntity().toId(1l), new BaseEntity().toId(3l),new BaseEntity().toId(2l));
     *  List<Long> resultList =  convertFieldsList(list,BaseEntity::getId, BaseStatusEntity.class);
     * @param list
     * @return
     */
    public  static <T,V> List<V> convertFieldsList(Collection<T> list, Function<T,V> keyMapper){

        if(ObjectTrue.isEmpty(list)){
            return new ArrayList<>();
        }
        List<V> resultList =  list.stream().map(keyMapper).collect(Collectors.toList());
        return resultList;

    }
    /**
     * T extends Serializable 为系列化对象或Object对象
     * V 为T(Object)对象的指定属性的类型,返回指定属性的类型的值
     *
     * List 以keyMapper属性的值的集合
     *  1.使用例子:
     *  List list = Arrays.asList( new BaseEntity().toId(1l), new BaseEntity().toId(3l),new BaseEntity().toId(2l));
     *  Set<Long> resultSet =  convertFieldsSet(list,BaseEntity::getId, BaseStatusEntity.class);
     * @param list
     * @return
     */
    public  static <T,V> Set<V> convertFieldsSet(Collection<T> list, Function<T,V> keyMapper){

        if(ObjectTrue.isEmpty(list)){
            return new HashSet<>();
        }
        Set<V> resultSet =  list.stream().map(keyMapper).collect(Collectors.toSet());
        return resultSet;

    }


    /**
     * 将数组转换为目标类型的列表。
     *  T[] item
     *  convertList(item -> Item::getId)
     *
     * @param from 源数组
     * @param func 转换函数
     * @return 转换后的结果列表
     */
    public static <T, U> List<U> convertList(T[] from, Function<T, U> func) {
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        return convertList(Arrays.asList(from), func);
    }

    /**
     * 对集合进行转换操作,返回转换后的结果列表。
     *  Collection<Item> item
     *  convertList(item -> Item::getId)
     * @param from 源集合
     * @param func 转换函数
     * @return 转换后的结果列表
     */
    public static <T, U> List<U> convertList(Collection<T> from, Function<T, U> func) {
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        return from.stream().map(func).filter(Objects::nonNull).collect(Collectors.toList());
    }

    /**
     * 对集合进行转换操作,并根据条件进行过滤,返回转换后的结果列表。
     *  List<String> originalList = Arrays.asList("apple", "banana", "cherry", "date");
     * Predicate<String> filter = str -> str.length() > 5; // 过滤长度大于5的字符串
     * Function<String, Integer> func = String::length; // 将字符串转换为其长度
     * List<Integer> resultList = convertList(originalList, func, filter);
     *
     * @param from   源集合
     * @param func   转换函数
     * @param filter 过滤条件函数
     * @return 转换并过滤后的结果列表
     */
    public static <T, U> List<U> convertList(Collection<T> from, Function<T, U> func, Predicate<T> filter) {
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        return from.stream().filter(filter).map(func).filter(Objects::nonNull).collect(Collectors.toList());
    }

    public static <T> Set<T> convertSet(Collection<T> from){
        return from.stream().filter(Objects::nonNull).collect(Collectors.toSet());
    }


    /**
     * 对集合进行转换操作,返回转换后的结果集合。
     *  Collection<Item> item
     *  convertList(item -> Item::getId)
     *
     * @param from 源集合
     * @param func 转换函数
     * @return 转换后的结果集合
     */
    public static <T, U> Set<U> convertSet(Collection<T> from, Function<T, U> func) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashSet<>();
        }
        return from.stream().map(func).filter(Objects::nonNull).collect(Collectors.toSet());
    }
    /**
     * 对集合进行转换操作,并根据条件进行过滤,返回转换后的结果集合。
     *  List<String> originalList = Arrays.asList("apple", "banana", "cherry", "date");
     * Predicate<String> filter = str -> str.length() > 5; // 过滤长度大于5的字符串
     * Function<String, Integer> func = String::length; // 将字符串转换为其长度
     * Set<Integer> resultList = convertSet(originalList, func, filter);
     *
     * @param from   源集合
     * @param func   转换函数
     * @param filter 过滤条件函数
     * @return 转换并过滤后的结果集合
     */
    public static <T, U> Set<U> convertSet(Collection<T> from, Function<T, U> func, Predicate<T> filter) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashSet<>();
        }
        return from.stream().filter(filter).map(func).filter(Objects::nonNull).collect(Collectors.toSet());
    }
    /**
     * 对集合进行转换操作,并根据条件进行过滤,返回按键映射关系的结果集合。
     *
     * List<String> originalList = Arrays.asList("apple", "banana", "cherry", "date");
     * Predicate<String> filter = str -> str.length() > 5; // 过滤长度大于5的字符串
     * Function<String, Integer> keyFunc = String::length; // 将字符串长度作为键
     * Map<Integer, String> resultMap = convertMapByFilter(originalList, filter, keyFunc);
     *
     * @param from    源集合
     * @param filter  过滤条件函数
     * @param keyFunc 键提取函数
     * @return 转换并过滤后的按键映射关系的结果集合
     */
    public static <T, K> Map<K, T> convertMapByFilter(Collection<T> from, Predicate<T> filter, Function<T, K> keyFunc) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashMap<>();
        }
        return from.stream().filter(filter).collect(Collectors.toMap(keyFunc, v -> v));
    }

    /**
     * 对集合进行转换操作,并根据键提取函数过滤,转换并过滤后的按键映射关系的结果集合。
     *
     * @param from    源集合
     * @param keyFunc 键提取函数
     * @return 转换并过滤后的按键映射关系的结果集合
     */
    public static <T, K> Map<K, T> convertMap(T[] from, Function<T, K> keyFunc) {
        if (Objects.isNull(from)) {
            return new HashMap<>();
        }

        return convertMap(Arrays.asList(from), keyFunc, Function.identity());
    }

    /**
     * 对集合进行转换操作,并根据键提取函数过滤,转换并过滤后的按键映射关系的结果集合。
     *
     * @param from    源集合
     * @param keyFunc 键提取函数
     * @return 转换并过滤后的按键映射关系的结果集合
     */
    public static <T, K> Map<K, T> convertMap(Collection<T> from, Function<T, K> keyFunc) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashMap<>();
        }
        return convertMap(from, keyFunc, Function.identity());
    }

    /**
     * 对集合进行转换操作并生成映射关系,返回结果集合。
     *
     * @param from     源集合
     * @param keyFunc  键提取函数
     * @param supplier Map 实例提供者
     * @return 转换生成的映射关系结果集合
     */
    public static <T, K> Map<K, T> convertMap(Collection<T> from, Function<T, K> keyFunc, Supplier<? extends Map<K, T>> supplier) {
        if (ObjectTrue.isEmpty(from)) {
            return supplier.get();
        }
        return convertMap(from, keyFunc, Function.identity(), supplier);
    }


    /**
     * 对集合进行转换操作并生成映射关系,返回结果集合。
     *
     * @param from     源集合
     * @param keyFunc  键提取函数
     * @param valueFunc Function 键提取函数
     * @return 转换生成的映射关系结果集合
     */
    public static <T, K, V> Map<K, V> convertMap(Collection<T> from, Function<T, K> keyFunc, Function<T, V> valueFunc) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashMap<>();
        }
        return convertMap(from, keyFunc, valueFunc, (v1, v2) -> v1);
    }

    /**
     * 对集合进行转换操作并生成映射关系,返回结果集合。
     *
     * @param from          源集合
     * @param keyFunc       键提取函数
     * @param valueFunc     值提取函数
     * @param mergeFunction 合并函数(用于处理键冲突时的值合并)
     * @return 转换生成的映射关系结果集合
     */
    public static <T, K, V> Map<K, V> convertMap(Collection<T> from, Function<T, K> keyFunc, Function<T, V> valueFunc, BinaryOperator<V> mergeFunction) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashMap<>();
        }
        return convertMap(from, keyFunc, valueFunc, mergeFunction, HashMap::new);
    }

    /**
     * List -> Map
     * 需要注意的是:
     * toMap 如果集合对象有重复的key,会报错Duplicate key ....
     *  apple1,apple12的id都为1。
     *  可以用 (k1,k2)->k1 来设置,如果有重复的key,则保留key1,舍弃key2
     *     List<T> list =  new ArrayList<>();
     *     Map<Long,T> map = list.stream().collect(Collectors.toMap(T::getId, a -> a,(k1, k2)->k1));
     *
     *
     *  List 以ID分组 Map<Integer,List<Apple>>
     *  Map<Integer, List<Apple>> groupBy = appleList.stream().collect(Collectors.groupingBy(Apple::getId));
     */
    /**
     * 对集合进行转换操作并生成映射关系,返回结果集合。
     *
     * @param from          源集合
     * @param keyFunc       键提取函数
     * @param valueFunc     值提取函数
     * @return 转换生成的映射关系结果集合
     */
    public static <T, K, V> Map<K, V> convertMap(Collection<T> from, Function<T, K> keyFunc, Function<T, V> valueFunc, Supplier<? extends Map<K, V>> supplier) {
        if (ObjectTrue.isEmpty(from)) {
            return supplier.get();
        }
        return convertMap(from, keyFunc, valueFunc, (v1, v2) -> v1, supplier);
    }

    /**
     * 对集合进行转换操作并生成映射关系,返回结果集合。
     *
     * @param from          源集合
     * @param keyFunc       键提取函数
     * @param valueFunc     值提取函数
     * @param mergeFunction 合并函数(用于处理键冲突时的值合并)
     * @param supplier      Map 实例提供者
     * @return 转换生成的映射关系结果集合
     */
    public static <T, K, V> Map<K, V> convertMap(Collection<T> from, Function<T, K> keyFunc, Function<T, V> valueFunc, BinaryOperator<V> mergeFunction, Supplier<? extends Map<K, V>> supplier) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashMap<>();
        }
        return from.stream().collect(Collectors.toMap(keyFunc, valueFunc, mergeFunction, supplier));
    }

    /**
     * 对集合进行转换操作并生成映射关系,返回结果集合。
     *
     * @param from          源集合
     * @param filter        过滤条件函数
     * @param keyFunc       键提取函数
     * @param valueFunc     值提取函数
     * @param mergeFunction 合并函数(用于处理键冲突时的值合并)
     * @return 转换生成的映射关系结果集合
     */
    public static <T, K, V> Map<K, V> convertMap(Collection<T> from, Predicate<T> filter, Function<T, K> keyFunc, Function<T, V> valueFunc, BinaryOperator<V> mergeFunction) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashMap<>();
        }
        return from.stream().filter(filter).collect(Collectors.toMap(keyFunc, valueFunc, mergeFunction));
    }

    /**
     * 将集合按照键进行分组,生成键与对应元素列表的多重映射关系。
     *
     * @param from    源集合
     * @param keyFunc 键提取函数
     * @param <T>     元素类型
     * @param <K>     键类型
     * @return 键与对应元素列表的多重映射关系
     */
    public static <T, K> Map<K, List<T>> convertMultiMap(Collection<T> from, Function<T, K> keyFunc) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashMap<>();
        }
        return from.stream().collect(Collectors.groupingBy(keyFunc, Collectors.mapping(t -> t, Collectors.toList())));
    }
    /**
     * 将集合按照键进行分组,生成键与对应元素列表的多重映射关系。
     *
     * @param from    源集合
     * @param keyFunc 键提取函数
     * @param <T>     元素类型
     * @param <K>     键类型
     * @return 键与对应元素列表的多重映射关系
     */
    public static <T, K, V> Map<K, List<V>> convertMultiListMap(Collection<T> from, Function<T, K> keyFunc, Function<T, V> valueFunc) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashMap<>();
        }
        return from.stream()
                .collect(Collectors.groupingBy(keyFunc, Collectors.mapping(valueFunc, Collectors.toList())));
    }
    /**
     * 将集合按照键进行分组,生成键与对应元素列表的多重映射关系。
     *
     * @param from    源集合
     * @param keyFunc 键提取函数
     * @param <T>     元素类型
     * @param <K>     键类型
     * @return 键与对应元素列表的多重映射关系
     */
    // 暂时没想好名字,先以 2 结尾噶
    public static <T, K, V> Map<K, Set<V>> convertMultiSetMap(Collection<T> from, Function<T, K> keyFunc, Function<T, V> valueFunc) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashMap<>();
        }
        return from.stream().collect(Collectors.groupingBy(keyFunc, Collectors.mapping(valueFunc, Collectors.toSet())));
    }


    /**
     * 对集合进行扁平化转换操作,将每个元素转换为一个流,并将所有流合并为一个结果列表。
     *
     * @param from 源集合
     * @param func 元素转换函数,将每个元素转换为一个流
     * @return 扁平化转换后的结果列表
     */
    public static <T, U> List<U> convertListByFlatMap(Collection<T> from,
                                                      Function<T, ? extends Stream<? extends U>> func) {
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        return from.stream().flatMap(func).filter(Objects::nonNull).collect(Collectors.toList());
    }

    /**
     * 对集合进行扁平化转换操作,将每个元素转换为一个流,并将所有流合并为一个结果集合。
     *
     * @param from 源集合
     * @param func 元素转换函数,将每个元素转换为一个流
     * @return 扁平化转换后的结果集合
     */
    public static <T, U> Set<U> convertSetByFlatMap(Collection<T> from,
                                                    Function<T, ? extends Stream<? extends U>> func) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashSet<>();
        }
        return from.stream().flatMap(func).filter(Objects::nonNull).collect(Collectors.toSet());
    }
    /**
     * 将集合按照键进行分组,生成键与对应元素列表的多重映射关系。
     *
     * @param from    源集合
     * @param keyFunc 键提取函数
     * @param <T>     元素类型
     * @param <K>     键类型
     * @return 键与对应元素列表的多重映射关系
     */
    public static <T, K> Map<K, T> convertImmutableMap(Collection<T> from, Function<T, K> keyFunc) {
        if (ObjectTrue.isEmpty(from)) {
            return Collections.emptyMap();
        }
        ImmutableMap.Builder<K, T> builder = ImmutableMap.builder();
        from.forEach(item -> builder.put(keyFunc.apply(item), item));
        return builder.build();
    }


    /**
     * 验证目标列表中,是否包括源对象
     * @param source
     * @param targets
     * @return
     */
    public static boolean containsAny(Object source, Object... targets) {
        return asList(targets).contains(source);
    }


    public static boolean containsAny(Collection<?> source, Collection<?> candidates) {
        return org.springframework.util.CollectionUtils.containsAny(source, candidates);
    }

    /**
     * 对集合进行去重操作
     *
     * @param collection 待去重的集合
     * @param keyExtractor 用于提取去重依据的函数
     * @param <T> 集合元素类型
     * @return 去重后的集合
     */
    public static <T> List<T> deduplicateCollection(Collection<T> collection, Function<? super T, String> keyExtractor) {
        if (ObjectTrue.isEmpty(collection)){
            return Collections.emptyList();
        }
        return collection.stream()
                .collect(Collectors.collectingAndThen(
                        Collectors.toCollection(
                                () -> new TreeSet<>(Comparator.comparing(keyExtractor, Comparator.nullsFirst(Comparator.naturalOrder())))),
                        ArrayList::new));
    }

    /**
     * 对集合进行去重操作,返回去重后的结果列表。
     * List<Item> item
     * item -> anyMatch(item.getIds(), id -> ObjectUtil.equal(id, configId))
     * @param from      源集合
     * @return 去重后的结果列表
     */
    public static <T> List<T> distinctList(Collection<T> from){
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        return from.stream().filter(ObjectTrue::isNotEmpty).distinct().collect(Collectors.toList());
    }

    /**
     * 对集合进行去重操作和按大小分组返回去重后的结果分组列表。
     * List<Item> item
     * item -> from.stream().filter(ObjectTrue::isNotEmpty).distinct().collect(Collectors.toList());
     * @param from      源集合
     * @return 去重后的结果列表
     */
    public static <T>  List<List<T>> listPartition(Collection<T> from, int batchSize){
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        List<T>  list =  from.stream().filter(ObjectTrue::isNotEmpty).distinct().collect(Collectors.toList());
        List<List<T>> groupList = Lists.partition(list, batchSize);
        return groupList;
    }


    /**
     * 对集合进行过滤后按大小分组返回去重后的结果分组列表。
     * List<Item> item
     * item -> from.stream().filter(predicate).distinct().collect(Collectors.toList());
     * @param from      源集合
     * @return 结果列表
     */
    public static <T>  List<List<T>> listPartition(Collection<T> from, int batchSize, Predicate<T> predicate){
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        List<T>  list =  from.stream().filter(predicate).distinct().collect(Collectors.toList());
        List<List<T>> groupList = Lists.partition(list, batchSize);
        return groupList;
    }


    /**
     * 对集合进行去重操作和按大小分组返回去重后的结果分组列表。
     * List<Item> item
     * item -> from.stream().filter(ObjectTrue::isNotEmpty).distinct().collect(Collectors.toList());
     * @param from      源集合
     * @return 去重后的结果列表
     */
    public static  <T, R>  List<List<R>> listPartition(Collection<T> from, Function<T, R> keyMapper,int batchSize){
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        List<R>  list =  from.stream()
                .filter(obj -> ObjectTrue.isNotEmpty(keyMapper.apply(obj)) )
                .map(keyMapper).distinct().collect(Collectors.toList());
        List<List<R>> groupList = Lists.partition(list, batchSize);
        return groupList;
    }


    /**
     * 对集合进行去重操作,返回去重后的结果列表。
     * List<Item> item
     * item -> anyMatch(item.getIds(), id -> ObjectUtil.equal(id, configId))
     * @param from      源集合
     * @param keyMapper 用于提取去重依据的函数
     * @return 去重后的结果列表
     */
    public static <T, R> List<T> distinct(Collection<T> from, Function<T, R> keyMapper) {
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        return distinct(from, keyMapper, (t1, t2) -> t1);
    }

    /**
     * 对集合进行去重操作,返回去重后的结果列表。
     *
     * @param from      源集合
     * @param keyMapper 用于提取去重依据的函数
     * @param cover     当出现重复元素时的处理函数,用于确定保留哪一个元素
     * @return 去重后的结果列表
     */
    public static <T, R> List<T> distinct(Collection<T> from, Function<T, R> keyMapper, BinaryOperator<T> cover) {
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        return new ArrayList<>(convertMap(from, keyMapper, Function.identity(), cover).values());
    }

    /**
     * 对比老、新两个列表,找出新增、修改、删除的数据
     *
     * @param oldList  老列表
     * @param newList  新列表
     * @param sameFunc 对比函数,返回 true 表示相同,返回 false 表示不同
     *                 注意,same 是通过每个元素的“标识”,判断它们是不是同一个数据
     * @return [新增列表、修改列表、删除列表]
     */
    public static <T> List<List<T>> diffList(Collection<T> oldList, Collection<T> newList,
                                             BiFunction<T, T, Boolean> sameFunc) {
        List<T> createList = new LinkedList<>(newList); // 默认都认为是新增的,后续会进行移除
        List<T> updateList = new ArrayList<>();
        List<T> deleteList = new ArrayList<>();

        // 通过以 oldList 为主遍历,找出 updateList 和 deleteList
        for (T oldObj : oldList) {
            // 1. 寻找是否有匹配的
            T foundObj = null;
            for (Iterator<T> iterator = createList.iterator(); iterator.hasNext(); ) {
                T newObj = iterator.next();
                // 1.1 不匹配,则直接跳过
                if (!sameFunc.apply(oldObj, newObj)) {
                    continue;
                }
                // 1.2 匹配,则移除,并结束寻找
                iterator.remove();
                foundObj = newObj;
                break;
            }
            // 2. 匹配添加到 updateList;不匹配则添加到 deleteList 中
            if (foundObj != null) {
                updateList.add(foundObj);
            } else {
                deleteList.add(oldObj);
            }
        }
        return asList(createList, updateList, deleteList);
    }


    /**
     * 过滤集合中满足条件的元素,返回过滤后的结果列表。
     * List<Item> item
     * String version = "1.0.0"
     * IterableConvert.filterList(item, item -> version.equals(item.getVersion()));
     * @param from      源集合
     * @param predicate 过滤条件函数
     * @return 过滤后的结果列表
     */
    public static <T> List<T> filterList(Collection<T> from, Predicate<T> predicate) {
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        return from.stream().filter(predicate).collect(Collectors.toList());
    }
    public static <T, U> List<U> filterConvertList(Collection<T> from, Predicate<T> predicate,Function<T, U> func) {
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        return from.stream().filter(predicate).map(func).collect(Collectors.toList());
    }

    @SafeVarargs
    public static <T> List<T> filterList(Collection<T> from, Predicate<T>...predicate) {
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        Stream<T> stream = from.stream();
        for (Predicate<T> tPredicate : predicate) {
            stream.filter(tPredicate);
        }
        return stream.collect(Collectors.toList());
    }
    @SafeVarargs
    public static <T, U> List<U> filterConvertList(Collection<T> from, Function<T, U> func, Predicate<T>... predicate) {
        if (ObjectTrue.isEmpty(from)) {
            return new ArrayList<>();
        }
        Stream<T> stream = from.stream();
        for (Predicate<T> tPredicate : predicate) {
            stream.filter(tPredicate);
        }
        return stream.map(func).collect(Collectors.toList());
    }

    public static <T> T findFirst(List<T> from, Predicate<T> predicate) {
        return findFirst(from, predicate, Function.identity());
    }

    public static <T, U> U findFirst(List<T> from, Predicate<T> predicate, Function<T, U> func) {
        if (ObjectTrue.isEmpty(from)) {
            return null;
        }
        return from.stream().filter(predicate).findFirst().map(func).orElse(null);
    }
    /**
     * 获取数据的指定索引的对象
     * @param array 数组
     * @param index 获取数组的索引值
     * @return 返回结果对象
     * @param <T> 返回结果对象
     */
    public static <T> T get(T[] array, int index) {
        if (null == array || index >= array.length) {
            return null;
        }
        return array[index];
    }


    public static <T> T getFirst(List<T> from) {
        return !ObjectTrue.isEmpty(from) ? from.get(0) : null;
    }

    public static <T, V extends Comparable<? super V>> V getMaxValue(Collection<T> from, Function<T, V> valueFunc) {
        if (ObjectTrue.isEmpty(from)) {
            return null;
        }
        assert from.size() > 0; // 断言,避免告警
        Optional<T> optionals = from.stream().max(Comparator.comparing(valueFunc));
        if (optionals.isPresent()) {
            T t = optionals.get();
            return valueFunc.apply(t);
        }
        return null;

    }

    public static <T, V extends Comparable<? super V>> V getMinValue(List<T> from, Function<T, V> valueFunc) {
        if (ObjectTrue.isEmpty(from)) {
            return null;
        }
        assert from.size() > 0; // 断言,避免告警
        Optional<T> optionals = from.stream().min(Comparator.comparing(valueFunc));
        if (optionals.isPresent()) {
            T t = optionals.get();
            return valueFunc.apply(t);
        }
        return null;
    }

    public static <T, V extends Comparable<? super V>> V getSumValue(List<T> from, Function<T, V> valueFunc,
                                                                     BinaryOperator<V> accumulator) {
        if (ObjectTrue.isEmpty(from)) {
            return null;
        }
        assert from.size() > 0; // 断言,避免告警

        Optional<V> optionals = from.stream().map(valueFunc).reduce(accumulator);
        if (optionals.isPresent()) {
            return optionals.get();
        }
        return null;
    }

    public static <T, V extends Comparable<? super V>> V getSumValue(List<T> from, Predicate<T> predicate,
                                                                     Function<T, V> valueFunc, BinaryOperator<V> accumulator) {
        if (ObjectTrue.isEmpty(from)) {
            return null;
        }
        Optional<V> optionals = from.stream().filter(predicate).map(valueFunc).reduce(accumulator);
        return optionals.orElse(null);
    }


    public static boolean isAnyEmpty(Collection<?>... collections) {
        return Arrays.stream(collections).anyMatch(ObjectTrue::isEmpty);
    }

    /**
     * 合并多个具有相同键的值列表,并返回合并后的结果列表。
     *
     * @param map 包含值列表的映射表
     * @return 合并后的结果列表
     */
    public static <T, V> List<V> mergeValuesFromMap(Map<T, List<V>> map) {
        return map.values()
                .stream()
                .flatMap(List::stream)
                .collect(Collectors.toList());
    }



    public static <T> Collection<T> singleton(T deptId) {
        return deptId == null ? Collections.emptyList() : Collections.singleton(deptId);
    }


    /**
     * 将集合对象列表转换成数组集合组数组
     * @param objects 对象列表信息
     * @return 集合列表组数组
     */
    public static  Map<String,List<Object>>  convertObjectToGroupMap(List<?> objects){
        Map<String,List<Object>> map = new LinkedHashMap<>();
        if (ObjectTrue.isEmpty(objects)){
            return map;
        }
        List<Field> fields = FieldUtils.getAllFieldsList(objects.get(0).getClass());
        for (Object object : objects) {
            for (Field field : fields) {
                field.setAccessible(true);
                try {
                    Object value = field.get(object);
                    String key = field.getName();
                    String valueString = ObjectTrue.isEmpty(value) ? "" : value.toString() ;
                    List<Object> list = map.getOrDefault(key,new ArrayList<>());
                    list.add(valueString);
                    map.put(key,list);
                } catch (IllegalAccessException e) {
                    log.info("convertObjectToGroupMap List<Object> objects to Map<String,List<Object>> IllegalAccessException" ,e);
                }
            }
        }
        return map;
    }



    /**
     * 将集合对象按对象属性转换成列表转换成数组集合组数组
     * @param object 对象信息转换成数组列表
     * @return 集合列表组数组
     */
    public static List<String> convertObjectValueToList(Object object){
        List<String> propertyValues = new ArrayList<>();
        List<Field> fields = FieldUtils.getAllFieldsList( object.getClass());
        for (Field field : fields) {
            field.setAccessible(true);
            try {
                Object value = field.get(object);
                String valueString = ObjectTrue.isEmpty(value) ? "" : value.toString() ;
                propertyValues.add(valueString);
            } catch (IllegalAccessException e) {
                log.info("convertObjectValueToList Object object to List<String> IllegalAccessException" ,e);
            }
        }
        return propertyValues;
    }
    /**
     * 将对象按属性转换成map对象
     * @param object 对象信息
     * @return 反回map对象
     */
    public static Map<String,Object> convertObjectToMap(Object object){
        Map<String,Object>  result = new LinkedHashMap<>();
        List<Field> fields = FieldUtils.getAllFieldsList( object.getClass());
        for (Field field : fields) {
            field.setAccessible(true);
            try {
                Object value = field.get(object);
                String valueString = ObjectTrue.isNotEmpty(value) ? value.toString() : null;
                result.put(field.getName(),valueString);
            } catch (IllegalAccessException e) {
                log.info("convertObjectToMap Object object to Map<String,Object> IllegalAccessException" ,e);
            }
        }


        return result;
    }

    /**
     * 转换统计由总数按页大小,获取得到分页数;
     * @param pageSize
     * @param total
     * @return
     */
    public static long getPages(int pageSize, long total) {
        if (pageSize == 0) {
            return 0L;
        }
        long pages = total /pageSize;
        if (total % pageSize != 0) {
            pages++;
        }
        return pages;
    }


    /**
     * 对集合进行过滤转换操作并生成映射关系,返回结果集合。
     *
     * @param from      源集合
     * @param predicate 键提取函数
     * @param keyFunc   键提取函数
     * @param valueFunc Function 键提取函数
     * @return 转换生成的映射关系结果集合
     */
    public static <T, K, V> Map<K, V> convertMap(Collection<T> from, Predicate<T> predicate, Function<T, K> keyFunc, Function<T, V> valueFunc) {
        if (ObjectTrue.isEmpty(from)) {
            return new HashMap<>();
        }
        return from.stream().filter(predicate).collect(Collectors.toMap(keyFunc, valueFunc, (v1, v2) -> v1));
    }

    /** 将两个 List 集合 A 和 B 转换成 Map<A, B> 类型的集合可以通过多种方式实现。以下是几种常见的方法:
        List<String> listA = Arrays.asList("a", "b", "c");
        List<String> listB = Arrays.asList("1", "2", "3");
        Map<String, String> map = convertListsToMap(listA, listB);
        System.out.println(map); // 输出: {a=1, b=2, c=3}
     **/
    public static <K, V> Map<K, V> convertListsToMap(List<K> keys, List<V> values) {
        if (keys == null || values == null) {
            return new HashMap<>();
        }
        if (keys.size() != values.size()) {
            throw new IllegalArgumentException("Lists must have the same size");
        }
        Map<K, V> map = new HashMap<>(keys.size());
        for (int i = 0; i < keys.size(); i++) {
            map.put(keys.get(i), values.get(i));
        }
        return map;
    }

}