sun.security.x509

Class RDN

java.lang.Object

sun.security.x509.RDN

public class RDN
extends java.lang.Object

RDNs are a set of {attribute = value} assertions. Some of those attributes are "distinguished" (unique w/in context). Order is never relevant. Some X.500 names include only a single distinguished attribute per RDN. This style is currently common. Note that DER-encoded RDNs sort AVAs by assertion OID ... so that when we parse this data we don't have to worry about canonicalizing it, but we'll need to sort them when we expose the RDN class more.

The ASN.1 for RDNs is:

 RelativeDistinguishedName ::=
   SET OF AttributeTypeAndValue

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

 AttributeType ::= OBJECT IDENTIFIER

 AttributeValue ::= ANY DEFINED BY AttributeType
 

Note that instances of this class are immutable.

Constructor Summary

Constructors

Constructor and Description
RDN(AVA ava)
RDN(AVA[] avas)
RDN(java.lang.String name) Constructs an RDN from its printable representation.
RDN(java.lang.String name, java.util.Map<java.lang.String,java.lang.String> keywordMap) Constructs an RDN from its printable representation.

Method Summary

Methods

Modifier and Type	Method and Description
java.util.List<AVA>	avas() Return an immutable List of the AVAs in this RDN.
boolean	equals(java.lang.Object obj)
int	hashCode()
int	size() Return the number of AVAs in this RDN.
java.lang.String	toRFC1779String()
java.lang.String	toRFC1779String(java.util.Map<java.lang.String,java.lang.String> oidMap)
java.lang.String	toRFC2253String()
java.lang.String	toRFC2253String(boolean canonical)
java.lang.String	toRFC2253String(java.util.Map<java.lang.String,java.lang.String> oidMap)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

RDN

public RDN(java.lang.String name)
    throws java.io.IOException

Constructs an RDN from its printable representation. An RDN may consist of one or multiple Attribute Value Assertions (AVAs), using '+' as a separator. If the '+' should be considered part of an AVA value, it must be preceded by '\'.

Parameters:

name - String form of RDN

Throws:

java.io.IOException - on parsing error

RDN

public RDN(java.lang.String name,
   java.util.Map<java.lang.String,java.lang.String> keywordMap)
    throws java.io.IOException

Constructs an RDN from its printable representation. An RDN may consist of one or multiple Attribute Value Assertions (AVAs), using '+' as a separator. If the '+' should be considered part of an AVA value, it must be preceded by '\'.

Parameters:

name - String form of RDN

keyword - an additional mapping of keywords to OIDs

Throws:

java.io.IOException - on parsing error

RDN

public RDN(AVA ava)

RDN

public RDN(AVA[] avas)

Method Detail

avas

public java.util.List<AVA> avas()

Return an immutable List of the AVAs in this RDN.

size

public int size()

Return the number of AVAs in this RDN.

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toRFC1779String

public java.lang.String toRFC1779String()

toRFC1779String

public java.lang.String toRFC1779String(java.util.Map<java.lang.String,java.lang.String> oidMap)

toRFC2253String

public java.lang.String toRFC2253String()

toRFC2253String

public java.lang.String toRFC2253String(java.util.Map<java.lang.String,java.lang.String> oidMap)

toRFC2253String

public java.lang.String toRFC2253String(boolean canonical)