Package com.unboundid.ldap.sdk

Class ReadOnlyEntry

java.lang.Object

com.unboundid.ldap.sdk.Entry

com.unboundid.ldap.sdk.ReadOnlyEntry

All Implemented Interfaces:

LDIFRecord, Serializable

Direct Known Subclasses:

AlarmEntry, AlertEntry, ChangeLogEntry, DraftChuLDAPLogSchema00Entry, EffectiveRightsEntry, JoinedEntry, RootDSE, SearchResultEntry, SoftDeletedEntry

@NotExtensible
@NotMutable
@ThreadSafety(level=COMPLETELY_THREADSAFE)
public class ReadOnlyEntry
extends Entry

This class defines an Entry subclass in which the contents of the entry cannot be modified. Any attempt to call a method which could be used to alter the contents of the entry will result in an UnsupportedOperationException.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
ReadOnlyEntry(DN dn, Attribute... attributes)	Creates a new read-only entry with the provided DN and set of attributes.
ReadOnlyEntry(DN dn, Schema schema, Attribute... attributes)	Creates a new read-only entry with the provided DN and set of attributes.
ReadOnlyEntry(DN dn, Schema schema, Collection<Attribute> attributes)	Creates a new read-only entry with the provided DN and set of attributes.
ReadOnlyEntry(DN dn, Collection<Attribute> attributes)	Creates a new read-only entry with the provided DN and set of attributes.
ReadOnlyEntry(Entry entry)	Creates a new read-only entry from the provided Entry.
ReadOnlyEntry(Schema schema, String... ldifLines)	Creates a new read-only entry from the provided LDIF representation.
ReadOnlyEntry(String... ldifLines)	Creates a new read-only entry from the provided LDIF representation.
ReadOnlyEntry(String dn, Attribute... attributes)	Creates a new read-only entry with the provided DN and set of attributes.
ReadOnlyEntry(String dn, Schema schema, Attribute... attributes)	Creates a new read-only entry with the provided DN and set of attributes.
ReadOnlyEntry(String dn, Schema schema, Collection<Attribute> attributes)	Creates a new read-only entry with the provided DN and set of attributes.
ReadOnlyEntry(String dn, Collection<Attribute> attributes)	Creates a new read-only entry with the provided DN and set of attributes.

Method Summary

Modifier and Type	Method	Description
boolean	addAttribute(Attribute attribute)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
boolean	addAttribute(String attributeName, byte[] attributeValue)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
boolean	addAttribute(String attributeName, byte[]... attributeValues)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
boolean	addAttribute(String attributeName, String attributeValue)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
boolean	addAttribute(String attributeName, String... attributeValues)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
boolean	removeAttribute(String attributeName)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
boolean	removeAttributeValue(String attributeName, byte[] attributeValue)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
boolean	removeAttributeValue(String attributeName, String attributeValue)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
boolean	removeAttributeValues(String attributeName, byte[]... attributeValues)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
boolean	removeAttributeValues(String attributeName, String... attributeValues)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
void	setAttribute(Attribute attribute)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
void	setAttribute(String attributeName, byte[] attributeValue)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
void	setAttribute(String attributeName, byte[]... attributeValues)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
void	setAttribute(String attributeName, String attributeValue)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
void	setAttribute(String attributeName, String... attributeValues)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
void	setDN(DN dn)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.
void	setDN(String dn)	Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Methods inherited from class com.unboundid.ldap.sdk.Entry

addAttribute, applyModifications, applyModifications, applyModifyDN, applyModifyDN, diff, diff, diff, duplicate, equals, getAttribute, getAttribute, getAttributes, getAttributesWithOptions, getAttributeValue, getAttributeValueAsBoolean, getAttributeValueAsDate, getAttributeValueAsDN, getAttributeValueAsInteger, getAttributeValueAsLong, getAttributeValueByteArrays, getAttributeValueBytes, getAttributeValues, getDN, getObjectClassAttribute, getObjectClassValues, getParentDN, getParentDNString, getParsedDN, getRDN, getSchema, hasAttribute, hasAttribute, hasAttribute, hasAttributeValue, hasAttributeValue, hasAttributeValue, hasAttributeValue, hashCode, hasObjectClass, intersectEntries, matchesBaseAndScope, matchesBaseAndScope, mergeEntries, removeAttributeValue, removeAttributeValue, setAttribute, toLDIF, toLDIF, toLDIF, toLDIF, toLDIFString, toLDIFString, toLDIFString, toLDIFString, toString, toString

Methods inherited from class java.lang.Object

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

Constructor Details

ReadOnlyEntry

public ReadOnlyEntry(@NotNull
 String dn,
 @NotNull
 Attribute... attributes)

Creates a new read-only entry with the provided DN and set of attributes.

Parameters:

dn - The DN for this entry. It must not be null.

attributes - The set of attributes for this entry. It must not be null.

ReadOnlyEntry

public ReadOnlyEntry(@NotNull
 String dn,
 @Nullable
 Schema schema,
 @NotNull
 Attribute... attributes)

Creates a new read-only entry with the provided DN and set of attributes.

Parameters:

dn - The DN for this entry. It must not be null.

schema - The schema to use for operations involving this entry. It may be null if no schema is available.

attributes - The set of attributes for this entry. It must not be null.

ReadOnlyEntry

public ReadOnlyEntry(@NotNull
 DN dn,
 @NotNull
 Attribute... attributes)

Creates a new read-only entry with the provided DN and set of attributes.

Parameters:

dn - The DN for this entry. It must not be null.

attributes - The set of attributes for this entry. It must not be null.

ReadOnlyEntry

public ReadOnlyEntry(@NotNull
 DN dn,
 @Nullable
 Schema schema,
 @NotNull
 Attribute... attributes)

Creates a new read-only entry with the provided DN and set of attributes.

Parameters:

dn - The DN for this entry. It must not be null.

schema - The schema to use for operations involving this entry. It may be null if no schema is available.

attributes - The set of attributes for this entry. It must not be null.

ReadOnlyEntry

public ReadOnlyEntry(@NotNull
 String dn,
 @NotNull
 Collection<Attribute> attributes)

Creates a new read-only entry with the provided DN and set of attributes.

Parameters:

dn - The DN for this entry. It must not be null.

attributes - The set of attributes for this entry. It must not be null.

ReadOnlyEntry

public ReadOnlyEntry(@NotNull
 String dn,
 @Nullable
 Schema schema,
 @NotNull
 Collection<Attribute> attributes)

Creates a new read-only entry with the provided DN and set of attributes.

Parameters:

dn - The DN for this entry. It must not be null.

schema - The schema to use for operations involving this entry. It may be null if no schema is available.

attributes - The set of attributes for this entry. It must not be null.

ReadOnlyEntry

public ReadOnlyEntry(@NotNull
 DN dn,
 @NotNull
 Collection<Attribute> attributes)

Creates a new read-only entry with the provided DN and set of attributes.

Parameters:

dn - The DN for this entry. It must not be null.

attributes - The set of attributes for this entry. It must not be null.

ReadOnlyEntry

public ReadOnlyEntry(@NotNull
 DN dn,
 @Nullable
 Schema schema,
 @NotNull
 Collection<Attribute> attributes)

Creates a new read-only entry with the provided DN and set of attributes.

Parameters:

dn - The DN for this entry. It must not be null.

schema - The schema to use for operations involving this entry. It may be null if no schema is available.

attributes - The set of attributes for this entry. It must not be null.

ReadOnlyEntry

public ReadOnlyEntry(@NotNull
 Entry entry)

Creates a new read-only entry from the provided Entry.

Parameters:

entry - The entry to use to create this read-only entry.

ReadOnlyEntry

public ReadOnlyEntry(@NotNull
 String... ldifLines)
              throws LDIFException

Creates a new read-only entry from the provided LDIF representation.

Parameters:

ldifLines - The set of lines that comprise an LDIF representation of the entry. It must not be null or empty.

Throws:

LDIFException - If the provided lines cannot be decoded as an entry in LDIF format.

ReadOnlyEntry

public ReadOnlyEntry(@Nullable
 Schema schema,
 @NotNull
 String... ldifLines)
              throws LDIFException

Creates a new read-only entry from the provided LDIF representation.

Parameters:

schema - The schema to use for operations involving this entry. It may be null if no schema is available.

ldifLines - The set of lines that comprise an LDIF representation of the entry. It must not be null or empty.

Throws:

LDIFException - If the provided lines cannot be decoded as an entry in LDIF format.

Method Details

setDN

public void setDN(@NotNull
 String dn)
           throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

setDN in class Entry

Parameters:

dn - The DN for this entry. It must not be null.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

setDN

public void setDN(@NotNull
 DN dn)
           throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

setDN in class Entry

Parameters:

dn - The DN for this entry. It must not be null.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

addAttribute

public boolean addAttribute(@NotNull
 Attribute attribute)
                     throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

addAttribute in class Entry

Parameters:

attribute - The attribute to be added. It must not be null.

Returns:

This method will never return successfully.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

addAttribute

public boolean addAttribute(@NotNull
 String attributeName,
 @NotNull
 String attributeValue)
                     throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

addAttribute in class Entry

Parameters:

attributeName - The name for the attribute to be added. It must not be null.

attributeValue - The value for the attribute to be added. It must not be null.

Returns:

This method will never return successfully.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

addAttribute

public boolean addAttribute(@NotNull
 String attributeName,
 @NotNull
 byte[] attributeValue)
                     throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

addAttribute in class Entry

Parameters:

attributeName - The name for the attribute to be added. It must not be null.

attributeValue - The value for the attribute to be added. It must not be null.

Returns:

This method will never return successfully.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

addAttribute

public boolean addAttribute(@NotNull
 String attributeName,
 @NotNull
 String... attributeValues)
                     throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

addAttribute in class Entry

Parameters:

attributeName - The name for the attribute to be added. It must not be null.

attributeValues - The set of values for the attribute to be added. It must not be null.

Returns:

This method will never return successfully.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

addAttribute

public boolean addAttribute(@NotNull
 String attributeName,
 @NotNull
 byte[]... attributeValues)
                     throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

addAttribute in class Entry

Parameters:

attributeName - The name for the attribute to be added. It must not be null.

attributeValues - The set of values for the attribute to be added. It must not be null.

Returns:

This method will never return successfully.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

removeAttribute

public boolean removeAttribute(@NotNull
 String attributeName)
                        throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

removeAttribute in class Entry

Parameters:

attributeName - The name of the attribute to remove. It must not be null.

Returns:

This method will never return successfully.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

removeAttributeValue

public boolean removeAttributeValue(@NotNull
 String attributeName,
 @NotNull
 String attributeValue)
                             throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

removeAttributeValue in class Entry

Parameters:

attributeName - The name of the attribute to remove. It must not be null.

attributeValue - The value of the attribute to remove. It must not be null.

Returns:

This method will never return successfully.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

removeAttributeValue

public boolean removeAttributeValue(@NotNull
 String attributeName,
 @NotNull
 byte[] attributeValue)
                             throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

removeAttributeValue in class Entry

Parameters:

attributeName - The name of the attribute to remove. It must not be null.

attributeValue - The value of the attribute to remove. It must not be null.

Returns:

This method will never return successfully.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

removeAttributeValues

public boolean removeAttributeValues(@NotNull
 String attributeName,
 @NotNull
 String... attributeValues)
                              throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

removeAttributeValues in class Entry

Parameters:

attributeName - The name of the attribute to remove. It must not be null.

attributeValues - The values of the attribute to remove. It must not be null.

Returns:

This method will never return successfully.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

removeAttributeValues

public boolean removeAttributeValues(@NotNull
 String attributeName,
 @NotNull
 byte[]... attributeValues)
                              throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

removeAttributeValues in class Entry

Parameters:

attributeName - The name of the attribute to remove. It must not be null.

attributeValues - The values of the attribute to remove. It must not be null.

Returns:

This method will never return successfully.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

setAttribute

public void setAttribute(@NotNull
 Attribute attribute)
                  throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

setAttribute in class Entry

Parameters:

attribute - The attribute to be included in this entry. It must not be null.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

setAttribute

public void setAttribute(@NotNull
 String attributeName,
 @NotNull
 String attributeValue)
                  throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

setAttribute in class Entry

Parameters:

attributeName - The name to use for the attribute. It must not be null.

attributeValue - The value to use for the attribute. It must not be null.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

setAttribute

public void setAttribute(@NotNull
 String attributeName,
 @NotNull
 byte[] attributeValue)
                  throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

setAttribute in class Entry

Parameters:

attributeName - The name to use for the attribute. It must not be null.

attributeValue - The value to use for the attribute. It must not be null.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

setAttribute

public void setAttribute(@NotNull
 String attributeName,
 @NotNull
 String... attributeValues)
                  throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

setAttribute in class Entry

Parameters:

attributeName - The name to use for the attribute. It must not be null.

attributeValues - The set of values to use for the attribute. It must not be null.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.

setAttribute

public void setAttribute(@NotNull
 String attributeName,
 @NotNull
 byte[]... attributeValues)
                  throws UnsupportedOperationException

Throws an UnsupportedOperationException to indicate that this is a read-only entry.

Overrides:

setAttribute in class Entry

Parameters:

attributeName - The name to use for the attribute. It must not be null.

attributeValues - The set of values to use for the attribute. It must not be null.

Throws:

UnsupportedOperationException - To indicate that this is a read-only entry.