PumaLocator (IBM WebSphere Portal Version 8.5.0.0 SPI Docs)

+
Search Tips | Advanced Search
PREV CLASS NEXT CLASS

Tree

SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

com.ibm.portal.um
Interface PumaLocator
public interface PumaLocator
The PumaLocator provides functions to lookup com.ibm.portal.um.User and com.ibm.portal.um.Group objects.
An instance of this Interface can be retrieved by calling com.ibm.portal.um.PumaHome, com.ibm.portal.um.portletservice.PumaHome or com.ibm.portal.um.portletservice.legacy.PumaHome

Some of the search methods take a Map with pagingProperties. These methods perform a paged search, i.e. that the result set is split up into subsets (pages) that can be requested individually using the the returned PagingIterator.

Since:

5.1.0.1

See Also:
PumaHome, PumaHome, PumaHome, PagingIterator

Field Summary

static java.lang.String MAXIMUM_RESULTS
          Use this property to set the maximum number of total results that a search request will return when performing a paged search.

static java.lang.String RESULTS_PER_PAGE
          Use this property to set the page size when performing a paged search.

static java.lang.String SORT_CONTROL
          Use this property control the sorting when performing a paged search.

Method Summary

Group findGroupByIdentifier(java.lang.String aIdentifier)
          Return the Group object referenced by the identifier (DN) within the user repository.

Group findGroupByObjectID(ObjectID aId)
          Return the Group object referenced by the given ObjectID.
If no group is found a PumaModelException is thrown

java.util.List<Group> findGroupsByAttribute(java.lang.String aAttribute, java.lang.String aValue)
          Return a List of Group where the attributes defined in the LDAP server matches the value of the given attribute.

PagingIterator<Group> findGroupsByAttribute(java.lang.String aAttribute, java.lang.String aValue, java.util.Map<java.lang.String,?> properties)
          Return a List of Group where the attributes defined in the LDAP server matches the value of the given attribute.

java.util.List<Group> findGroupsByDefaultAttribute(java.lang.String aValue)
          Returns Group by comparing the provided value to the default attribute type configured for the Group type For a LIKE comparision only the multi-character wild card is supported and the character used is '*'.

java.util.List<Group> findGroupsByDefaultAttribute(java.lang.String aValue, boolean aSorted)
          Returns Group by comparing the provided value to the default attribute type configured for the Group type For a LIKE comparision only the multi-character wild card is supported and the character used is '*'.

java.util.List<Group> findGroupsByPrincipal(Principal aPrincipal, boolean aNested)
          Return the Groups where the given Principal is member of.

PagingIterator<Group> findGroupsByPrincipal(Principal aPrincipal, boolean aNested, java.util.Map<java.lang.String,?> properties)
          Return the Groups where the given Principal is member of.

java.util.List<Group> findGroupsByQuery(java.lang.String aQuery)
          Return a List of Group representing the resultset of the provided Query.

PagingIterator<Group> findGroupsByQuery(java.lang.String aQuery, java.util.Map<java.lang.String,?> properties)
          Return a List of Group representing the resultset of the provided Query.

java.util.List<Group> findGroupsByQuery(java.lang.String aQuery, com.ibm.websphere.wim.model.SortControl aControl)
          Return a List of Group representing the resultset of the provided Query.

java.util.List<Principal> findMembersByGroup(Group aGroup, boolean aNested)
          Return the mebers for a given Group.

PagingIterator<Principal> findMembersByGroup(Group aGroup, boolean aNested, java.util.Map<java.lang.String,?> properties)
          Return the mebers for a given Group.

Principal findPrincipalByIdentifier(java.lang.String aIdentifier)
          Return the Principal (user or group) object referenced by the given identifier.

java.util.Map<java.lang.String,Principal> findPrincipalsByIdentifiers(java.util.Collection<java.lang.String> identifiers)
          Return the Principal (user and/or group) objects referenced by the given identifiers.

User findUserByIdentifier(java.lang.String aIdentifier)
          Return the User object referenced by the given identifier.

User findUserByObjectID(ObjectID aId)
          Return the User object referenced by the given ObjectID.
If no user is found a PumaModelException is thrown

java.util.List<User> findUsersByAttribute(java.lang.String aAttribute, java.lang.String aValue)
          Return a List of User where the attribute defined in the LDAP server matches the given value.

PagingIterator<User> findUsersByAttribute(java.lang.String aAttribute, java.lang.String aValue, java.util.Map<java.lang.String,?> pagingProps)
          Return a List of Users where the attribute defined in the user repository matches the given value.

java.util.List<User> findUsersByAttributeRecursively(User user, java.lang.String attribute, int depth)
          Return a List of Principals that are linked by the given attribute.

java.util.List<User> findUsersByDefaultAttribute(java.lang.String aValue)
          Returns User by comparing the provided value to the default attribute type configured for the User type.

java.util.List<User> findUsersByDefaultAttribute(java.lang.String aValue, boolean aSorted)
          Returns User by comparing the provided value to the default attribute type configured for the User type.

java.util.List<User> findUsersByQuery(java.lang.String aQuery)
          Return a List of User representing the resultset of the provided Query.

PagingIterator<User> findUsersByQuery(java.lang.String aQuery, java.util.Map<java.lang.String,?> properties)
          Return a List of User representing the resultset of the provided Query.

java.util.List<User> findUsersByQuery(java.lang.String aQuery, com.ibm.websphere.wim.model.SortControl aControl)
          Return a List of User representing the resultset of the provided Query.

java.util.List<Group> searchGroupByName(java.lang.String name)
          Return a list of Groups that have a name that matches the given name.

PagingIterator<Group> searchGroupByName(java.lang.String name, java.util.Map<java.lang.String,?> properties)
          Return a list of Groups that have a name that matches the given name.

java.util.List<User> searchUserByName(java.lang.String aName)
          Return a list of Users that have a name that matches the given name.

PagingIterator<User> searchUserByName(java.lang.String aName, java.util.Map<java.lang.String,?> properties)
          Return a list of Users that have a name that matches the given name.

Field Detail

MAXIMUM_RESULTS
static final java.lang.String MAXIMUM_RESULTS
Use this property to set the maximum number of total results that a search request will return when performing a paged search. If a search request matches more entities, a SizeLimitExceedException will be thrown. The value is optional, must be of type Integer and greater 0 if present.

See Also:
Constant Field Values

RESULTS_PER_PAGE
static final java.lang.String RESULTS_PER_PAGE
Use this property to set the page size when performing a paged search. The value is mandatory, must be of type Integer and greater 0.

See Also:
Constant Field Values

SORT_CONTROL
static final java.lang.String SORT_CONTROL
Use this property control the sorting when performing a paged search. The value is optional, must be of type com.ibm.websphere.wim.model.SortControl if present.

See Also:
Constant Field Values

Method Detail

findPrincipalByIdentifier
Principal findPrincipalByIdentifier(java.lang.String aIdentifier)
                                    throws PumaSystemException,
                                           PumaModelException,
                                           PumaMissingAccessRightsException
Returns the Principal (user or group) object referenced by the given identifier. The identifier is String refers to the String provided PumaProfile.getIdentifier(Principal).
If no principal is found a PumaModelException is thrown
The character encoding used as input for the identifier must match the encoding acceptable by the user store

Parameters:
aIdentifier - a unique Identifier of a Principal object within the User Repository
Returns:
The Principal object available by the given identifier
Throws:
PumaSystemException - will be thrown whenever an unrecoverable back-end error occurs
PumaModelException - will be thrown if no Principal could be found
PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights
Since:

6.1.0.3

findPrincipalsByIdentifiers
java.util.Map<java.lang.String,Principal> findPrincipalsByIdentifiers(java.util.Collection<java.lang.String> identifiers)
                                                                      throws PumaSystemException,
                                                                             PumaModelException,
                                                                             PumaMissingAccessRightsException
Returns the Principal (user and/or group) objects referenced by the given identifiers. The key set of the result contains the same strings than the input collection. This method can be used to get a collection of principals using one request to back-end instead of using several invocations of findPrincipalByIdentifier(String).
If for any given identifier no principal is found, a PumaModelException is thrown
The character encoding used as input for the identifier must match the encoding acceptable by the user store

Parameters:
identifiers - a collection of unique Identifier of a Principal object within the User Repository
Returns:
a Map of Principal objects available by the given identifiers
Throws:
PumaSystemException - will be thrown whenever an unrecoverable back-end error occurs
PumaModelException - will be thrown if no Principal could be found
PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights
Since:

8.0

findUserByIdentifier
User findUserByIdentifier(java.lang.String aIdentifier)
                          throws PumaSystemException,
                                 PumaModelException,
                                 PumaMissingAccessRightsException
Returns the User object referenced by the given identifier. The identifier is String refers to the String provided by WSCredential.getUniqueSecurityName() or by PumaProfile.getIdentifier(Principal).
If no user is found a PumaModelException is thrown
The character encoding used as input for the identifier must match the encoding acceptable by the user store

Parameters:
aIdentifier - a unique Identifier of a User object within the User Repository
Returns:
The User object available by the given identifier
Throws:
PumaSystemException - will be thrown whenever an unrecoverable backend error occurs
PumaModelException - will be thrown if no User could be found
PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights

findUserByObjectID
User findUserByObjectID(ObjectID aId)
                        throws PumaSystemException,
                               PumaModelException,
                               PumaMissingAccessRightsException
Returns the User object referenced by the given ObjectID.
If no user is found a PumaModelException is thrown

Parameters:
aId - WebSphere Portal Identifier of a User
Returns:
The User object available by the given ObjectID
Throws:
PumaSystemException - will be thrown whenever an unrecoverable backend error occurs
PumaModelException - will be thrown if no User could be found
PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights

findGroupByObjectID
Group findGroupByObjectID(ObjectID aId)
                          throws PumaSystemException,
                                 PumaModelException,
                                 PumaMissingAccessRightsException
Returns the Group object referenced by the given ObjectID.
If no group is found a PumaModelException is thrown

Parameters:
aId - WebSphere Portal Identifier of a Group
Returns:
The Group object available by the given ObjectID
Throws:
PumaSystemException - will be thrown whenever an unrecoverable backend error occurs
PumaModelException - will be thrown if no Group could be found
PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights

findGroupByIdentifier
Group findGroupByIdentifier(java.lang.String aIdentifier)
                            throws PumaSystemException,
                                   PumaModelException,
                                   PumaMissingAccessRightsException
Returns the Group object referenced by the identifier (DN) within the user repository. If no group is found a PumaModelException is thrown
The character encoding used as input for the identifier must match the encoding acceptable by the user store

Parameters:
aIdentifier - a unique Identifier of a Group object within the Repository
Returns:
The Group object available by the given identifier
Throws:
PumaSystemException - will be thrown whenever an unrecoverable backend error occurs
PumaModelException - will be thrown if no Group could be found
PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights

findUsersByDefaultAttribute
java.util.List<User> findUsersByDefaultAttribute(java.lang.String aValue)
                                                 throws PumaSystemException,
                                                        PumaAttributeException,
                                                        PumaMissingAccessRightsException
Returns User by comparing the provided value to the default attribute type configured for the User type. For a LIKE comparision only the multi-character wild card is supported and the character used is '*'. The '*' can appear in the value any number of times and at any place. Any '*' character part of the value must be escaped using the backslash ('\') character. The character encoding used as input for attribute key must match the encoding acceptable by the user store
Parameters: aValue - NULL is not allowed as input Returns: List read-only List containing User. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights See Also: User, List
findUsersByDefaultAttribute java.util.List<User> findUsersByDefaultAttribute(java.lang.String aValue, boolean aSorted) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns User by comparing the provided value to the default attribute type configured for the User type. For a LIKE comparision only the multi-character wild card is supported and the character used is '*'. The '*' can appear in the value any number of times and at any place. Any '*' character part of the value must be escaped using the backslash ('\') character. The character encoding used as input for attribute key must match the encoding acceptable by the user store Parameters: aValue - NULL is not allowed as input aSorted - defines if the result should be sorted. if true the result will be sorted ascending based on the defaultattribute. Returns: List read-only List containing User. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 6.1 See Also: User, List findGroupsByDefaultAttribute java.util.List<Group> findGroupsByDefaultAttribute(java.lang.String aValue) throws PumaSystemException, PumaMissingAccessRightsException Returns Group by comparing the provided value to the default attribute type configured for the Group type For a LIKE comparision only the multi-character wild card is supported and the character used is '*'. The '*' can appear in the value any number of times and at any place. Any '*' character part of the value must be escaped using the backslash ('\') character. The character encoding used as input for attribute key must match the encoding acceptable by the user store Parameters: aValue - NULL is not allowed as input Returns: List read-only List containing com.ibm.portal.um.Group. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights See Also: Group, List findGroupsByDefaultAttribute java.util.List<Group> findGroupsByDefaultAttribute(java.lang.String aValue, boolean aSorted) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns Group by comparing the provided value to the default attribute type configured for the Group type For a LIKE comparision only the multi-character wild card is supported and the character used is '*'. The '*' can appear in the value any number of times and at any place. Any '*' character part of the value must be escaped using the backslash ('\') character. The character encoding used as input for attribute key must match the encoding acceptable by the user store Parameters: aValue - NULL is not allowed as input aSorted - defines if the result should be sorted. if true the result will be sorted ascending based on the defaultattribute. Returns: List read-only List containing com.ibm.portal.um.Group. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are read-only, missing or not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights See Also: Group, List findUsersByAttribute java.util.List<User> findUsersByAttribute(java.lang.String aAttribute, java.lang.String aValue) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns a List of User where the attribute defined in the LDAP server matches the given value. Only attributes of type can be used for this search. For a LIKE comparision only the multi-character wild card is supported and the character used is '*'. The '*' can appear in the value any number of times and at any place. Any '*' character part of the value must be escaped using the backslash ('\') character. The character encoding used as input for attribute key and value must match the encoding acceptable by the user store Parameters: aAttribute - User attribute of type where the value is stored in aValue - Value to compare with Returns: List read-only List containing com.ibm.portal.um.User. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights See Also: User, List findUsersByAttribute PagingIterator<User> findUsersByAttribute(java.lang.String aAttribute, java.lang.String aValue, java.util.Map<java.lang.String,?> pagingProps) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns a List of Users where the attribute defined in the user repository matches the given value. Only attributes of type can be used for this search. For a LIKE comparision only the multi-character wild card is supported and the character used is '*'. The '*' can appear in the value any number of times and at any place. Any '*' character part of the value must be escaped using the backslash ('\') character. As this is a paged search, only a subset (page) of the complete result is returned. The page size is determined by the properties map passed as parameter. Use e.g. PagingIterator.hasNextPage() and PagingIterator.getNextPage(List) to iterate over the result pages. Parameters: aAttribute - User attribute of type where the value is stored in aValue - Value to compare with pagingProperties - Map that specifies the paging properties. Must at least contain a positive value for RESULTS_PER_PAGE. Returns: PagingIterator object that can be used to iterate over the paged result. If nothing is found, the iterator will contain one empty page. Throws: java.lang.IllegalArgumentException - if pagingProperties is null or does contain invalid properties. PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 7.0 See Also: The character encoding used as input for attribute key and value must match the encoding acceptable by the user store , User, List findGroupsByAttribute java.util.List<Group> findGroupsByAttribute(java.lang.String aAttribute, java.lang.String aValue) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns a List of Group where the attributes defined in the LDAP server matches the value of the given attribute. The two values will be checked based on a LIKE pattern. Only attributes of type can be used for this search. For a LIKE comparision only the multi-character wild card is supported and the character used is '*'. The '*' can appear in the value any number of times and at any place. Any '*' character part of the value must be escaped using the backslash ('\') character. The character encoding used as input for attribute key and value must match the encoding acceptable by the user store Parameters: aAttribute - Group attribute of type where the value is stored in aValue - the Value to compare with Returns: List read-only List containing com.ibm.portal.um.Group. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights See Also: Group, List findGroupsByAttribute PagingIterator<Group> findGroupsByAttribute(java.lang.String aAttribute, java.lang.String aValue, java.util.Map<java.lang.String,?> properties) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns a List of Group where the attributes defined in the LDAP server matches the value of the given attribute. The two values will be checked based on a LIKE pattern. Only attributes of type can be used for this search. For a LIKE comparision only the multi-character wild card is supported and the character used is '*'. The '*' can appear in the value any number of times and at any place. Any '*' character part of the value must be escaped using the backslash ('\') character. The character encoding used as input for attribute key and value must match the encoding acceptable by the user store As this is a paged search, only a subset (page) of the complete result is returned. The page size is determined by the properties map passed as parameter. Use e.g. PagingIterator.hasNextPage() and PagingIterator.getNextPage(List) to iterate over the result pages. Parameters: aAttribute - Group attribute of type where the value is stored in aValue - the Value to compare with pagingProperties - Map that specifies the paging properties. Must at least contain a positive value for RESULTS_PER_PAGE. Returns: PagingIterator object that can be used to iterate over the paged result. If nothing is found, the iterator will contain one empty page. Throws: java.lang.IllegalArgumentException - if pagingProperties is null or does contain invalid properties. PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 7.0 See Also: PagingIterator, Group, List findMembersByGroup java.util.List<Principal> findMembersByGroup(Group aGroup, boolean aNested) throws PumaSystemException, PumaModelException, PumaMissingAccessRightsException Returns the mebers for a given Group. It is possible to retrieve the flat members or nested members of the given group based on the Nested flag Calls for Nested membership might take long, bacause of the potentially large amount of groups Parameters: aGroup - Group to get Member for. null is not allowed as input parameter aNested - if set to true nested members will be returned. if set to false only the first hirarchy level will be returned Returns: List read-only List containing com.ibm.portal.um.Principal. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaModelException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights See Also: Principal, List findMembersByGroup PagingIterator<Principal> findMembersByGroup(Group aGroup, boolean aNested, java.util.Map<java.lang.String,?> properties) throws PumaSystemException, PumaModelException, PumaMissingAccessRightsException Returns the mebers for a given Group. It is possible to retrieve the flat members or nested members of the given group based on the Nested flag Calls for Nested membership might take long, bacause of the potentially large amount of groups. As this is a paged search, only a subset (page) of the complete result is returned. The page size is determined by the properties map passed as parameter. Use e.g. PagingIterator.hasNextPage() and PagingIterator.getNextPage(List) to iterate over the result pages. Parameters: aGroup - Group to get Member for. null is not allowed as input parameter aNested - if set to true nested members will be returned. if set to false only the first hirarchy level will be returned pagingProperties - Map that specifies the paging properties. Must at least contain a positive value for RESULTS_PER_PAGE. Returns: PagingIterator object that can be used to iterate over the paged result. If nothing is found, the iterator will contain one empty page. Throws: java.lang.IllegalArgumentException - if pagingProperties is null or does contain invalid properties. PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights PumaModelException - will be thrown if a non-existing page was requested Since: 7.0 See Also: PagingIterator, Principal, List findGroupsByPrincipal java.util.List<Group> findGroupsByPrincipal(Principal aPrincipal, boolean aNested) throws PumaSystemException, PumaModelException, PumaMissingAccessRightsException Returns the Groups where the given Principal is member of. Dependent on the aNested attribute either the first level of membership or all nested memberships are returned. Note that virtual groups that the Principal is member of - like the one returned by PumaEnvironment.getAllAuthenticatedUserGroup() - are not included in the result list. Calls for Nested membership might take long, bacause of the potential large amount of groups Parameters: aPrincipal - the Principal to get its membership, null is not allowed as input parameter aNested - if set to true nested members will be returned. if set to false only the first hirarchy level will be returned Returns: List read-only List containing com.ibm.portal.um.Group. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights PumaModelException See Also: Group, List findGroupsByPrincipal PagingIterator<Group> findGroupsByPrincipal(Principal aPrincipal, boolean aNested, java.util.Map<java.lang.String,?> properties) throws PumaSystemException, PumaModelException, PumaMissingAccessRightsException Returns the Groups where the given Principal is member of. Dependent on the aNested attribute either the first level of membership or all nested memberships are returned. Note that virtual groups that the Principal is member of - like the one returned by PumaEnvironment.getAllAuthenticatedUserGroup() - are not included in the result list. Calls for Nested membership might take long, bacause of the potential large amount of groups As this is a paged search, only a subset (page) of the complete result is returned. The page size is determined by the properties map passed as parameter. Use e.g. PagingIterator.hasNextPage() and PagingIterator.getNextPage(List) to iterate over the result pages. Parameters: aPrincipal - the Principal to get its membership, null is not allowed as input parameter aNested - if set to true nested members will be returned. if set to false only the first hirarchy level will be returned pagingProperties - Map that specifies the paging properties. Must at least contain a positive value for RESULTS_PER_PAGE. Returns: PagingIterator object that can be used to iterate over the paged result. If nothing is found, the iterator will contain one empty page. Throws: java.lang.IllegalArgumentException - if pagingProperties is null or does contain invalid properties. PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights PumaModelException Since: 7.0 See Also: PagingIterator, Group, List findUsersByQuery java.util.List<User> findUsersByQuery(java.lang.String aQuery) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns a List of User representing the resultset of the provided Query. The query is based on the XPath query language Parameters: aQuery - an XPath expression Returns: List read-only List containing com.ibm.portal.um.User. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 6.1 See Also: User, List findUsersByQuery PagingIterator<User> findUsersByQuery(java.lang.String aQuery, java.util.Map<java.lang.String,?> properties) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns a List of User representing the resultset of the provided Query. The query is based on the XPath query language As this is a paged search, only a subset (page) of the complete result is returned. The page size is determined by the properties map passed as parameter. Use e.g. PagingIterator.hasNextPage() and PagingIterator.getNextPage(List) to iterate over the result pages. Parameters: aQuery - an XPath expression pagingProperties - Map that specifies the paging properties. Must at least contain a positive value for RESULTS_PER_PAGE. Returns: PagingIterator object that can be used to iterate over the paged result. If nothing is found, the iterator will contain one empty page. Throws: java.lang.IllegalArgumentException - if pagingProperties is null or does contain invalid properties. PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 7.0 See Also: PagingIterator, User, List findGroupsByQuery java.util.List<Group> findGroupsByQuery(java.lang.String aQuery) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns a List of Group representing the resultset of the provided Query. The query is based on the XPath query language Parameters: aQuery - an XPath expression Returns: List read-only List containing com.ibm.portal.um.Group. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 6.1 See Also: User, List findGroupsByQuery PagingIterator<Group> findGroupsByQuery(java.lang.String aQuery, java.util.Map<java.lang.String,?> properties) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns a List of Group representing the resultset of the provided Query. The query is based on the XPath query language As this is a paged search, only a subset (page) of the complete result is returned. The page size is determined by the properties map passed as parameter. Use e.g. PagingIterator.hasNextPage() and PagingIterator.getNextPage(List) to iterate over the result pages. Parameters: aQuery - an XPath expression pagingProperties - Map that specifies the paging properties. Must at least contain a positive value for RESULTS_PER_PAGE. Returns: PagingIterator object that can be used to iterate over the paged result. If nothing is found, the iterator will contain one empty page. Throws: java.lang.IllegalArgumentException - if pagingProperties is null or does contain invalid properties. PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 7.0 See Also: PagingIterator, User, List findUsersByQuery java.util.List<User> findUsersByQuery(java.lang.String aQuery, com.ibm.websphere.wim.model.SortControl aControl) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns a List of User representing the resultset of the provided Query. The query is based on the XPath query language Parameters: aQuery - an XPath expression aControl - defines how the result set should be sorted Returns: List read-only List containing com.ibm.portal.um.User. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 6.1 See Also: User, List findGroupsByQuery java.util.List<Group> findGroupsByQuery(java.lang.String aQuery, com.ibm.websphere.wim.model.SortControl aControl) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException Returns a List of Group representing the resultset of the provided Query. The query is based on the XPath query language Parameters: aQuery - an XPath expression aControl - defines how the result set should be sorted Returns: List read-only List containing com.ibm.portal.um.Group. If nothing is found an empty java.util.List will be returned Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaAttributeException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 6.1 See Also: User, List searchUserByName java.util.List<User> searchUserByName(java.lang.String aName) throws PumaSystemException, PumaModelException, PumaMissingAccessRightsException Returns a list of Users that have a name that matches the given name. The query used for finding the users considers those attributes that are typically used as name and matches their values against the given name. Parameters: name - defines the string to be used in the query Returns: List of User objects Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaModelException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 6.1 searchUserByName PagingIterator<User> searchUserByName(java.lang.String aName, java.util.Map<java.lang.String,?> properties) throws PumaSystemException, PumaMissingAccessRightsException Returns a list of Users that have a name that matches the given name. As this is a paged search, only a subset (page) of the complete result is returned. The page size is determined by the properties map passed as parameter. Use e.g. PagingIterator.hasNextPage() and PagingIterator.getNextPage(List) to iterate over the result pages. Parameters: name - defines the string to be used in the query pagingProperties - Map that specifies the paging properties. Must at least contain a positive value for RESULTS_PER_PAGE. Returns: PagingIterator object that can be used to iterate over the paged result. If nothing is found, the iterator will contain one empty page. Throws: java.lang.IllegalArgumentException - if pagingProperties is null or does contain invalid properties. PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaModelException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 7.0 See Also: The query used for finding the users considers those attributes that are typically used as name and matches their values against the given name. searchGroupByName java.util.List<Group> searchGroupByName(java.lang.String name) throws PumaSystemException, PumaModelException, PumaMissingAccessRightsException Returns a list of Groups that have a name that matches the given name. The query used for finding the groups considers those attributes that are typically used as name and matches their values against the given name. Parameters: name - defines the string to be used in the query Returns: List of Group objects Throws: PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaModelException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 6.1 searchGroupByName PagingIterator<Group> searchGroupByName(java.lang.String name, java.util.Map<java.lang.String,?> properties) throws PumaSystemException, PumaMissingAccessRightsException Returns a list of Groups that have a name that matches the given name. As this is a paged search, only a subset (page) of the complete result is returned. The page size is determined by the properties map passed as parameter. Use e.g. PagingIterator.hasNextPage() and PagingIterator.getNextPage(List) to iterate over the result pages. Parameters: name - defines the string to be used in the query pagingProperties - Map that specifies the paging properties. Must at least contain a positive value for RESULTS_PER_PAGE. Returns: PagingIterator object that can be used to iterate over the paged result. If nothing is found, the iterator will contain one empty page. Throws: java.lang.IllegalArgumentException - if pagingProperties is null or does contain invalid properties. PumaSystemException - will be thrown whenever an unrecoverable backend error occurs PumaModelException - will be thrown if attributes are not defined PumaMissingAccessRightsException - will be thrown if the current authenticated user does not have the necessary rights Since: 7.0 See Also: The query used for finding the groups considers those attributes that are typically used as name and matches their values against the given name. findUsersByAttributeRecursively java.util.List<User> findUsersByAttributeRecursively(User user, java.lang.String attribute, int depth) throws PumaSystemException, PumaAttributeException, PumaMissingAccessRightsException, MemberNotFoundException Returns a List of Principals that are linked by the given attribute. This method can only be applied on an attribute of the type AttributeDefinition.MEMBERDN. The (n+1)th user in the list is identified by the value of the given attribute of the nth user. If the given attribute is multi-valued, only the first value is considered. The computation will stop either at the first principal where the attribute is null or at the level where the current User does not have the necessary permissions or at the given depth. Parameters: user - start point to fetch all dependent principals, null is not allowed as input parameter attribute - the attribute to look at depth - the maximum size of the list to be returned; use -1 for "unrestricted" Returns: a List containing the chain of principals available form the given user Throws: PumaSystemException PumaAttributeException PumaMissingAccessRightsException MemberNotFoundException - - if the user referred to by parameter aUser is not available Since: 6.1 PREV CLASS NEXT CLASS Tree SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

Field Summary
static java.lang.String	MAXIMUM_RESULTS Use this property to set the maximum number of total results that a search request will return when performing a paged search.
static java.lang.String	RESULTS_PER_PAGE Use this property to set the page size when performing a paged search.
static java.lang.String	SORT_CONTROL Use this property control the sorting when performing a paged search.

Method Summary
Group	findGroupByIdentifier(java.lang.String aIdentifier) Return the Group object referenced by the identifier (DN) within the user repository.
Group	findGroupByObjectID(ObjectID aId) Return the Group object referenced by the given `ObjectID`. If no group is found a PumaModelException is thrown
java.util.List<Group>	findGroupsByAttribute(java.lang.String aAttribute, java.lang.String aValue) Return a List of Group where the attributes defined in the LDAP server matches the value of the given attribute.
PagingIterator<Group>	findGroupsByAttribute(java.lang.String aAttribute, java.lang.String aValue, java.util.Map<java.lang.String,?> properties) Return a List of Group where the attributes defined in the LDAP server matches the value of the given attribute.
java.util.List<Group>	findGroupsByDefaultAttribute(java.lang.String aValue) Returns `Group by comparing the provided value to the default attribute type configured for the Group type For a LIKE comparision only the multi-character wild card is supported and the character used is '*'.`
java.util.List<Group>	findGroupsByDefaultAttribute(java.lang.String aValue, boolean aSorted) Returns `Group by comparing the provided value to the default attribute type configured for the Group type For a LIKE comparision only the multi-character wild card is supported and the character used is '*'.`
java.util.List<Group>	findGroupsByPrincipal(Principal aPrincipal, boolean aNested) Return the Groups where the given Principal is member of.
PagingIterator<Group>	findGroupsByPrincipal(Principal aPrincipal, boolean aNested, java.util.Map<java.lang.String,?> properties) Return the Groups where the given Principal is member of.
java.util.List<Group>	findGroupsByQuery(java.lang.String aQuery) Return a List of `Group representing the resultset of the provided Query.`
PagingIterator<Group>	findGroupsByQuery(java.lang.String aQuery, java.util.Map<java.lang.String,?> properties) Return a List of `Group representing the resultset of the provided Query.`
java.util.List<Group>	findGroupsByQuery(java.lang.String aQuery, com.ibm.websphere.wim.model.SortControl aControl) Return a List of `Group representing the resultset of the provided Query.`
java.util.List<Principal>	findMembersByGroup(Group aGroup, boolean aNested) Return the mebers for a given Group.
PagingIterator<Principal>	findMembersByGroup(Group aGroup, boolean aNested, java.util.Map<java.lang.String,?> properties) Return the mebers for a given Group.
Principal	findPrincipalByIdentifier(java.lang.String aIdentifier) Return the Principal (user or group) object referenced by the given identifier.
java.util.Map<java.lang.String,Principal>	findPrincipalsByIdentifiers(java.util.Collection<java.lang.String> identifiers) Return the Principal (user and/or group) objects referenced by the given identifiers.
User	findUserByIdentifier(java.lang.String aIdentifier) Return the User object referenced by the given identifier.
User	findUserByObjectID(ObjectID aId) Return the User object referenced by the given `ObjectID`. If no user is found a PumaModelException is thrown
java.util.List<User>	findUsersByAttribute(java.lang.String aAttribute, java.lang.String aValue) Return a List of `User where the attribute defined in the LDAP server matches the given value.`
PagingIterator<User>	findUsersByAttribute(java.lang.String aAttribute, java.lang.String aValue, java.util.Map<java.lang.String,?> pagingProps) Return a List of `Users where the attribute defined in the user repository matches the given value.`
java.util.List<User>	findUsersByAttributeRecursively(User user, java.lang.String attribute, int depth) Return a List of Principals that are linked by the given attribute.
java.util.List<User>	findUsersByDefaultAttribute(java.lang.String aValue) Returns `User by comparing the provided value to the default attribute type configured for the User type.`
java.util.List<User>	findUsersByDefaultAttribute(java.lang.String aValue, boolean aSorted) Returns `User by comparing the provided value to the default attribute type configured for the User type.`
java.util.List<User>	findUsersByQuery(java.lang.String aQuery) Return a List of `User representing the resultset of the provided Query.`
PagingIterator<User>	findUsersByQuery(java.lang.String aQuery, java.util.Map<java.lang.String,?> properties) Return a List of `User representing the resultset of the provided Query.`
java.util.List<User>	findUsersByQuery(java.lang.String aQuery, com.ibm.websphere.wim.model.SortControl aControl) Return a List of `User representing the resultset of the provided Query.`
java.util.List<Group>	searchGroupByName(java.lang.String name) Return a list of Groups that have a name that matches the given name.
PagingIterator<Group>	searchGroupByName(java.lang.String name, java.util.Map<java.lang.String,?> properties) Return a list of Groups that have a name that matches the given name.
java.util.List<User>	searchUserByName(java.lang.String aName) Return a list of Users that have a name that matches the given name.
PagingIterator<User>	searchUserByName(java.lang.String aName, java.util.Map<java.lang.String,?> properties) Return a list of Users that have a name that matches the given name.

com.ibm.portal.um Interface PumaLocator

MAXIMUM_RESULTS

RESULTS_PER_PAGE

SORT_CONTROL

findPrincipalByIdentifier

findPrincipalsByIdentifiers

findUserByIdentifier

findUserByObjectID

findGroupByObjectID

findGroupByIdentifier

findUsersByDefaultAttribute

findUsersByDefaultAttribute

findGroupsByDefaultAttribute

findGroupsByDefaultAttribute

findUsersByAttribute

findUsersByAttribute

findGroupsByAttribute

findGroupsByAttribute

findMembersByGroup

findMembersByGroup

findGroupsByPrincipal

findGroupsByPrincipal

findUsersByQuery

findUsersByQuery

findGroupsByQuery

findGroupsByQuery

findUsersByQuery

findGroupsByQuery

searchUserByName

searchUserByName

searchGroupByName

searchGroupByName

findUsersByAttributeRecursively

com.ibm.portal.um
Interface PumaLocator