Class SeqUtil
java.lang.Object
com.sure.tool.collection.SeqUtil
Sequenced 集合工具类(JDK 21
SequencedCollection / SequencedMap)。
提供首尾安全访问、倒序快照、不可变前置/追加等能力; Guava / Hutool / Apache Commons 均无等价实现。
- Since:
- 1.1.0
-
Method Summary
Modifier and TypeMethodDescriptionstatic <K,V> Map.Entry <K, V> firstEntryOrNull(Map<K, V> map) 安全取有序 Map 的首条目。static <K,V> K firstKeyOrNull(Map<K, V> map) 安全取有序 Map 的首键。static <T> TfirstOrNull(Collection<T> collection) 安全取首元素。static <K,V> Map.Entry <K, V> lastEntryOrNull(Map<K, V> map) 安全取有序 Map 的尾条目。static <K,V> K lastKeyOrNull(Map<K, V> map) 安全取有序 Map 的尾键。static <T> TlastOrNull(Collection<T> collection) 安全取尾元素。static <T> List<T> reversed(Collection<T> collection) 倒序返回集合副本(快照,非视图)。static <T> List<T> withFirst(Collection<T> collection, T first) 返回「首元素 + 原集合」的不可变新列表,原集合不变。static <T> List<T> withLast(Collection<T> collection, T last) 返回「原集合 + 尾元素」的不可变新列表,原集合不变。
-
Method Details
-
reversed
倒序返回集合副本(快照,非视图)。- Type Parameters:
T- 元素类型- Parameters:
collection- 输入集合,可为空- Returns:
- 倒序的不可变列表;输入为空时返回空列表
-
firstOrNull
安全取首元素。- Type Parameters:
T- 元素类型- Parameters:
collection- 输入集合,可为空- Returns:
- 首元素;空集合返回
null
-
lastOrNull
安全取尾元素。- Type Parameters:
T- 元素类型- Parameters:
collection- 输入集合,可为空- Returns:
- 尾元素;空集合返回
null
-
withFirst
返回「首元素 + 原集合」的不可变新列表,原集合不变。- Type Parameters:
T- 元素类型- Parameters:
collection- 输入集合,可为空first- 前置元素- Returns:
- 不可变列表
-
withLast
返回「原集合 + 尾元素」的不可变新列表,原集合不变。- Type Parameters:
T- 元素类型- Parameters:
collection- 输入集合,可为空last- 追加元素- Returns:
- 不可变列表
-
firstKeyOrNull
安全取有序 Map 的首键。- Type Parameters:
K- 键类型V- 值类型- Parameters:
map- 输入 Map,可为空- Returns:
- 首键;空 Map 返回
null
-
lastKeyOrNull
安全取有序 Map 的尾键。- Type Parameters:
K- 键类型V- 值类型- Parameters:
map- 输入 Map,可为空- Returns:
- 尾键;空 Map 返回
null
-
firstEntryOrNull
-
lastEntryOrNull
-