Collator (Java Platform SE 8 )

java.lang.Object
- java.text.Collator

All Implemented Interfaces:

Cloneable ， Comparator < Object >

已知直接子类：

RuleBasedCollator
```
public abstract class Collator
extends Object
implements Comparator<Object>, Cloneable
```
Collator类执行区域设置敏感String比较。您使用此类来构建自然语言文本的搜索和排序例程。
Collator是一个抽象基类。子类实现特定的整理策略。一个子类， RuleBasedCollator ，目前提供了Java平台，适用于广泛的语言。可以创建其他子类来处理更专门的需求。

像其他语言环境敏感类，你可以使用静态工厂方法， getInstance ，以获得适当Collator对象为给定的语言环境。您只需要查看Collator的Collator如果您需要了解特定整理策略的详细信息，或者您需要修改该策略。

以下示例显示如何使用默认语言环境的Collator比较两个字符串。
```
 // Compare two strings in the default locale
 Collator myCollator = Collator.getInstance();
 if( myCollator.compare("abc", "ABC") < 0 )
     System.out.println("abc is less than ABC");
 else
     System.out.println("abc is greater than or equal to ABC");
 
```
您可以设置Collator的强度属性来确定在比较中被认为是显着的差异水平。提供四个优势： PRIMARY ， SECONDARY ， TERTIARY和IDENTICAL 。对语言特征的优势的确切分配取决于区域设置。例如，在捷克语中，“e”和“f”被认为是主要差异，而“e”和“Ä”是次要差异，“e”和“E”是三级差异，“e”和“e”相同。以下显示了美国英语的情况和口音如何被忽略。
```
 //Get the Collator for US English and set its strength to PRIMARY
 Collator usCollator = Collator.getInstance(Locale.US);
 usCollator.setStrength(Collator.PRIMARY);
 if( usCollator.compare("abc", "ABC") == 0 ) {
     System.out.println("Strings are equivalent");
 }
 
```
为了比较String一次， compare方法提供了最好的性能。然而，当排序String的列表时，通常需要多次比较每个String 。在这种情况下， CollationKey提供更好的性能。 CollationKey类将String转换为一系列比特，可以与其他CollationKey进行比较。 A CollationKey由给定的String的Collator对象创建。
注意： CollationKey从不同的Collator s不能比较。请参阅类描述CollationKey用于使用例如CollationKey秒。
另请参见：

RuleBasedCollator ， CollationKey ， CollationElementIterator ， Locale

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CANONICAL_DECOMPOSITION` 分解模式值。
`static int`	`FULL_DECOMPOSITION` 分解模式值。
`static int`	`IDENTICAL` 整理器强度值。
`static int`	`NO_DECOMPOSITION` 分解模式值。
`static int`	`PRIMARY` 整理器强度值。
`static int`	`SECONDARY` 整理器强度值。
`static int`	`TERTIARY` 整理器强度值。

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`Collator()` 默认构造函数。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`Object`	`clone()` 覆盖可克隆
`int`	`compare(Object o1, Object o2)` 比较其两个参数的顺序。
`abstract int`	`compare(String source, String target)` 根据此Collator的排序规则将源字符串与目标字符串进行比较。
`boolean`	`equals(Object that)` 比较两个Collator的平等。
`boolean`	`equals(String source, String target)` 基于此Collator的排序规则比较两个字符串的相等性的便利方法。
`static Locale[]`	`getAvailableLocales()` 返回一个所有区域设置的数组，该类的 `getInstance`方法可以返回本地化实例。
`abstract CollationKey`	`getCollationKey(String source)` 将String转换成可以与其他CollationKeys进行比较的一系列位。
`int`	`getDecomposition()` 获取此Collator的分解模式。
`static Collator`	`getInstance()` 获取当前默认语言环境的Collator。
`static Collator`	`getInstance(Locale desiredLocale)` 获取所需语言环境的Collator。
`int`	`getStrength()` 返回此Collator的强度属性。
`abstract int`	`hashCode()` 生成此Collator的哈希码。
`void`	`setDecomposition(int decompositionMode)` 设置此Collator的分解模式。
`void`	`setStrength(int newStrength)` 设置此Collator的强度属性。

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

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

- 字段详细信息
  - PRIMARY
```
public static final int PRIMARY
```
    整理器强度值。当设定时，在比较期间只有PRIMARY差异被认为是重要的。对语言特征的优势分配取决于区域设置。一个常见的例子是将不同的基本字母（“a”对“b”）视为主要差异。
    
    另请参见：
    
    setStrength(int) ， getStrength() ， Constant Field Values
  - SECONDARY
```
public static final int SECONDARY
```
    整理器强度值。当设定时，在比较期间只有第二和以上的差异被认为是重要的。对语言特征的优势分配取决于区域设置。一个常见的例子是同一个基本字母（“a”vs“ï”）的不同重音形式被认为是第二个差异。
    
    另请参见：
    
    setStrength(int) ， getStrength() ， Constant Field Values
  - TERTIARY
```
public static final int TERTIARY
```
    整理器强度值。设定时，在比较期间，只有TERTIARY及以上差异被认为是重要的。对语言特征的优势分配取决于区域设置。一个常见的例子是病例差异（“a”vs“A”）被认为是TERTIARY差异。
    
    另请参见：
    
    setStrength(int) ， getStrength() ， Constant Field Values
  - IDENTICAL
```
public static final int IDENTICAL
```
    整理器强度值。设定时，所有差异在比较期间都被认为是显着的。对语言特征的优势分配取决于区域设置。一个常见的例子是控制字符（“\ u0001”vs“\ u0002”）在PRIMARY，SECONDARY和TERTIARY级别被认为是相等的，但在IDENTICAL级别不同。此外，如果分解设置为NO_DECOMPOSITION，则在“ENC”（A-grave）和“A \ u0300”（A，combine-grave）之间的预先组合的重音符之间的区别将在IDENTICAL级别被认为是重要的。
    
    另请参见：
    
    Constant Field Values
  - NO_DECOMPOSITION
```
public static final int NO_DECOMPOSITION
```
    分解模式值。设置NO_DECOMPOSITION时，重音字符不会被分解以进行归类。这是默认设置，并提供最快的排序规则，但只会为不使用重音的语言产生正确的结果。
    
    另请参见：
    
    getDecomposition() ， setDecomposition(int) ， Constant Field Values
  - CANONICAL_DECOMPOSITION
```
public static final int CANONICAL_DECOMPOSITION
```
    分解模式值。使用CANONICAL_DECOMPOSITION设置，根据Unicode标准的规范变体的字符将被分解以进行归类。这应该被用来获得正确的重音符号排序。
    CANONICAL_DECOMPOSITION对应于标准化形式D，如Unicode Technical Report #15 所述。
    
    另请参见：
    
    getDecomposition() ， setDecomposition(int) ， Constant Field Values
  - FULL_DECOMPOSITION
```
public static final int FULL_DECOMPOSITION
```
    分解模式值。使用FULL_DECOMPOSITION设置，Unicode规范变体和Unicode兼容性变体将被分解以进行归类。这不仅引起重音字符的整理，而且还会使具有特殊格式的字符与其正常形式进行整理。例如，半宽和全角ASCII和片假名字符然后整理在一起。 FULL_DECOMPOSITION是最完整的，因此是最慢的分解模式。
    FULL_DECOMPOSITION对应于归一化形式KD，如Unicode Technical Report #15 所述。
    
    另请参见：
    
    getDecomposition() ， setDecomposition(int) ， Constant Field Values
- 构造方法详细信息
  - Collator
```
protected Collator()
```
    默认构造函数。这个构造函数是受保护的，所以子类可以访问它。用户通常通过调用出厂方法getInstance来创建一个Collator子类。
    
    另请参见：
    
    getInstance()
- 方法详细信息
  - getInstance
```
public static Collator getInstance()
```
    获取当前默认语言环境的Collator。默认语言环境由java.util.Locale.getDefault确定。
    
    结果
    
    默认语言环境的Collator（例如en_US）
    
    另请参见：
    
    Locale.getDefault()
  - getInstance
```
public static Collator getInstance(Locale desiredLocale)
```
    获取所需语言环境的Collator。
    
    参数
    
    desiredLocale - 所需的语言环境。
    
    结果
    
    对于所需语言环境的Collator。
    
    另请参见：
    
    Locale ， ResourceBundle
  - compare
```
public abstract int compare(String source,
                            String target)
```
    根据此Collator的排序规则将源字符串与目标字符串进行比较。根据源字符串是否小于等于或大于目标字符串，返回小于等于或大于零的整数。有关使用示例，请参阅Collator类描述。
    对于一次比较，该方法具有最佳性能。如果给定的String参与多个比较，CollationKey.compareTo具有最佳性能。有关使用CollationKeys的示例，请参阅Collator类描述。
    
    参数
    
    source - 源字符串。
    
    target - 目标字符串。
    
    结果
    
    返回一个整数值。如果源小于目标值，则值小于零，如果源和目标相等，则值为零，如果源大于目标值，则值大于零。
    
    另请参见：
    
    CollationKey ， getCollationKey(java.lang.String)
  - compare
```
public int compare(Object o1,
                   Object o2)
```
    比较其两个参数的顺序。返回负整数，零或正整数，因为第一个参数小于，等于或大于第二个参数。
    这个实现只返回compare((String)o1, (String)o2) 。
    
    Specified by:
    
    compare在接口 Comparator<Object>
    
    参数
    
    o1 - 要比较的第一个对象。
    
    o2 - 要比较的第二个对象。
    
    结果
    
    第一个参数的负整数，零或正整数小于等于或大于第二个参数。
    
    异常
    
    ClassCastException - 无法将参数转换为字符串。
    
    从以下版本开始：
    
    1.2
    
    另请参见：
    
    Comparator
  - getCollationKey
```
public abstract CollationKey getCollationKey(String source)
```
    将String转换成可以与其他CollationKeys进行比较的一系列位。当Strings涉及多个比较时，CollationKeys提供比Collator.compare更好的性能。有关使用CollationKeys的示例，请参阅Collator类描述。
    
    参数
    
    source - 要转换为归类密钥的字符串。
    
    结果
    
    基于此Collator的排序规则的给定String的CollationKey。如果源String为null，则返回一个空CollationKey。
    
    另请参见：
    
    CollationKey ， compare(java.lang.String, java.lang.String)
  - equals
```
public boolean equals(String source,
                      String target)
```
    基于此Collator的排序规则比较两个字符串的相等性的便利方法。
    
    参数
    
    source - 要比较的源字符串。
    
    target - 要比较的目标字符串。
    
    结果
    
    如果字符串根据排序规则规则相等，则为true。假，否则。
    
    另请参见：
    
    compare(java.lang.String, java.lang.String)
  - getStrength
```
public int getStrength()
```
    返回此Collator的强度属性。强度属性确定在比较期间被认为是显着的最小差异水平。有关使用示例，请参阅Collator类描述。
    
    结果
    
    此Collator目前的实力财产。
    
    另请参见：
    
    setStrength(int) ， PRIMARY ， SECONDARY ， TERTIARY ， IDENTICAL
  - setStrength
```
public void setStrength(int newStrength)
```
    设置此Collator的强度属性。强度属性确定在比较期间被认为是显着的最小差异水平。有关使用示例，请参阅Collator类描述。
    
    参数
    
    newStrength - 新的实力值。
    
    异常
    
    IllegalArgumentException - 如果新的实力值不是PRIMARY，SECONDARY，TERTIARY或IDENTICAL之一。
    
    另请参见：
    
    getStrength() ， PRIMARY ， SECONDARY ， TERTIARY ， IDENTICAL
  - getDecomposition
```
public int getDecomposition()
```
    获取此Collator的分解模式。分解模式决定如何处理Unicode组合字符。调整分解模式允许用户在更快更完整的排序规则行为之间进行选择。
    分解模式的三个值为：
    - NO_DECOMPOSITION，
    - CANONICAL_DECOMPOSITION
    - FULL_DECOMPOSITION。
    有关这些三个常数的说明，请参阅文档。
    结果
    
    分解模式
    
    另请参见：
    
    setDecomposition(int) ， NO_DECOMPOSITION ， CANONICAL_DECOMPOSITION ， FULL_DECOMPOSITION
  - setDecomposition
```
public void setDecomposition(int decompositionMode)
```
    设置此Collator的分解模式。有关分解模式的描述，请参阅getDecomposition。
    
    参数
    
    decompositionMode - 新的分解模式。
    
    异常
    
    IllegalArgumentException - 如果给定值不是有效的分解模式。
    
    另请参见：
    
    getDecomposition() ， NO_DECOMPOSITION ， CANONICAL_DECOMPOSITION ， FULL_DECOMPOSITION
  - getAvailableLocales
```
public static Locale[] getAvailableLocales()
```
    返回一个所有区域设置的数组，该类的getInstance方法可以返回本地化实例。返回的数组表示由Java运行时支持的语言环境和安装的CollatorProvider 实现的联合。它必须至少包含一个等于Locale.US的语言环境实例。
    
    结果
    
    一组本地化的本地化 Collator实例可用。
  - clone
```
public Object clone()
```
    覆盖可克隆
    
    重写：
    
    clone在 Object
    
    结果
    
    这个实例的一个克隆。
    
    另请参见：
    
    Cloneable
  - equals
```
public boolean equals(Object that)
```
    比较两个Collator的平等。
    
    Specified by:
    
    equals中的 Comparator<Object>
    
    重写：
    
    equals在 Object
    
    参数
    
    that - 与此进行比较的Collator。
    
    结果
    
    如果此Collator与Collator相同，则为true; 否则为假。
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - hashCode
```
public abstract int hashCode()
```
    生成此Collator的哈希码。
    
    重写：
    
    hashCode在 Object
    
    结果
    
    该对象的哈希码值。
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

Class Collator

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Comparator

字段详细信息

PRIMARY

SECONDARY

TERTIARY

IDENTICAL

NO_DECOMPOSITION

CANONICAL_DECOMPOSITION

FULL_DECOMPOSITION

构造方法详细信息

Collator

方法详细信息

getInstance

getInstance

compare

compare

getCollationKey

equals

getStrength

setStrength

getDecomposition

setDecomposition

getAvailableLocales

clone

equals

hashCode