Java in a Nutshell, 5th Edition [Electronic resources]

This class implements the java.security.Principal interface for entities represented by X.500 distinguished names (such as "CN=David,O=davidflanagan.com,C=US"). The constructor methods can accept the distinguished name in string form or in binary encoded form. getName( ) returns the name in string form, using the format defined by one of the three consant values. The no-argument version of getName( ) (the one defined by the Principal interface) returns the distinguished name formatted as specified by RFC 2253. Finally, getEncoded( ) returns a binary-encoded form of the name.

public final class

X500Principal implements java.security.Principal, Serializable { // Public Constructors public

X500Principal (java.io.InputStream

is ); public

X500Principal (String

name ); public

X500Principal (byte[ ]

name ); // Public Constants public static final String

CANONICAL ; ="CANONICAL" public static final String

RFC1779 ; ="RFC1779" public static final String

RFC2253 ; ="RFC2253" // Public Instance Methods public byte[ ]

getEncoded ( ); public String

getName (String

format ); // Methods Implementing Principal public boolean

equals (Object

o ); public String

getName ( ); public int

hashCode ( ); public String

toString ( ); }

Passed To

java.security.cert.TrustAnchor.TrustAnchor( ), java.security.cert.X509CertSelector.{setIssuer( ), setSubject( )}, java.security.cert.X509CRLSelector.addIssuer( )

Returned By

java.security.cert.TrustAnchor.getCA( ), java.security.cert.X509Certificate.{getIssuerX500Principal( ), getSubjectX500Principal( )}, java.security.cert.X509CertSelector.{getIssuer( ), getSubject( )}, java.security.cert.X509CRL.getIssuerX500Principal( ), java.security.cert.X509CRLEntry.getCertificateIssuer( )