ComparatorChain (ujava

java.lang.Object
- cn.ujava.common.comparator.ComparatorChain<E>

Type Parameters:

E - 被比较的对象

All Implemented Interfaces:

Chain<Comparator<E>,ComparatorChain<E>>, Serializable, Iterable<Comparator<E>>, Comparator<E>
```
public class ComparatorChain<E>
extends Object
implements Chain<Comparator<E>,ComparatorChain<E>>, Comparator<E>, Serializable
```
比较器链。此链包装了多个比较器，最终比较结果按照比较器顺序综合多个比较器结果。
按照比较器链的顺序分别比较，如果比较出相等则转向下一个比较器，否则直接返回
此类copy from Apache-commons-collections

Author:

ujava

Since:

3.0.7

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`ComparatorChain()` 构造空的比较器链，必须至少有一个比较器，否则会在compare时抛出`UnsupportedOperationException`
`ComparatorChain(Comparator<E> comparator)` 构造，初始化单一比较器。比较器为正序
`ComparatorChain(Comparator<E> comparator, boolean reverse)` 构造，初始化单一比较器。自定义正序还是反序
`ComparatorChain(List<Comparator<E>> list)` 构造，使用已有的比较器列表
`ComparatorChain(List<Comparator<E>> list, BitSet bits)` 构造，使用已有的比较器列表和对应的BitSet BitSet中的boolean值需与list中的`Comparator`一一对应，true表示正序，false反序

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`ComparatorChain<E>`	`addChain(Comparator<E> element)` 加入责任链
`ComparatorChain<E>`	`addComparator(Comparator<E> comparator)` 在链的尾部添加比较器，使用正向排序
`ComparatorChain<E>`	`addComparator(Comparator<E> comparator, boolean reverse)` 在链的尾部添加比较器，使用给定排序方式
`int`	`compare(E o1, E o2)` 执行比较按照比较器链的顺序分别比较，如果比较出相等则转向下一个比较器，否则直接返回
`boolean`	`equals(Object object)`
`int`	`hashCode()`
`boolean`	`isLocked()` 是否已经被锁定。当开始比较时（调用compare方法）此值为true
`Iterator<Comparator<E>>`	`iterator()`
`static <E> ComparatorChain<E>`	`of(Comparator<E>... comparators)` 构建 `ComparatorChain`
`static <E> ComparatorChain<E>`	`of(Comparator<E> comparator)` 构建 `ComparatorChain`
`static <E> ComparatorChain<E>`	`of(Comparator<E> comparator, boolean reverse)` 构建 `ComparatorChain`
`static <E> ComparatorChain<E>`	`of(List<Comparator<E>> comparators)` 构建 `ComparatorChain`
`static <E> ComparatorChain<E>`	`of(List<Comparator<E>> comparators, BitSet bits)` 构建 `ComparatorChain`
`ComparatorChain<E>`	`setComparator(int index, Comparator<E> comparator)` 替换指定位置的比较器，保持原排序方式
`ComparatorChain<E>`	`setComparator(int index, Comparator<E> comparator, boolean reverse)` 替换指定位置的比较器，替换指定排序方式
`ComparatorChain<E>`	`setForwardSort(int index)` 更改指定位置的排序方式为正序
`ComparatorChain<E>`	`setReverseSort(int index)` 更改指定位置的排序方式为反序
`int`	`size()` 比较器链中比较器个数

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

Methods inherited from interface java.lang.Iterable
forEach, spliterator

Methods inherited from interface java.util.Comparator
comparing, comparing, comparingDouble, comparingInt, comparingLong, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

- Constructor Detail
  - ComparatorChain
```
public ComparatorChain()
```
    构造空的比较器链，必须至少有一个比较器，否则会在compare时抛出UnsupportedOperationException
  - ComparatorChain
```
public ComparatorChain(Comparator<E> comparator)
```
    构造，初始化单一比较器。比较器为正序
    
    Parameters:
    
    comparator - 在比较器链中的第一个比较器
  - ComparatorChain
```
public ComparatorChain(Comparator<E> comparator,
                       boolean reverse)
```
    构造，初始化单一比较器。自定义正序还是反序
    
    Parameters:
    
    comparator - 在比较器链中的第一个比较器
    
    reverse - 是否反序，true表示反序，false正序
  - ComparatorChain
```
public ComparatorChain(List<Comparator<E>> list)
```
    构造，使用已有的比较器列表
    
    Parameters:
    
    list - 比较器列表
    
    See Also:
    
    ComparatorChain(List, BitSet)
  - ComparatorChain
```
public ComparatorChain(List<Comparator<E>> list,
                       BitSet bits)
```
    构造，使用已有的比较器列表和对应的BitSet
    BitSet中的boolean值需与list中的Comparator一一对应，true表示正序，false反序
    
    Parameters:
    
    list - Comparator 列表
    
    bits - Comparator 列表对应的排序boolean值，true表示正序，false反序
- Method Detail
  - of
```
public static <E> ComparatorChain<E> of(Comparator<E> comparator)
```
    构建 ComparatorChain
    
    Type Parameters:
    
    E - 被比较对象类型
    
    Parameters:
    
    comparator - 比较器
    
    Returns:
    
    ComparatorChain
    
    Since:
    
    5.4.3
  - of
```
public static <E> ComparatorChain<E> of(Comparator<E> comparator,
                                        boolean reverse)
```
    构建 ComparatorChain
    
    Type Parameters:
    
    E - 被比较对象类型
    
    Parameters:
    
    comparator - 比较器
    
    reverse - 是否反向
    
    Returns:
    
    ComparatorChain
    
    Since:
    
    5.4.3
  - of
```
@SafeVarargs
public static <E> ComparatorChain<E> of(Comparator<E>... comparators)
```
    构建 ComparatorChain
    
    Type Parameters:
    
    E - 被比较对象类型
    
    Parameters:
    
    comparators - 比较器数组
    
    Returns:
    
    ComparatorChain
    
    Since:
    
    5.4.3
  - of
```
public static <E> ComparatorChain<E> of(List<Comparator<E>> comparators)
```
    构建 ComparatorChain
    
    Type Parameters:
    
    E - 被比较对象类型
    
    Parameters:
    
    comparators - 比较器列表
    
    Returns:
    
    ComparatorChain
    
    Since:
    
    5.4.3
  - of
```
public static <E> ComparatorChain<E> of(List<Comparator<E>> comparators,
                                        BitSet bits)
```
    构建 ComparatorChain
    
    Type Parameters:
    
    E - 被比较对象类型
    
    Parameters:
    
    comparators - 比较器列表
    
    bits - Comparator 列表对应的排序boolean值，true表示正序，false反序
    
    Returns:
    
    ComparatorChain
    
    Since:
    
    5.4.3
  - addComparator
```
public ComparatorChain<E> addComparator(Comparator<E> comparator)
```
    在链的尾部添加比较器，使用正向排序
    
    Parameters:
    
    comparator - Comparator 比较器，正向
    
    Returns:
    
    this
  - addComparator
```
public ComparatorChain<E> addComparator(Comparator<E> comparator,
                                        boolean reverse)
```
    在链的尾部添加比较器，使用给定排序方式
    
    Parameters:
    
    comparator - Comparator 比较器
    
    reverse - 是否反序，true表示正序，false反序
    
    Returns:
    
    this
  - setComparator
```
public ComparatorChain<E> setComparator(int index,
                                        Comparator<E> comparator)
                                 throws IndexOutOfBoundsException
```
    替换指定位置的比较器，保持原排序方式
    
    Parameters:
    
    index - 位置
    
    comparator - Comparator
    
    Returns:
    
    this
    
    Throws:
    
    IndexOutOfBoundsException - if index < 0 or index >= size()
  - setComparator
```
public ComparatorChain<E> setComparator(int index,
                                        Comparator<E> comparator,
                                        boolean reverse)
```
    替换指定位置的比较器，替换指定排序方式
    
    Parameters:
    
    index - 位置
    
    comparator - Comparator
    
    reverse - 是否反序，true表示正序，false反序
    
    Returns:
    
    this
  - setForwardSort
```
public ComparatorChain<E> setForwardSort(int index)
```
    更改指定位置的排序方式为正序
    
    Parameters:
    
    index - 位置
    
    Returns:
    
    this
  - setReverseSort
```
public ComparatorChain<E> setReverseSort(int index)
```
    更改指定位置的排序方式为反序
    
    Parameters:
    
    index - 位置
    
    Returns:
    
    this
  - size
```
public int size()
```
    比较器链中比较器个数
    
    Returns:
    
    Comparator count
  - isLocked
```
public boolean isLocked()
```
    是否已经被锁定。当开始比较时（调用compare方法）此值为true
    
    Returns:
    
    true = ComparatorChain cannot be modified; false = ComparatorChain can still be modified.
  - iterator
```
public Iterator<Comparator<E>> iterator()
```
    Specified by:
    
    iterator in interface Iterable<Comparator<E>>
  - addChain
```
public ComparatorChain<E> addChain(Comparator<E> element)
```
    Description copied from interface: Chain
    
    加入责任链
    
    Specified by:
    
    addChain in interface Chain<Comparator<E>,ComparatorChain<E>>
    
    Parameters:
    
    element - 责任链新的环节元素
    
    Returns:
    
    this
  - compare
```
public int compare(E o1,
                   E o2)
            throws UnsupportedOperationException
```
    执行比较
    按照比较器链的顺序分别比较，如果比较出相等则转向下一个比较器，否则直接返回
    
    Specified by:
    
    compare in interface Comparator<E>
    
    Parameters:
    
    o1 - 第一个对象
    
    o2 - 第二个对象
    
    Returns:
    
    -1, 0, or 1
    
    Throws:
    
    UnsupportedOperationException - 如果比较器链为空，无法完成比较
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object object)
```
    Specified by:
    
    equals in interface Comparator<E>
    
    Overrides:
    
    equals in class Object

Class ComparatorChain<E>

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

Methods inherited from interface java.util.Comparator

Constructor Detail

ComparatorChain

ComparatorChain

ComparatorChain

ComparatorChain

ComparatorChain

Method Detail

of

of

of

of

of

addComparator

addComparator

setComparator

setComparator

setForwardSort

setReverseSort

size

isLocked

iterator

addChain

compare

hashCode

equals