ListUtil (vjkit 1.0.8 API)

java.lang.Object
- com.vip.vjtools.vjkit.collection.ListUtil

```
public class ListUtil
extends Object
```
关于List的工具集合. 1. 常用函数(如是否为空，sort/binarySearch/shuffle/reverse(via JDK Collection) 2. 各种构造函数(from guava and JDK Collection) 3. 各种扩展List类型的创建函数 5. 集合运算：交集，并集, 差集, 补集，from Commons Collection，但对其不合理的地方做了修正

Constructor Summary

Constructors
Constructor and Description

ListUtil()

Constructors
Constructor and Description
`ListUtil()`

Method Summary

Methods
Modifier and Type	Method and Description
`static <T> int`	`binarySearch(List<? extends Comparable<? super T>> sortedList, T key)` 二分法快速查找对象, 使用Comparable对象自身的比较.
`static <T> int`	`binarySearch(List<? extends T> sortedList, T key, Comparator<? super T> c)` 二分法快速查找对象，使用Comparator.
`static <T> List<T>`	`difference(List<? extends T> list1, List<? extends T> list2)` list1, list2的差集（在list1，不在list2中的对象），产生新List.
`static <T> List<T>`	`disjoint(List<? extends T> list1, List<? extends T> list2)` list1, list2的补集（在list1或list2中，但不在交集中的对象，又叫反交集）产生新List.
`static <T> List<T>`	`emptyList()` 返回一个空的结构特殊的List，节约空间.
`static <T> List<T>`	`emptyListIfNull(List<T> list)` 如果list为null，转化为一个安全的空List.
`static <T> T`	`getFirst(List<T> list)` 获取第一个元素, 如果List为空返回 null.
`static <T> T`	`getLast(List<T> list)` 获取最后一个元素，如果List为空返回null.
`static <T> List<T>`	`intersection(List<? extends T> list1, List<? extends T> list2)` list1, list2的交集（同时在list1和list2的对象），产生新List copy from Apache Common Collection4 ListUtils，但其做了不合理的去重，因此重新改为性能较低但不去重的版本与List.retainAll()相比，考虑了的List中相同元素出现的次数, 如"a"在list1出现两次，而在list2中只出现一次，则交集里会保留一个"a".
`static boolean`	`isEmpty(List<?> list)` 判断是否为空.
`static boolean`	`isNotEmpty(List<?> list)` 判断是否不为空.
`static <T> ArrayList<T>`	`newArrayList()` Deprecated. JDK7开始已经简化
`static <T> ArrayList<T>`	`newArrayList(Iterable<T> elements)` 根据等号左边的类型，构造类型正确的ArrayList, 并初始化元素.
`static <T> ArrayList<T>`	`newArrayList(T... elements)` 根据等号左边的类型，构造类型正确的ArrayList, 并初始化元素.
`static <T> ArrayList<T>`	`newArrayListWithCapacity(int initSize)` 根据等号左边的类型，构造类型正确的ArrayList, 并初始化数组大小.
`static <T> CopyOnWriteArrayList<T>`	`newCopyOnWriteArrayList()` Deprecated. JDK7开始已经简化
`static <T> CopyOnWriteArrayList<T>`	`newCopyOnWriteArrayList(T... elements)` 根据等号左边的类型，构造类型转换的CopyOnWriteArrayList, 并初始化元素.
`static <T> LinkedList<T>`	`newLinkedList()` Deprecated. JDK7开始已经简化
`static <T> LinkedList<T>`	`newLinkedList(Iterable<? extends T> elements)` 根据等号左边的类型，构造类型正确的LinkedList.
`static <T> void`	`notNullList(List<T> list)` 清理掉List中的Null对象
`static <T> List<List<T>>`	`partition(List<T> list, int size)` List分页函数
`static <T> List<T>`	`reverse(List<T> list)` 返回一个倒转顺序访问的List，仅仅是一个倒序的View，不会实际多生成一个List
`static void`	`shuffle(List<?> list)` 随机乱序，使用默认的Random.
`static void`	`shuffle(List<?> list, Random rnd)` 随机乱序，使用传入的Random.
`static <T> List<T>`	`singletonList(T o)` 返回只含一个元素但结构特殊的List，节约空间.
`static <T extends Comparable<? super T>> void`	`sort(List<T> list)` 升序排序, 采用JDK认为最优的排序算法, 使用元素自身的compareTo()方法
`static <T> void`	`sort(List<T> list, Comparator<? super T> c)` 升序排序, 采用JDK认为最优的排序算法, 使用Comparetor.
`static <T extends Comparable<? super T>> void`	`sortReverse(List<T> list)` 倒序排序, 采用JDK认为最优的排序算法,使用元素自身的compareTo()方法
`static <T> void`	`sortReverse(List<T> list, Comparator<? super T> c)` 倒序排序, 采用JDK认为最优的排序算法, 使用Comparator
`static <T> List<T>`	`synchronizedList(List<T> list)` 返回包装后同步的List，所有方法都会被synchronized原语同步.
`static <E> List<E>`	`union(List<? extends E> list1, List<? extends E> list2)` list1,list2的并集（在list1或list2中的对象），产生新List 对比Apache Common Collection4 ListUtils, 优化了初始大小
`static <T> void`	`uniqueNotNullList(List<T> list)`
`static <T> List<T>`	`unmodifiableList(List<? extends T> list)` 返回包装后不可修改的List.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ListUtil
```
public ListUtil()
```
- Method Detail
  - isEmpty
```
public static boolean isEmpty(List<?> list)
```
    判断是否为空.
  - isNotEmpty
```
public static boolean isNotEmpty(List<?> list)
```
    判断是否不为空.
  - getFirst
```
public static <T> T getFirst(List<T> list)
```
    获取第一个元素, 如果List为空返回 null.
  - getLast
```
public static <T> T getLast(List<T> list)
```
    获取最后一个元素，如果List为空返回null.
  - newArrayList
```
@Deprecated
public static <T> ArrayList<T> newArrayList()
```
    Deprecated. JDK7开始已经简化
    
    根据等号左边的类型，构造类型正确的ArrayList.
  - newArrayList
```
public static <T> ArrayList<T> newArrayList(T... elements)
```
    根据等号左边的类型，构造类型正确的ArrayList, 并初始化元素.
    
    See Also:
    Lists.newArrayList(Object...)
  - newArrayList
```
public static <T> ArrayList<T> newArrayList(Iterable<T> elements)
```
    根据等号左边的类型，构造类型正确的ArrayList, 并初始化元素.
    
    See Also:
    Lists.newArrayList(Iterable)
  - newArrayListWithCapacity
```
public static <T> ArrayList<T> newArrayListWithCapacity(int initSize)
```
    根据等号左边的类型，构造类型正确的ArrayList, 并初始化数组大小.
    
    See Also:
    Lists.newArrayListWithCapacity(int)
  - newLinkedList
```
@Deprecated
public static <T> LinkedList<T> newLinkedList()
```
    Deprecated. JDK7开始已经简化
    
    根据等号左边的类型，构造类型正确的LinkedList.
  - newLinkedList
```
public static <T> LinkedList<T> newLinkedList(Iterable<? extends T> elements)
```
    根据等号左边的类型，构造类型正确的LinkedList.
    
    See Also:
    Lists.newLinkedList()
  - newCopyOnWriteArrayList
```
@Deprecated
public static <T> CopyOnWriteArrayList<T> newCopyOnWriteArrayList()
```
    Deprecated. JDK7开始已经简化
    
    根据等号左边的类型，构造类型正确的CopyOnWriteArrayList.
  - newCopyOnWriteArrayList
```
public static <T> CopyOnWriteArrayList<T> newCopyOnWriteArrayList(T... elements)
```
    根据等号左边的类型，构造类型转换的CopyOnWriteArrayList, 并初始化元素.
  - emptyList
```
public static final <T> List<T> emptyList()
```
    返回一个空的结构特殊的List，节约空间. 注意返回的List不可写, 写入会抛出UnsupportedOperationException.
    
    See Also:
    Collections.emptyList()
  - emptyListIfNull
```
public static <T> List<T> emptyListIfNull(List<T> list)
```
    如果list为null，转化为一个安全的空List. 注意返回的List不可写, 写入会抛出UnsupportedOperationException.
    
    See Also:
    Collections.emptyList()
  - singletonList
```
public static <T> List<T> singletonList(T o)
```
    返回只含一个元素但结构特殊的List，节约空间. 注意返回的List不可写, 写入会抛出UnsupportedOperationException.
    
    See Also:
    Collections.singletonList(Object)
  - unmodifiableList
```
public static <T> List<T> unmodifiableList(List<? extends T> list)
```
    返回包装后不可修改的List. 如果尝试写入会抛出UnsupportedOperationException.
    
    See Also:
    Collections.unmodifiableList(List)
  - synchronizedList
```
public static <T> List<T> synchronizedList(List<T> list)
```
    返回包装后同步的List，所有方法都会被synchronized原语同步. 用于CopyOnWriteArrayList与 ArrayDequeue均不符合的场景
  - sort
```
public static <T extends Comparable<? super T>> void sort(List<T> list)
```
    升序排序, 采用JDK认为最优的排序算法, 使用元素自身的compareTo()方法
    
    See Also:
    Collections.sort(List)
  - sortReverse
```
public static <T extends Comparable<? super T>> void sortReverse(List<T> list)
```
    倒序排序, 采用JDK认为最优的排序算法,使用元素自身的compareTo()方法
    
    See Also:
    Collections.sort(List)
  - sort
```
public static <T> void sort(List<T> list,
            Comparator<? super T> c)
```
    升序排序, 采用JDK认为最优的排序算法, 使用Comparetor.
    
    See Also:
    Collections.sort(List, Comparator)
  - sortReverse
```
public static <T> void sortReverse(List<T> list,
                   Comparator<? super T> c)
```
    倒序排序, 采用JDK认为最优的排序算法, 使用Comparator
    
    See Also:
    Collections.sort(List, Comparator)
  - binarySearch
```
public static <T> int binarySearch(List<? extends Comparable<? super T>> sortedList,
                   T key)
```
    二分法快速查找对象, 使用Comparable对象自身的比较. list必须已按升序排序. 如果不存在，返回一个负数，代表如果要插入这个对象，应该插入的位置
    
    See Also:
    Collections.binarySearch(List, Object)
  - binarySearch
```
public static <T> int binarySearch(List<? extends T> sortedList,
                   T key,
                   Comparator<? super T> c)
```
    二分法快速查找对象，使用Comparator. list必须已按升序排序. 如果不存在，返回一个负数，代表如果要插入这个对象，应该插入的位置
    
    See Also:
    Collections.binarySearch(List, Object, Comparator)
  - shuffle
```
public static void shuffle(List<?> list)
```
    随机乱序，使用默认的Random.
    
    See Also:
    Collections.shuffle(List)
  - shuffle
```
public static void shuffle(List<?> list,
           Random rnd)
```
    随机乱序，使用传入的Random.
    
    See Also:
    Collections.shuffle(List, Random)
  - reverse
```
public static <T> List<T> reverse(List<T> list)
```
    返回一个倒转顺序访问的List，仅仅是一个倒序的View，不会实际多生成一个List
    
    See Also:
    Lists.reverse(List)
  - partition
```
public static <T> List<List<T>> partition(List<T> list,
                          int size)
```
    List分页函数
  - notNullList
```
public static <T> void notNullList(List<T> list)
```
    清理掉List中的Null对象
  - uniqueNotNullList
```
public static <T> void uniqueNotNullList(List<T> list)
```
  - union
```
public static <E> List<E> union(List<? extends E> list1,
                List<? extends E> list2)
```
    list1,list2的并集（在list1或list2中的对象），产生新List 对比Apache Common Collection4 ListUtils, 优化了初始大小
  - intersection
```
public static <T> List<T> intersection(List<? extends T> list1,
                       List<? extends T> list2)
```
    list1, list2的交集（同时在list1和list2的对象），产生新List copy from Apache Common Collection4 ListUtils，但其做了不合理的去重，因此重新改为性能较低但不去重的版本与List.retainAll()相比，考虑了的List中相同元素出现的次数, 如"a"在list1出现两次，而在list2中只出现一次，则交集里会保留一个"a".
  - difference
```
public static <T> List<T> difference(List<? extends T> list1,
                     List<? extends T> list2)
```
    list1, list2的差集（在list1，不在list2中的对象），产生新List. 与List.removeAll()相比，会计算元素出现的次数，如"a"在list1出现两次，而在list2中只出现一次，则差集里会保留一个"a".
  - disjoint
```
public static <T> List<T> disjoint(List<? extends T> list1,
                   List<? extends T> list2)
```
    list1, list2的补集（在list1或list2中，但不在交集中的对象，又叫反交集）产生新List. copy from Apache Common Collection4 ListUtils，但其并集－交集时，初始大小没有对交集*2，所以做了修改

Class ListUtil

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ListUtil

Method Detail

isEmpty

isNotEmpty

getFirst

getLast

newArrayList

newArrayList

newArrayList

newArrayListWithCapacity

newLinkedList

newLinkedList

newCopyOnWriteArrayList

newCopyOnWriteArrayList

emptyList

emptyListIfNull

singletonList

unmodifiableList

synchronizedList

sort

sortReverse

sort

sortReverse

binarySearch

binarySearch

shuffle

shuffle

reverse

partition

notNullList

uniqueNotNullList

union

intersection

difference

disjoint