java.text.Collator
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 | |||||||||
java.lang.Object
public abstract class Collator
Collator 클래스는, 로케일에 의존하는 String 의 비교를 실시합니다. 이 클래스를 사용해, 자연 언어 텍스트의 검색과 소트의 루틴을 구축합니다.
Collator 는, 추상 base class입니다. 서브 클래스에 의해, 특정의 조합 방법을 구현합니다. 현재는, 1 개의 서브 클래스 RuleBasedCollator 가 Java 플랫폼에서 제공되고 있어 광범위의 언어에 적용 가능합니다. 한층 더 특수한 필요성이 있는 경우에는, 다른 서브 클래스를 작성할 수 있습니다.
로케일에 의존하는 것 외의 클래스와 같이, static 팩토리 메소드 getInstance 를 사용해, 어느 로케일에 대한 적절한 Collator 객체를 얻을 수 있습니다. 특정의 조합 방법의 상세를 이해하거나 그방법을 수정하거나 하는 경우에는,Collator 의 서브 클래스를 보는 것만으로 충분합니다.
다음의 예는, 디폴트 로케일의 Collator 를 사용해 2 개의 캐릭터 라인을 비교하는 방법을 나타낸 것입니다.
// 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 의 「강함」속성을 설정하면, 비교로 중요로 간주해지는 상위 레벨을 결정할 수 있습니다. 4 개의 레벨 PRIMARY,SECONDARY,TERTIARY,IDENTICAL 가 있습니다. 어느 언어의 기능에 어느 레벨을 할당할까는, 정확하게는 로케일에 따라서 다릅니다. 예를 들어, 체코어에서는, "e" 와 "f" 는 주요한 (primary) 상위로 간주해집니다만, "e" 와 "ê" 는 2 차적 (secondary), "e" 와 "E" 는 3 차적 (tertiary)인 상위로 간주해져 "e" 와 "e" 는 동일 (identical)로 간주해집니다. 다음의 예는, 미국 영어로 대문자와 소문자의 차이와 엑센트를 무시하는 방법을 나타낸 것입니다.
//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");
}
String 를 1 회만 비교하는 경우,compare 메소드를 사용하면(자) 최선의 퍼포먼스를 얻을 수 있습니다. 한편,String 리스트를 소트 하는 경우는 일반적으로, 각 String 를 몇번이나 비교하지 않으면 안됩니다. 그러한 경우는,CollationKey 를 사용하는 편이 좋은 퍼포먼스를 얻을 수 있습니다. CollationKey 는 String 를 비트열로 변환한 것이어, 다른 CollationKey 와 비트 단위로 비교할 수 있습니다. CollationKey 는, 특정의 String 에 대해서 Collator 객체에 의해 작성됩니다.
주: 다른 Collator 에 의해 작성된CollationKey 끼리는 비교할 수 없습니다. CollationKey 의 사용예에 대해서는,CollationKey 의 클래스의 설명을 참조해 주세요.
RuleBasedCollator ,
CollationKey ,
CollationElementIterator ,
Locale | 필드의 개요 | |
|---|---|
static int |
CANONICAL_DECOMPOSITION
분해 모드치입니다. |
static int |
FULL_DECOMPOSITION
분해 모드치입니다. |
static int |
IDENTICAL
Collator 의 강함을 나타내는 값입니다. |
static int |
NO_DECOMPOSITION
분해 모드치입니다. |
static int |
PRIMARY
Collator 의 강함을 나타내는 값입니다. |
static int |
SECONDARY
Collator 의 강함을 나타내는 값입니다. |
static int |
TERTIARY
Collator 의 강함을 나타내는 값입니다. |
| 생성자 의 개요 | |
|---|---|
protected |
Collator ()
디폴트의 생성자 입니다. |
| 메소드의 개요 | |
|---|---|
Object |
clone ()
Cloneable 를 오버라이드(override) 합니다. |
int |
compare (Object o1,
Object o2)
순서부를 위해서(때문에) 2 개의 인수를 비교합니다. |
abstract int |
compare (String source,
String target)
Collator 의 조합 룰에 따라, 소스 캐릭터 라인과 타겟 캐릭터 라인을 비교합니다. |
boolean |
equals (Object that)
2 개의 Collator 가 동일한지 어떤지를 비교합니다. |
boolean |
equals (String source,
String target)
Collator 의 조합 룰에 따라 2 개의 캐릭터 라인이 동일한지 어떤지를 비교하기 위한 편리한 메소드입니다. |
static Locale [] |
getAvailableLocales ()
이 클래스의 getInstance 메소드가 로컬라이즈 된 인스턴스를 돌려줄 수 있는 로케일 모든 배열을 돌려줍니다. |
abstract CollationKey |
getCollationKey (String source)
String 를, 다른 CollationKey 와 비트 단위로 비교 가능한 비트열로 변환합니다. |
int |
getDecomposition ()
Collator 의 분해 모드를 가져옵니다. |
static Collator |
getInstance ()
현재의 디폴트 로케일에 대한 Collator 를 가져옵니다. |
static Collator |
getInstance (Locale desiredLocale)
필요한 로케일의 Collator 를 가져옵니다. |
int |
getStrength ()
Collator 의 강함 속성을 돌려줍니다. |
abstract int |
hashCode ()
Collator 의 해시 코드를 생성합니다. |
void |
setDecomposition (int decompositionMode)
Collator 의 분해 모드를 설정합니다. |
void |
setStrength (int newStrength)
Collator 의 강함 속성을 돌려줍니다. |
| 클래스 java.lang. Object 로부터 상속된 메소드 |
|---|
finalize , getClass , notify , notifyAll , toString , wait , wait , wait |
| 필드의 상세 |
|---|
public static final int PRIMARY
setStrength(int) ,
getStrength() ,
정수 필드치 public static final int SECONDARY
setStrength(int) ,
getStrength() ,
정수 필드치 public static final int TERTIARY
setStrength(int) ,
getStrength() ,
정수 필드치 public static final int IDENTICAL
public static final int NO_DECOMPOSITION
getDecomposition() ,
setDecomposition(int) ,
정수 필드치 public static final int CANONICAL_DECOMPOSITION
CANONICAL_DECOMPOSITION 는,「Unicode Technical Report #15」로 설명되고 있는 Normalization Form D 에 상당합니다.
getDecomposition() ,
setDecomposition(int) ,
정수 필드치 public static final int FULL_DECOMPOSITION
FULL_DECOMPOSITION 는,「Unicode Technical Report #15」로 설명되고 있는 Normalization Form KD 에 상당합니다.
getDecomposition() ,
setDecomposition(int) ,
정수 필드치 | 생성자 의 상세 |
|---|
protected Collator()
getInstance() | 메소드의 상세 |
|---|
public static Collator getInstance()
Locale.getDefault() public static Collator getInstance(Locale desiredLocale)
desiredLocale - 필요한 로케일
Locale ,
ResourceBundle
public abstract int compare(String source,
String target)
1 회만의 비교이면, 이 메소드의 퍼포먼스가 가장 우수합니다. 지정된 캐릭터 라인으로 여러 차례의 비교가 필요하면, CollationKey.compareTo 의 퍼포먼스가 가장 우수합니다. CollationKey 의 사용예에 대해서는, Collator 클래스의 설명을 참조해 주세요.
source - 소스 캐릭터 라인target - 타겟 캐릭터 라인
CollationKey ,
getCollationKey(java.lang.String)
public int compare(Object o1,
Object o2)
이 구현은 단순하게 다음의 코드를 돌려줍니다. compare((String) o1, (String) o2)
Comparator <Object > 내의 compare o1 - 비교 대상의 최초의 객체o2 - 비교 대상의 2 번째의 객체
ClassCastException - 인수를 String 에 캐스트 할 수 없는 경우Comparator public abstract CollationKey getCollationKey(String source)
source - 조합 키로 변환하는 캐릭터 라인
CollationKey ,
compare(java.lang.String, java.lang.String)
public boolean equals(String source,
String target)
source - 비교 대상의 소스 캐릭터 라인target - 비교 대상의 타겟 캐릭터 라인
compare(java.lang.String, java.lang.String) public int getStrength()
setStrength(int) ,
PRIMARY ,
SECONDARY ,
TERTIARY ,
IDENTICAL public void setStrength(int newStrength)
newStrength - 강함 속성의 새로운 값
IllegalArgumentException - 새로운 강함을 나타내는 값이
PRIMARY, SECONDARY, TERTIARY, IDENTICAL 의 어떤 것도 아닌 경우getStrength() ,
PRIMARY ,
SECONDARY ,
TERTIARY ,
IDENTICAL public int getDecomposition()
분해 모드에는 다음의 3 개의 값이 있습니다.
setDecomposition(int) ,
NO_DECOMPOSITION ,
CANONICAL_DECOMPOSITION ,
FULL_DECOMPOSITION public void setDecomposition(int decompositionMode)
decompositionMode - 새로운 분해 모드
IllegalArgumentException - 지정된 값이 유효한 분해 모드가 아니다
경우getDecomposition() ,
NO_DECOMPOSITION ,
CANONICAL_DECOMPOSITION ,
FULL_DECOMPOSITION public static Locale [] getAvailableLocales()
getInstance 메소드가 로컬라이즈 된 인스턴스를 돌려줄 수 있는 로케일 모든 배열을 돌려줍니다. 반환되는 배열은, Java 런타임 및 인스톨 되고 있는 CollatorProvider 구현에 의해 지원되고 있는 로케일의 화집합을 나타냅니다. 이것에는,Locale.US 와 등가인 Locale 인스턴스가 적어도 1 개(살) 포함되어 있을 필요가 있습니다.
Collator 인스턴스를 사용 가능한 로케일의 배열public Object clone()
Object 내의 clone Cloneable public boolean equals(Object that)
Comparator <Object > 내의 equals Object 내의 equals that - 비교 대조의 Collator
Object.hashCode() ,
Hashtable public abstract int hashCode()
Object 내의 hashCode Object.equals(java.lang.Object) ,
Hashtable
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.