com.unboundid.ldap.sdk
Class SearchResultEntry

java.lang.Object
  extended by com.unboundid.ldap.sdk.Entry
      extended by com.unboundid.ldap.sdk.ReadOnlyEntry
          extended by 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.