Class SeqUtil

java.lang.Object
com.sure.tool.collection.SeqUtil

public final class SeqUtil extends Object
Sequenced 集合工具类(JDK 21 SequencedCollection / SequencedMap)。

提供首尾安全访问、倒序快照、不可变前置/追加等能力; Guava / Hutool / Apache Commons 均无等价实现。

Since:
1.1.0
  • Method Details

    • reversed

      public static <T> List<T> reversed(Collection<T> collection)
      倒序返回集合副本(快照,非视图)。
      Type Parameters:
      T - 元素类型
      Parameters:
      collection - 输入集合,可为空
      Returns:
      倒序的不可变列表;输入为空时返回空列表
    • firstOrNull

      public static <T> T firstOrNull(Collection<T> collection)
      安全取首元素。
      Type Parameters:
      T - 元素类型
      Parameters:
      collection - 输入集合,可为空
      Returns:
      首元素;空集合返回 null
    • lastOrNull

      public static <T> T lastOrNull(Collection<T> collection)
      安全取尾元素。
      Type Parameters:
      T - 元素类型
      Parameters:
      collection - 输入集合,可为空
      Returns:
      尾元素;空集合返回 null
    • withFirst

      public static <T> List<T> withFirst(Collection<T> collection, T first)
      返回「首元素 + 原集合」的不可变新列表,原集合不变。
      Type Parameters:
      T - 元素类型
      Parameters:
      collection - 输入集合,可为空
      first - 前置元素
      Returns:
      不可变列表
    • withLast

      public static <T> List<T> withLast(Collection<T> collection, T last)
      返回「原集合 + 尾元素」的不可变新列表,原集合不变。
      Type Parameters:
      T - 元素类型
      Parameters:
      collection - 输入集合,可为空
      last - 追加元素
      Returns:
      不可变列表
    • firstKeyOrNull

      public static <K,V> K firstKeyOrNull(Map<K,V> map)
      安全取有序 Map 的首键。
      Type Parameters:
      K - 键类型
      V - 值类型
      Parameters:
      map - 输入 Map,可为空
      Returns:
      首键;空 Map 返回 null
    • lastKeyOrNull

      public static <K,V> K lastKeyOrNull(Map<K,V> map)
      安全取有序 Map 的尾键。
      Type Parameters:
      K - 键类型
      V - 值类型
      Parameters:
      map - 输入 Map,可为空
      Returns:
      尾键;空 Map 返回 null
    • firstEntryOrNull

      public static <K,V> Map.Entry<K,V> firstEntryOrNull(Map<K,V> map)
      安全取有序 Map 的首条目。
      Type Parameters:
      K - 键类型
      V - 值类型
      Parameters:
      map - 输入 Map,可为空
      Returns:
      首条目;空 Map 返回 null
    • lastEntryOrNull

      public static <K,V> Map.Entry<K,V> lastEntryOrNull(Map<K,V> map)
      安全取有序 Map 的尾条目。
      Type Parameters:
      K - 键类型
      V - 值类型
      Parameters:
      map - 输入 Map,可为空
      Returns:
      尾条目;空 Map 返回 null