com.ibm.itim.remoteservices.provider
Class SearchResult

java.lang.Object
  |
  +--com.ibm.itim.remoteservices.provider.SearchResult
All Implemented Interfaces:
java.io.Serializable

public class SearchResult
extends java.lang.Object
implements java.io.Serializable

Encapsulates an entry returned from a search on a remote resource. A search result corresponds to a single entity within TIM. For example, when communicating with a database a SearchResult would correspond to a row of the database, which may then be imported to TIM as an account or a person.

TIM will determine the type of entry to add based the object classes. If the object classes do not include the type expected for this service profile, then the entry will be interpreted as supporting data. For example, when reconciling accounts, each account entry must include the object class for that service and other entries, such as group data, will be added as supporting data.

Only attributes that are meaningful to the user should be added here. Users of this class should not add attributes that are used only for internal management by TIM at this point. For example, attributes like erglobalid. These will be added by the TIM dataservices framework elsewhere.

See Also:
Serialized Form

Constructor Summary
SearchResult(java.lang.String dn, java.util.Collection objectClasses, AttributeValues attributeValues)
          Creates new SearchResult
SearchResult(java.lang.String dn, java.lang.String objectClass, AttributeValues attributeValues)
          Creates new SearchResult
 
Method Summary
 AttributeValues getAttributeValues()
          Gets the model attributes for this search entry
 java.lang.String getDN()
          Gets the distinguished name for this search result
 java.lang.String getObjectClass()
          Gets the first object class or null if there isn't one
 java.util.Collection getObjectClasses()
          Gets the object classes for this search entry
 java.lang.String toString()
          Overrides the method from java.lang.Object.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

SearchResult

public SearchResult(java.lang.String dn,
                    java.util.Collection objectClasses,
                    AttributeValues attributeValues)
Creates new SearchResult

Parameters:
dn - the distinguished name for this entry
objectClasses - One or more object classes for the entry
attributeValues - The attributes of the search entry which cannot be null or empty.

SearchResult

public SearchResult(java.lang.String dn,
                    java.lang.String objectClass,
                    AttributeValues attributeValues)
Creates new SearchResult

Parameters:
dn - the distinguished name for this entry which cannot be null or empty.
objectClass - Single object class for the entry which cannot be null or empty.
attributeValues - The attributes of the search entry which cannot be null or empty.
Method Detail

getDN

public java.lang.String getDN()
Gets the distinguished name for this search result

Returns:
the distinguished name for this search result and not null.

getAttributeValues

public AttributeValues getAttributeValues()
Gets the model attributes for this search entry

Returns:
model attributes which will not be null.

getObjectClasses

public java.util.Collection getObjectClasses()
Gets the object classes for this search entry

Returns:
object classes which will not be null or empty.

getObjectClass

public java.lang.String getObjectClass()
Gets the first object class or null if there isn't one

Returns:
the first object class which will not be null.

toString

public java.lang.String toString()
Overrides the method from java.lang.Object.

Overrides:
toString in class java.lang.Object
Returns:
the name of the class, the dn, and the object classes which will not be null.


IBM Tivoli Identity Manager 4.6
© Copyright International Business Machines Corporation 2005. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.