CompareChain (bus-core 6.3.5 API)

java.lang.Object
- org.aoju.bus.core.compare.CompareChain<E>

All Implemented Interfaces:

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

Since:

JDK 1.8+

Version:

6.3.5

Author:

Kimi Liu

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`CompareChain()` 构造空的比较器链,必须至少有一个比较器,否则会在compare时抛出`UnsupportedOperationException`
`CompareChain(Comparator<E> comparator)` 构造,初始化单一比较器比较器为正序
`CompareChain(Comparator<E> comparator, boolean reverse)` 构造,初始化单一比较器自定义正序还是反序
`CompareChain(List<Comparator<E>> list)` 构造,使用已有的比较器列表
`CompareChain(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
`CompareChain<E>`	`addChain(Comparator<E> element)` 加入责任链
`CompareChain<E>`	`addComparator(Comparator<E> comparator)` 在链的尾部添加比较器,使用正向排序
`CompareChain<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> CompareChain<E>`	`of(Comparator<E>... comparators)` 构建 `CompareChain`
`static <E> CompareChain<E>`	`of(Comparator<E> comparator)` 构建 `CompareChain`
`static <E> CompareChain<E>`	`of(Comparator<E> comparator, boolean reverse)` 构建 `CompareChain`
`static <E> CompareChain<E>`	`of(List<Comparator<E>> comparators)` 构建 `CompareChain`
`static <E> CompareChain<E>`	`of(List<Comparator<E>> comparators, BitSet bits)` 构建 `CompareChain`
`CompareChain<E>`	`setComparator(int index, Comparator<E> comparator)` 替换指定位置的比较器,保持原排序方式
`CompareChain<E>`	`setComparator(int index, Comparator<E> comparator, boolean reverse)` 替换指定位置的比较器,替换指定排序方式
`CompareChain<E>`	`setForwardSort(int index)` 更改指定位置的排序方式为正序
`CompareChain<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
  - CompareChain
```
public CompareChain()
```
    构造空的比较器链,必须至少有一个比较器,否则会在compare时抛出UnsupportedOperationException
  - CompareChain
```
public CompareChain(Comparator<E> comparator)
```
    构造,初始化单一比较器比较器为正序
    
    Parameters:
    
    comparator - 在比较器链中的第一个比较器
  - CompareChain
```
public CompareChain(Comparator<E> comparator,
                    boolean reverse)
```
    构造,初始化单一比较器自定义正序还是反序
    
    Parameters:
    
    comparator - 在比较器链中的第一个比较器
    
    reverse - 是否反序,true表示反序,false正序
  - CompareChain
```
public CompareChain(List<Comparator<E>> list)
```
    构造,使用已有的比较器列表
    
    Parameters:
    
    list - 比较器列表
    
    See Also:
    
    CompareChain(List, BitSet)
  - CompareChain
```
public CompareChain(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> CompareChain<E> of(Comparator<E> comparator)
```
    构建 CompareChain
    
    Type Parameters:
    
    E - 被比较对象类型
    
    Parameters:
    
    comparator - 比较器
    
    Returns:
    
    CompareChain
  - of
```
public static <E> CompareChain<E> of(Comparator<E> comparator,
                                     boolean reverse)
```
    构建 CompareChain
    
    Type Parameters:
    
    E - 被比较对象类型
    
    Parameters:
    
    comparator - 比较器
    
    reverse - 是否反向
    
    Returns:
    
    CompareChain
  - of
```
public static <E> CompareChain<E> of(Comparator<E>... comparators)
```
    构建 CompareChain
    
    Type Parameters:
    
    E - 被比较对象类型
    
    Parameters:
    
    comparators - 比较器数组
    
    Returns:
    
    CompareChain
  - of
```
public static <E> CompareChain<E> of(List<Comparator<E>> comparators)
```
    构建 CompareChain
    
    Type Parameters:
    
    E - 被比较对象类型
    
    Parameters:
    
    comparators - 比较器列表
    
    Returns:
    
    CompareChain
  - of
```
public static <E> CompareChain<E> of(List<Comparator<E>> comparators,
                                     BitSet bits)
```
    构建 CompareChain
    
    Type Parameters:
    
    E - 被比较对象类型
    
    Parameters:
    
    comparators - 比较器列表
    
    bits - Comparator 列表对应的排序boolean值，true表示正序，false反序
    
    Returns:
    
    CompareChain
  - addComparator
```
public CompareChain<E> addComparator(Comparator<E> comparator)
```
    在链的尾部添加比较器,使用正向排序
    
    Parameters:
    
    comparator - Comparator 比较器,正向
    
    Returns:
    
    this
  - addComparator
```
public CompareChain<E> addComparator(Comparator<E> comparator,
                                     boolean reverse)
```
    在链的尾部添加比较器,使用给定排序方式
    
    Parameters:
    
    comparator - Comparator 比较器
    
    reverse - 是否反序,true表示正序,false反序
    
    Returns:
    
    this
  - setComparator
```
public CompareChain<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 CompareChain<E> setComparator(int index,
                                     Comparator<E> comparator,
                                     boolean reverse)
```
    替换指定位置的比较器,替换指定排序方式
    
    Parameters:
    
    index - 位置
    
    comparator - Comparator
    
    reverse - 是否反序,true表示正序,false反序
    
    Returns:
    
    this
  - setForwardSort
```
public CompareChain<E> setForwardSort(int index)
```
    更改指定位置的排序方式为正序
    
    Parameters:
    
    index - 位置
    
    Returns:
    
    this
  - setReverseSort
```
public CompareChain<E> setReverseSort(int index)
```
    更改指定位置的排序方式为反序
    
    Parameters:
    
    index - 位置
    
    Returns:
    
    this
  - size
```
public int size()
```
    比较器链中比较器个数
    
    Returns:
    
    Comparator count
  - isLocked
```
public boolean isLocked()
```
    是否已经被锁定当开始比较时(调用compare方法)此值为true
    
    Returns:
    
    true = CompareChain cannot be modified; false = CompareChain can still be modified.
  - iterator
```
public Iterator<Comparator<E>> iterator()
```
    Specified by:
    
    iterator in interface Iterable<Comparator<E>>
  - addChain
```
public CompareChain<E> addChain(Comparator<E> element)
```
    Description copied from interface: Chain
    
    加入责任链
    
    Specified by:
    
    addChain in interface Chain<Comparator<E>,CompareChain<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 CompareChain<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

CompareChain

CompareChain

CompareChain

CompareChain

CompareChain

Method Detail

of

of

of

of

of

addComparator

addComparator

setComparator

setComparator

setForwardSort

setReverseSort

size

isLocked

iterator

addChain

compare

hashCode

equals