org.forgerock.opendj.ldap

Class Ava

java.lang.Object

org.forgerock.opendj.ldap.Ava

All Implemented Interfaces:

Comparable<Ava>

public final class Ava
extends Object
implements Comparable<Ava>

An attribute value assertion (AVA) as defined in RFC 4512 section 2.3 consists of an attribute description with zero options and an attribute value.

The following are examples of string representations of AVAs:

 uid=12345
 ou=Engineering
 cn=Kurt Zeilenga
 

Note: The name AVA is historical, coming from X500/LDAPv2. However, in LDAP context, this class actually represents an AttributeTypeAndValue.

See Also:

RFC 4512 - Lightweight Directory Access Protocol (LDAP): Directory Information Models

Constructor Summary

Constructors

Constructor and Description
Ava(AttributeType attributeType, Object attributeValue) Creates a new attribute value assertion (AVA) using the provided attribute type and value.
Ava(AttributeType attributeType, String attributeName, Object attributeValue) Creates a new attribute value assertion (AVA) using the provided attribute type, name and value.
Ava(String attributeType, Object attributeValue) Creates a new attribute value assertion (AVA) using the provided attribute type and value decoded using the default schema.

Method Summary

Modifier and Type	Method and Description
int	compareTo(Ava ava)
boolean	equals(Object obj)
String	getAttributeName() Returns the attribute name associated with this AVA.
AttributeType	getAttributeType() Returns the attribute type associated with this AVA.
ByteString	getAttributeValue() Returns the attribute value associated with this AVA.
int	hashCode()
Attribute	toAttribute() Returns a single valued attribute having the same attribute type and value as this AVA.
String	toString()
static Ava	valueOf(String ava) Parses the provided LDAP string representation of an AVA using the default schema.
static Ava	valueOf(String ava, Schema schema) Parses the provided LDAP string representation of an AVA using the provided schema.

Methods inherited from class java.lang.Object

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

Constructor Detail

Ava

public Ava(AttributeType attributeType,
           Object attributeValue)

Creates a new attribute value assertion (AVA) using the provided attribute type and value.

If attributeValue is not an instance of ByteString then it will be converted using the ByteString.valueOfObject(Object) method.

Parameters:

attributeType - The attribute type.

attributeValue - The attribute value.

Throws:

NullPointerException - If attributeType or attributeValue was null.

Ava

public Ava(AttributeType attributeType,
           String attributeName,
           Object attributeValue)

Creates a new attribute value assertion (AVA) using the provided attribute type, name and value.

If attributeValue is not an instance of ByteString then it will be converted using the ByteString.valueOfObject(Object) method.

Parameters:

attributeType - The attribute type.

attributeName - The user provided attribute name.

attributeValue - The attribute value.

Throws:

NullPointerException - If attributeType, attributeName or attributeValue was null.

Ava

public Ava(String attributeType,
           Object attributeValue)

Creates a new attribute value assertion (AVA) using the provided attribute type and value decoded using the default schema.

If attributeValue is not an instance of ByteString then it will be converted using the ByteString.valueOfObject(Object) method.

Parameters:

attributeType - The attribute type.

attributeValue - The attribute value.

Throws:

UnknownSchemaElementException - If attributeType was not found in the default schema.

NullPointerException - If attributeType or attributeValue was null.

Method Detail

valueOf

public static Ava valueOf(String ava)

Parses the provided LDAP string representation of an AVA using the default schema.

Parameters:

ava - The LDAP string representation of an AVA.

Returns:

The parsed RDN.

Throws:

LocalizedIllegalArgumentException - If ava is not a valid LDAP string representation of a AVA.

NullPointerException - If ava was null.

valueOf

public static Ava valueOf(String ava,
                          Schema schema)

Parses the provided LDAP string representation of an AVA using the provided schema.

Parameters:

ava - The LDAP string representation of a AVA.

schema - The schema to use when parsing the AVA.

Returns:

The parsed AVA.

Throws:

LocalizedIllegalArgumentException - If ava is not a valid LDAP string representation of a AVA.

NullPointerException - If ava or schema was null.

compareTo

public int compareTo(Ava ava)

Specified by:

compareTo in interface Comparable<Ava>

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

getAttributeType

public AttributeType getAttributeType()

Returns the attribute type associated with this AVA.

Returns:

The attribute type associated with this AVA.

getAttributeName

public String getAttributeName()

Returns the attribute name associated with this AVA.

Returns:

The attribute name associated with this AVA.

getAttributeValue

public ByteString getAttributeValue()

Returns the attribute value associated with this AVA.

Returns:

The attribute value associated with this AVA.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toAttribute

public Attribute toAttribute()

Returns a single valued attribute having the same attribute type and value as this AVA.

Returns:

A single valued attribute having the same attribute type and value as this AVA.

toString

public String toString()

Overrides:

toString in class Object