Hutool ListUtil工具类详解

最新推荐文章于 2025-04-23 10:32:57 发布

原创最新推荐文章于 2025-04-23 10:32:57 发布

· 646 阅读

10 ·

版权

文章标签：

#java

提升自己专栏收录该内容

95 篇文章

订阅专栏

精心整理了最新的面试资料和简历模板，有需要的可以自行获取

点击前往百度网盘获取
 点击前往夸克网盘获取

Hutool ListUtil工具类详解

一、工具类简介

Hutool的ListUtil是一个针对Java List集合的增强工具类，封装了集合操作中的常见场景，能够简化代码并提升开发效率。适用于List的创建、分页、过滤、转换等高频操作，有效减少样板代码。

二、核心功能及代码示例

1. 快速创建集合

// 创建ArrayList
List<String> list1 = ListUtil.toList("A", "B", "C");

// 创建不可变集合（JDK9+风格）
List<String> unmodifiableList = ListUtil.of("Java", "Hutool", "Spring");

// 创建分页后的子集（自动计算起止索引）
List<Integer> fullList = IntUtil.range(1, 100);
List<Integer> page = ListUtil.page(2, 10, fullList); // 第3页，每页10条

2. 集合操作

// 拆分集合（每3个元素一组）
List<List<String>> splitGroups = ListUtil.split(list1, 3);

// 元素过滤（保留长度>2的字符串）
List<String> filtered = ListUtil.filter(list1, s -> s.length() > 2);

// 集合去重（根据对象属性）
List<User> users = ...;
List<User> uniqueUsers = ListUtil.distinct(users, User::getId);

// 集合排序（自然排序/自定义比较器）
ListUtil.sortByProperty(users, "age"); // 按年龄升序
ListUtil.sort(users, Comparator.comparing(User::getCreateTime).reversed());

3. 数据转换

// List转Map
Map<Long, User> idUserMap = ListUtil.toMap(users, User::getId);

// 提取对象属性集合
List<Long> ids = ListUtil.getFieldValues(users, User::getId);

// 转换为其他集合类型
Vector<String> vector = ListUtil.toVector(list1);

4. 特殊集合处理

// 空集合安全处理
List<String> safeList = ListUtil.emptyIfNull(null); // 返回空集合

// 批量修改元素
ListUtil.replaceAll(list1, str -> str + "_suffix");

// 并行流处理（需注意线程安全）
ListUtil.parallelForEach(users, user -> process(user));

三、典型应用场景

场景1：数据库查询分页

public PageResult<User> queryUsers(int pageNo, int pageSize) {
    List<User> allUsers = userDao.findAll();
    List<User> pageList = ListUtil.page(pageNo-1, pageSize, allUsers);
    return new PageResult<>(pageList, allUsers.size());
}

场景2：DTO/VO转换

public List<UserVO> convertToVO(List<UserDTO> dtos) {
    return ListUtil.map(dtos, dto -> {
        UserVO vo = new UserVO();
        BeanUtil.copyProperties(dto, vo);
        vo.setFullName(dto.getFirstName() + " " + dto.getLastName());
        return vo;
    });
}