Interface GroupService
A group is a collection of principals. It's membership consists of direct principal assignment and/or nested group membership. All groups are uniquely identified by a namespace code plus a name.
As mentioned previously, groups support nested group membership. A principal or group is considered to be a "member" of a group if it is either directly assigned to the group or indirectly assigned (via a nested group membership). A principal or group is said to be a "direct" member of another group only if it is directly assigned as a member of the group, and not via a nested group assignment.
- Author:
- Kuali Rice Team (rice.collab@kuali.org)
-
Method Summary
Modifier and TypeMethodDescriptionbooleanaddGroupToGroup(String childId, String parentId) Adds the group with the id supplied in childId as a member of the group with the id supplied in parentId.booleanaddPrincipalToGroup(String principalId, String groupId) Add the principal with the given principalId as a member of the group with the given groupId.createGroup(Group group) Creates a new group using the given Group.createGroupMember(GroupMember groupMember) Creates a new group using the given GroupMember.findGroupIds(org.kuali.rice.core.api.criteria.QueryByCriteria queryByCriteria) Query for groups based on the given search criteria which is a Map of group field names to values.findGroupMembers(org.kuali.rice.core.api.criteria.QueryByCriteria queryByCriteria) Query for group members based on the given search criteria which is a Map of group member field names to values.findGroups(org.kuali.rice.core.api.criteria.QueryByCriteria queryByCriteria) Query for groups based on the given search criteria which is a Map of group field names to values.getAttributes(String groupId) Get all the attributes of the given group.getCurrentAndFutureMembers(String groupId) Returns the list of group members who are currently active and futureActive .getDirectGroupIdsByPrincipalId(String principalId) Get all the groups for the given principal.getDirectMemberGroupIds(String groupId) Returns all group ids that are direct members of the given group id.getDirectMemberGroupIdsWithDate(String groupId) getDirectMemberPrincipalIds(String groupId) Returns all principal ids that are direct members of the given group id.getDirectParentGroupIds(String groupId) Returns all parent groups ids that the given group id is a member of.getDirectParentGroupIdsWithDate(String groupId, org.joda.time.DateTime asOfDate) Lookup a Group based on the passed in id.getGroupByNamespaceCodeAndName(String namespaceCode, String groupName) Lookup a Group based on the passed in namespace and name.getGroupIdsByPrincipalId(String principalId) Get all the groups for the given principal.getGroupIdsByPrincipalIdAndNamespaceCode(String principalId, String namespaceCode) Get all the groups for the given principal.getGroups(Collection<String> ids) Gets all groups for the given collection of group ids.getGroupsByPrincipalId(String principalId) Get all the groups for a given principal.getGroupsByPrincipalIdAndNamespaceCode(String principalId, String namespaceCode) Get all the groups within a namespace for a given principal.getMemberGroupIds(String groupId) Returns all group ids that are members of the given group id.getMemberPrincipalIds(String groupId) Returns all principal ids that are members of the given group id.getMembers(List<String> groupIds) Get all GroupMembers all the groups with the given group ids.getMembersOfGroup(String groupId) Get all GroupMembers all the groups with a given group id.getMembersOfGroupWithDate(String groupId, org.joda.time.DateTime asOfDate) Get all GroupMembers all the groups with a given group id and asOfDate.getMembersWithDate(List<String> groupIds, org.joda.time.DateTime asOfDate) getParentGroupIds(String groupId) Returns all parent groups ids that the given group id is a member of.booleanisDirectMemberOfGroup(String principalId, String groupId) Check whether the give principal is a member of the group.booleanisGroupMemberOfGroup(String groupMemberId, String groupId) Check whether the group identified by groupMemberId is a member of the group identified by groupId.booleanisGroupMemberOfGroupWithDate(String groupMemberId, String groupId, org.joda.time.DateTime asOfDate) booleanisMemberOfGroup(String principalId, String groupId) Check whether the give principal is a member of the group.booleanisMemberOfGroupWithDate(String principalId, String groupId, org.joda.time.DateTime asOfDate) voidremoveAllMembers(String groupId) Removes all members from the group with the given groupId.booleanremoveGroupFromGroup(String childId, String parentId) Removes the group with the id supplied in childId from the group with the id supplied in parentId.booleanremovePrincipalFromGroup(String principalId, String groupId) Removes the member principal with the given principalId from the group with the given groupId.updateGroup(String groupId, Group group) Updates a group using the given Group.updateGroup(Group group) Updates an existing group using the given Group.updateGroupMember(GroupMember groupMember) Updates an existing group using the given GroupMember.
-
Method Details
-
getGroupsByPrincipalId
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'principalId=\' + #p0") List<Group> getGroupsByPrincipalId(String principalId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Get all the groups for a given principal.This will include all groups directly assigned as well as those inferred by the fact that they are members of higher level groups.
- Parameters:
principalId- The id of the Principal- Returns:
- a list of Group objects in which the given Principal is a member of. An empty list is returned if an invalid or non-existant principalId is supplied.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the principalId is null or blank
-
getGroupsByPrincipalIdAndNamespaceCode
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'principalId=\' + #p0 + \'|\' + \'namespaceCode=\' + #p1") List<Group> getGroupsByPrincipalIdAndNamespaceCode(String principalId, String namespaceCode) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Get all the groups within a namespace for a given principal.This will include all groups directly assigned as well as those inferred by the fact that they are members of higher level groups, and filtered by Group namespace.
- Parameters:
principalId- The id of the PrincipalnamespaceCode- The namespace code of the desired Groups to return- Returns:
- a list of Group objects in which the given Principal is a member of, filtered by Group namespace. An empty list is returned if an invalid or non-existant principalId is supplied.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the principalId, namespaceCode is null or blank
-
findGroupIds
List<String> findGroupIds(org.kuali.rice.core.api.criteria.QueryByCriteria queryByCriteria) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Query for groups based on the given search criteria which is a Map of group field names to values.This method returns it's results as a List of group ids that match the given search criteria.
- Parameters:
queryByCriteria- the criteria. Cannot be null.- Returns:
- a list of groupId Strings in which the given criteria match Group properties. An empty list is returned if an invalid or non-existent criteria is supplied.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the queryByCriteria is null
-
findGroups
GroupQueryResults findGroups(org.kuali.rice.core.api.criteria.QueryByCriteria queryByCriteria) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Query for groups based on the given search criteria which is a Map of group field names to values.This method returns it's results as a List of Groups that match the given search criteria.
- Parameters:
queryByCriteria- the criteria. Cannot be null.- Returns:
- a list of Group objects in which the given criteria match Group properties. An empty list is returned if an invalid or non-existent criteria is supplied.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the queryByCriteria is null
-
findGroupMembers
GroupMemberQueryResults findGroupMembers(org.kuali.rice.core.api.criteria.QueryByCriteria queryByCriteria) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Query for group members based on the given search criteria which is a Map of group member field names to values.This method returns it's results as a List of GroupMemberss that match the given search criteria.
- Parameters:
queryByCriteria- the criteria. Cannot be null.- Returns:
- a list of GroupMember objects in which the given criteria match Group properties. An empty list is returned if an invalid or non-existent criteria is supplied.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the queryByCriteria is null
-
getGroup
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupType", key="\'id=\' + #p0") Group getGroup(String id) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Lookup a Group based on the passed in id.- Parameters:
id- String that matches the desired Groups id- Returns:
- a Group with the given id value. A null reference is returned if an invalid or non-existant id is supplied.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupId is null or blank
-
getGroupByNamespaceCodeAndName
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupType", key="\'namespaceCode=\' + #p0 + \'|\' + \'groupName=\' + #p1") Group getGroupByNamespaceCodeAndName(String namespaceCode, String groupName) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Lookup a Group based on the passed in namespace and name.- Parameters:
namespaceCode- String that matches the desired Group's namespaceCodegroupName- String that matches the desired Group's name- Returns:
- a Group with the given namespace and name values. A null reference is returned if an invalid or non-existant id is supplied.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the namespaceCode, groupName is null or blank
-
getGroups
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupType", key="\'ids=\' + T(org.kuali.rice.core.api.cache.CacheKeyUtils).key(#p0)") List<Group> getGroups(Collection<String> ids) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Gets all groups for the given collection of group ids.The result is a Map containing the group id as the key and the Group as the value.
- Parameters:
ids- Collection that matches the desired Groups' id- Returns:
- a Map of Groups with the given id values. An empty Map is returned if an invalid or non-existant id is supplied.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupIds null or empty
-
isMemberOfGroup
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{isMemberOfGroup}\' + \'principalId=\' + #p0 + \'|\' + \'groupId=\' + #p1") boolean isMemberOfGroup(String principalId, String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Check whether the give principal is a member of the group.Will return true if the principal is a member of the group or a group assigned to this group.
- Parameters:
principalId- Id of the principalgroupId- Id string of group- Returns:
- true if principal is a member of the group or a member of a group assigned to the the group.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the principalId, groupId is null or blank
-
isDirectMemberOfGroup
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{isDirectMemberOfGroup}\' + \'principalId=\' + #p0 + \'|\' + \'groupId=\' + #p1") boolean isDirectMemberOfGroup(String principalId, String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Check whether the give principal is a member of the group.This method does not recurse into contained groups.
- Parameters:
principalId- Id of the principalgroupId- Id string of group- Returns:
- true if principal is a direct member of the group.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the principalId, groupId is null or blank
-
getGroupIdsByPrincipalId
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{getGroupIdsByPrincipalId}\' + \'principalId=\' + #p0") List<String> getGroupIdsByPrincipalId(String principalId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Get all the groups for the given principal. Recurses into parent groups to provide a comprehensive list.This returns id for all groups for a given principal id.
- Parameters:
principalId- Id of a Principal- Returns:
- a list of Group Ids in which the principal is a member of.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the principalId is null or blank
-
getGroupIdsByPrincipalIdAndNamespaceCode
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{getGroupIdsByPrincipalIdAndNamespaceCode}\' + \'principalId=\' + #p0 + \'|\' + \'namespaceCode=\' + #p1") List<String> getGroupIdsByPrincipalIdAndNamespaceCode(String principalId, String namespaceCode) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Get all the groups for the given principal. Recurses into parent groups to provide a comprehensive list. This is limited to the passed in Group's namespace.This returns id for all groups for a given principal id, limited to specific Group namespace.
- Parameters:
principalId- Id of a PrincipalnamespaceCode- Namspace code to limit group results to- Returns:
- a list of Group Ids in which the principal is a member of, limited to the passed in namespace.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the principalId, namespaceCode is null or blank
-
getDirectGroupIdsByPrincipalId
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{getDirectGroupIdsByPrincipalId}\' + \'principalId=\' + #p0") List<String> getDirectGroupIdsByPrincipalId(String principalId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Get all the groups for the given principal. Does not recurse into parent groups.This returns id for all groups for a given principal id.
- Parameters:
principalId- Id of a Principal- Returns:
- a list of Group Ids in which the principal is directly a member of.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the principalId is null or blank
-
isGroupMemberOfGroup
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{isGroupMemberOfGroup}\' + \'groupMemberId=\' + #p0 + \'|\' + \'groupId=\' + #p1") boolean isGroupMemberOfGroup(String groupMemberId, String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Check whether the group identified by groupMemberId is a member of the group identified by groupId. This will recurse through all groups.Will return true if the group is a member of the group or a group assigned to this group.
- Parameters:
groupMemberId- Id of the principalgroupId- Id string of group- Returns:
- true if group is a member of the group or a member of a group assigned to the the group.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupMemberId, groupId is null or blank
-
getMemberPrincipalIds
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{getMemberPrincipalIds}\' + \'groupId=\' + #p0") List<String> getMemberPrincipalIds(String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Returns all principal ids that are members of the given group id. Recurses into contained groups for comprehensive list.Will return a list of all principal ids for members this group.
- Parameters:
groupId- Id string of group- Returns:
- List of principal ids
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupId is null or blank
-
getDirectMemberPrincipalIds
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{getDirectMemberPrincipalIds}\' + \'groupId=\' + #p0") List<String> getDirectMemberPrincipalIds(String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Returns all principal ids that are direct members of the given group id.Will return a list of all principal ids for direct members this group.
- Parameters:
groupId- Id string of group- Returns:
- List of direct member principal ids.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupId is null or blank
-
getMemberGroupIds
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{getMemberGroupIds}\' + \'groupId=\' + #p0") List<String> getMemberGroupIds(String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Returns all group ids that are members of the given group id. Recurses into contained groups for a comprehensive list.Will return a list of all group ids for members this group.
- Parameters:
groupId- Id string of group- Returns:
- List of group ids
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupId is null or blank
-
getDirectMemberGroupIds
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{getDirectMemberGroupIds}\' + \'groupId=\' + #p0") List<String> getDirectMemberGroupIds(String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Returns all group ids that are direct members of the given group id.Will return a list of all group ids for direct members this group.
- Parameters:
groupId- Id string of group- Returns:
- List of direct member group ids.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupId is null or blank
-
getParentGroupIds
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{getParentGroupIds}\' + \'groupId=\' + #p0") List<String> getParentGroupIds(String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Returns all parent groups ids that the given group id is a member of. Recurses parent groups for a comprehensive list.Will return a list of all group ids that the given group id is a member of.
- Parameters:
groupId- Id string of group- Returns:
- List of parent group ids.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupId is null or blank
-
getDirectParentGroupIds
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'{getDirectParentGroupIds}\' + \'groupId=\' + #p0") List<String> getDirectParentGroupIds(String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Returns all parent groups ids that the given group id is a member of.Will return a list of all group ids that the given group id is a member of.
- Parameters:
groupId- Id string of group- Returns:
- List of parent group ids.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupId is null or blank
-
getAttributes
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupType", key="\'{getAttributes}\' + \'groupId=\' + #p0") Map<String,String> getAttributes(String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Get all the attributes of the given group.- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupId is null or blank
-
getMembersOfGroup
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'groupId=\' + #p0") List<GroupMember> getMembersOfGroup(String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Get all GroupMembers all the groups with a given group id.The collection of GroupMembers will contain members for a the group in no defined order.
- Parameters:
groupId- Id of group- Returns:
- Collection of GroupMembers.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupId is null or blank
-
getMembersOfGroupWithDate
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'groupId=\' + #p0 + \'|\' + \'asOfDate=\' + #p1") List<GroupMember> getMembersOfGroupWithDate(String groupId, org.joda.time.DateTime asOfDate) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Get all GroupMembers all the groups with a given group id and asOfDate.The collection of GroupMembers will contain members for a the group in no defined order. That were members at the specified time.
- Parameters:
groupId- Id of groupasOfDate- Date for historical record- Returns:
- Collection of GroupMembers.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupId is null or blank
-
getMembers
@Cacheable(value="http://rice.kuali.org/kim/v2_0/GroupMemberType", key="\'groupIds=\' + T(org.kuali.rice.core.api.cache.CacheKeyUtils).key(#p0)") List<GroupMember> getMembers(List<String> groupIds) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Get all GroupMembers all the groups with the given group ids.The collection of GroupMembers will contain members for all the groups in no defined order. The values returned may or may not be grouped by group id.
- Parameters:
groupIds- Ids of groups- Returns:
- Collection of GroupMembers.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupIds is null or empty
-
createGroup
@CacheEvict(value={"http://rice.kuali.org/kim/v2_0/GroupType","http://rice.kuali.org/kim/v2_0/GroupMemberType"}, allEntries=true) Group createGroup(Group group) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Creates a new group using the given Group.This will attempt to create a new Group
- Parameters:
group- The new group to be created- Returns:
- a the Group that has been created.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the group is null
-
updateGroup
@CacheEvict(value={"http://rice.kuali.org/kim/v2_0/GroupType","http://rice.kuali.org/kim/v2_0/GroupMemberType"}, allEntries=true) Group updateGroup(Group group) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Updates an existing group using the given Group.This will attempt to update an existing Group. For this to return without exceptions, the passed in Group must have it's Id set and be a valid group that already exists.
- Parameters:
group- The group to be updated- Returns:
- a the Group that has been updated.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the group is null
-
updateGroup
@CacheEvict(value={"http://rice.kuali.org/kim/v2_0/GroupType","http://rice.kuali.org/kim/v2_0/GroupMemberType"}, allEntries=true) Group updateGroup(String groupId, Group group) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Updates a group using the given Group.This will attempt to update an existing group with data from the passed in group. If the passed in groupId and the group.id values are different this method will inactivate the old group and create a new group with the same members with the passed in groups properties.
- Parameters:
groupId- Id of the Group to be updatedgroup- Group object to use for update- Returns:
- a the Group that has been updated.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the group is null or the groupId is null or blank
-
createGroupMember
@CacheEvict(value={"http://rice.kuali.org/kim/v2_0/GroupMemberType","http://rice.kuali.org/kim/v2_0/RoleType"}, allEntries=true) GroupMember createGroupMember(GroupMember groupMember) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Creates a new group using the given GroupMember.This will attempt to create a new GroupMember
- Parameters:
groupMember- The new groupMember to be created- Returns:
- a the GroupMember that has been created.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the group is null
-
updateGroupMember
@CacheEvict(value={"http://rice.kuali.org/kim/v2_0/GroupMemberType","http://rice.kuali.org/kim/v2_0/RoleType"}, allEntries=true) GroupMember updateGroupMember(GroupMember groupMember) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Updates an existing group using the given GroupMember.This will attempt to update an existing GroupMember. For this to return without exceptions, the passed in GroupMember must have it's Id set and be a valid groupMember that already exists.
- Parameters:
groupMember- The groupMember to be updated- Returns:
- a the GroupMember that has been updated.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupMember is null
-
addGroupToGroup
@CacheEvict(value={"http://rice.kuali.org/kim/v2_0/GroupMemberType","http://rice.kuali.org/kim/v2_0/RoleType"}, allEntries=true) boolean addGroupToGroup(String childId, String parentId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Adds the group with the id supplied in childId as a member of the group with the id supplied in parentId.- Parameters:
childId- Id of the Group to be added to the members of ParentparentId- Id of the Group object to add the member to- Returns:
- true if the member was added successfully.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the childId, parentId is null or blank
-
removeGroupFromGroup
@CacheEvict(value={"http://rice.kuali.org/kim/v2_0/GroupMemberType","http://rice.kuali.org/kim/v2_0/RoleType"}, allEntries=true) boolean removeGroupFromGroup(String childId, String parentId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Removes the group with the id supplied in childId from the group with the id supplied in parentId.- Parameters:
childId- Id of the Group to be removed from the members of ParentparentId- Id of the Group object to remove the member from- Returns:
- true if the member was removed successfully.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the childId, parentId is null or blank
-
addPrincipalToGroup
@CacheEvict(value={"http://rice.kuali.org/kim/v2_0/GroupMemberType","http://rice.kuali.org/kim/v2_0/RoleType"}, allEntries=true) boolean addPrincipalToGroup(String principalId, String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Add the principal with the given principalId as a member of the group with the given groupId.- Parameters:
principalId- Id of the Principal to be added to the members of the Parent GroupgroupId- Id of the Group object to add the member to- Returns:
- true if the member was added successfully.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the principalId, groupId is null or blank
-
removePrincipalFromGroup
@CacheEvict(value={"http://rice.kuali.org/kim/v2_0/GroupMemberType","http://rice.kuali.org/kim/v2_0/RoleType"}, allEntries=true) boolean removePrincipalFromGroup(String principalId, String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Removes the member principal with the given principalId from the group with the given groupId.- Parameters:
principalId- Id of the Principal to be removed from the members of the Parent GroupgroupId- Id of the Group object to remove the member from- Returns:
- true if the member was removed successfully.
- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the principalId, groupId is null or blank
-
removeAllMembers
@CacheEvict(value={"http://rice.kuali.org/kim/v2_0/GroupMemberType","http://rice.kuali.org/kim/v2_0/RoleType"}, allEntries=true) void removeAllMembers(String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException Removes all members from the group with the given groupId.- Parameters:
groupId- Id of the Group object to remove the members from- Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException- if the groupId is null or blank
-
isGroupMemberOfGroupWithDate
boolean isGroupMemberOfGroupWithDate(String groupMemberId, String groupId, org.joda.time.DateTime asOfDate) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException - Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException
-
isMemberOfGroupWithDate
boolean isMemberOfGroupWithDate(String principalId, String groupId, org.joda.time.DateTime asOfDate) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException - Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException
-
getDirectMemberGroupIdsWithDate
List<String> getDirectMemberGroupIdsWithDate(String groupId) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException - Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException
-
getDirectParentGroupIdsWithDate
List<String> getDirectParentGroupIdsWithDate(String groupId, org.joda.time.DateTime asOfDate) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException - Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException
-
getMembersWithDate
List<GroupMember> getMembersWithDate(List<String> groupIds, org.joda.time.DateTime asOfDate) throws org.kuali.rice.core.api.exception.RiceIllegalArgumentException - Throws:
org.kuali.rice.core.api.exception.RiceIllegalArgumentException
-
getCurrentAndFutureMembers
Returns the list of group members who are currently active and futureActive .- Parameters:
groupId- Id of the Group object to get the members from- Returns:
- list of group members
-