RuleBasedCollator (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.text
클래스 RuleBasedCollator

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

모든 구현된 인터페이스:: Cloneable, Comparator <Object >

public class RuleBasedCollator
extends Collator
extends Collator

RuleBasedCollator 클래스는 Collator 구상 서브 클래스에서 간단한 조작으로 데이터드리븐의 테이블 Collator를 사용 가능하게 합니다. 이 클래스를 사용하면, 커스터마이즈 한 테이블 베이스의 Collator를 작성할 수 있습니다 . RuleBasedCollator는 문자를 소트 키에 맵 합니다.

효율화를 위해서 RuleBasedCollator에는 다음의 제약이 있습니다 (또한 복잡한 언어에는 다른 서브 클래스가 사용된다).

<수식자 >에 의해 제어되는 특별한 조합 룰이 지정되면, Collator 객체 전체에 적용된다
기술이 없는 모든 문자는 조합 순서의 마지막에 온다

조합 테이블은 조합 룰의 리스트로부터 되어, 각각의 룰은 다음의 3개의 형식의 어떤 것인지를 취합니다.


    <modifier>
    <relation> <text-argument>
    <reset> <text-argument>

룰 요소의 정의는 다음과 같습니다.

텍스트 인수: 텍스트 인수는 특수 문자 (즉, 일반적인 공백 문자 [0009-000D, 0020] 으로 룰 구문 문자 [0021-002F, 003A-0040, 005B-0060, 007B-007E]) 이외이면 어떠한 문자 순서에서도 괜찮습니다. 이러한 특수 문자가 필요하면, 단일 인용부호로 둘러쌉니다 (예를 들어 ampersand(&) => '&'). 다만, 인용부호로 둘러싸이지 않은 공백 문자는 무시될테니 주의해 주세요. 예를 들어, b c는 bc로 서 처리됩니다.
수식자: 현재는 특별한 조합 룰을 온으로 하는 수식자가 2개 있습니다.
- '@' : 프랑스어와 같이, 엑센트 ( 제 2 상위)의 역방향의 소트를 온으로 한다
- '! ' : 타이어/설대어의 모음과 자음의 스왑을 온으로 한다. 타이어의 모음 \U0E40-\U0E44가 자음 \U0E01-\U0E2E에 선행한다, 또는 설대어의 모음 \U0EC0-\U0EC4가 자음 \U0E81-\U0EAE에 선행하는 경우에 이 룰이 적용되면, 조합을 위해서 모음은 자음의 후에 배치된다
'@' : 엑센트가 프랑스어와 같이 역방향으로 소트 되는 것을 나타냅니다.
관계 문자: 관계 문자에는 다음의 것이 있습니다.
- '<' : 보다 큰, 문자 상위의 경우 ( 제 1)
- ';' : 보다 큰, 엑센트 상위의 경우 ( 제 2)
- ', ' : 보다 큰, 케이스 (대문자와 소문자) 상위의 경우 ( 제 3)
- '=' : 동일하다
리셋 문자: 주로 단축과 확장을 위해서 사용합니다만, 룰 세트의 마지막에 수정을 추가하기 위해서도 사용할 수 있는 리셋가 문자 1개 있습니다.
'&' : 다음의 룰이, 리셋 텍스트 인수가 소트 되는 위치에 계속되는 것을 나타냅니다.

이것은 실제보다 복잡하게 느껴집니다. 예를 들어 다음의 예는 같은 것을 동등의 방법으로 나타낸 것입니다.


 a < b < c
 a < b & b < c
 a < c & a < b

텍스트 인수의 바로 후에 다음의 항목이 오므로 순서가 중요합니다. 다음의 예는 동등하지는 않습니다.


 a < b & a < c
 a < c & a < b

순서에는 텍스트 인수가 이미 존재하는지, 그 텍스트 인수의 최초의 부분 캐릭터 라인이 존재하지 않으면 안됩니다 (예를 들어 「a < b & ae < e」는 유효. 순서에 대해 「a」는 「ae」가 리셋 되기 전에 있기 때문에). 이 후자의 케이스로 「ae」는 1 문자로서 입력되지 않고, 그처럼은 다루어지지 않습니다. 「e」는 2 문자 ( 「a」에 계속되는 「e」)에 확장되었는지와 같이 소트 됩니다. 이 차이는 자연 언어로 보여집니다. 종래의 스페인어의 「ch」는 단일 문자에 단축되었는지와 같이 처리됩니다 ( 「c < ch < d」라고 표현된다). 한편, 종래의 독일어의 a 모음 변이는 2개의 문자에 확장되었는지와 같이 처리됩니다 ( 「a, A < b, B ... &ae;\u00e3& AE;\u00c3」라고 표현된다). \u00e3 및 \u00c3는 a 모음 변이의 escape sequence입니다.

무시 가능한 문자

무시 가능한 문자의 경우, 최초의 룰은 관계 문자로 시작되지 않으면 안됩니다 (위의 예는 실제로는 일부를 나타내고 있다. 즉, 「a < b」는 실제로는 「< a < b」여야 함). 그러나, 최초의 관계 문자가 「<」가 아니면, 최초의 「<」까지의 모든 텍스트 인수는 무시할 수 있습니다. 예를 들어 「, - < a < b」에서는 「-」을 무시할 수 있는 문자입니다. 이것은 전에 「black-birds」라고 하는 말로 보았던 대로입니다. 다른 언어의 예를 보면, 대부분의 엑센트를 무시할 수 있는 것을 알 수 있습니다.

정규화와 엑센트

RuleBasedCollator는 자동적으로 그 룰 테이블을 처리하는 것으로써, 사전 합성이 끝난 버전과 결합 문자 버전의 엑센트 첨부 문자가 어느쪽이나 포함되도록 합니다. 제공되고 있는 룰 캐릭터 라인이 베이스 문자와 독립한 결합 엑센트 문자로부터 마셔 구성되는 경우, 룰 캐릭터 라인의 문자의 모든 표준적인 조합해에 일치하는 사전 합성이 끝난 엑센트 첨부 문자가 테이블에 입력됩니다.

이것으로 코레이타가 NO_DECOMPOSITION 로 설정되어 있을 때에도, RuleBasedCollator를 사용해 엑센트 첨부 캐릭터 라인을 비교할 수 있습니다. 다만, 주의해야 할 점이 2개 있습니다. 1번째는 조합 대상의 캐릭터 라인이 표준적인 순서에 없는 결합 순서를 보관 유지하고 있는 경우, 코레이타를 CANONICAL_DECOMPOSITION 또는 FULL_DECOMPOSITION 로 설정해 결합 순서의 소트를 가능하게 할 필요가 있다고 하는 것입니다. 이제(이미 ) 1개는 캐릭터 라인이 분해 호환의 문자 (완전폭이나 반폭등의 형식)를 보관 유지하는 경우, 룰 테이블에는 표준적인 매핑만이 포함되므로 FULL_DECOMPOSITION를 사용할 필요가 있다고 하는 것입니다.

에러

다음의 경우는 에러가 됩니다.

텍스트 인수에 인용부호로 둘러싸이지 않은 구두점 문자가 있다 (예:「a < b-c < d」)
관계 문자나 리셋 문자의 뒤에 텍스트 인수가 없다 (예:「a <, b」)
텍스트 인수 (또는 텍스트 인수의 최초의 부분 캐릭터 라인)가 아직 순서에 없는데, 리셋 문자가 있다 (예:「a < b & e < f」)

이러한 에러중 어떤 것인가가 있으면, RuleBasedCollator가 ParseException을 Throw 합니다.

례

간단한 예:「< a < b < c < d」

노르웨이어: 「< 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 < \u00E5=a\u030A, \u00C5=A\u030A ;aa, AA< \u00E6, \u00C6< \u00F8, \u00D8」

보통, 룰 베이스의 Collator 객체를 작성하려면, Collator 팩토리 메서드 getInstance를 사용합니다. 그러나, 요구에 맞춘 특수한 룰을 가지는 룰 베이스의 Collator 객체를 작성하려면, String 객체에 룰을 지정해, RuleBasedCollator를 구축합니다. 예를 들어 다음과 같이 합니다.


 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" +
                 "< \u00E5=a\u030A, \u00C5=A\u030A" +
                 ";aa, AA< \u00E6, \u00C6< \u00F8, \u00D8";
 RuleBasedCollator myNorwegian = new RuleBasedCollator(Norwegian);

Collator를 결합하는 것은 캐릭터 라인을 결합한다라는 같은 정도 간단합니다. 다음의 예는 2개이 다른 로케일의 2개의 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

이제(이미 ) 1개의 예에서는 기존의 테이블을 변경해 새로운 Collator 객체를 작성합니다. 예를 들어 「& C < ch, cH, Ch, CH」를 en_USCollator 객체에 추가해, 독자적인 테이블을 작성합니다.


 // Create a new Collator object with additional rules
 String addRules = "&C< ch, cH, Ch, CH";
 RuleBasedCollator myCollator =
     new RuleBasedCollator(en_USCollator + addRules);
 // myCollator contains the new rules

다음의 예는 비스페이싱아크센트의 순서를 변경하는 방법을 나타내고 있습니다.


 // 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에 서는 영어의 문자를 일본어의 문자보다 전에 소트 하는 일도, 후에 소트 할 수도 있습니다.


 // 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 \u2212
 String jaString = "& \u2212 < \u3041, \u3042 < \u3043, \u3044";
 RuleBasedCollator myJapaneseCollator = new
     RuleBasedCollator(en_USCollator.getRules() + jaString);

관련 항목:: Collator, CollationElementIterator

필드 개요

클래스 java.text. Collator 로부터 상속된 필드
`CANONICAL_DECOMPOSITION, FULL_DECOMPOSITION, IDENTICAL, NO_DECOMPOSITION, PRIMARY, SECONDARY, TERTIARY`

생성자 개요
`RuleBasedCollator (String rules)` RuleBasedCollator 생성자 입니다.

메서드 개요
`Object`	`clone ()` 표준 오버라이드(override)입니다.
`int`	`compare (String source, String target)` 2개가 다른 캐릭터 라인에 포함된 문자 데이터를, 조합 룰에 따라 비교합니다.
`boolean`	`equals (Object obj)` 2개의 조합 객체가 동일한지 어떤지를 비교합니다.
`CollationElementIterator`	`getCollationElementIterator (CharacterIterator source)` 지정된 String CollationElementIterator를 리턴합니다.
`CollationElementIterator`	`getCollationElementIterator (String source)` 지정된 String CollationElementIterator를 리턴합니다.
`CollationKey`	`getCollationKey (String source)` 캐릭터 라인을 CollationKey.compareTo 로 비교할 수 있는 일련의 문자로 변환합니다.
`String`	`getRules ()` 조합 객체에 대한 테이블 베이스 룰을 취득합니다.
`int`	`hashCode ()` 테이블 베이스 조합 객체의 해시 코드를 생성합니다.

클래스 java.text. Collator 로부터 상속된 메서드
`compare, equals, getAvailableLocales, getDecomposition, getInstance, getInstance, getStrength, setDecomposition, setStrength`

클래스 java.lang. Object 로부터 상속된 메서드
`finalize, getClass, notify, notifyAll, toString, wait, wait, wait`

생성자 상세