ai.yue.library.base.util

Class ListUtils

java.lang.Object

cn.hutool.core.collection.ListUtil

ai.yue.library.base.util.ListUtils

public class ListUtils
extends cn.hutool.core.collection.ListUtil

List工具类

Since:

2017年10月27日

Author:

ylyue

Constructor Summary

Constructors

Constructor and Description
ListUtils()

Method Summary

Modifier and Type	Method and Description
static List<com.alibaba.fastjson.JSONObject>	distinct(List<com.alibaba.fastjson.JSONObject> list, String distinctKey) List - JSONObject value去重
static <T> List<T>	distinct(List<T> list) HashSet去重
static List<com.alibaba.fastjson.JSONObject>	distinctCount(List<com.alibaba.fastjson.JSONObject> list, String distinctKey, SortEnum sortEnum) List-JSONObject集合去重统计与排序
static List<com.alibaba.fastjson.JSONObject>	distinctCountSortSelectKeep(List<com.alibaba.fastjson.JSONObject> list, String distinctKey, SortEnum sortEnum, String keepKey, MaxOrMinEnum maxOrMinEnum) List-JSONObject集合——去重、统计、排序与元素选择性保留
static <T> T	get(List<?> list, Class<T> clazz) 获得List数组中对应类型的第一个值
static List<List<com.alibaba.fastjson.JSONObject>>	grouping(List<com.alibaba.fastjson.JSONObject> list, String key) 数据分组
static boolean	isEmpty(List<?> list) List数组是否为空
static boolean	isNotEmpty(List<?> list) List数组是否不为空
static List<String>	keepSameValue(List<String> list, List<String> list2) 保留相同值
static com.alibaba.fastjson.JSONArray	merge(com.alibaba.fastjson.JSONArray array, com.alibaba.fastjson.JSONObject json, String key) 将JSON集合，合并到数组的JSON集合
static void	merge(List<com.alibaba.fastjson.JSONObject> list1, List<com.alibaba.fastjson.JSONObject> list2, String key1, String key2) List合并
static <T> List<T>	reverse(List<T> list, Class<T> clazz) 反转集合
static List<com.alibaba.fastjson.JSONObject>	sort(List<com.alibaba.fastjson.JSONObject> list, String sortKey, SortEnum sortEnum) List-JSONObject集合排序
static <T> List<T>	sortT(List<T> list, String sortField, SortEnum sortEnum) List-T集合排序
static List<com.alibaba.fastjson.JSONObject>	toCamelCaseJsonList(List<com.alibaba.fastjson.JSONObject> list) JsonList属性命名策略转换-驼峰命名法
static <T> List<com.alibaba.fastjson.JSONObject>	toCamelCaseJsonListT(List<T> list) JsonList属性命名策略转换-驼峰命名法
static List<com.alibaba.fastjson.JSONObject>	toJsonList(com.alibaba.fastjson.JSONArray jsonArray) JSONArray 转 List - JSONObject
static List<com.alibaba.fastjson.JSONObject>	toJsonList(List<Map<String,Object>> list) List - Map 转 List - JSONObject
static <T> List<com.alibaba.fastjson.JSONObject>	toJsonListT(List<T> list) List - Class 转 List - JSONObject
static com.alibaba.fastjson.JSONObject[]	toJsons(com.alibaba.fastjson.JSONArray jsonArray) JSONArray 转 JSONObject[]
static com.alibaba.fastjson.JSONObject[]	toJsons(List<com.alibaba.fastjson.JSONObject> list) List-JSONObject 转 JSONObject[]
static com.alibaba.fastjson.JSONObject[]	toJsons(String jsonString) String 转 JSONObject[]
static com.alibaba.fastjson.JSONObject[]	toJsons(String text, String regex, String key) String 转 JSONObject[] 示例：
static <T> com.alibaba.fastjson.JSONObject[]	toJsonsT(List<T> list) List - Class 转 JSONObject[]
static <T> com.alibaba.fastjson.JSONObject[]	toJsonsTAndRemoveEmpty(List<T> list) List - Class 转 JSONObject[] 并移除空对象
static <T> List<T>	toList(com.alibaba.fastjson.JSONArray jsonArray, Class<T> clazz) JSONArray 转 List-Class
static <T> List<T>	toList(List<com.alibaba.fastjson.JSONObject> list, Class<T> clazz) List-JSONObject 转 List-Class
static List<String>	toList(List<com.alibaba.fastjson.JSONObject> list, String keepKey) List-JSONObject 转 List-String
static <T> List<T>	toList(List<com.alibaba.fastjson.JSONObject> list, String keepKey, Class<T> clazz) List-JSONObject 转 List-Class
static <T> ArrayList<T>	toList(T[] array) 数组转List
static List<String>	toListAndDistinct(List<com.alibaba.fastjson.JSONObject> list, String keepKey) List - JSONObject 转 List - String 并去除重复元素
static <T> List<T>	toListAndDistinct(List<com.alibaba.fastjson.JSONObject> list, String keepKey, Class<T> clazz) List-JSONObject 转 List-Class 并去除重复元素
static List<com.alibaba.fastjson.JSONObject>	toSnakeCaseJsonList(List<com.alibaba.fastjson.JSONObject> list) JsonList属性命名策略转换-下划线命名法
static <T> List<com.alibaba.fastjson.JSONObject>	toSnakeCaseJsonListT(List<T> list) JsonList属性命名策略转换-下划线命名法
static List<com.alibaba.fastjson.JSONObject>	toUnderlineCaseJsonList(List<com.alibaba.fastjson.JSONObject> list) JsonList属性命名策略转换-下划线命名法
static <T> List<com.alibaba.fastjson.JSONObject>	toUnderlineCaseJsonListT(List<T> list) JsonList属性命名策略转换-下划线命名法

Methods inherited from class cn.hutool.core.collection.ListUtil

empty, filter, indexOfAll, list, list, list, list, list, list, of, page, reverse, reverseNew, setOrAppend, sort, sortByPinyin, sortByProperty, split, sub, sub, toCopyOnWriteArrayList, toLinkedList, toList, toList, toList, toList, unmodifiable

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ListUtils

public ListUtils()

Method Detail

isEmpty

public static boolean isEmpty(List<?> list)

List数组是否为空

Parameters:

list - list

Returns:

是否为空

isNotEmpty

public static boolean isNotEmpty(List<?> list)

List数组是否不为空

Parameters:

list - list

Returns:

是否不为空

get

public static <T> T get(List<?> list,
                        Class<T> clazz)

获得List数组中对应类型的第一个值

Type Parameters:

T - 想要的类型

Parameters:

list - List数组

clazz - 想要的类型Class

Returns:

找到的第一个值或null

grouping

public static List<List<com.alibaba.fastjson.JSONObject>> grouping(List<com.alibaba.fastjson.JSONObject> list,
                                                                   String key)

数据分组

将拥有相同的 key 值的JSON数据归为一组

Parameters:

list - 要处理的集合

key - 分组依据

Returns:

分组后的list

keepSameValue

public static List<String> keepSameValue(List<String> list,
                                         List<String> list2)

保留相同值

Parameters:

list - 循环第一层

list2 - 循环第二层

Returns:

处理后的list

merge

public static com.alibaba.fastjson.JSONArray merge(com.alibaba.fastjson.JSONArray array,
                                                   com.alibaba.fastjson.JSONObject json,
                                                   String key)

将JSON集合，合并到数组的JSON集合

以条件key获得JSONObject数组中每个对象的value作为JSON对象的key，然后进行合并。
JSON对象key获得的值，应该是一个JSONObject对象

示例：

        JSONArray array = [
                {
                        "id": 1,
                        "name": "name"
                }
        ]
        JSONObject json = {
                1: {
                        "sex": "男",
                        "age": 18
                }
        }
 
        String key = "id";
                
        JSONArray mergeResult = merge(array, json, key);
        System.out.println(mergeResult);
 

结果： [{"id": 1, "name": "name", "sex": "男", "age": 18}]

Parameters:

array - JSONObject数组

json - JSON对象

key - 条件

Returns:

合并后的JSONArray

merge

public static void merge(List<com.alibaba.fastjson.JSONObject> list1,
                         List<com.alibaba.fastjson.JSONObject> list2,
                         String key1,
                         String key2)

List合并

将 list2 合并到 list1 里面

Parameters:

list1 - 需要合并的列表

list2 - 被合并的列表

key1 - list1中JSON所使用的key

key2 - list2中JSON所使用的key

sort

public static List<com.alibaba.fastjson.JSONObject> sort(List<com.alibaba.fastjson.JSONObject> list,
                                                         String sortKey,
                                                         SortEnum sortEnum)

List-JSONObject集合排序

Parameters:

list - 需要处理的集合

sortKey - 排序依据（JSONObject的key）

sortEnum - 排序方式

Returns:

处理后的List集合

sortT

public static <T> List<T> sortT(List<T> list,
                                String sortField,
                                SortEnum sortEnum)

List-T集合排序

Type Parameters:

T - 泛型

Parameters:

list - 需要处理的集合

sortField - 排序字段

sortEnum - 排序方式

Returns:

处理后的List集合

reverse

public static <T> List<T> reverse(List<T> list,
                                  Class<T> clazz)

反转集合

Type Parameters:

T - 泛型

Parameters:

list - 需要处理的集合

clazz - 集合元素类型

Returns:

反转后的List集合

distinct

public static <T> List<T> distinct(List<T> list)

HashSet去重

Type Parameters:

T - 泛型

Parameters:

list - 需要去重的list

Returns:

去重后的list

distinct

public static List<com.alibaba.fastjson.JSONObject> distinct(List<com.alibaba.fastjson.JSONObject> list,
                                                             String distinctKey)

List - JSONObject value去重

根据参数distinctKey去重。

Parameters:

list - 需要处理的集合

distinctKey - 去重的依据（JSON的key）

Returns:

处理后的List集合

distinctCount

public static List<com.alibaba.fastjson.JSONObject> distinctCount(List<com.alibaba.fastjson.JSONObject> list,
                                                                  String distinctKey,
                                                                  SortEnum sortEnum)

List-JSONObject集合去重统计与排序

根据参数distinctKey（JSONObject的key）计算元素重复次数，并为每个JSONObject添加一个 frequency（频率元素），value的值是从整数1开始计数。

示例：json.put("frequency", frequency)

根据frequency（重复频率）排序

Parameters:

list - 需要处理的集合

distinctKey - 去重的依据（JSONObject的key）

sortEnum - 排序方式

Returns:

处理后的List集合

distinctCountSortSelectKeep

public static List<com.alibaba.fastjson.JSONObject> distinctCountSortSelectKeep(List<com.alibaba.fastjson.JSONObject> list,
                                                                                String distinctKey,
                                                                                SortEnum sortEnum,
                                                                                String keepKey,
                                                                                MaxOrMinEnum maxOrMinEnum)

List-JSONObject集合——去重、统计、排序与元素选择性保留

根据参数distinctKey（JSONObject的key），计算元素重复次数。并为每个JSONObject添加一个frequency（频率元素），value的值是从整数1开始计数。

示例：json.put("frequency", frequency)

根据frequency（重复频率）排序

Parameters:

list - 需要处理的集合

distinctKey - 去重的依据（JSONObject的key）

sortEnum - 排序方式

keepKey - 需要保留的重复元素（此参数必须为可判断的Number类型：根据maxOrMinEnum选择保留最大值 或 最小值）如：根据id去重，保留age为最大或最小的JSONObject

maxOrMinEnum - 保留的值：最大值 或 最小值

Returns:

处理后的List集合

toList

public static <T> ArrayList<T> toList(T[] array)

数组转List

此方法为 Arrays.asList(Object...) 的安全实现

Type Parameters:

T - 数组中的对象类

Parameters:

array - 将被转换的数组

Returns:

被转换数组的列表视图

toList

public static <T> List<T> toList(com.alibaba.fastjson.JSONArray jsonArray,
                                 Class<T> clazz)

JSONArray 转 List-Class

Type Parameters:

T - 泛型

Parameters:

jsonArray - 需要转换的JSONArray

clazz - json转换的POJO类型

Returns:

转换后的List

toList

public static <T> List<T> toList(List<com.alibaba.fastjson.JSONObject> list,
                                 Class<T> clazz)

List-JSONObject 转 List-Class

Type Parameters:

T - 泛型

Parameters:

list - 需要转换的List

clazz - json转换的POJO类型

Returns:

转换后的List

toList

public static List<String> toList(List<com.alibaba.fastjson.JSONObject> list,
                                  String keepKey)

List-JSONObject 转 List-String

Parameters:

list - 需要转换的List

keepKey - 保留值的key

Returns:

转换后的List

toList

public static <T> List<T> toList(List<com.alibaba.fastjson.JSONObject> list,
                                 String keepKey,
                                 Class<T> clazz)

List-JSONObject 转 List-Class

Type Parameters:

T - 泛型

Parameters:

list - 需要转换的List

keepKey - 保留值的key

clazz - 类型

Returns:

转换后的List

toListAndDistinct

public static List<String> toListAndDistinct(List<com.alibaba.fastjson.JSONObject> list,
                                             String keepKey)

List - JSONObject 转 List - String 并去除重复元素

Parameters:

list - 需要转换的List

keepKey - 保留值的key

Returns:

处理后的List

toListAndDistinct

public static <T> List<T> toListAndDistinct(List<com.alibaba.fastjson.JSONObject> list,
                                            String keepKey,
                                            Class<T> clazz)

List-JSONObject 转 List-Class 并去除重复元素

Type Parameters:

T - 泛型

Parameters:

list - 需要转换的List

keepKey - 保留值的key

clazz - 类型

Returns:

处理后的List

toJsonList

public static List<com.alibaba.fastjson.JSONObject> toJsonList(List<Map<String,Object>> list)

List - Map 转 List - JSONObject

性能测试说明：
测试CPU：i7-4710MQ
测试结果：百万级数据平均200ms（毫秒）

Parameters:

list - 需要转换的List

Returns:

转换后的List

toJsonList

public static List<com.alibaba.fastjson.JSONObject> toJsonList(com.alibaba.fastjson.JSONArray jsonArray)

JSONArray 转 List - JSONObject

性能测试报告：
无类型转换（类型推断）：见 toJsonList(List)
安全模式强制类型转换：暂未测试

Parameters:

jsonArray - 需要转换的JSONArray

Returns:

转换后的jsonList

toJsonListT

public static <T> List<com.alibaba.fastjson.JSONObject> toJsonListT(List<T> list)

List - Class 转 List - JSONObject

性能测试报告：
安全模式强制类型转换：暂未测试

Type Parameters:

T - 泛型

Parameters:

list - 需要转换的List

Returns:

转换后的jsonList

toJsons

public static com.alibaba.fastjson.JSONObject[] toJsons(com.alibaba.fastjson.JSONArray jsonArray)

JSONArray 转 JSONObject[]

对象引用转换，内存指针依旧指向元数据

Parameters:

jsonArray - 需要转换的JSONArray

Returns:

转换后的jsons

toJsons

public static com.alibaba.fastjson.JSONObject[] toJsons(List<com.alibaba.fastjson.JSONObject> list)

List-JSONObject 转 JSONObject[]

对象引用转换，内存指针依旧指向元数据

Parameters:

list - 需要转换的List

Returns:

转换后的jsons

toJsonsT

public static <T> com.alibaba.fastjson.JSONObject[] toJsonsT(List<T> list)

List - Class 转 JSONObject[]

性能测试报告：
安全模式强制类型转换：暂未测试

Type Parameters:

T - 泛型

Parameters:

list - 需要转换的List

Returns:

转换后的jsons

toJsonsTAndRemoveEmpty

public static <T> com.alibaba.fastjson.JSONObject[] toJsonsTAndRemoveEmpty(List<T> list)

List - Class 转 JSONObject[] 并移除空对象

性能测试报告：
安全模式强制类型转换：暂未测试

Type Parameters:

T - 泛型

Parameters:

list - 需要转换的List

Returns:

转换后的jsons

toJsons

public static com.alibaba.fastjson.JSONObject[] toJsons(String jsonString)

String 转 JSONObject[]

Parameters:

jsonString - 需要转换的JSON字符串

Returns:

JSON数组

toJsons

public static com.alibaba.fastjson.JSONObject[] toJsons(String text,
                                                        String regex,
                                                        String key)

String 转 JSONObject[]

示例：

        
 		String text = "1,3,5,9";
 		JSONObject[] jsons = toJsons(text, ",", "id");
 		System.out.println(Arrays.toString(jsons));
 
 

结果： [{"id":"1"}, {"id":"3"}, {"id":"5"}, {"id":"9"}]

Parameters:

text - 需要转换的文本

regex - 文本分割表达式，同String类的split()方法

key - JSON的key名称

Returns:

转换后的jsons

toSnakeCaseJsonList

public static List<com.alibaba.fastjson.JSONObject> toSnakeCaseJsonList(List<com.alibaba.fastjson.JSONObject> list)

JsonList属性命名策略转换-下划线命名法

Parameters:

list - 需要转换的jsonList

Returns:

转换后的jsonList

toSnakeCaseJsonListT

public static <T> List<com.alibaba.fastjson.JSONObject> toSnakeCaseJsonListT(List<T> list)

JsonList属性命名策略转换-下划线命名法

Type Parameters:

T - 泛型

Parameters:

list - 需要转换的List

Returns:

转换后的jsonList

toUnderlineCaseJsonList

public static List<com.alibaba.fastjson.JSONObject> toUnderlineCaseJsonList(List<com.alibaba.fastjson.JSONObject> list)

JsonList属性命名策略转换-下划线命名法

Parameters:

list - 需要转换的jsonList

Returns:

转换后的jsonList

toUnderlineCaseJsonListT

public static <T> List<com.alibaba.fastjson.JSONObject> toUnderlineCaseJsonListT(List<T> list)

JsonList属性命名策略转换-下划线命名法

Type Parameters:

T - 泛型

Parameters:

list - 需要转换的List

Returns:

转换后的jsonList

toCamelCaseJsonList

public static List<com.alibaba.fastjson.JSONObject> toCamelCaseJsonList(List<com.alibaba.fastjson.JSONObject> list)

JsonList属性命名策略转换-驼峰命名法

Parameters:

list - 需要转换的jsonList

Returns:

转换后的jsonList

toCamelCaseJsonListT

public static <T> List<com.alibaba.fastjson.JSONObject> toCamelCaseJsonListT(List<T> list)

JsonList属性命名策略转换-驼峰命名法

Type Parameters:

T - 泛型

Parameters:

list - 需要转换的List

Returns:

转换后的jsonList