|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
java.lang.Objectjavax.naming.ldap.LdapName
public class LdapName
이 클래스는,RFC 2253 으로 지정되고 있는 식별명을 나타냅니다. 식별명 (DN)은, 「상대 식별명 (RDN)」로 불리는 컴퍼넌트군의 순서 첨부 리스트입니다. DN 의 자세한 것은, RFC 2253 에 기재되어 있습니다.
이 클래스는, RFC 2253 으로 보여지는 몇개의 애매한 점을 분명히 합니다.
LdapName
에게 건네지는 캐릭터 라인명이나 LdapName
로부터 반환되는 캐릭터 라인명은, 완전한 Unicode 캐릭터 세트를 사용합니다. 이러한 캐릭터 라인명에는, 「\B4」와 같은 3 문자의 서브 캐릭터 라인으로 나타내지는 8중창마다, UTF-8 에 encode 되는 문자를 포함할 수가 있습니다. 한편, 캐릭터 라인내의 단일의 문자로 나타내지는 8중창마다 UTF-8 에 encode 되는 문자를 포함할 수 없습니다. 이 기술은, 의미가 약간 애매합니다.
LdapName
는, 유효한 이름을 모두 적절히 해석하는 한편으로, 무효인 이름의 해석시에는, 위반의 가능성을 완전하게는 검출하지 않습니다. 즉, 무효인 이름에 대해서 「관대」입니다. 이름의 유효성은, 최종적으로 LDAP 서버에게 건네진 시점에서 판정됩니다. LDAP 서버는, schema 정보나 상호 운용의 요건등의 각종 요인에 근거해, 건네받은 이름을 받아들이는지 거부합니다.
동등성, 속성의 형태, 바이너리치 및 캐릭터 라인치의 테스트시에, 이름을 구성하는 알파벳의 대문자와 소문자는 구별되지 않습니다. 인용, 이스케이프, UTF-8 의 16 진인코딩이 같으면, 캐릭터 라인치 그 자체가 차이가 나도, 동일한 캐릭터 라인이라고 보여집니다. 복수의 값을 가지는 RDN ( 「ou=Sales+cn=Bob」등)의 컴퍼넌트의 순서는, 특히 중요하지는 않습니다.
LDAP 명의 컴퍼넌트 (RDN)에는 번호를 붙일 수 있고 있습니다. n 개의 RDN 로부터 되는 LDAP 명의 인덱스의 범위는 0 ~ (n-1)여,[0, n] 와 같이 기술됩니다. 제일 오른쪽의 RDN 는 인덱스 0, 제일왼쪽의 RDN 는 인덱스 n-1 입니다. 예를 들어, 「CN=Steve Kille, O=Isode Limited, C=GB」라고 하는 식별명에는,{C=GB, O=Isode Limited, CN=Steve Kille} 의 오른쪽으로부터 순서에, 0, 1, 2 의 순서로 번호를 붙일 수 있습니다. 빈 상태(empty)의 LDAP 명은, 빈 상태(empty)의 RDN 리스트로 나타내집니다.
LdapName 의 인스턴스에 대한 읽기 전용의 동시 multi-thread 액세스는, 반드시 동기 시키지 않아도 괜찮습니다.
별도 지정된 사항이 없는 경우, null 인수를 생성자 , 또는 이 클래스의 메소드에 건네주면(자), NullPointerException 가 throw 됩니다.
생성자 의 개요 | |
---|---|
LdapName (List <Rdn > rdns)
해석이 끝난 RDN 컴퍼넌트를 지정해 LDAP 명을 작성합니다. |
|
LdapName (String name)
식별명을 지정해 LDAP 명을 작성합니다. |
메소드의 개요 | |
---|---|
Name |
add (int posn,
Rdn comp)
단일의 RDN 를, 이 LDAP 명의 지정의 위치에 추가합니다. |
Name |
add (int posn,
String comp)
단일의 컴퍼넌트를, 이 LDAP 명의 지정의 위치에 추가합니다. |
Name |
add (Rdn comp)
단일의 RDN 를 이 LDAP 명의 마지막에 추가합니다. |
Name |
add (String comp)
단일의 컴퍼넌트를 이 LDAP 명의 마지막에 추가합니다. |
Name |
addAll (int posn,
List <Rdn > suffixRdns)
이름의 RDN 를, 이 이름의 지정의 위치에 순서에 추가합니다. |
Name |
addAll (int posn,
Name suffix)
이름의 컴퍼넌트를, 이 이름의 지정한 위치에 순서에 추가합니다. |
Name |
addAll (List <Rdn > suffixRdns)
이름의 RDN 를, 이 이름의 말미에 순서에 추가합니다. |
Name |
addAll (Name suffix)
이름의 컴퍼넌트를, 이 이름의 말미에 순서에 추가합니다. |
Object |
clone ()
이 이름의 카피를 생성합니다. |
int |
compareTo (Object obj)
LdapName 와 지정된 Object 의 순서를 비교합니다. |
boolean |
endsWith (List <Rdn > rdns)
지정의 RDN 순서가 이 LDAP 명의 접미사(suffix)이 될지 어떨지를 판정합니다. |
boolean |
endsWith (Name n)
이 LDAP 명이 지정의 LDAP 명의 접미사(suffix)로 끝날지 어떨지가 판정됩니다. |
boolean |
equals (Object obj)
2 개의 LDAP 명이 동일한지 어떤지를 판정합니다. |
String |
get (int posn)
이 LDAP 명의 컴퍼넌트를 캐릭터 라인으로서 가져옵니다. |
Enumeration <String > |
getAll ()
이 이름의 컴퍼넌트를, 캐릭터 라인의 열거로서 가져옵니다. |
Name |
getPrefix (int posn)
컴퍼넌트가 이 LDAP 명의 컴퍼넌트의 접두사로 구성되는 이름을 작성합니다. |
Rdn |
getRdn (int posn)
이 LDAP 명의 RDN 를 Rdn 로서 가져옵니다. |
List <Rdn > |
getRdns ()
상대 식별명의 리스트를 가져옵니다. |
Name |
getSuffix (int posn)
컴퍼넌트가 이 LDAP 명의 컴퍼넌트의 접미사(suffix)을 구성하는 이름을 작성합니다. |
int |
hashCode ()
이 LDAP 명의 해시 코드를 계산합니다. |
boolean |
isEmpty ()
이 LDAP 명이 빈 상태(empty)인가 어떤가를 판정합니다. |
Object |
remove (int posn)
이 LDAP 명으로부터 컴퍼넌트를 삭제합니다. |
int |
size ()
이 LDAP 명의 컴퍼넌트수를 가져옵니다. |
boolean |
startsWith (List <Rdn > rdns)
지정의 RDN 순서가 이 LDAP 명의 접두사가 될지 어떨지를 판정합니다. |
boolean |
startsWith (Name n)
이 LDAP 명이 지정의 LDAP 명의 접두사로 시작될지 어떨지가 판정됩니다. |
String |
toString ()
RFC 2253 에 정의되어 클래스의 설명에 기재되어 있는 서식에서, 이 LDAP 명의 캐릭터 라인 표현을 돌려줍니다. |
클래스 java.lang. Object 로부터 상속된 메소드 |
---|
finalize , getClass , notify , notifyAll , wait , wait , wait |
생성자 의 상세 |
---|
public LdapName(String name) throws InvalidNameException
name
- RFC 2253 에
지정된 서식의 null 이외의 식별명
InvalidNameException
- 구문 위반이 검출되었을 경우Rdn.escapeValue(Object value)
public LdapName(List <Rdn > rdns)
리스트내의 RDN 의 인덱스는, 클래스의 설명에 기술된 RDN 의 번호부에 따라 붙일 수 있습니다.
rdns
- 이 LDAP 명을 구성하는 Rdn 의 null 이외의 리스트메소드의 상세 |
---|
public int size()
Name
내의 size
public boolean isEmpty()
Name
내의 isEmpty
public Enumeration <String > getAll()
Name
내의 getAll
public String get(int posn)
Name
내의 get
posn
- 취득하는 컴퍼넌트의 0 으로부터 시작되는 인덱스.
범위는 [0, size()] 가 아니면 안된다
IndexOutOfBoundsException
- 위치가 지정한 범위에 없는 경우public Rdn getRdn(int posn)
posn
- 취득하는 RDN 의 0 으로부터 시작되는 인덱스.
범위는 [0, size()] 가 아니면 안된다
IndexOutOfBoundsException
- 위치가 지정한 범위에 없는 경우public Name getPrefix(int posn)
Name
내의 getPrefix
posn
- 정지하는 컴퍼넌트의 0 으로부터 시작되는 인덱스.
범위는 [0, size()] 가 아니면 안된다
IndexOutOfBoundsException
- 위치가 지정한 범위에 없는 경우public Name getSuffix(int posn)
Name
내의 getSuffix
posn
- 개시하는 컴퍼넌트의 0 으로부터 시작되는 인덱스.
범위는 [0, size()] 가 아니면 안된다
IndexOutOfBoundsException
- 위치가 지정한 범위에 없는 경우public boolean startsWith(Name n)
Name
내의 startsWith
n
- 체크 대상의 LDAP 명
getPrefix(int posn)
public boolean startsWith(List <Rdn > rdns)
rdns
- 체크하는 Rdn 순서
public boolean endsWith(Name n)
Name
내의 endsWith
n
- 체크 대상의 LDAP 명
getSuffix(int posn)
public boolean endsWith(List <Rdn > rdns)
rdns
- 체크하는 Rdn 순서
public Name addAll(Name suffix) throws InvalidNameException
Name
내의 addAll
suffix
- 추가하는 null 이외의 컴퍼넌트
InvalidNameException
- suffix 가 유효한 LDAP 명이 아닌 경우,
또는 컴퍼넌트의 추가가 이 LDAP 명의 구문 규칙에
위반하는 경우public Name addAll(List <Rdn > suffixRdns)
suffixRdns
- 추가하는 null 이외의 접미사(suffix) Rdn
public Name addAll(int posn, Name suffix) throws InvalidNameException
Name
내의 addAll
suffix
- 추가하는 null 이외의 컴퍼넌트posn
- 새로운 컴퍼넌트가 추가되는 인덱스.
범위는 [0, size()] 가 아니면 안된다
InvalidNameException
- suffix 가 유효한 LDAP 명이 아닌 경우,
또는 컴퍼넌트의 추가가 이 LDAP 명의 구문 규칙에
위반하는 경우
IndexOutOfBoundsException.
- 위치가 지정한 범위에 없는 경우public Name addAll(int posn, List <Rdn > suffixRdns)
suffixRdns
- 추가하는 null 이외의 접미사(suffix) Rdnposn
- RDN 가 추가되는 인덱스.
범위는 [0, size()] 가 아니면 안된다
IndexOutOfBoundsException.
- 위치가 지정한 범위에 없는 경우public Name add(String comp) throws InvalidNameException
Name
내의 add
comp
- 추가하는 null 이외의 컴퍼넌트
InvalidNameException
- 이름의 마지막에 컴퍼넌트를 추가하면(자), 이름의 구문에 위반하는 경우public Name add(Rdn comp)
comp
- 추가하는 null 이외의 RDN
public Name add(int posn, String comp) throws InvalidNameException
Name
내의 add
comp
- 추가하는 null 이외의 컴퍼넌트posn
- 새로운 컴퍼넌트가 추가되는 인덱스.
범위는 [0, size()] 가 아니면 안된다
IndexOutOfBoundsException.
- 위치가 지정한 범위에 없는 경우
InvalidNameException
- 지정한 위치에 컴퍼넌트를 추가하면(자), 이름의 구문에 위반하는 경우public Name add(int posn, Rdn comp)
comp
- 추가하는 null 이외의 RDNposn
- 새로운 RDN 가 추가되는 인덱스.
범위는 [0, size()] 가 아니면 안된다
IndexOutOfBoundsException
- 위치가 지정한 범위에 없는 경우public Object remove(int posn) throws InvalidNameException
Name
내의 remove
posn
- 삭제하는 컴퍼넌트의 인덱스.
범위는 [0, size()] 가 아니면 안된다
IndexOutOfBoundsException
- 위치가 지정한 범위에 없는 경우
InvalidNameException
- 컴퍼넌트의 삭제가 이 이름의 구문 규칙에 위반하는 경우public List <Rdn > getRdns()
Rdn
클래스의 인스턴스인 RDN 의 리스트로 나타내지는 이름public Object clone()
Name
내의 clone
Object
내의 clone
Cloneable
public String toString()
Object
내의 toString
public boolean equals(Object obj)
한편의 LDAP 명의 RDN 가 이제(벌써) 한편의 LDAP 명의 대응하는 RDN 와 동일하면, 2 개의 LDAP 명은 동일하게 됩니다. 이것은, 2 개의 LDAP 명이 같은 수의 RDN 로부터 구성되어 대응하는 각각의 RDN 의 equals() 테스트가 true 를 돌려주는 것을 의미합니다. RDN 의 동등성의 정의에 대해서는,Rdn.equals(Object obj)
를 참조해 주세요.
Object
내의 equals
obj
- null 의 가능성이 있는 비교 대조 객체
hashCode()
public int compareTo(Object obj)
obj 가 null 인지, LdapName 의 인스턴스가 아닌 경우는, ClassCastException 가 throw 됩니다.
LDAP 명의 순서부는, 문자를 비교할 때의 사전적인 규칙에 따릅니다. LDAP 명에 포함되는 모든 RDN 에 확장자(extension)가 적용됩니다. 모든 RDN 는 지정순서에 늘어놓을 수 있어 사전적으로 비교됩니다. RDN 의 비교 규칙에 대해서는,Rdn.compareTo(Object obj)
를 참조해 주세요.
이 LDAP 명이 사전적으로 obj 보다 짧은 경우, 부의 수가 돌려주어집니다. 이 LDAP 명이 사전적으로 obj 보다 긴 경우, 정의 수가 돌려주어집니다.
Comparable <Object >
내의 compareTo
Name
내의 compareTo
obj
- 비교되는 null 이외의 LdapName
ClassCastException
- obj 가 LdapName 가 아닌 경우Comparable.compareTo(Object)
public int hashCode()
Object
내의 hashCode
equals(java.lang.Object)
|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.