com.unboundid.ldap.sdk
Class SearchResultEntry

java.lang.Object
  com.unboundid.ldap.sdk.Entry
      com.unboundid.ldap.sdk.ReadOnlyEntry
          com.unboundid.ldap.sdk.SearchResultEntry

All Implemented Interfaces:

LDAPResponse, LDIFRecord, java.io.Serializable

@NotMutable
@ThreadSafety(level=COMPLETELY_THREADSAFE)
public final class SearchResultEntry
extends ReadOnlyEntry
implements LDAPResponse

This class provides a data structure for representing an LDAP search result entry. This is a ReadOnlyEntry object that may also include zero or more controls included with the entry returned from the server.

See Also:

Serialized Form

Field Summary

Fields inherited from interface com.unboundid.ldap.protocol.LDAPResponse

NO_CONTROLS

Constructor Summary

SearchResultEntry(Entry entry, Control... controls)
Creates a new search result entry from the provided entry.

SearchResultEntry(int messageID, Entry entry, Control... controls)
Creates a new search result entry from the provided entry.

SearchResultEntry(int messageID, java.lang.String dn, Attribute[] attributes, Control... controls)
Creates a new search result entry with the provided information.

SearchResultEntry(int messageID, java.lang.String dn, java.util.Collection<Attribute> attributes, Control... controls)
Creates a new search result entry with the provided information.

SearchResultEntry(int messageID, java.lang.String dn, Schema schema, Attribute[] attributes, Control... controls)
Creates a new search result entry with the provided information.

SearchResultEntry(int messageID, java.lang.String dn, Schema schema, java.util.Collection<Attribute> attributes, Control... controls)
Creates a new search result entry with the provided information.

SearchResultEntry(java.lang.String dn, Attribute[] attributes, Control... controls)
Creates a new search result entry with the provided information.

SearchResultEntry(java.lang.String dn, java.util.Collection<Attribute> attributes, Control... controls)
Creates a new search result entry with the provided information.

Method Summary

boolean	equals(java.lang.Object o) Indicates whether the provided object is equal to this entry.
Control	getControl(java.lang.String oid) Retrieves the control with the specified OID.
Control[]	getControls() Retrieves the set of controls returned with this search result entry.
int	getMessageID() Retrieves the message ID for the LDAP message containing this response.
int	hashCode() Generates a hash code for this entry.
void	toString(java.lang.StringBuilder buffer) Appends a string representation of this entry to the provided buffer.

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

addAttribute, addAttribute, addAttribute, addAttribute, addAttribute, removeAttribute, removeAttributeValue, removeAttributeValue, removeAttributeValues, removeAttributeValues, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setDN, setDN

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

addAttribute, applyModifications, applyModifications, diff, diff, duplicate, 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, hasObjectClass, intersectEntries, matchesBaseAndScope, matchesBaseAndScope, mergeEntries, removeAttributeValue, removeAttributeValue, setAttribute, toLDIF, toLDIF, toLDIF, toLDIF, toLDIFString, toLDIFString, toLDIFString, toLDIFString, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

SearchResultEntry

public SearchResultEntry(java.lang.String dn,
                         Attribute[] attributes,
                         Control... controls)

Creates a new search result entry with the provided information.

Parameters:

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

attributes - The set of attributes to include in this search result entry. It must not be null.

controls - The set of controls for this search result entry. It must not be null.

SearchResultEntry

public SearchResultEntry(int messageID,
                         java.lang.String dn,
                         Attribute[] attributes,
                         Control... controls)

Creates a new search result entry with the provided information.

Parameters:

messageID - The message ID for the LDAP message containing this response.

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

attributes - The set of attributes to include in this search result entry. It must not be null.

controls - The set of controls for this search result entry. It must not be null.

SearchResultEntry

public SearchResultEntry(int messageID,
                         java.lang.String dn,
                         Schema schema,
                         Attribute[] attributes,
                         Control... controls)

Creates a new search result entry with the provided information.

Parameters:

messageID - The message ID for the LDAP message containing this response.

dn - The DN for this search result 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 to include in this search result entry. It must not be null.

controls - The set of controls for this search result entry. It must not be null.

SearchResultEntry

public SearchResultEntry(java.lang.String dn,
                         java.util.Collection<Attribute> attributes,
                         Control... controls)

Creates a new search result entry with the provided information.

Parameters:

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

attributes - The set of attributes to include in this search result entry. It must not be null.

controls - The set of controls for this search result entry. It must not be null.

SearchResultEntry

public SearchResultEntry(int messageID,
                         java.lang.String dn,
                         java.util.Collection<Attribute> attributes,
                         Control... controls)

Creates a new search result entry with the provided information.

Parameters:

messageID - The message ID for the LDAP message containing this response.

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

attributes - The set of attributes to include in this search result entry. It must not be null.

controls - The set of controls for this search result entry. It must not be null.

SearchResultEntry

public SearchResultEntry(int messageID,
                         java.lang.String dn,
                         Schema schema,
                         java.util.Collection<Attribute> attributes,
                         Control... controls)

Creates a new search result entry with the provided information.

Parameters:

messageID - The message ID for the LDAP message containing this response.

dn - The DN for this search result 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 to include in this search result entry. It must not be null.

controls - The set of controls for this search result entry. It must not be null.

SearchResultEntry

public SearchResultEntry(Entry entry,
                         Control... controls)

Creates a new search result entry from the provided entry.

Parameters:

entry - The entry to use to create this search result entry. It must not be null.

controls - The set of controls for this search result entry. It must not be null.

SearchResultEntry

public SearchResultEntry(int messageID,
                         Entry entry,
                         Control... controls)

Creates a new search result entry from the provided entry.

Parameters:

messageID - The message ID for the LDAP message containing this response.

entry - The entry to use to create this search result entry. It must not be null.

controls - The set of controls for this search result entry. It must not be null.

Method Detail

getMessageID

public int getMessageID()

Retrieves the message ID for the LDAP message containing this response.

Specified by:

getMessageID in interface LDAPResponse

Returns:

The message ID for the LDAP message containing this response.

getControls

public Control[] getControls()

Retrieves the set of controls returned with this search result entry. Individual response controls of a specific type may be retrieved and decoded using the get method in the response control class.

Returns:

The set of controls returned with this search result entry.

getControl

public Control getControl(java.lang.String oid)

Retrieves the control with the specified OID. If there is more than one control with the given OID, then the first will be returned.

Parameters:

oid - The OID of the control to retrieve.

Returns:

The control with the requested OID, or null if there is no such control for this search result entry.

hashCode

public int hashCode()

Generates a hash code for this entry.

Overrides:

hashCode in class Entry

Returns:

The generated hash code for this entry.

equals

public boolean equals(java.lang.Object o)

Indicates whether the provided object is equal to this entry. The provided object will only be considered equal to this entry if it is an entry with the same DN and set of attributes.

Overrides:

equals in class Entry

Parameters:

o - The object for which to make the determination.

Returns:

true if the provided object is considered equal to this entry, or false if not.

toString

public void toString(java.lang.StringBuilder buffer)

Appends a string representation of this entry to the provided buffer.

Specified by:

toString in interface LDAPResponse

Specified by:

toString in interface LDIFRecord

Overrides:

toString in class Entry

Parameters:

buffer - The buffer to which to append the string representation of this entry.