Package com.iplanet.am.sdk

Interface AMGroup

All Superinterfaces:

AMConstants, AMObject

All Known Subinterfaces:

AMAssignableDynamicGroup, AMDynamicGroup, AMStaticGroup

public interface AMGroup
extends AMObject

Deprecated.

As of Sun Java System Access Manager 7.1.

The AMGroup interface provides methods to manage group

Field Summary

Fields inherited from interface com.iplanet.am.sdk.AMConstants

ADD_MEMBER, ADMIN_GROUPS_ENABLED_ATTR, ADMIN_ROLE_ATTR, ADMINISTRATION_SERVICE, CACHE_ENABLED_DISABLED_KEY, CACHE_MAX_SIZE_KEY, COMPLIANCE_SPECIAL_FILTER_ATTR, COMPLIANCE_USER_DELETION_ATTR, CONTAINER_DEFAULT_TEMPLATE_ROLE, CONTAINER_SUPPORTED_TYPES_ATTRIBUTE, DCT_ATTRIBUTE_LIST_ATTR, DCT_ENABLED_ATTR, DOMAIN_ADMINISTRATORS, DOMAIN_HELP_DESK_ADMINISTRATORS, EMAIL_ATTRIBUTE, FILTER_ATTR_NAME, INET_ADMIN_OBJECT_CLASS, INET_DOMAIN_STATUS_ATTR, INET_DOMAIN_STATUS_ATTRIBUTE, INVALID_USERID_CHARACTERS, OTHER_COSATTR_TYPE, POLICY_COSATTR_TYPE, POLICY_SUFFIX, PRE_POST_PROCESSING_MODULES_ATTR, REMOVE_ATTRIBUTE, REMOVE_MEMBER, REQUIRED_SERVICES_ATTR, ROLE_MANAGED_CONTAINER_DN_ATTRIBUTE, SCOPE_BASE, SCOPE_ONE, SCOPE_SUB, SERVICE_STATUS_ATTRIBUTE, STATIC_GROUP_DN_ATTRIBUTE, SUBSCRIBABLE_ATTRIBUTE, UNIQUE_ATTRIBUTE_LIST_ATTRIBUTE, UNIQUE_MEMBER_ATTRIBUTE, USER_CREATE_NOTIFICATION_LIST, USER_DELETE_NOTIFICATION_LIST, USER_ENCRYPTED_PASSWORD_ATTRIBUTE, USER_ENTRY_PROCESSING_IMPL, USER_MODIFY_NOTIFICATION_LIST, USER_PASSWORD_ATTRIBUTE, USER_SEARCH_RETURN_ATTR, USERID_PASSWORD_VALIDATION_CLASS

Fields inherited from interface com.iplanet.am.sdk.AMObject

ACTIVE, ACTIVE_VALUE, ASSIGNABLE_DYNAMIC_GROUP, DELETED, DELETED_VALUE, DYNAMIC_GROUP, FILTERED_ROLE, GROUP, GROUP_CONTAINER, GROUP_PROFILE, INACTIVE, INACTIVE_VALUE, MANAGED_ROLE, ORGANIZATION, ORGANIZATIONAL_UNIT, PEOPLE_CONTAINER, POLICY, RESOURCE, ROLE, ROLE_PROFILE, SERVICE, STATIC_GROUP, TEMPLATE, UNDETERMINED_OBJECT_TYPE, UNKNOWN_OBJECT_TYPE, USER

Method Summary

Modifier and Type	Method	Description
void	addNestedGroups(Set groups)	Deprecated. Nests the given group distinguished names in this the group.
Set	createAssignableDynamicGroups(Map groups)	Deprecated. Creates assignable dynamic groups and initializes their attributes.
Set	createAssignableDynamicGroups(Set groupNames)	Deprecated. Creates assignable dynamic groups in this group.
Set	createDynamicGroups(Map groups)	Deprecated. Creates dynamic groups and initializes their attributes.
Set	createDynamicGroups(Set groupNames)	Deprecated. Creates dynamic groups in this group.
Set	createStaticGroups(Map groups)	Deprecated. Creates static groups and initializes their attributes.
Set	createStaticGroups(Set groupNames)	Deprecated. Creates static groups in this group.
void	deleteAssignableDynamicGroups(Set groupDNs)	Deprecated. Deletes assignable dynamic groups in this group.
void	deleteDynamicGroups(Set groupDNs)	Deprecated. Deletes dynamic groups in this group.
void	deleteStaticGroups(Set groupDNs)	Deprecated. Deletes static groups in this group.
Set	getGroupDNs(int level)	Deprecated. Gets the groups in this group.
Set	getNestedGroupDNs()	Deprecated. Returns the groups nested in this group.
long	getNumberOfGroups(int level)	Deprecated. Returns number of groups in the group.
long	getNumberOfUsers()	Deprecated. Returns number of users in the group.
Set	getUserAndGroupDNs()	Deprecated. Returns the distinguished name of users and nested groups in the group.
Set	getUserDNs()	Deprecated. Returns the distinguished name of users in the group.
void	removeNestedGroups(Set groups)	Deprecated. Removes groups which are nested in this group.
Set	searchGroups(String wildcard, int level)	Deprecated. Searches for groups in this group using wildcards.
Set	searchGroups(String wildcard, Map avPairs, int level)	Deprecated. Searches for groups in this group using wildcards and attribute values.
AMSearchResults	searchGroups(String wildcard, Map avPairs, AMSearchControl searchControl)	Deprecated. Searches for groups in this group using wildcards and attribute values.
AMSearchResults	searchUsers(AMSearchControl searchControl, String avfilter)	Deprecated. Searches for users in this group using attribute values.
Set	searchUsers(String wildcard)	Deprecated. Searches for users in this group using wildcards and attribute values.
AMSearchResults	searchUsers(String wildcard, Map avPairs, AMSearchControl searchControl)	Deprecated. Searches for users in this group using wildcards.

Methods inherited from interface com.iplanet.am.sdk.AMObject

addEventListener, assignPolicies, assignServices, createPolicyTemplate, createPolicyTemplate, createTemplate, createTemplate, delete, delete, getAssignedServices, getAttribute, getAttributeByteArray, getAttributes, getAttributes, getAttributesByteArray, getAttributesByteArray, getAttributesFromDataStore, getAttributesFromDataStore, getDN, getOrganizationDN, getParentDN, getPolicy, getPolicyTemplate, getServiceAttributes, getServiceStatus, getStringAttribute, getTemplate, isExists, modifyService, purge, removeAttributes, removeEventListener, search, setAttributeByteArray, setAttributes, setAttributesByteArray, setServiceStatus, setStringAttribute, store, store, unassignPolicies, unassignServices

Method Detail

getNumberOfUsers

long getNumberOfUsers()
               throws AMException,
                      SSOException

Deprecated.

Returns number of users in the group.

Returns:

Number of users in the group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token no longer valid.

getUserDNs

Set getUserDNs()
        throws AMException,
               SSOException

Deprecated.

Returns the distinguished name of users in the group.

Returns:

a set of user distinguished names in the group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

getUserAndGroupDNs

Set getUserAndGroupDNs()
                throws AMException,
                       SSOException

Deprecated.

Returns the distinguished name of users and nested groups in the group.

Returns:

The distinguished name of users and nested groups in the group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

addNestedGroups

void addNestedGroups(Set groups)
              throws AMException,
                     SSOException

Deprecated.

Nests the given group distinguished names in this the group. This will effectively make the groups members of this group. And any ACIs set for this group will be inherited by the nested groups and their members.

Parameters:

groups - The set of group distinguished names to be nested in this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

searchUsers

Set searchUsers(String wildcard)
         throws AMException,
                SSOException

Deprecated.

Searches for users in this group using wildcards and attribute values. Wildcards can be specified such as a*, *, *a.

Parameters:

wildcard - wildcard pattern to be used in the search

Returns:

Set of distinguished name of users matching the search

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid

searchUsers

AMSearchResults searchUsers(String wildcard,
                            Map avPairs,
                            AMSearchControl searchControl)
                     throws AMException,
                            SSOException

Deprecated.

Searches for users in this group using wildcards. Wildcards can be specified such as a*, *, *a.

Parameters:

wildcard - wildcard pattern to be used in the search

avPairs - attribute-value pairs to match when searching users

searchControl - specifies the size limit and time limit

Returns:

AMSearchResults which contains a set of distinguished name of Users matching the search.

Throws:

AMException - if there is an internal error in the access management store.

SSOException - if the single sign on token is no longer valid.

searchUsers

AMSearchResults searchUsers(AMSearchControl searchControl,
                            String avfilter)
                     throws AMException,
                            SSOException

Deprecated.

Searches for users in this group using attribute values. Wildcards such as a*, *, *a can be specified for the attribute values. The distinguished names of users with matching attribute-value pairs will be returned.

Parameters:

searchControl - specifies the search scope to be used, VLV ranges etc.,

avfilter - this attribute-value pairs filter will be logical AND with user search filter.

Returns:

AMSearchResults which contains a set of distinguished names of Users matching the search.

Throws:

AMException - if there is an internal error in the access management Store.

SSOException - if the single sign on token is no longer valid.

createStaticGroups

Set createStaticGroups(Set groupNames)
                throws AMException,
                       SSOException

Deprecated.

Creates static groups in this group.

Parameters:

groupNames - The set of static groups' names to be created in this group.

Returns:

set of static group objects created.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

createStaticGroups

Set createStaticGroups(Map groups)
                throws AMException,
                       SSOException

Deprecated.

Creates static groups and initializes their attributes.

Parameters:

groups - Map where the key is the name of the static group, and the value is a Map to represent Attribute-Value Pairs

Returns:

Set of group objects created.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

createDynamicGroups

Set createDynamicGroups(Set groupNames)
                 throws AMException,
                        SSOException

Deprecated.

Creates dynamic groups in this group.

Parameters:

groupNames - The set of dynamic groups' names to be created in this group.

Returns:

Set of dynamic group objects created

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

createDynamicGroups

Set createDynamicGroups(Map groups)
                 throws AMException,
                        SSOException

Deprecated.

Creates dynamic groups and initializes their attributes.

Parameters:

groups - Map of name of the dynamic group to attribute-value pairs map.

Returns:

Set of dynamic group objects created.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

createAssignableDynamicGroups

Set createAssignableDynamicGroups(Set groupNames)
                           throws AMException,
                                  SSOException

Deprecated.

Creates assignable dynamic groups in this group.

Parameters:

groupNames - The set of assignable dynamic groups' names to be created in this group.

Returns:

Set of assignable dynamic group objects created.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

createAssignableDynamicGroups

Set createAssignableDynamicGroups(Map groups)
                           throws AMException,
                                  SSOException

Deprecated.

Creates assignable dynamic groups and initializes their attributes.

Parameters:

groups - Map of name of the assignable dynamic group to attribute-value pairs map;

Returns:

Set of assignable dynamic group objects created.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

getGroupDNs

Set getGroupDNs(int level)
         throws AMException,
                SSOException

Deprecated.

Gets the groups in this group. It returns groups either at one level or a whole subtree.

Parameters:

level - the level (AMConstants.SCOPE_ONE or AMConstants.SCOPE_SUB) for returning groups.

Returns:

The group distinguished names in this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store or if the level is invalid.

SSOException - if the single sign on token is no longer valid.

getNestedGroupDNs

Set getNestedGroupDNs()
               throws AMException,
                      SSOException

Deprecated.

Returns the groups nested in this group.

Returns:

The group distinguished names nested in this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

removeNestedGroups

void removeNestedGroups(Set groups)
                 throws AMException,
                        SSOException

Deprecated.

Removes groups which are nested in this group.

Parameters:

groups - The set of user DN's to be removed from the static group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid

getNumberOfGroups

long getNumberOfGroups(int level)
                throws AMException,
                       SSOException

Deprecated.

Returns number of groups in the group. It returns number of groups either at one level or a whole subtree.

Parameters:

level - the level (AMConstants.SCOPE_ONE or AMConstants.SCOPE_SUB) for returning groups.

Returns:

Number of groups in the group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

deleteStaticGroups

void deleteStaticGroups(Set groupDNs)
                 throws AMException,
                        SSOException

Deprecated.

Deletes static groups in this group.

Parameters:

groupDNs - The set of static group distinguished names to be deleted from this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

deleteDynamicGroups

void deleteDynamicGroups(Set groupDNs)
                  throws AMException,
                         SSOException

Deprecated.

Deletes dynamic groups in this group.

Parameters:

groupDNs - The set of dynamic group distinguished names to be deleted from this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid

deleteAssignableDynamicGroups

void deleteAssignableDynamicGroups(Set groupDNs)
                            throws AMException,
                                   SSOException

Deprecated.

Deletes assignable dynamic groups in this group.

Parameters:

groupDNs - The set of assignable dynamic group distinguished names to be deleted from this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

searchGroups

Set searchGroups(String wildcard,
                 int level)
          throws AMException,
                 SSOException

Deprecated.

Searches for groups in this group using wildcards. Wildcards can be specified such as a*, *, *a.

Parameters:

wildcard - wildcard pattern to be used in the search

level - the search level that needs to be used ( AMConstants.SCOPE_ONE or AMConstants.SCOPE_TREE).

Returns:

Set of distinguished name of sub groups matching the search

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

searchGroups

Set searchGroups(String wildcard,
                 Map avPairs,
                 int level)
          throws AMException,
                 SSOException

Deprecated.

Searches for groups in this group using wildcards and attribute values. Wildcards can be specified such as a*, *, *a.

Parameters:

wildcard - wildcard pattern to be used in the search

avPairs - attribute-value pairs to match when searching groups

level - the search level that needs to be used ( AMConstants.SCOPE_ONE or AMConstants.SCOPE_TREE)

Returns:

Set of distinguished name of groups matching the search

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

searchGroups

AMSearchResults searchGroups(String wildcard,
                             Map avPairs,
                             AMSearchControl searchControl)
                      throws AMException,
                             SSOException

Deprecated.

Searches for groups in this group using wildcards and attribute values. Wildcards can be specified such as a*, *, *a.

Parameters:

wildcard - wildcard pattern to be used in the search

avPairs - attribute-value pairs to match when searching groups

searchControl - specifies the search scope to be used

Returns:

AMSearchResults which contains a set of distinguished name of groups matching the search.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.