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为默认区域比较两个字符串。
```
 // 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");
 }
 
```
比较Strings恰好一次，这compare方法提供了最佳的性能。当排序Strings然而，它一般是要比较各String多次。在这种情况下，CollationKeys提供更好的性能。的CollationKey类将String一系列比特位可以比较与其他CollationKeys。一CollationKey是由给定的String Collator对象创建一个。
注： CollationKeys不同Collators不能相比的。看到班上的描述CollationKey为例，采用CollationKeys。
另请参见：

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)` 比较字符串的源到目标字符串根据这个排序器的排序规则。
`boolean`	`equals(Object that)` 比较两个对照者的平等。
`boolean`	`equals(String source, String target)` 比较基于这两个字符串的排序规则排序的平等便捷方法。
`static Locale[]`	`getAvailableLocales()` 返回一个数组的所有地方，这个班的 `getInstance`方法可以返回局部实例。
`abstract CollationKey`	`getCollationKey(String source)` 将字符串转换成一系列的比特位可以比其他collationkeys。
`int`	`getDecomposition()` 得到这一分解模式。
`static Collator`	`getInstance()` 被整理为当前默认的区域设置。
`static Collator`	`getInstance(Locale desiredLocale)` 获取所需的现场整理。
`int`	`getStrength()` 返回此整理的强度特性。
`abstract int`	`hashCode()` 生成该整理的哈希代码。
`void`	`setDecomposition(int decompositionMode)` 这一集的分解模式。
`void`	`setStrength(int newStrength)` 这一集的强度特性。

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

- Field Detail
  - PRIMARY
```
public static final int PRIMARY
```
    整理强度值。当设置时，只有主要的差异被认为是显着的比较。语言功能的优势的分配是语言设置依赖。一个常见的例子是针对不同的基本字母（“A”和“B”）被认为是一个主要的区别。
    
    另请参见：
    
    setStrength(int)， getStrength()， Constant Field Values
  - SECONDARY
```
public static final int SECONDARY
```
    整理强度值。当设置，只有中学和以上的差异被认为是显着的比较。语言功能的优势的分配是语言设置依赖。一个常见的例子是不同的重音相同的基本字母形式（“一”与“�”）被认为是一个次要的差异。
    
    另请参见：
    
    setStrength(int)， getStrength()， Constant Field Values
  - TERTIARY
```
public static final int TERTIARY
```
    整理强度值。当设置，只有第三级和以上的差异被认为是显着的，在比较。语言功能的优势的分配是语言设置依赖。一个常见的例子是，不同的情况下（“A”和“A”）被认为是第三级的区别。
    
    另请参见：
    
    setStrength(int)， getStrength()， Constant Field Values
  - IDENTICAL
```
public static final int IDENTICAL
```
    整理强度值。当设置时，所有的差异都被认为是显着的比较。语言功能的优势的分配是语言设置依赖。一个常见的例子是控制字符（“处”与“\ u0002”）被认为是相等的在小学、中学、和三级，但在同一水平不同。此外，在预先组成的口音如“u00c0差异”（a-grave）结合的口音，如“一u0300”（A，结合墓）将如果分解将no_decomposition认为在同一水平上显著。
    
    另请参见：
    
    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对应的归一化形式描述Unicode Technical Report #15 KD。
    
    另请参见：
    
    getDecomposition()， setDecomposition(int)， Constant Field Values
- Constructor Detail
  - Collator
```
protected Collator()
```
    默认构造函数。此构造函数是受保护的，所以子类可以访问它。用户通常会创建一个排序的子类通过调用工厂方法getInstance。
    
    另请参见：
    
    getInstance()
- 方法详细信息
  - getInstance
```
public static Collator getInstance()
```
    被整理为当前默认的区域设置。默认的设置是由java.util.locale.getdefault。
    
    结果
    
    为默认区域整理。（例如，en_us）
    
    另请参见：
    
    Locale.getDefault()
  - getInstance
```
public static Collator getInstance(Locale desiredLocale)
```
    获取所需的现场整理。
    
    参数
    
    desiredLocale -所需的现场。
    
    结果
    
    所需的现场整理。
    
    另请参见：
    
    Locale， ResourceBundle
  - compare
```
public abstract int compare(String source,
                            String target)
```
    比较字符串的源到目标字符串根据这个排序器的排序规则。返回一个小于等于或大于零的整数，这取决于源字符串是否小于或等于或大于目标字符串。看到一个使用实例对照类描述。
    对于一一次比较，该方法具有最佳的性能。如果一个给定的字符串将参与多重比较，CollationKey.compareTo具有最好的性能。看到一类描述为例，利用CollationKeys。
    
    参数
    
    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的参数不能被转换为字符串。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    Comparator
  - getCollationKey
```
public abstract CollationKey getCollationKey(String source)
```
    将字符串转换成一系列的比特位可以比其他collationkeys。CollationKeys提供更好的性能比Collator.compare字符串时涉及的多重比较。看到一类描述为例，利用CollationKeys。
    
    参数
    
    source -被转化成一个排序键的字符串。
    
    结果
    
    对于给定的基于这个排序器的排序规则的字符串的CollationKey。如果源字符串为空，空CollationKey返回。
    
    另请参见：
    
    CollationKey， compare(java.lang.String, java.lang.String)
  - equals
```
public boolean equals(String source,
                      String target)
```
    比较基于这两个字符串的排序规则排序的平等便捷方法。
    
    参数
    
    source -源字符串比较。
    
    target -以与目标字符串。
    
    结果
    
    根据排序规则，如果字符串是相等的，则为。虚假的，否则。
    
    另请参见：
    
    compare(java.lang.String, java.lang.String)
  - getStrength
```
public int getStrength()
```
    返回此整理的强度特性。的强度属性确定在比较过程中被认为是显着的最低水平的差异。看到一个使用实例对照类描述。
    
    结果
    
    这个排序器的电流强度。
    
    另请参见：
    
    setStrength(int)， PRIMARY， SECONDARY， TERTIARY， IDENTICAL
  - setStrength
```
public void setStrength(int newStrength)
```
    这一集的强度特性。的强度属性确定在比较过程中被认为是显着的最低水平的差异。看到一个使用实例对照类描述。
    
    参数
    
    newStrength -新的强度值。
    
    异常
    
    IllegalArgumentException -如果新的强度值不是一个小学，中学，大学或相同。
    
    另请参见：
    
    getStrength()， PRIMARY， SECONDARY， TERTIARY， IDENTICAL
  - getDecomposition
```
public int getDecomposition()
```
    得到这一分解模式。分解模式确定如何处理Unicode字符组成。调整分解模式允许用户在更快更完整的排序规则行为之间选择。
    分解模式的三个值是：
    - no_decomposition，
    - canonical_decomposition
    - full_decomposition。
    看文件这三个常数描述它们的意义。
    结果
    
    分解模式
    
    另请参见：
    
    setDecomposition(int)， NO_DECOMPOSITION， CANONICAL_DECOMPOSITION， FULL_DECOMPOSITION
  - setDecomposition
```
public void setDecomposition(int decompositionMode)
```
    这一集的分解模式。看到一个描述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)
```
    比较两个对照者的平等。
    
    Specified by:
    
    equals 接口 Comparator<Object>
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    that -整理要与此相比。
    
    结果
    
    如果Collator像Collator一样真实；否则为false。
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
public abstract int hashCode()
```
    生成该整理的哈希代码。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    此对象的哈希代码值。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Collator

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Comparator

Field Detail

PRIMARY

SECONDARY

TERTIARY

IDENTICAL

NO_DECOMPOSITION

CANONICAL_DECOMPOSITION

FULL_DECOMPOSITION

Constructor Detail

Collator

方法详细信息

getInstance

getInstance

compare

compare

getCollationKey

equals

getStrength

setStrength

getDecomposition

setDecomposition

getAvailableLocales

clone

equals

hashCode