类 java.text.RuleBasedCollator

java.lang.Object
   |
   +----java.text.Collator
           |
           +----java.text.RuleBasedCollator

public class RuleBasedCollator
extends Collator

类 RuleBasedCollator 是 Collator 的具体子类，Collator 提供了一个简单的数据驱动的表整理程序。使用该类可以创建一个定制的基于表的 Collator。 RuleBasedCollator 将字符映射为分类关键字。

为了提高效率，RuleBasedCollator 具有下列限制 ( 其它子类可能用于更复杂的语言中 )：

如果指定了法语第二级定序，它将应用到所有整理程序对象。
所有没有用到的 Unicode 字符在整理程序次序的末尾。
私用的字符被认为是相同的。Unicode 中的私用区域是 0xE800-0xF8FF。

整理表由一系列整理规则组成，每条规则是下列三种格式之一：

下面说明如何创建自己的整理规则：

Text-Argument：一个 text-argument 是任意字符序列，不包括特殊字符 ( 即空白字符和用于修饰符、关系和复位中的字符 )。如果需要那些字符可以把它们放在单引号中 ( 例如和号 => '&'). 注意未引起的空白字符被忽略；例如 b c 被作为 bc。
Modifier：一个单个的修饰符，用来指明所有的音调符号都是向后结合的 ( 第二级差别 )。
'@' : 指示音调符号按倒序排序，象法语中那样。
Relation：关系如下：
- '<' ：大于，作为字符的差别 ( 第一级 )
- ';' ：大于，作为音调符号的差别 ( 第二级 )
- ',' ：大于，作为大小写的差别 ( 第三级 )
- '=' ：等于
Reset: 有一个单复位，它主要用于压缩和扩充，但是它也用于在一个规则集的末尾添加一个修改。
'&' ：指示复位 text-argument 将被排序的位置的下一条规则。

这听起来比实际运用复杂的多。例如下列是表达同一件事的等价的方式：

注意顺序是重要的，因为随后的项目直接出现在 text-augument 之后。下面的格式是不等价的：

a
text-argument 必须已经出现在序列中，或者 text-augument 的一些初始的子串出现在序列中。( 例如 "a 可忽略的字符
对于可忽略的字符，第一条规则必须以一个关系开始 ( 上面所使用的例子实际上是一些片段；"a 标准化和语音符号
Collator 自动的在内部将文本标准化，在可能的地方按照基本的字符划分音节。当处理规则和比较两个字符串时完成这项工作。Collator 也使用 Unicode 规范映射保证组合序列被正确排序。

错误
以下为错误：

text-argument 包含未括起的标点符号 ( 例如 "a 关系或复位字符之后没有 text-argument ( 例如 "a <, b")。
复位字符处 text-argument ( 或 text-argument 的初始子串 ) 没有在序列中。( 例如 "a 如果造成以上的一个错误，RuleBasedCollator 抛出一个 ParseException。
示例
简单的： "挪威语： " 通常，为了创建一个基于规则的整理设备，使用 Collator 的工厂方法 getInstance。但是，为了用指定的符合需求的规则创建一个基于规则的 Collator 对象，用包含在 String 对象中的规则构造 RuleBasedCollator。例如：

String Simple = "
或者：

String Norwegian = "

组合 Collator 同组合字符串一样简单。下面的例子将两个位于不同位置的 Collator 组合起来：

// Create an en_US Collator object RuleBasedCollator en_USCollator = (RuleBasedCollator) Collator.getInstance(new Locale("en", "US", "")); // Create a da_DK Collator object RuleBasedCollator da_DKCollator = (RuleBasedCollator) Collator.getInstance(new Locale("da", "DK", "")); // Combine the two // First, get the collation rules from en_USCollator String en_USRules = en_USCollator.getRules(); // Second, get the collation rules from da_DKCollator String da_DKRules = da_DKCollator.getRules(); RuleBasedCollator newCollator = new RuleBasedCollator(en_USRules + da_DKRules); // newCollator has the combined rules

另一个更有趣的例子将改变现有的表，创建一个新的 Collator 对象。例如将 "& C en_USCollator 对象中创建自己的对象：

// Create a new Collator object with additional rules String addRules = "& C

下面的例子说明了如何改变非空格语音符号的顺序：

// old rule String oldRules = "=?;?;?;?" // main accents + ";?;?;?;?" // main accents + ";?;?;?;?" // main accents + ";?;?;?;?" // main accents + ";?;?;?;?" // main accents + "

最后的例子显示了如何把新的第一级顺序放在缺省设定之前。例如，在日语 Collator 中，可以把英文字符排在日文字符之前或之后：

// get en_US Collator rules RuleBasedCollator en_USCollator = (RuleBasedCollator)Collator.getInstance(Locale.US); // add a few Japanese character to sort before English characters // suppose the last character before the first base letter 'a' in // the English collation rule is ? String jaString = "& ?

参见：
Collator, CollationElementIterator

构造子索引

RuleBasedCollator(String)
RuleBasedCollator 构造子。

方法索引

clone()
标准覆盖；在此语义中没有改变。
compare(String, String)
基于整理规则，比较两个不同的字符串中的字符数据。
equals(Object)
比较两个整理对象是否相等。
getCollationElementIterator(String)
为给定的 String 返回一个 CollationElementIterator。
getCollationKey(String)
把字符串转换为一系列字符，它们可以与 CollationKey.compareTo 相比较。
getRules()
获得整理对象的基于表的规则。
hashCode()
为基于表的整理对象生成散列码。

构造子
 RuleBasedCollator
public RuleBasedCollator(String rules) throws ParseException

RuleBasedCollator 构造子。它采用表规则并在外面创建一个整理表。请参见 RuleBasedCollator 类描述获得关于整理规则语法的详细资料。

参数：
rules - 基于该整理规则创建整理表。
抛出： ParseException
如果规则创建过程失败将抛出一个格式异常。例如，创建规则 "a 参见：
Locale

方法
getRules
public String getRules()

获得整理对象的基于表的规则。

返回值：
返回创建整理对象所用的整理规则。

name="getCollationElementIterator(java.lang.String)"> getCollationElementIterator
public CollationElementIterator getCollationElementIterator(String source)

为给定的 String 返回一个 CollationElementIterator。

参见：
CollationElementIterator

compare
public int compare(String source, String target)

基于整理规则，比较两个不同的字符串中的字符数据。返回在某种语言中一个字符串是否大于、小于或等于另一个字符串的信息。它可以在子类中被覆盖。

覆盖：
类 Collator 中的 compare

getCollationKey
public CollationKey getCollationKey(String source)

把字符串转换为一系列字符，它们可以与 CollationKey.compareTo 相比较。它覆盖了 java.text.Collator.getCollationKey。它可以在子类中被覆盖。

覆盖：
类 Collator 中的 getCollationKey

clone
public Object clone()

标准覆盖；在此语义中没有改变。

覆盖：
类 Collator 中的 clone

equals
public boolean equals(Object obj)

比较两个整理对象是否相等。

参数：
obj - 与该整理对象比较的基于表的整理对象。
返回值：
如果当前基于表的整理对象与基于表的整理对象 obj 相等则返回 true；否则返回 false。
覆盖：
类 Collator 中的 equals

hashCode
public int hashCode()

为基于表的整理对象生成散列码。

覆盖：
类 Collator 中的 hashCode

当前位置类层次 (JDK) 所有类 (JDK) 所有域和方法 (JDK)