netscape.ldap.util
Class RDN

java.lang.Object
  netscape.ldap.util.RDN

All Implemented Interfaces:

Serializable

public final class RDN

extends Object

implements Serializable

Objects of this class represent the components of a distinguished name (DN). (In some situations, these components are referred to as relative distinguished names, or RDNs.) For example, the DN "uid=bjensen, ou=People, o=Example.com" has three components: "uid=bjensen", "ou=People", and "o=Example.com".

Each DN component consists of an attribute type and a value. For example, in "o=Example.com", the attribute type is "o" and the value is "Example.com".

You can use objects of this class to add components to an existing DN object.

See Also:

DN, Serialized Form

Field Summary

static String[]	_cesAttributes
static String	CES_SYNTAX

Constructor Summary

RDN(String rdn)
Constructs a new RDN object from the specified DN component.

Method Summary

boolean	equals(RDN rdn) Determines if the current DN component is equal to the specified DN component.
String[]	explodeRDN(boolean noType) Deprecated. use toString or getValues instead.
static String[]	getAttributesForSyntax(String oid) Returns all attributes registered for the given syntax as a String Array.
static String	getAttributeSyntax(String attr) Returns the syntax for the attribute if the given attribute is registered in the internal attribute table.
String	getType() Deprecated. use getTypes() instead.
String[]	getTypes() Returns the attribute types of the DN component.
String	getValue() Deprecated. use getValues() instead.
String[]	getValues() Returns the values of the DN component.
boolean	isMultivalued() Returns true if the RDN is multi-valued.
static boolean	isRDN(String rdn) Determines if the specified string is a distinguished name component.
static void	registerAttributeSyntax(String attr, String oid) Registers the the given attribute for the given syntax in an internal table.
String	toString() Returns the string representation of the DN component.
static void	unregisterAttributeSyntax(String attr) Removes the the given attribute from the attribute syntax table.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

_cesAttributes

public static final String[] _cesAttributes

CES_SYNTAX

public static final String CES_SYNTAX

See Also:

Constant Field Values

Constructor Detail

RDN

public RDN(String rdn)

Constructs a new RDN object from the specified DN component.

Parameters:

rdn - DN component

Method Detail

explodeRDN

public String[] explodeRDN(boolean noType)

Deprecated. use toString or getValues instead.

Returns the DN component as the first element in an array of strings.

Parameters:

noType - specify true to ignore the attribute type and equals sign (for example, "cn=") and return only the value

Returns:

an array of strings representing the DN component.

getType

public String getType()

Deprecated. use getTypes() instead.

Returns the attribute type of the DN component.

Returns:

rdn the attribute type of the DN component.

getTypes

public String[] getTypes()

Returns the attribute types of the DN component.

Returns:

rdn the attribute types of the DN component.

getValue

public String getValue()

Deprecated. use getValues() instead.

Returns the value of the DN component.

Returns:

rdn the value of the DN component.

getValues

public String[] getValues()

Returns the values of the DN component.

Returns:

rdn the values of the DN component.

isMultivalued

public boolean isMultivalued()

Returns true if the RDN is multi-valued.

Returns:

true if the RDN is multi-valued.

toString

public String toString()

Returns the string representation of the DN component.

Returns:

the string representation of the DN component.

isRDN

public static boolean isRDN(String rdn)

Determines if the specified string is a distinguished name component.

Parameters:

rdn - the string to check

Returns:

true if the string is a distinguished name component.

equals

public boolean equals(RDN rdn)

Determines if the current DN component is equal to the specified DN component. Uses an internal table of ces (case exact string) attributes to determine how the attributes should be compared.

Parameters:

rdn - the DN component to compare against the current DN component.

Returns:

true if the two DN components are equal.

See Also:

registerAttributeSyntax(java.lang.String, java.lang.String), getAttributeSyntax(java.lang.String)

registerAttributeSyntax

public static void registerAttributeSyntax(String attr,
                                           String oid)

Registers the the given attribute for the given syntax in an internal table. This table is used for attribute comparison in the equals() method.

Parameters:

attr - the attribute to register.

oid - the syntax to register with the attribute.

See Also:

equals(netscape.ldap.util.RDN), unregisterAttributeSyntax(java.lang.String), getAttributeSyntax(java.lang.String), getAttributesForSyntax(java.lang.String)

unregisterAttributeSyntax

public static void unregisterAttributeSyntax(String attr)

Removes the the given attribute from the attribute syntax table.

Parameters:

attr - the attribute to remove.

See Also:

registerAttributeSyntax(java.lang.String, java.lang.String), getAttributeSyntax(java.lang.String), getAttributesForSyntax(java.lang.String)

getAttributeSyntax

public static String getAttributeSyntax(String attr)

Returns the syntax for the attribute if the given attribute is registered in the internal attribute table.

Parameters:

attr - the attribute to lookup in the table.

Returns:

the syntax of the attribute if found, null otherwise.

See Also:

unregisterAttributeSyntax(java.lang.String), registerAttributeSyntax(java.lang.String, java.lang.String), getAttributesForSyntax(java.lang.String)

getAttributesForSyntax

public static String[] getAttributesForSyntax(String oid)

Returns all attributes registered for the given syntax as a String Array.

Parameters:

oid - the syntax to look up in the table.

Returns:

all attributes for the given syntax as a String[]

See Also:

unregisterAttributeSyntax(java.lang.String), registerAttributeSyntax(java.lang.String, java.lang.String), getAttributeSyntax(java.lang.String)