Class ListUtil
java.lang.Object
com.sure.tool.collection.ListUtil
列表工具类,参考 Hutool 的
ListUtil 设计。
English: List-specific helpers such as partitioning, splitting and safe indexing.
- Since:
- 0.1.0
- Author:
- suretool
-
Method Summary
Modifier and TypeMethodDescriptionstatic double数值均值(null 元素跳过;空或全 null 返回 0.0)。cartesianProduct(List<? extends List<? extends T>> lists) 任意维度笛卡尔积(对齐 GuavaLists.cartesianProduct)。均分块:按固定大小切分为多个子列表(与partition(List, int)同语义,别名友好)。combinations(List<T> list, int k) k 元素组合(对齐 GuavaSets.combinations的列表版)。static <T> List<T> 拼接多个列表(对齐 GuavaIterables.concat,null 列表跳过)。static <T> List<T> 拼接两个列表(对齐 GuavaLists.concat)。static <T> List<T> 去重并保持原有顺序(首个出现位置保留)。static <T> List<T> 过滤:仅保留满足谓词的元素(保序)。static <T,R> List <R> 扁平映射:将每个元素展开为其子列表并依次拼接,内层 null 列表跳过。static <T> T越界安全取值:索引越界时返回null,负数从尾部定位(-1 表示末尾元素)。static <T> List<T> intersection(List<T> left, List<T> right) 交集(保序去重):按左列表出现顺序。static boolean列表是否为空。static booleanisNotEmpty(List<?> list) 列表是否非空。static <T,R> List <R> 映射:对每个元素应用函数生成新列表。static <T extends Comparable<? super T>>
T自然序最大值(空列表抛NoSuchElementException)。static <T> Tmax(List<T> list, Comparator<? super T> comparator) 按比较器取最大值(空列表抛NoSuchElementException)。static <T extends Comparable<? super T>>
T自然序最小值(空列表抛NoSuchElementException)。static <T> Tmin(List<T> list, Comparator<? super T> comparator) 按比较器取最小值(空列表抛NoSuchElementException)。static <T> List<T> 元素移动到新下标(其余元素顺移,与List.move语义一致)。static <T> List<T> 分页截取:返回第 pageIndex 页(从 0 开始)的 pageSize 条数据。列表切分:按固定大小切分为多个子列表。permutations(List<T> list) 全排列(对齐 GuavaCollections2.permutations)。static <T> List<T> 反转列表(原地)。static <T> List<T> reverseNew(List<T> list) 反转列表(返回新列表,不影响原列表)。static <T> List<T> 随机取样:返回不重复的 count 个元素(保原顺序的随机子集);count 不小于列表大小时返回全量洗牌副本。static <T> List<T> 原地洗牌(Fisher-Yates,可注入随机源)。static <T> List<T> shuffleCopy(List<T> list, Random random) 洗牌副本:返回洗牌后的新列表,原列表不变。static <T> List<T> 截取子列表。static <T> List<T> subListSafe(List<T> list, int fromIndex, int toIndex) 越界安全截取:起始与结束下标被钳制到合法范围,起始大于结束时返回空列表。static <T> List<T> 差集(保序去重):左列表中不在右列表的元素。static long数值求和(null 元素跳过;空或全 null 返回 0)。static <T> List<T> toList(T... values) 创建列表。static <T> List<T> 并集(保序去重):先左后右,右侧重复元素不追加。两列表按最短长度配对(zip),返回不可变二元组列表。
-
Method Details
-
toList
创建列表。- Type Parameters:
T- 元素类型- Parameters:
values- 元素- Returns:
- 列表
-
partition
-
page
-
sub
-
reverse
-
reverseNew
-
isEmpty
-
isNotEmpty
-
get
越界安全取值:索引越界时返回null,负数从尾部定位(-1 表示末尾元素)。- Type Parameters:
T- 元素类型- Parameters:
list- 列表(null 返回 null)index- 下标(支持负数尾部定位)- Returns:
- 对应元素,越界或列表为 null 时返回 null
- Since:
- 1.16.0
-
subListSafe
-
distinct
-
map
映射:对每个元素应用函数生成新列表。- Type Parameters:
T- 元素类型R- 结果类型- Parameters:
list- 列表(null 返回空列表)mapper- 映射函数(null 时抛NullPointerException)- Returns:
- 映射后的新列表
- Since:
- 1.16.0
-
filter
过滤:仅保留满足谓词的元素(保序)。- Type Parameters:
T- 元素类型- Parameters:
list- 列表(null 返回空列表)predicate- 过滤谓词(null 时抛NullPointerException)- Returns:
- 过滤后的新列表
- Since:
- 1.16.0
-
flatMap
扁平映射:将每个元素展开为其子列表并依次拼接,内层 null 列表跳过。- Type Parameters:
T- 元素类型R- 结果元素类型- Parameters:
list- 列表(null 返回空列表)mapper- 展开函数(null 时抛NullPointerException)- Returns:
- 扁平化后的新列表
- Since:
- 1.16.0
-
zip
-
shuffle
-
shuffleCopy
-
sample
-
chunk
均分块:按固定大小切分为多个子列表(与partition(List, int)同语义,别名友好)。- Type Parameters:
T- 元素类型- Parameters:
list- 列表(null 返回空)size- 每块大小(<=0 抛IllegalArgumentException)- Returns:
- 分块结果
- Since:
- 1.16.0
-
union
-
intersection
-
subtract
-
min
自然序最小值(空列表抛NoSuchElementException)。- Type Parameters:
T- 元素类型- Parameters:
list- 列表- Returns:
- 最小元素
- Since:
- 1.16.0
-
max
自然序最大值(空列表抛NoSuchElementException)。- Type Parameters:
T- 元素类型- Parameters:
list- 列表- Returns:
- 最大元素
- Since:
- 1.16.0
-
min
按比较器取最小值(空列表抛NoSuchElementException)。- Type Parameters:
T- 元素类型- Parameters:
list- 列表comparator- 比较器- Returns:
- 最小元素
- Since:
- 1.16.0
-
max
按比较器取最大值(空列表抛NoSuchElementException)。- Type Parameters:
T- 元素类型- Parameters:
list- 列表comparator- 比较器- Returns:
- 最大元素
- Since:
- 1.16.0
-
sum
-
average
-
move
元素移动到新下标(其余元素顺移,与List.move语义一致)。- Type Parameters:
T- 元素类型- Parameters:
list- 列表from- 原下标(越界抛IndexOutOfBoundsException)to- 目标下标- Returns:
- 操作后的同一列表
- Since:
- 1.16.0
-
cartesianProduct
任意维度笛卡尔积(对齐 GuavaLists.cartesianProduct)。返回所有维度组合:
[[1,2],[a,b]] -> [[1,a],[1,b],[2,a],[2,b]]; 任一维度为空集合时结果为空;输入列表本身为空时结果含一个空组合。- Type Parameters:
T- 元素类型- Parameters:
lists- 维度集合列表(外层为维度,内层为该维度取值),可为null- Returns:
- 笛卡尔积列表;
null返回null - Since:
- 1.19.0
-
permutations
-
combinations
k 元素组合(对齐 GuavaSets.combinations的列表版)。combinations([1,2,3], 2) -> [[1,2],[1,3],[2,3]];k=0 返回含空组合; k=n 返回原列表。k 越界(<0 或 >n)抛IllegalArgumentException。- Type Parameters:
T- 元素类型- Parameters:
list- 列表,可为nullk- 组合大小- Returns:
- 组合列表集合;
null返回null - Since:
- 1.19.0
-
concat
-
concat
拼接多个列表(对齐 GuavaIterables.concat,null 列表跳过)。- Type Parameters:
T- 元素类型- Parameters:
lists- 列表数组,可为null- Returns:
- 拼接后的不可变列表;
null返回空列表 - Since:
- 1.19.0
-