com.pearl.common/
├─ entity/        # 實(shí)體類模塊
│  └─ User.java   # 用戶實(shí)體定義
└─ spring/        # 工具類模塊
   └─ BeanUtils.java # 反射工具類

package com.pearl.common.entity;

/**
 * 業(yè)務(wù)實(shí)體：用戶信息模型
 * @author yyb
 * @since 2025/05/06
 * @apiNote 包含基礎(chǔ)屬性及Java Bean規(guī)范的訪問器方法
 */
public class User {

    /**
     * id
     */
    private String id;
    /**
     * 姓名
     */
    private String name;
    /**
     * 年齡
     */
    private Integer age;

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public User(String id, String name, Integer age) {
        this.id = id;
        this.name = name;
        this.age = age;
    }

    @Override
    public String toString() {
        return "User{" +
                "id='" + id + ''' +
                ", name='" + name + ''' +
                ", age=" + age +
                '}';
    }
}

package com.pearl.common.spring;

import com.pearl.common.entity.User;
import java.lang.reflect.InvocationTargetException;

/**
 * Bean對象反射操作工具類
 * @author yyb
 * @since 2025/05/06
 * @apiNote 提供基于方法名反射的屬性值獲取能力
 */
public class BeanUtils {
    private static final String GET_PREFIX = "get";  // getter方法前綴
    private static final String SET_PREFIX = "set";  // setter方法前綴

    /**
     * 通過反射調(diào)用對象的Getter方法獲取屬性值
     * @param target 對象實(shí)例
     * @param fieldName 目標(biāo)字段名（駝峰命名，如"userName"）
     * @param <T> 泛型約束（需為Java Bean規(guī)范類）
     * @return 字段值字符串表示，異常時(shí)返回空字符串
     * @throws SecurityException 反射權(quán)限異常
     * @example 獲取user對象的name屬性：getMethodValue(user, "name")
     */
    public static <T> String getMethodValue(T target, String fieldName) {
        String methodName = GET_PREFIX + 
            fieldName.substring(0, 1).toUpperCase() + 
            fieldName.substring(1);  // 拼接方法名（如"getName"）
        
        try {
            // 反射調(diào)用方法并轉(zhuǎn)換為字符串
            return String.valueOf(target.getClass()
                .getMethod(methodName)
                .invoke(target));
        } catch (NoSuchMethodException | IllegalAccessException | 
                 InvocationTargetException e) {
            e.printStackTrace();  // 生產(chǎn)環(huán)境建議日志記錄
            return "";
        }
    }

    // main方法測試
    public static void main(String[] args) {
        //根據(jù)對象和字段名稱獲取get方法返回值
        User user = new User("1", "張三", 18);
        String nameVale = getMethodValue(user, "name");
        System.out.printf("name：" + nameVale);

    }
}

package com.pearl.common.util;

import com.pearl.common.spring.BeanUtils;
import java.util.*;
import java.util.stream.Collectors;

/**
 * 集合操作工具類
 * @author yyb
 * @since 2025/05/06
 * @apiNote 提供基于反射的復(fù)雜去重與分組功能
 */
public class CollectionUtils {
    private static final String SEPARATOR = ",";  // 默認(rèn)分隔符

    /**
     * 多屬性組合去重：基于TreeSet的自然排序特性
     * @param sourceList 原始集合（支持null，但返回空集合）
     * @param fieldNames 參與去重的屬性名數(shù)組（如["name", "age"]）
     * @param <T> 泛型約束（需為Java Bean規(guī)范類）
     * @return 去重后的ArrayList集合，保留首次出現(xiàn)的元素
     * @implNote 通過拼接屬性值為唯一標(biāo)識，利用TreeSet的唯一性實(shí)現(xiàn)去重
     */
    public static <T> List<T> listDistinct(List<T> sourceList, String... fieldNames) {
        if (sourceList == null || sourceList.isEmpty()) {
            return new ArrayList<>();  // 防御性編程：空集合返回空列表
        }

        return sourceList.stream()
            .collect(Collectors.collectingAndThen(
                Collectors.toCollection(() -> new TreeSet<>(
                    Comparator.comparing(o -> buildKey(o, fieldNames, SEPARATOR))
                )), 
                ArrayList::new
            ));
    }

    // 輔助方法：拼接屬性值為唯一鍵
    private static <T> String buildKey(T object, String[] fields, String separator) {
        StringBuilder keyBuilder = new StringBuilder();
        for (String field : fields) {
            keyBuilder.append(BeanUtils.getMethodValue(object, field))
                      .append(separator);
        }
        // 移除末尾多余分隔符（如"name,age,"處理為"name,age"）
        return keyBuilder.length() > 0 ? 
            keyBuilder.deleteCharAt(keyBuilder.length() - 1).toString() : 
            "";
    }
}

public class CollectionTest {
    public static void main(String[] args) {
        // 構(gòu)造測試數(shù)據(jù)（包含重復(fù)屬性組合）
        List<User> userList = Arrays.asList(
            new User("1", "張三", 18),
            new User("3", "李四", 18),
            new User("5", "王五", 18),
            new User("2", "張三", 20),  // 與第一個(gè)用戶name重復(fù)，但age不同
            new User("4", "李四", 18)   // 與第二個(gè)用戶name+age均重復(fù)
        );

        // 單屬性去重（按姓名）
        List<User> singleDistinct = CollectionUtils.listDistinct(userList, "name");
        System.out.println("單屬性去重（name）結(jié)果：" + singleDistinct);
        // 輸出：[User{id='1', name='張三', age=18}, User{id='3', name='李四', age=18}, User{id='5', name='王五', age=18}]

        // 多屬性去重（按name+age）
        List<User> multiDistinct = CollectionUtils.listDistinct(userList, "name", "age");
        System.out.println("多屬性去重（name+age）結(jié)果：" + multiDistinct);
        // 輸出：[User{id='1', name='張三', age=18}, User{id='3', name='李四', age=18}, User{id='2', name='張三', age=20}, User{id='5', name='王五', age=18}]
    }
}

public static <T> Map<String, List<T>> propertyGroupMap(
    List<T> sourceList, 
    String separator, 
    String... fieldNames) {

    Map<String, List<T>> groupMap = new HashMap<>();
    if (sourceList == null || sourceList.isEmpty()) {
        return groupMap;
    }

    for (T item : sourceList) {
        // 構(gòu)建分組鍵（支持自定義分隔符，如"name-age"）
        String groupKey = buildKey(item, fieldNames, separator);
        
        // 分組邏輯：同一鍵對應(yīng)列表添加元素
        groupMap.computeIfAbsent(groupKey, k -> new ArrayList<>())
                .add(item);
    }
    return groupMap;
}

Map<String, List<User>> nameGroup = 
    CollectionUtils.propertyGroupMap(userList, "", "name");

// 輸出結(jié)果：
// {
//   張三=[User{id='1', name='張三', age=18}, User{id='2', name='張三', age=20}],
//   李四=[User{id='3', name='李四', age=18}, User{id='4', name='李四', age=18}],
//   王五=[User{id='5', name='王五', age=18}]
// }

Map<String, List<User>> nameAgeGroup = 
    CollectionUtils.propertyGroupMap(userList, "-", "name", "age");

// 輸出結(jié)果：
// {
//   張三-18=[User{id='1', name='張三', age=18}],
//   李四-18=[User{id='3', name='李四', age=18}, User{id='4', name='李四', age=18}],
//   張三-20=[User{id='2', name='張三', age=20}],
//   王五-18=[User{id='5', name='王五', age=18}]
// }