Java Class Collections

模块 java.base 软件包 java.util

java.lang.Object
	java.util.Collections
		public class Collections xtends Object

此类仅包含对集合进行操作或返回集合的静态方法。
如果提供给它们的集合或类对象为 null，则此类的方法都抛出 NullPointerException 。

对集合中的元素进行升序排序。这要求列表中的所有元素都必须实现 Comparable 接口，而且所有元素都必须是使用指定比较器可相互比较的。

void sort(List list)：根据元素的自然顺序对集合中的元素进行升序排序。
void sort(List list,Comparator comparator)：按 comparator 参数指定的排序方式对集合中的元素进行排序。

List a = new ArrayList<>();
for (int i = 0; i < 12; i++) a.add(i);
Collections.sort(a);
Collections.reverse(a); // 两者组合可以逆序排序
Collections.sort(a, Collections.reverseOrder()); // 逆序排序
Collections.sort(a, (a, b) -> b - a) // 指定排序方式，逆序排序

调用 reverse() 静态方法可以对指定集合元素进行反转。

ArrayList a = Arrays.asList(new Integer[]{2,4,8,3,4});
Collections.reverse(list); // 反转

Collections.max(a);
Collections.min(a);

static > T max​(Collection coll) 根据元素的自然顺序返回给定集合的最大元素。
static T max​(Collection coll, Comparator comp) 根据指定比较器引发的顺序返回给定集合的最大元素。
static > T min​(Collection coll) 根据元素的 自然顺序返回给定集合的最小元素。
static T min​(Collection coll, Comparator comp)
根据指定比较器引发的顺序返回给定集合的最小元素。

static void fill​(List list, T obj) 用指定的元素替换指定列表的所有元素。

static > void sort​(List list) 根据其元素的 natural ordering ，将指定列表按升序排序。
static void sort​(List list, Comparator c) 根据指定比较器引发的顺序对指定列表进行排序。
static void reverse​(List list) 反转指定列表中元素的顺序。
static Comparator reverseOrder() 返回一个比较器， Comparable实现 Comparable接口的对象集合强制执行 自然排序的 Comparable 。
static Comparator reverseOrder​(Comparator cmp) 返回一个比较器，它强制指定比较器的反向排序。
static void rotate​(List list, int distance) 按指定距离旋转指定列表中的元素。
static void swap​(List list, int i, int j) 交换指定列表中指定位置的元素。

static boolean replaceAll​(List list, T oldVal, T newVal) 用列表替换列表中所有出现的指定值。

static void shuffle​(List list) 使用默认的随机源随机置换指定的列表。
static void shuffle​(List list, Random rnd) 使用指定的随机源随机置换指定的列表。

static boolean addAll​(Collection c, T… elements) 将所有指定的元素添加到指定的集合中。
static Queue asLifoQueue​(Deque deque) 返回 Deque 的视图作为后进先出（Lifo） Queue 。
static int binarySearch​(List> list, T key) 使用二进制搜索算法在指定列表中搜索指定对象。
static int binarySearch​(List list, T key, Comparator c) 使用二进制搜索算法在指定列表中搜索指定对象。
static Collection checkedCollection​(Collection c, 类 type) 返回指定集合的动态类型安全视图。
static List checkedList​(List list, 类 type) 返回指定列表的动态类型安全视图。
static Map checkedMap​(Map m, 类 keyType, 类 valueType) 返回指定映射的动态类型安全视图。
static NavigableMap checkedNavigableMap​(NavigableMap m, 类 keyType, 类 valueType) 返回指定可导航映射的动态类型安全视图。
static NavigableSet checkedNavigableSet​(NavigableSet s, 类 type) 返回指定可导航集的动态类型安全视图。
static Queue checkedQueue​(Queue queue, 类 type) 返回指定队列的动态类型安全视图。
static Set checkedSet​(Set s, 类 type) 返回指定集的动态类型安全视图。
static SortedMap checkedSortedMap​(SortedMap m, 类 keyType, 类 valueType) 返回指定有序映射的动态类型安全视图。
static SortedSet checkedSortedSet​(SortedSet s, 类 type) 返回指定有序集的动态类型安全视图。
static void copy​(List dest, List src) 将一个列表中的所有元素复制到另一个列表中。
static boolean disjoint​(Collection c1, Collection c2) 如果两个指定的集合没有共同的元素，则返回 true 。
static Enumeration emptyEnumeration() 返回没有元素的枚举。
static Iterator emptyIterator() 返回没有元素的迭代器。
static List emptyList() 返回一个空列表（不可变）。
static ListIterator emptyListIterator() 返回没有元素的列表迭代器。
static Map emptyMap() 返回一个空映射（不可变）。
static NavigableMap emptyNavigableMap() 返回一个空的可导航地图（不可变）。
static NavigableSet emptyNavigableSet() 返回一个空的可导航集（不可变）。
static Set emptySet() 返回一个空集（不可变）。
static SortedMap emptySortedMap() 返回一个空的有序映射（不可变）。
static SortedSet emptySortedSet() 返回一个空的有序集（不可变）。
static Enumeration enumeration​(Collection c) 返回指定集合的枚举。
static int frequency​(Collection c, Object o) 返回指定集合中等于指定对象的元素数。
static int indexOfSubList​(List source, List target) 返回指定源列表中第一次出现的指定目标列表的起始位置，如果不存在，则返回-1。
static int lastIndexOfSubList​(List source, List target) 返回指定源列表中指定目标列表最后一次出现的起始位置，如果不存在，则返回-1。
static ArrayList list​(Enumeration e) 返回一个数组列表，其中包含指定枚举返回的元素，这些元素按枚举返回的顺序排列。
static List nCopies​(int n, T o) 返回由指定对象的 n副本组成的不可变列表。
static Set newSetFromMap​(Map map) 返回由指定映射支持的集合。
static Set singleton​(T o) 返回仅包含指定对象的不可变集。
static List singletonList​(T o) 返回仅包含指定对象的不可变列表。
static Map singletonMap​(K key, V value) 返回不可变映射，仅将指定键映射到指定值。
static Collection synchronizedCollection​(Collection c) 返回由指定集合支持的同步（线程安全）集合。
static List synchronizedList​(List list) 返回由指定列表支持的同步（线程安全）列表。
static Map synchronizedMap​(Map m) 返回由指定映射支持的同步（线程安全）映射。
static NavigableMap synchronizedNavigableMap​(NavigableMap m) 返回由指定的可导航映射支持的同步（线程安全）可导航映射。
static NavigableSet synchronizedNavigableSet​(NavigableSet s) 返回由指定的可导航集支持的同步（线程安全）可导航集。
static Set synchronizedSet​(Set s) 返回由指定集支持的同步（线程安全）集。
static SortedMap synchronizedSortedMap​(SortedMap m) 返回由指定的有序映射支持的同步（线程安全）有序映射。
static SortedSet synchronizedSortedSet​(SortedSet s) 返回由指定有序集支持的同步（线程安全）有序集。
static Collection unmodifiableCollection​(Collection c) 返回指定集合的 unmodifiable view 。
static List unmodifiableList​(List list) 返回指定列表的 unmodifiable view 。
static Map unmodifiableMap​(Map m) 返回指定映射的 unmodifiable view 。
static NavigableMap unmodifiableNavigableMap​(NavigableMap m) 返回指定的可导航地图的 unmodifiable view 。
static NavigableSet unmodifiableNavigableSet​(NavigableSet s) 返回指定的可导航集的 unmodifiable view 。
static Set unmodifiableSet​(Set s) 返回指定集的 unmodifiable view 。
static SortedMap unmodifiableSortedMap​(SortedMap m) 返回指定有序映射的 unmodifiable view 。
static SortedSet unmodifiableSortedSet​(SortedSet s) 返回指定有序集的 unmodifiable view 。