Package org.forgerock.opendj.ldap

Class Attributes

java.lang.Object
org.forgerock.opendj.ldap.Attributes
public final class Attributes extends Object
This class contains methods for creating and manipulating attributes.

  • Method Details

    • emptyAttribute

      public static Attribute emptyAttribute(AttributeDescription attributeDescription)
      Returns a read-only empty attribute having the specified attribute description. Attempts to modify the returned attribute either directly, or indirectly via an iterator, result in an UnsupportedOperationException.
      Parameters:
      attributeDescription - The attribute description.
      Returns:
      The empty attribute.
      Throws:
      NullPointerException - If attributeDescription was null.

    • emptyAttribute

      public static Attribute emptyAttribute(String attributeDescription)
      Returns a read-only empty attribute having the specified attribute description. The attribute description will be decoded using the default schema. Attempts to modify the returned attribute either directly, or indirectly via an iterator, result in an UnsupportedOperationException.
      Parameters:
      attributeDescription - The attribute description.
      Returns:
      The empty attribute.
      Throws:
      org.forgerock.i18n.LocalizedIllegalArgumentException - If attributeDescription could not be decoded using the default schema.
      NullPointerException - If attributeDescription was null.

    • renameAttribute

      public static Attribute renameAttribute(Attribute attribute, AttributeDescription attributeDescription)
      Returns a view of attribute having a different attribute description. All operations on the returned attribute "pass-through" to the underlying attribute.
      Parameters:
      attribute - The attribute to be renamed.
      attributeDescription - The new attribute description for attribute.
      Returns:
      A renamed view of attribute.
      Throws:
      NullPointerException - If attribute or attributeDescription was null.

    • renameAttribute

      public static Attribute renameAttribute(Attribute attribute, String attributeDescription)
      Returns a view of attribute having a different attribute description. All operations on the returned attribute "pass-through" to the underlying attribute. The attribute description will be decoded using the default schema.
      Parameters:
      attribute - The attribute to be renamed.
      attributeDescription - The new attribute description for attribute.
      Returns:
      A renamed view of attribute.
      Throws:
      org.forgerock.i18n.LocalizedIllegalArgumentException - If attributeDescription could not be decoded using the default schema.
      NullPointerException - If attribute or attributeDescription was null.

    • singletonAttribute

      public static Attribute singletonAttribute(AttributeDescription attributeDescription, Object value)
      Returns a read-only single-valued attribute having the specified attribute description and value. Attempts to modify the returned attribute either directly, or indirectly via an iterator, result in an UnsupportedOperationException.

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

      Parameters:
      attributeDescription - The attribute description.
      value - The single attribute value.
      Returns:
      The single-valued attribute.
      Throws:
      NullPointerException - If attributeDescription or value was null.

    • singletonAttribute

      public static Attribute singletonAttribute(String attributeDescription, Object value)
      Returns a read-only single-valued attribute having the specified attribute description. The attribute description will be decoded using the default schema. Attempts to modify the returned attribute either directly, or indirectly via an iterator, result in an UnsupportedOperationException.

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

      Parameters:
      attributeDescription - The attribute description.
      value - The single attribute value.
      Returns:
      The single-valued attribute.
      Throws:
      org.forgerock.i18n.LocalizedIllegalArgumentException - If attributeDescription could not be decoded using the default schema.
      NullPointerException - If attributeDescription or value was null.

    • unmodifiableAttribute

      public static Attribute unmodifiableAttribute(Attribute attribute)
      Returns a read-only view of attribute. Query operations on the returned attribute "read-through" to the underlying attribute, and attempts to modify the returned attribute either directly or indirectly via an iterator result in an UnsupportedOperationException.
      Parameters:
      attribute - The attribute for which a read-only view is to be returned.
      Returns:
      A read-only view of attribute.
      Throws:
      NullPointerException - If attribute was null.