javax.security.auth.x500
클래스 X500Principal

java.lang.Object 
  |
  +--javax.security.auth.x500.X500Principal

모든 구현 인터페이스:

Principal , Serializable

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 (어느쪽이나 가능)으로 정의된 문법을 사용해 지정할 필요가 있습니다.

이 constructor 은 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 표현을 복호화(decode) 하는 것으로 얻을 수 있는 Unicode 캐릭터 라인이 됩니다.

형식에 "CANONICAL" 를 지정했을 경우, 이 메소드는 RFC 2253 에 적합해, 다음과 같이 표준화 된 캐릭터 라인 표현을 돌려줍니다.

1. 선두의 0 은 닷 단락의 10 진 OID 로서 encode 된 속성의 형태로부터 제거된다
2. PrintableString 형 및 UTF8String 형의 DirectoryString 속성치는 16 진수 형식에서는 출력되지 않는다
3. PrintableString 및 UTF8String 이외의 형태의 DirectoryString 속성치는 16 진수 형식에서 출력된다
4. 전후의 공백 캐릭터가, 16 진수 이외의 속성치로부터 제거된다 (값이 공백 캐릭터를 포함해 구성되어 있는 경우 이외)
5. 1 kr 이상의 공백 캐릭터로부터 되는 내부의 부분 캐릭터 라인은 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

hashCode

public int hashCode()

이 X500Principal 의 해시 코드를 돌려줍니다.

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

정의:

인터페이스 Principal 내의 hashCode

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 X500Principal 의 해시 코드