扫码一下
查看教程更方便
Ordering
可以看作是一个丰富的比较器,具有增强的链接功能、多种实用方法、多类型排序能力等。
以下是 com.google.common.collect.Ordering<T>
类的声明
@GwtCompatible
public abstract class Ordering<T>
extends Object
implements Comparator<T>
序号 | 方法 | 说明 |
---|---|---|
1 | static Ordering<Object> allEqual() | 返回将所有值视为相等的排序,表示“无排序”。 将此排序传递给任何稳定的排序算法都不会改变元素的顺序。 |
2 | static Ordering<Object> arbitrary() | 返回所有对象的任意排序,其中 compare(a, b) == 0 意味着 a == b (身份相等)。 |
3 | int binarySearch(List<? extends T> sortedList, T key) | 使用二进制搜索算法在 sortedList 中搜索键。 |
4 | abstract int compare(T left, T right) | 比较其两个参数的顺序。 |
5 | <U extends T> Ordering<U> compound(Comparator<? super U> secondaryComparator) | 返回一个排序,它首先使用排序 this,但在“tie”的情况下,然后委托给 secondaryComparator。 |
6 | static <T> Ordering<T> compound(Iterable<? extends Comparator<? super T>> comparators) | 返回一个顺序,它按顺序尝试每个给定的比较器,直到找到非零结果,返回该结果,并且仅当所有比较器都返回零时才返回零。 |
7 | static <T> Ordering<T> explicit(List<T> valuesInOrder) | 返回根据对象在给定列表中出现的顺序比较对象的顺序。 |
8 | static <T> Ordering<T> explicit(T leastValue, T... remainingValuesInOrder) | 返回一个排序,该排序根据将对象提供给此方法的顺序来比较对象。 |
9 | static <T> Ordering<T> from(Comparator<T> comparator) | 返回基于现有比较器实例的排序。 |
10 | <E extends T> List<E> greatestOf(Iterable<E> iterable, int k) | 根据此顺序返回给定 iterable 的 k 个最大元素,按从大到小的顺序排列。 |
11 | <E extends T> List<E> greatestOf(Iterator<E> iterator, int k) | 根据此顺序从给定的迭代器返回 k 个最大的元素,从大到小。 |
12 | <E extends T> ImmutableList<E> immutableSortedCopy(Iterable<E> elements) | 返回一个不可变列表,其中包含按此顺序排序的元素。 |
13 | boolean isOrdered(Iterable<? extends T> iterable) | 根据此顺序,如果 iterable 中第一个元素之后的每个元素都大于或等于它之前的元素,则返回 true。 |
14 | boolean isStrictlyOrdered(Iterable<? extends T> iterable) | 根据此顺序,如果 iterable 中第一个元素之后的每个元素都严格大于它之前的元素,则返回 true |
15 | <E extends T> List<E> leastOf(Iterable<E> iterable, int k) | 根据此顺序返回给定 iterable 的 k 个最少元素,按从小到大的顺序排列。 |
16 | <E extends T> List<E> leastOf(Iterator<E> elements, int k) | 根据此顺序从给定的迭代器返回 k 个最少的元素,从最小到最大的顺序。 |
17 | <S extends T> Ordering<Iterable<S>> lexicographical() | 返回一个新的排序,它通过成对比较相应的元素来对可迭代对象进行排序,直到找到非零结果; 强加“字典顺序”。 |
18 | <E extends T> E max(E a, E b) | 根据此排序返回两个值中的较大者。 |
19 | <E extends T> E max(E a, E b, E c, E... rest) | 根据此排序返回指定值中的最大值。 |
20 | <E extends T> E max(Iterable<E> iterable) | 根据此排序返回指定值中的最大值。 |
21 | <E extends T> E max(Iterator<E> iterator) | 根据此排序返回指定值中的最大值。 |
22 | <E extends T> E min(E a, E b) | 根据此排序返回两个值中的较小者。 |
23 | <E extends T> E min(E a, E b, E c, E... rest) | 根据此排序返回指定值中的最小值。 |
24 | <E extends T> E min(Iterable<E> iterable) | 根据此排序返回指定值中的最小值。 |
25 | <E extends T> E min(Iterator<E> iterator) | 根据此排序返回指定值中的最小值。 |
26 | static <C extends Comparable> Ordering<C> natural() | 返回使用值的自然顺序的可序列化排序。 |
27 | <S extends T> Ordering<S> nullsFirst() | 返回将 null 视为小于所有其他值的排序,并使用它来比较非 null 值。 |
28 | <S extends T> Ordering<S> nullsLast() | 返回将 null 视为大于所有其他值的排序,并使用此排序来比较非 null 值。 |
29 | <F> Ordering<F> onResultOf(Function<F,? extends T> function) | 返回 F 上的新排序,它通过首先对元素应用一个函数来排序元素,然后使用它比较这些结果。 |
30 | <S extends T> Ordering<S> reverse() | 返回此顺序的相反顺序; 相当于 Collections.reverseOrder(Comparator) 的 Ordering。 |
31 | <E extends T> List<E> sortedCopy(Iterable<E> elements) | 返回一个可变列表,其中包含按此顺序排序的元素; 仅当结果列表可能需要进一步修改或可能包含 null 时才使用它。 |
32 | static Ordering<Object> usingToString() | 返回一个排序,该排序通过 toString() 返回的字符串表示的自然排序来比较对象。 |
该类继承了以下类的方法 -
在 C:/> Guava 中使用我们选择的任何编辑器创建以下 java 程序。
GuavaTester.java
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import com.google.common.collect.Ordering;
public class GuavaTester {
public static void main(String args[]) {
List<Integer> numbers = new ArrayList<Integer>();
numbers.add(new Integer(5));
numbers.add(new Integer(2));
numbers.add(new Integer(15));
numbers.add(new Integer(51));
numbers.add(new Integer(53));
numbers.add(new Integer(35));
numbers.add(new Integer(45));
numbers.add(new Integer(32));
numbers.add(new Integer(43));
numbers.add(new Integer(16));
Ordering ordering = Ordering.natural();
System.out.println("Input List: ");
System.out.println(numbers);
Collections.sort(numbers,ordering );
System.out.println("Sorted List: ");
System.out.println(numbers);
System.out.println("======================");
System.out.println("List is sorted: " + ordering.isOrdered(numbers));
System.out.println("Minimum: " + ordering.min(numbers));
System.out.println("Maximum: " + ordering.max(numbers));
Collections.sort(numbers,ordering.reverse());
System.out.println("Reverse: " + numbers);
numbers.add(null);
System.out.println("Null added to Sorted List: ");
System.out.println(numbers);
Collections.sort(numbers,ordering.nullsFirst());
System.out.println("Null first Sorted List: ");
System.out.println(numbers);
System.out.println("======================");
List<String> names = new ArrayList<String>();
names.add("Ram");
names.add("Shyam");
names.add("Mohan");
names.add("Sohan");
names.add("Ramesh");
names.add("Suresh");
names.add("Naresh");
names.add("Mahesh");
names.add(null);
names.add("Vikas");
names.add("Deepak");
System.out.println("Another List: ");
System.out.println(names);
Collections.sort(names,ordering.nullsFirst().reverse());
System.out.println("Null first then reverse sorted list: ");
System.out.println(names);
}
}
使用 javac 编译器编译类,如下所示
C:\Guava>javac GuavaTester.java
现在运行 GuavaTester 以查看结果。
C:\Guava>java GuavaTester
结果如下
Input List:
[5, 2, 15, 51, 53, 35, 45, 32, 43, 16]
Sorted List:
[2, 5, 15, 16, 32, 35, 43, 45, 51, 53]
======================
List is sorted: true
Minimum: 2
Maximum: 53
Reverse: [53, 51, 45, 43, 35, 32, 16, 15, 5, 2]
Null added to Sorted List:
[53, 51, 45, 43, 35, 32, 16, 15, 5, 2, null]
Null first Sorted List:
[null, 2, 5, 15, 16, 32, 35, 43, 45, 51, 53]
======================
Another List:
[Ram, Shyam, Mohan, Sohan, Ramesh, Suresh, Naresh, Mahesh, null, Vikas, Deepak]
Null first then reverse sorted list:
[Vikas, Suresh, Sohan, Shyam, Ramesh, Ram, Naresh, Mohan, Mahesh, Deepak, null]