RuleBasedCollator (Java Platform SE 8 )

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

All Implemented Interfaces:

Cloneable Comparator Object >，<
```
public class RuleBasedCollator
extends Collator
```
这是 Collator RuleBasedCollator类，提供了一个简单的、数据驱动的一个具体子类，表整理。这个类，你可以创建一个定制的基于表的 Collator。 RuleBasedCollator映射字符排序的键。
RuleBasedCollator有以下限制效率（其他子类可以用于更复杂的语言）：
1. 如果一个特殊的排序规则由 <修改> 控制指定适用于整个整理的对象。
2. 所有未提及的字符都在排序规则顺序的结尾。
排序规则表由一个排序规则列表组成，其中每个规则都是三种形式之一：
```
 
        
        
        
      
        
      <修改>
  
         
         
         
       
         
       <关系> 
        <文本参数> 
         <重置> 
          <文本参数> 
          
         
       
 
        
        
        
      
        
      
```
规则的元素定义如下：
- 文本参数：文本的论点是任何字符序列，不含特殊字符（即常见的空白字符[ 0020 ]和0009-000d，规则语法特点[ 0021-002f，003a-0040，005b-0060，007b-007e ]）。如果这些字符的需要，你可以把它们放在单引号（如符号= >’和‘）。注意引号空格字符将被忽略；例如b c作为bc。
- 改性剂：目前有两种改性剂，打开特殊的排序规则。
  - “@”：打开向后排序的口音（二级差异），如在法国。
  - '！”：打开泰国/老挝元音辅音交换。如果这条规则是在部队当泰国元音的范围u0e40 \ u0e44先于泰国辅音的范围u0e01 \ u0e2e或范围的u0ec0 \ \ \ u0ec4之前u0e81 \ u0eae然后元音是放置整理的目的后，老老的辅音辅音的范围元音。
  “@”：指示重音在向后排列，如在法语中。
- 关系：关系如下：
  - “<”：更大，作为一个字母的区别（主要）
  - “；”：更大的，作为一个口音的区别（次要）
  - “，”：更大的，作为一个案例差异（第三级）
  - 等于：等于
- 复位：有一个单一的复位，主要用于收缩和扩张，但它也可以被用来在一套规则的末端添加一个修饰。
  “”：指示下一条规则如下位置，以将重置文本参数进行排序。
这听起来比它在实践中更复杂。例如，以下是表达同一事物的等效方法：
```
 a < b < c
 a < b & b < c
 a < c & a < b
 
```
注意顺序是很重要的，作为后续项目的文本参数后立即。以下是不等价的：
```
 a < b & a < c
 a < c & a < b
 
```
或文本参数必须已在序列中出现的文本，或争论一些初始字符串必须出现。（例如：“A”是有效的，因为“A”是存在于序列中的“自动曝光”重置之前。在这后一种情况下，“自动曝光”是没有输入和处理作为一个单一的字符，相反，“E”是排序，因为如果它扩展到两个字符：“A”后面的“E”。这种差异出现在自然语言：在传统的西班牙“CH”视同合同，单个字符（表示为“C＜CH＜D”），而在传统的德国a-umlaut视同扩展到两个字符（表示为“，一组B，B…“u00e3发射；发射；\ u00c3”）。【\ u00e3和u00c3，当然，对于a-umlaut转义序列。]
可忽略的人物

对于小人物，首先一定要有一个关系（实例我们用上面真的片段；“< b”真的应该是“＜B”）。如果，然而，第一种关系不是“<”，然后所有的所有文字争论到第一个“<”不容忽视。例如，“，-＜B“做”-“可忽略的人物，我们看到在“黑色的鸟早”。在样品的不同的语言，你看到大多数的口音是可以忽略的。

归一化和口音

RuleBasedCollator自动过程的规则表，包括前组成并结合重音字符字符版本。即使提供的规则字符串只包含基本特征和分离相结合的口音特点，预先由重音字符从规则的字符串匹配字符的所有规范的组合将进入表。

这允许您使用rulebasedcollator比较重音弦即使对照设置为no_decomposition。有两点需要注意，但是。首先，如果字符串是整理包含组合序列可能不规范秩序，你应该整理到canonical_decomposition或full_decomposition使组合序列排序。其次，如果字符串包含兼容性分解特征（如全角半角形式），你必须使用full_decomposition，因为规则表只包括正则映射。

错误

以下是错误：
- 一个文本参数包含引号标点符号（例如“< B-C＜D”）。
- 没有后跟一个文本参数的关系或重置字符（例如：“A <，B”）。
- 复位的文本参数（或参数的初始文本串）是不是已经在序列。（例如：“A”<“F”）
如果你产生一个错误，一个 RuleBasedCollator抛出一个 ParseException。
实例

简单：“< A >

挪威：“<，< B，B＜C，C＜D，D组、E组、F组、G组、H组我，我< J，J＜K，K＜L，L＜m，m＜n，n＜O，O < P，P Q，Q＜R，R＜S，S＜T，T＜u，u＜V，V＜W，W＜x，x＜y，y＜Z，Z < \ u00e6，\ u00c6 < \ u00f8，\ u00d8 < \ u00e5 = \ u030a，\ u00c5 = \ u030a；AA、AA”

创建一个专门的规则，根据你的需要RuleBasedCollator对象，你构建的RuleBasedCollator与包含在String对象的规则。例如:
```
 String simple = "< a< b< c< d";
 RuleBasedCollator mySimple = new RuleBasedCollator(simple);
 
```
或：
```
 String Norwegian = "< a, A < b, B < c, C < d, D < e, E < f, F < g, G < h, H < i, I" +
                    "< j, J < k, K < l, L < m, M < n, N < o, O < p, P < q, Q < r, R" +
                    "< s, S < t, T < u, U < v, V < w, W < x, X < y, Y < z, Z" +
                    "< \u00E6, \u00C6" +     // Latin letter ae & AE
                    "< \u00F8, \u00D8" +     // Latin letter o & O with stroke
                    "< \u00E5 = a\u030A," +  // Latin letter a with ring above
                    "  \u00C5 = A\u030A;" +  // Latin letter A with ring above
                    "  aa, AA";
 RuleBasedCollator myNorwegian = new RuleBasedCollator(Norwegian);
 
```
一个新的排序规则的字符串可以通过连接字符串创建规则。例如，通过getRules()返回的规则可以将多个RuleBasedCollators级联。

下面的示例演示如何更改非间距重音的顺序，
```
 // old rule
 String oldRules = "=\u0301;\u0300;\u0302;\u0308"    // main accents
                 + ";\u0327;\u0303;\u0304;\u0305"    // main accents
                 + ";\u0306;\u0307;\u0309;\u030A"    // main accents
                 + ";\u030B;\u030C;\u030D;\u030E"    // main accents
                 + ";\u030F;\u0310;\u0311;\u0312"    // main accents
                 + "< a , A ; ae, AE ; \u00e6 , \u00c6"
                 + "< b , B < c, C < e, E & C < d, D";
 // change the order of accent characters
 String addOn = "& \u0300 ; \u0308 ; \u0302";
 RuleBasedCollator myCollator = new RuleBasedCollator(oldRules + addOn);
 
```
另请参见：

Collator， CollationElementIterator

Field Summary
- Fields inherited from class java.text.Collator
  CANONICAL_DECOMPOSITION, FULL_DECOMPOSITION, IDENTICAL, NO_DECOMPOSITION, PRIMARY, SECONDARY, TERTIARY

构造方法摘要

构造方法
Constructor and Description
`RuleBasedCollator(String rules)` rulebasedcollator构造函数。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Object`	`clone()` 标准重写；语义没有更改。
`int`	`compare(String source, String target)` 比较基于排序规则规则的两个不同字符串中存储的字符数据。
`boolean`	`equals(Object obj)` 比较两个排序规则对象的相等性。
`CollationElementIterator`	`getCollationElementIterator(CharacterIterator source)` 返回一个给定的characteriterator CollationElementIterator。
`CollationElementIterator`	`getCollationElementIterator(String source)` 返回一个给定字符串CollationElementIterator。
`CollationKey`	`getCollationKey(String source)` 将字符串转换成一系列的人物，可与CollationKey.compareTo相比。
`String`	`getRules()` 获取排序规则对象的表为基础的规则。
`int`	`hashCode()` 生成基于表的排序规则对象的哈希代码

Methods inherited from class java.text.Collator
compare, equals, getAvailableLocales, getDecomposition, getInstance, getInstance, getStrength, setDecomposition, setStrength

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

- Constructor Detail
  - RuleBasedCollator
```
public RuleBasedCollator(String rules)
                  throws ParseException
```
    rulebasedcollator构造函数。这将需要表规则并从中建立一个整理表。请看rulebasedcollator类描述为排序规则语法的更多细节。
    
    参数
    
    rules的排序规则建立整理表。
    
    异常
    
    ParseException -格式异常将在规则的建立过程失败时引发。例如，建立规则“A”？< D”会导致构造函数抛出ParseException因为'吗？”是不被引用。
    
    另请参见：
    
    Locale
- 方法详细信息
  - getRules
```
public String getRules()
```
    获取排序规则对象的表为基础的规则。
    
    结果
    
    返回创建表整理对象的排序规则规则。
  - getCollationElementIterator
```
public CollationElementIterator getCollationElementIterator(String source)
```
    返回一个给定字符串CollationElementIterator。
    
    参数
    
    source -被整理的字符串
    
    结果
    
    一个 CollationElementIterator对象
    
    另请参见：
    
    CollationElementIterator
  - getCollationElementIterator
```
public CollationElementIterator getCollationElementIterator(CharacterIterator source)
```
    返回一个给定的characteriterator CollationElementIterator。
    
    参数
    
    source的迭代器进行整理
    
    结果
    
    一个 CollationElementIterator对象
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    CollationElementIterator
  - compare
```
public int compare(String source,
                   String target)
```
    比较基于排序规则规则的两个不同字符串中存储的字符数据。返回一个字符串是否小于或等于另一个语言中的字符串的信息。这可以在子类中重写。
    
    Specified by:
    
    compare 方法重写，继承类 Collator
    
    参数
    
    source -源字符串。
    
    target -目标字符串。
    
    结果
    
    返回一个整数值。值小于零，如果源小于目标，值为零，如果源和目标是相等的，值大于零，如果源大于目标。
    
    异常
    
    NullPointerException -如果 source或 target是空的。
    
    另请参见：
    
    CollationKey， Collator.getCollationKey(java.lang.String)
  - getCollationKey
```
public CollationKey getCollationKey(String source)
```
    将字符串转换成一系列的人物，可与CollationKey.compareTo相比。这会java.text.collator.getcollationkey。它可以在子类中重写。
    
    Specified by:
    
    getCollationKey 方法重写，继承类 Collator
    
    参数
    
    source -被转化成一个排序键的字符串。
    
    结果
    
    对于给定的基于这个排序器的排序规则的字符串的CollationKey。如果源字符串为空，空CollationKey返回。
    
    另请参见：
    
    CollationKey， Collator.compare(java.lang.String, java.lang.String)
  - clone
```
public Object clone()
```
    标准重写；语义没有更改。
    
    重写：
    
    clone 方法重写，继承类 Collator
    
    结果
    
    这个实例的克隆。
    
    另请参见：
    
    Cloneable
  - equals
```
public boolean equals(Object obj)
```
    比较两个排序规则对象的相等性。
    
    Specified by:
    
    equals 接口 Comparator<Object>
    
    重写：
    
    equals 方法重写，继承类 Collator
    
    参数
    
    基于 obj整理对象的表是与此相比。
    
    结果
    
    如果基于排序的对象是基于排序的对象表的相同的电流表真；否则为false。
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
public int hashCode()
```
    生成基于表的排序规则对象的哈希代码
    
    Specified by:
    
    hashCode 方法重写，继承类 Collator
    
    结果
    
    此对象的哈希代码值。
    
    另请参见：
    
    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 RuleBasedCollator

Field Summary

Fields inherited from class java.text.Collator

构造方法摘要

方法摘要

Methods inherited from class java.text.Collator

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Comparator

Constructor Detail

RuleBasedCollator

方法详细信息

getRules

getCollationElementIterator

getCollationElementIterator

compare

getCollationKey

clone

equals

hashCode