compact1, compact2, compact3

java.text

Class CollationKey

java.lang.Object

java.text.CollationKey

All Implemented Interfaces:

Comparable < CollationKey >

public abstract class CollationKey
extends Object
implements Comparable<CollationKey>

甲CollationKey表示String下一个特定的规则Collator对象。 比较两个CollationKey返回他们所代表的String的相对顺序。 使用CollationKey s比较String s通常比使用Collator.compare快。 因此，当String必须进行多次比较时，例如当排序String的列表时。 使用CollationKey更有效率。

您不能直接创建CollationKey 。 而是通过调用Collator.getCollationKey生成它们。 只能比较CollationKey来自同一生成S- Collator对象。

为CollationKey生成String涉及检查整个String并将其转换为可以按比例比较的一系列位。 一旦生成密钥，就可以快速比较。 在String需要进行多次比较时，生成键的成本将以较快的比较进行补偿。 另一方面，比较的结果通常由每个String的前几个字符String 。 Collator.compare只检查所需的字符数，这样可以在单次比较时更快。

以下示例显示了如何使用CollationKey对String的列表进行排序。

 // Create an array of CollationKeys for the Strings to be sorted.
 Collator myCollator = Collator.getInstance();
 CollationKey[] keys = new CollationKey[3];
 keys[0] = myCollator.getCollationKey("Tom");
 keys[1] = myCollator.getCollationKey("Dick");
 keys[2] = myCollator.getCollationKey("Harry");
 sort(keys);

 //...

 // Inside body of sort routine, compare keys this way
 if (keys[i].compareTo(keys[j]) > 0)
    // swap keys[i] and keys[j]

 //...

 // Finally, when we've returned from sort.
 System.out.println(keys[0].getSourceString());
 System.out.println(keys[1].getSourceString());
 System.out.println(keys[2].getSourceString());
 

另请参见：

Collator ， RuleBasedCollator

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	CollationKey(String source) CollationKey构造函数。

方法摘要

Modifier and Type	Method and Description
abstract int	compareTo(CollationKey target) 将此CollationKey与目标CollationKey进行比较。
String	getSourceString() 返回此CollationKey表示的String。
abstract byte[]	toByteArray() 将CollationKey转换为位序列。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

CollationKey

protected CollationKey(String source)

CollationKey构造函数。

参数

source - 源字符串

异常

NullPointerException - 如果 source为空

从以下版本开始：

1.6

方法详细信息

compareTo

public abstract int compareTo(CollationKey target)

将此CollationKey与目标CollationKey进行比较。 应用了创建这些键的Collator对象的排序规则。 注意：由不同Collator创建的CollationKeys无法比较。

Specified by:

compareTo中的 Comparable<CollationKey>

参数

target - 目标CollationKey

结果

返回一个整数值。 如果该值小于目标值，则该值小于零，如果此值和目标值相等，则值为零，如果该值大于目标值，则值大于零。

另请参见：

Collator.compare(java.lang.String, java.lang.String)

getSourceString

public String getSourceString()

返回此CollationKey表示的String。

结果

这个CollationKey的源字符串

toByteArray

public abstract byte[] toByteArray()

将CollationKey转换为位序列。 如果两个CollationKey可以合法比较，那么可以比较每个这些密钥的字节数组，以获得相同的结果。 字节数组首先被组织成最高有效字节。

结果

CollationKey的字节数组表示