javax.security.auth.x500
클래스 X500Principal

java.lang.Object 
  javax.security.auth.x500.X500Principal

모든 구현된 인터페이스:

Serializable, Principal

public final class X500Principal
extends Object 
implements Principal,
 Serializable 

이 클래스는 X. 500 Principal를 나타냅니다. X500Principal는 「CN=Duke, OU=JavaSoft, O=Sun Microsystems, C=US」와 같은 식별명으로 표기됩니다.

이 클래스는 식별명의 캐릭터 라인 표현을 사용하는지, 식별명의 ASN. 1 DER encode 바이트 표현을 사용해 인스턴스화 됩니다. 식별명의 캐릭터 라인 표현에 대한 현재의 사양은, RFC 2253 으로 정의되고 있습니다. 그러나, RFC 2253 으로 RFC 1779 양쪽 모두에 기술된 캐릭터 라인 형식도 가능하고, 또한, RFC 2459 로 OID (Object Identifier)가 정의되고 있는 속성의 형태 키워드도 인식합니다.

이 X500Principal 캐릭터 라인 표현은, getName 메서드를 호출하는 것으로 취득할 수 있습니다.

X509Certificate getSubjectX500Principal 메서드와 getIssuerX500Principal 메서드는 인증서 의 발행자 필드와 피인증자 필드를 나타내는 X500Principal를 리턴합니다.

도입된 버전 :

1.4

관련 항목:

X509Certificate, 직렬화 된 형식

필드 개요

static String	CANONICAL Distinguished Name 표준적인 String 형식입니다.
static String	RFC1779 Distinguished Name RFC 1779 String 형식입니다.
static String	RFC2253 Distinguished Name RFC 2253 String 형식입니다.

생성자 개요

X500Principal (byte[] name)
ASN. 1 DER encode 형식의 식별명으로부터 X500Principal를 작성합니다.

X500Principal (InputStream is)
ASN. 1 DER encode 형식의 식별명을 포함한 InputStream로 부터 X500Principal를 작성합니다.

X500Principal (String name)
X. 500 식별명 (예: CN=Duke, OU=JavaSoft, O=Sun Microsystems, C=US)의 캐릭터 라인 표현으로부터 X500Principal를 작성합니다.

메서드 개요

boolean	equals (Object o) 지정된 Object 곳의 X500Principal가 동일한지 어떤지를 비교합니다.
byte[]	getEncoded () ASN. 1 DER encode 형식의 식별명을 리턴합니다.
String	getName () RFC 2253 으로 정의된 형식에서 X. 500 식별명의 캐릭터 라인 형식을 리턴합니다.
String	getName (String format) 지정한 형식에서 X. 500 식별명의 캐릭터 라인 형식을 리턴합니다.
int	hashCode () 이 X500Principal 해시 코드를 리턴합니다.
String	toString () 이 X500Principal, 사용자가 사용하기 쉬운 캐릭터 라인 형식을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

필드의 상세

RFC1779

public static final String  RFC1779

Distinguished Name RFC 1779 String 형식입니다.

관련 항목:

정수 필드값

RFC2253

public static final String  RFC2253

Distinguished Name RFC 2253 String 형식입니다.

관련 항목:

정수 필드값

CANONICAL

public static final String  CANONICAL

Distinguished Name 표준적인 String 형식입니다.

관련 항목:

정수 필드값

생성자 상세

X500Principal

public X500Principal(String  name)

X. 500 식별명 (예: CN=Duke, OU=JavaSoft, O=Sun Microsystems, C=US)의 캐릭터 라인 표현으로부터 X500Principal를 작성합니다. 식별명은 RFC 1779 나 RFC 2253 (어느쪽이나 가능)으로 정의된 문법을 사용해 지정할 필요가 있습니다.

이 생성자는 RFC 1779 로 RFC 2253 으로 정의되었다 (그리고 getName(String format) 로 리스트 된다) 속성의 형태 키워드를 인식할 뿐만 아니라, RFC 2459 로 정의된 OID를 가지는 T, DNQ 또는 DNQUALIFIER, SURNAME, GIVENNAME, INITIALS, GENERATION, EMAILADDRESS, SERIALNUMBER 각 키워드 및 그 직후의 키워드도 인식합니다. 그 다른 속성의 형태는 OID 로 지정할 필요가 있습니다.

파라미터:

name - RFC 1779 형식 또는 RFC 2253 형식의 X. 500 식별명

예외:

NullPointerException - name가 null인 경우

IllegalArgumentException - name 지정이 올바르지 않은 경우

X500Principal

public X500Principal(byte[] name)

ASN. 1 DER encode 형식의 식별명으로부터 X500Principal를 작성합니다. 이 구조체의 ASN. 1 표기는 다음과 같이 됩니다.

 Name ::= CHOICE {
   RDNSequence }

 RDNSequence ::= SEQUENCE OF RelativeDistinguishedName

 RelativeDistinguishedName ::=
   SET SIZE (1 .. MAX) OF AttributeTypeAndValue

 AttributeTypeAndValue ::= SEQUENCE {
   type     AttributeType,
   value    AttributeValue }

 AttributeType ::= OBJECT IDENTIFIER

 AttributeValue ::= ANY DEFINED BY AttributeType
 ....
 DirectoryString ::= CHOICE {
       teletexString           TeletexString (SIZE (1..MAX)),
       printableString         PrintableString (SIZE (1..MAX)),
       universalString         UniversalString (SIZE (1..MAX)),
       utf8String              UTF8String (SIZE (1.. MAX)),
       bmpString               BMPString (SIZE (1..MAX)) }
 

파라미터:

name - ASN. 1 DER encode 형식에 한 식별명을 포함한 바이트 배열

예외:

IllegalArgumentException - encode 에러가 발생했을 경우 (DN 부정한 형식)

X500Principal

public X500Principal(InputStream  is)

ASN. 1 DER encode 형식의 식별명을 포함한 InputStream로 부터 X500Principal를 작성합니다. 이 구조체의 ASN. 1 표기는 X500Principal(byte[] name) 로 설명하고 있습니다.

입력 스트림의 read 위치는 encode 한 식별명의 후에 오는 다음의 이용 가능한 바이트가 됩니다.

파라미터:

is - ASN. 1 DER encode 형식에 한 식별명을 포함한 InputStream

예외:

NullPointerException - InputStream가 null인 경우

IllegalArgumentException - encode 에러가 발생했을 경우 (DN 부정한 형식)

메서드의 상세

getName

public String  getName()

RFC 2253 으로 정의된 형식에서 X. 500 식별명의 캐릭터 라인 형식을 리턴합니다.

이 메서드는 getName(X500Principal.RFC2253)를 호출하는 것으로 같습니다.

정의:

인터페이스 Principal 내의 getName

반환값:

이 X500Principal 식별명

getName

public String  getName(String  format)

지정한 형식에서 X. 500 식별명의 캐릭터 라인 형식을 리턴합니다. 형식으로 지정하는 유효한 값은 「RFC1779」, 「RFC2253」, 「CANONICAL」(대문자와 소문자를 구별한다)의 어떤 것인가입니다.

형식에 「RFC1779」를 지정했을 경우, 이 메서드는 RFC 1779 로 정의되고 있는 속성의 형태 키워드 (CN, L, ST, O, OU, C, STREET)를 발행합니다. 그 다른 속성의 형태는 OID 로서 발행됩니다.

형식에 「RFC2253」를 지정했을 경우, 이 메서드는 RFC 2253 으로 정의되고 있는 속성의 형태 키워드 (CN, L, ST, O, OU, C, STREET, DC, UID)를 발행합니다. 엄밀하게 해석하면, RFC 2253 에서는 UTF-8 캐릭터 라인 표현만을 지정할 수 있습니다. 이 메서드가 돌려주는 String는 이 UTF-8 표현을 복호화 하는 것으로 얻을 수 있는 Unicode 캐릭터 라인이 됩니다.

형식에 「CANONICAL」를 지정했을 경우, 이 메서드는 RFC 2253에 적합해, 다음과 같이 표준화 된 캐릭터 라인 표현을 리턴합니다.

1. 선두의 0 은 닷 단락의 10 진 OID 로서 encode 된 속성의 형태로부터 제거된다
2. PrintableString 형 및 UTF8String 형의 DirectoryString 속성값는 16 진수 형식에서는 출력되지 않는다
3. PrintableString 및 UTF8String 이외의 형태의 DirectoryString 속성값는 16 진수 형식에서 출력된다
4. 전후의 공백 문자가 16 진수 이외의 속성값로부터 제거된다 (값이 공백 문자를 포함해 구성되어 있는 경우 이외)
5. 1개 이상의 공백 문자로부터 되는 내부의 부분 캐릭터 라인은 16 진수 이외의 속성값에서는 1개의 공백 문자에 변환된다
6. 복수의 Attribute Value Assertion (AVA)를 포함한 Relative Distinguished Name는 표준 키워드를 포함한 AVA 알파벳순서, 그리고 OID 키워드를 포함한 AVA 숫자순서에 출력된다
7. 이스케이프 되는 속성값의 문자는 RFC 2253 섹션 2.4 로 이스케이프 된다고 기술되고 있는 문자 뿐이다 (backslash 문자를 앞에 두고 붙이는 것으로 이스케이프 된다)
8. 이름 전체는 String.toUpperCase(Locale.US)를 사용해 대문자에 변환된다
9. 이름 전체는 String.toLowerCase(Locale.US)를 사용해 소문자에 변환된다
10. 이름은 Unicode Standard와 UAX #15에 기술되고 있는 정규화 형식 KD를 사용해, 최종적으로 정규화된다

장래, 표준 형식이 추가 도입될 가능성이 있습니다.

파라미터:

format - 사용하는 형식

반환값:

지정한 형식을 사용한, 이 X500Principal 캐릭터 라인 형식

예외:

IllegalArgumentException - 지정된 형식이 무효인 경우

getEncoded

public byte[] getEncoded()

ASN. 1 DER encode 형식의 식별명을 리턴합니다. 이 구조체의 ASN. 1 표기는 X500Principal(byte[] name) 로 설명하고 있습니다.

이후의 변경으로부터 보호하기 위해서 리턴된 바이트 배열의 복제가 작성됩니다.

반환값:

ASN. 1 DER encode 형식에 한 식별명을 포함한 바이트 배열

toString

public String  toString()

이 X500Principal, 사용자가 사용하기 쉬운 캐릭터 라인 형식을 리턴합니다.

정의:

인터페이스 Principal 내의 toString

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 X500Principal 캐릭터 라인 표현

equals

public boolean equals(Object  o)

지정된 Object 곳의 X500Principal가 동일한지 어떤지를 비교합니다.

특히, Object o가 X500Principal 이며, 이 객체와 o 표준적인 캐릭터 라인 표현 (getName(X500Principal.CANONICAL) 메서드로 취득)가 동일한 경우에 이 메서드는 true를 리턴합니다.

이 구현은 RFC 2459 요건에 준거하고 있습니다.

정의:

인터페이스 Principal 내의 equals

오버라이드(override):

클래스 Object 내의 equals

파라미터:

o - 이 X500Principal와 동일한지 어떤지가 비교되는 Object

반환값:

지정한 Object이 이 X500Principal와 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 X500Principal 해시 코드를 리턴합니다.

해시 코드는 getName(X500Principal.CANONICAL). hashCode()로 계산됩니다.

정의:

인터페이스 Principal 내의 hashCode

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 X500Principal 해시 코드

관련 항목:

Object.equals(java.lang.Object), Hashtable