com.ibm.itim.dataservices.model.system
Class SystemUserSearch

java.lang.Object
  |
  +--com.ibm.itim.dataservices.model.system.SystemUserSearch

public class SystemUserSearch
extends java.lang.Object

Provides an interface for searching for SystemUserEntity(s). This interface is supplied to clients so that they can search in a more direct manner without having to traverse data model relationships to retrieve SystemUserEntity(s). It should be noted that, like all other classes in the com.ibm.itim.dataservices package and its sub-packages, this class is not remote able. It should be used from local customization code such as JavaScript extensions, but not from code deployed outside the platform. It should also be noted that, like all other search classes in the com.ibm.itim.dataservices package and its sub-packages, this search class does not check ACIs to filter out results. A remote able equivalent that performs ACI checking is available in the com.ibm.itim.apps.provisioning.AccountManager class.

See Also:
SystemUserEntity

Constructor Summary
SystemUserSearch()
          Default constructor.
 
Method Summary
 SystemUserEntity lookup(DistinguishedName dn)
          Retrieves the SystemUser from the data store with the given distinguished name.
 SearchResults searchByDelegate(DistinguishedName tenantDN, DistinguishedName delegateDN, SearchParameters params)
          Searches for system users that have the specified delegate.
 SearchResults searchByFilter(CompoundDN searchContext, java.lang.String filter, SearchParameters params)
          Searches for system users that meet the criteria defined within the given filter.
 SearchResults searchByFilter(DistinguishedName tenantDN, java.lang.String filter, SearchParameters params)
          Searches for system users that meet the criteria defined within the given filter.
 SearchResults searchByOwner(DistinguishedName ownerDN, SearchParameters params)
          Searches for system users (platform accounts) owned by the given person (identity).
 SearchResults searchByRole(DistinguishedName roleDN, SearchParameters params)
          Searches for system users (platform accounts) that are members of the given system role (group).
 SystemUserEntity searchByUserID(DistinguishedName tenantDN, java.lang.String userID)
          Retrieves the system user with the given id.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SystemUserSearch

public SystemUserSearch()
Default constructor.

Method Detail

lookup

public SystemUserEntity lookup(DistinguishedName dn)
                        throws ModelCommunicationException,
                               ObjectNotFoundException
Retrieves the SystemUser from the data store with the given distinguished name.

Parameters:
dn - DistinguishedName of the SystemUser.
Returns:
SystemUser with the corresponding distinguished name.
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if unable to locate the entity in the data store. This may be due to an invalid distinguished name, or the entity may have been removed by another client.

searchByUserID

public SystemUserEntity searchByUserID(DistinguishedName tenantDN,
                                       java.lang.String userID)
                                throws ModelCommunicationException,
                                       ObjectNotFoundException
Retrieves the system user with the given id.

Parameters:
tenantDN - DistinguishedName of the tenant (system root) to use as the base of the search.
userID - Id of the system user to search for.
Returns:
SystemUserEntity with the matching id.
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if search base is invalid or no system user has the given id in the data store.

searchByFilter

public SearchResults searchByFilter(DistinguishedName tenantDN,
                                    java.lang.String filter,
                                    SearchParameters params)
                             throws ModelCommunicationException,
                                    ObjectNotFoundException
Searches for system users that meet the criteria defined within the given filter. This search is performed as a raw search against the data store without any semantic mapping.

Parameters:
tenantDN - DistinguishedName of the tenant (system root) to use as the base of the search.
filter - Filter that defines the criteria for returned SystemUserEntities to meet. The filter must be in the format defined by RFC2254.
params - SearchParameters that provide additional context for how the search should be performed. Scope is not supported.
Returns:
SearchResults holding SystemUserEntities for all system users that meet the search criteria.
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if search base is invalid.

searchByFilter

public SearchResults searchByFilter(CompoundDN searchContext,
                                    java.lang.String filter,
                                    SearchParameters params)
                             throws ModelCommunicationException,
                                    ObjectNotFoundException
Searches for system users that meet the criteria defined within the given filter. This search is performed as a raw search against the data store without any semantic mapping.

Parameters:
searchContext - CompoundDN with only one DistinguishedName identifying the tenant (system root) to use as the base of the search.
filter - Filter that defines the criteria for returned SystemUserEntities to meet. The filter must be in the format defined by RFC2254.
params - SearchParameters that provide additional context for how the search should be performed. Scope is not supported.
Returns:
SearchResults holding SystemUserEntities for all system users that meet the search criteria.
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if search base is invalid.

searchByOwner

public SearchResults searchByOwner(DistinguishedName ownerDN,
                                   SearchParameters params)
                            throws ModelCommunicationException,
                                   ObjectNotFoundException
Searches for system users (platform accounts) owned by the given person (identity).

Parameters:
ownerDN - DistinguishedName of the person (identity) who is the subject of the search.
params - SearchParameters that provide additional context for how the search should be performed. Scope is not supported.
Returns:
SearchResults holding SystemUserEntities for all system users that are owned by the given person.
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if unable to locate the owner in the data store. This may be due to an invalid distinguished name, or the entity may have been removed by another client.

searchByRole

public SearchResults searchByRole(DistinguishedName roleDN,
                                  SearchParameters params)
                           throws ModelCommunicationException,
                                  ObjectNotFoundException
Searches for system users (platform accounts) that are members of the given system role (group).

Parameters:
roleDN - DistinguishedName of the role (group) that is the subject of the search.
params - SearchParameters that provide additional context for how the search should be performed. Scope is not supported.
Returns:
SearchResults holding SystemUserEntities for all system users that are members of the given role (group).
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if unable to locate the role in the data store. This may be due to an invalid distinguished name, or the entity may have been removed by another client.

searchByDelegate

public SearchResults searchByDelegate(DistinguishedName tenantDN,
                                      DistinguishedName delegateDN,
                                      SearchParameters params)
                               throws ModelCommunicationException,
                                      ObjectNotFoundException
Searches for system users that have the specified delegate.

Parameters:
tenantDN - DistinguishedName of the tenant (system root) to use as the base of the search.
delegateDN - The DistinguishedName of the delegate (system user).
params - SearchParameters that provide additional context for how the search should be performed. Scope is not supported.
Returns:
SearchResults holding SystemUserEntities for all system users that meet the search criteria.
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if search base is invalid.


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.