Package cz.metacentrum.perun.core.impl

Class GroupsManagerImpl

java.lang.Object

cz.metacentrum.perun.core.impl.GroupsManagerImpl

All Implemented Interfaces:

GroupsManagerImplApi

public class GroupsManagerImpl
extends Object
implements GroupsManagerImplApi

Implementation of GroupsManager

Author:

Michal Prochazka michalp@ics.muni.cz, Slavek Licehammer glory@ics.muni.cz

Field Summary

Fields

Modifier and Type	Field	Description
static final int	ADMINSGROUP
protected static final RowMapper<AssignedGroup>	ASSIGNED_GROUP_MAPPER
protected static final String	ASSIGNED_GROUP_MAPPING_SELECT_QUERY
protected static final RowMapper<Group>	GROUP_MAPPER
protected static final String	GROUP_MAPPING_SELECT_QUERY
protected static final String	MEMBER_GROUPS_MAPPING_SELECT_QUERY
static final int	MEMBERSGROUP
static final int	SUBGROUP

Constructor Summary

Constructors

Constructor	Description
GroupsManagerImpl(DataSource perunPool)	Create new instance of this class.

Method Summary

Modifier and Type	Method	Description
void	addGroupToAutoRegistration(PerunSession sess, Group group)	Adds group to the list of groups which can be registered into during vo registration.
void	addGroupToAutoRegistration(PerunSession sess, Group group, ApplicationFormItem formItem)	Adds group from list of groups which can be registered into during vo or group registration and are representing options of the specified application form item.
Member	addMember(PerunSession sess, Group group, Member member, MembershipType type, int sourceGroupId)	Adds member of the VO to the group in the same VO.
void	allowGroupToHierarchicalVo(PerunSession sess, Group group, Vo vo)	Sets flag required for including group to parent vo in a vo hierarchy.
void	checkGroupExists(PerunSession sess, Group group)	Check if group exists in underlaying data source.
Group	createGroup(PerunSession sess, Vo vo, Group group)	Creates a new top-level group and associates it with the VO from parameter.
Group	createGroup(PerunSession sess, Vo vo, Group parentGroup, Group group)	Creates a new subgroup of the existing group.
void	deleteGroup(PerunSession sess, Vo vo, Group group)	Deletes group.
void	deleteGroupFromAutoRegistration(PerunSession sess, Group group)	Deletes group from list of groups which can be registered into during vo registration.
void	deleteGroupFromAutoRegistration(PerunSession sess, Group group, ApplicationFormItem formItem)	Deletes group from list of groups which can be registered into during vo or group registration and are representing options of the specified application form item.
void	disallowGroupToHierarchicalVo(PerunSession sess, Group group, Vo vo)	Unsets flag required for including group to parent vo in a vo hierarchy
List<User>	getAdmins(PerunSession sess, Group group)	Gets list of all administrators of this group.
List<Group>	getAllAllowedGroupsToHierarchicalVo(PerunSession sess, Vo vo)	Returns all groups which can be included to VO.
List<Group>	getAllAllowedGroupsToHierarchicalVo(PerunSession sess, Vo vo, Vo memberVo)	Returns groups which can be included to VO from specific member VO.
List<Group>	getAllGroups(PerunSession sess)	Get all groups from all vos.
List<Group>	getAllGroups(PerunSession sess, Vo vo)	Get all groups of the VO.
List<Group>	getAllGroupsForAutoRegistration(PerunSession sess)	Returns all groups which can be registered into during any vo registration.
List<Group>	getAllGroupsWhereMemberIsActive(PerunSession sess, Member member)	Returns all member's groups where member is in active state (is valid there) Included members group.
List<Group>	getAllMemberGroups(PerunSession sess, Member member)	Return all members groups.
List<Group>	getAssignedGroupsToFacility(PerunSession perunSession, Facility facility)	Return list of assigned groups from all facility resources
List<Group>	getAssignedGroupsToResource(PerunSession perunSession, Resource resource)	Return list of assigned groups on the resource.
List<Group>	getAssignedGroupsToResource(PerunSession perunSession, Resource resource, Member member)	Return list of assigned groups on the resource with specified member.
List<Group>	getAssociatedGroupsToFacility(PerunSession perunSession, Facility facility)	Return list of all associated groups from all facility resources (does not require ACTIVE group-resource status)
List<Group>	getAssociatedGroupsToResource(PerunSession perunSession, Resource resource)	Return list of assigned groups on the resource.
List<Group>	getAssociatedGroupsToResource(PerunSession perunSession, Resource resource, Member member)	Return list of groups associated with the resource with specified member.
List<User>	getDirectAdmins(PerunSession sess, Group group)	Gets list of direct user administrators of this group.
MemberGroupStatus	getDirectMemberGroupStatus(PerunSession session, Member member, Group group)	Returns direct members status in given group.
List<Facility>	getFacilitiesWhereGroupIsAdmin(PerunSession session, Group group)	Returns all facilities where given group is FACILITYADMIN.
List<Group>	getGroupAdmins(PerunSession sess, Group group)	Gets list of all group administrators of this group.
List<Integer>	getGroupApplicationIds(PerunSession sess, Group group)	Return list of IDs of all applications, which belongs to Group.
Group	getGroupById(PerunSession sess, int id)	Search for the group with specified id in all VOs.
Group	getGroupByName(PerunSession sess, Vo vo, String name)	Search for the group with specified name in specified VO
List<Member>	getGroupMembers(PerunSession sess, Group group)	Get all group members ignoring theirs status.
List<Member>	getGroupMembers(PerunSession sess, Group group, List<Status> statuses, boolean excludeStatus)	Return group members.
List<Member>	getGroupMembersById(PerunSession sess, Group group, int id)	Get group members by member ID -> meaning we will get all (DIRECT/INDIRECT) group memberships for specified member (or user, since it will be the same).
List<Member>	getGroupMembersByMembership(PerunSession sess, Group group, MembershipType membershipType)	Get only group members which has given membership type ignoring their status.
List<Pair<Group,Resource>>	getGroupResourcePairsByAttribute(PerunSession sess, Attribute attribute)	Returns all group-resource which have set the attribute with the value.
List<Group>	getGroups(PerunSession sess, Vo vo)	Get all groups of users under the VO.
List<Group>	getGroupsByAttribute(PerunSession sess, Attribute attribute)	Returns all groups which have set the attribute with the value.
List<Group>	getGroupsByIds(PerunSession perunSession, List<Integer> ids)	Gets groups by their ids.
int	getGroupsCount(PerunSession sess)	Get count of all groups.
int	getGroupsCount(PerunSession sess, Vo vo)
List<Group>	getGroupsForAutoRegistration(PerunSession sess, Group group, ApplicationFormItem formItem)	Returns all groups which can be registered into during group registration and are representing options of the specified application form item.
List<Group>	getGroupsForAutoRegistration(PerunSession sess, Vo vo)	Returns all groups which can be registered into during vo registration and are representing options of the specified application form item.
List<Group>	getGroupsForAutoRegistration(PerunSession sess, Vo vo, ApplicationFormItem formItem)	Returns all groups which can be registered into during vo registration and are representing options of the specified application form item.
List<Integer>	getGroupsIds(PerunSession sess, Vo vo)	Get all groups ids for given vo.
Paginated<Group>	getGroupsPage(PerunSession sess, Vo vo, GroupsPageQuery query)	Get page of groups from the given vo.
List<Group>	getGroupsStructuresToSynchronize(PerunSession sess)	Gets all groups which have enabled group structure synchronization.
List<Group>	getGroupsToSynchronize(PerunSession sess)	Gets all groups which have enabled synchronization.
List<Group>	getGroupsWhereGroupIsAdmin(PerunSession session, Group group)	Returns all groups where given group is GROUPADMIN.
List<Group>	getGroupsWhereUserIsActiveMember(PerunSession sess, User user, Vo vo)	Returns groups in which the user is active member.
List<Group>	getGroupsWithAssignedExtSourceInVo(PerunSession sess, ExtSource source, Vo vo)	Get all groups in specific vo with assigned extSource
List<User>	getGroupUsers(PerunSession sess, Group group)	Return group users sorted by name.
String	getName(int id)
List<Group>	getOperandGroups(PerunSession sess, int groupId)	Return all operand groups of requested result group.
ApplicationForm	getParentApplicationFormForAutoRegistrationGroup(Group group)	Get parent form for auto registration group where this group is involved in auto registration process
Group	getParentGroup(PerunSession sess, Group group)	Get parent group.
List<Group>	getResultGroups(PerunSession sess, int groupId)	Return all result groups of requested operand group.
List<Integer>	getResultGroupsIds(PerunSession sess, int groupId)	Return list of all result groups ids of requested operand group.
List<Member>	getServiceGroupMembers(PerunSession sess, Group group)	Gets a list of Members, who are also service users, from a given group.
List<Group>	getSubGroups(PerunSession sess, Group parentGroup)	Get all immediate subgroups of the parent group under the VO.
int	getSubGroupsCount(PerunSession sess, Group parentGroup)	Returns number of immediate subgroups of the parent group.
Paginated<Group>	getSubgroupsPage(PerunSession sess, Group group, GroupsPageQuery query)	Get page of subgroups from the given parent group.
Map<Integer,MemberGroupStatus>	getTotalGroupStatusForMembers(PerunSession session, Group group, List<Member> members)	Returns total member's status of given members in given group.
MemberGroupStatus	getTotalMemberGroupStatus(PerunSession session, Member member, Group group)	Returns total member's status in given group.
List<Group>	getUserGroups(PerunSession sess, User user)	Return groups where user is member.
List<Group>	getUserGroups(PerunSession sess, User user, List<Status> memberStatuses, List<MemberGroupStatus> memberGroupStatuses)	Return groups where user is member with allowed statuses in vo and group.
int	getVoId(PerunSession sess, Group group)	Get the id of the VO which is owner of the group.
List<Vo>	getVosWhereGroupIsAdmin(PerunSession session, Group group)	Returns all vos where given group si VOADMIN.
boolean	groupExists(PerunSession sess, Group group)	Check if group exists in underlaying data source.
boolean	hasGroupAnyManagerRole(PerunSession session, Group group)	Checks if the given group has any related manager roles
boolean	isAllowedGroupToHierarchicalVo(PerunSession sess, Group group, Vo vo)	Returns flag representing if the group can be included in the (parent) vo's groups
boolean	isDirectGroupMember(PerunSession sess, Group group, Member member)	Return true if Member is direct member of the Group
boolean	isGroupForAnyAutoRegistration(PerunSession sess, Group group)	Check if group has automatic registration enabled in any form item.
boolean	isGroupForAutoRegistration(PerunSession sess, Group group, List<Integer> formItems)	Check if group has automatic registration enabled in the given form item.
boolean	isGroupMember(PerunSession sess, Group group, Member member)	Return true if Member is member of the Group
boolean	isOneWayRelationBetweenGroups(Group resultGroup, Group operandGroup)	Checks if relation exists between result group and operand group.
boolean	isRelationBetweenGroups(Group group1, Group group2)	Checks if relation between groups exists.
boolean	isRelationRemovable(PerunSession sess, Group resultGroup, Group operandGroup)	Check if the relation between given groups can be deleted.
boolean	isUserMemberOfGroup(PerunSession sess, User user, Group group)	Checks whether the user is member of the group.
void	removeAllManagerRolesOfGroup(PerunSession session, Group group)	Removes all manager roles related to the given group
void	removeGroupUnion(PerunSession sess, Group resultGroup, Group operandGroup)	Removes a union between two groups.
void	removeMember(PerunSession sess, Group group, Member member)	Removes member form the group.
void	removeResultGroupRelations(PerunSession sess, Group resultGroup)	Removes all relations of this result group.
void	saveGroupRelation(PerunSession sess, Group resultGroup, Group operandGroup, boolean parentFlag)	Saves union operation between result group and operand group.
void	setDirectGroupStatus(PerunSession sess, Member member, Group group, MemberGroupStatus status)	Set direct status of the member to specified status in given group.
void	setIndirectGroupStatus(PerunSession sess, Member member, Group group, MemberGroupStatus status)	Set status of the member to specified status for indirect relations where the given group is the source group.
Group	updateGroup(PerunSession sess, Group group)	Updates group by ID.
Group	updateGroupName(PerunSession sess, Group group)	Updates group by ID.
Group	updateParentGroupId(PerunSession sess, Group group)	Updates parentGroupId.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

MEMBERSGROUP

public static final int MEMBERSGROUP

See Also:

• Constant Field Values

ADMINSGROUP

public static final int ADMINSGROUP

See Also:

• Constant Field Values

SUBGROUP

public static final int SUBGROUP

See Also:

• Constant Field Values

GROUP_MAPPING_SELECT_QUERY

protected static final String GROUP_MAPPING_SELECT_QUERY

See Also:

• Constant Field Values

MEMBER_GROUPS_MAPPING_SELECT_QUERY

protected static final String MEMBER_GROUPS_MAPPING_SELECT_QUERY

See Also:

• Constant Field Values

ASSIGNED_GROUP_MAPPING_SELECT_QUERY

protected static final String ASSIGNED_GROUP_MAPPING_SELECT_QUERY

See Also:

• Constant Field Values

GROUP_MAPPER

protected static final RowMapper<Group> GROUP_MAPPER

ASSIGNED_GROUP_MAPPER

protected static final RowMapper<AssignedGroup> ASSIGNED_GROUP_MAPPER

Constructor Details

GroupsManagerImpl

public GroupsManagerImpl(DataSource perunPool)

Create new instance of this class.

Method Details

addGroupToAutoRegistration

public void addGroupToAutoRegistration(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Adds group to the list of groups which can be registered into during vo registration.

Specified by:

addGroupToAutoRegistration in interface GroupsManagerImplApi

Parameters:

sess - session

group - group to add

addGroupToAutoRegistration

public void addGroupToAutoRegistration(PerunSession sess,
 Group group,
 ApplicationFormItem formItem)
                                throws FormItemNotExistsException

Description copied from interface: GroupsManagerImplApi

Adds group from list of groups which can be registered into during vo or group registration and are representing options of the specified application form item.

Specified by:

addGroupToAutoRegistration in interface GroupsManagerImplApi

Parameters:

sess - session

group - group to add

Throws:

FormItemNotExistsException

addMember

public Member addMember(PerunSession sess,
 Group group,
 Member member,
 MembershipType type,
 int sourceGroupId)
                 throws AlreadyMemberException

Description copied from interface: GroupsManagerImplApi

Adds member of the VO to the group in the same VO.

Specified by:

addMember in interface GroupsManagerImplApi

Returns:

Member with specific MembershipType

Throws:

AlreadyMemberException

allowGroupToHierarchicalVo

public void allowGroupToHierarchicalVo(PerunSession sess,
 Group group,
 Vo vo)

Description copied from interface: GroupsManagerImplApi

Sets flag required for including group to parent vo in a vo hierarchy.

Specified by:

allowGroupToHierarchicalVo in interface GroupsManagerImplApi

Parameters:

sess - perun session

group - group

vo - parent vo

checkGroupExists

public void checkGroupExists(PerunSession sess,
 Group group)
                      throws GroupNotExistsException

Description copied from interface: GroupsManagerImplApi

Check if group exists in underlaying data source.

Specified by:

checkGroupExists in interface GroupsManagerImplApi

Throws:

GroupNotExistsException

createGroup

public Group createGroup(PerunSession sess,
 Vo vo,
 Group group)
                  throws GroupExistsException

Description copied from interface: GroupsManagerImplApi

Creates a new top-level group and associates it with the VO from parameter.

For this method the new group has always same shortName like Name. Important: voId in object group is ignored

This method sets ids and uuid to the given group object but returns a new group object loaded from the DB.

Specified by:

createGroup in interface GroupsManagerImplApi

vo - to associates group with

group - new group with name without ":"

Returns:

newly created top-level group

Throws:

GroupExistsException

createGroup

public Group createGroup(PerunSession sess,
 Vo vo,
 Group parentGroup,
 Group group)
                  throws GroupExistsException

Description copied from interface: GroupsManagerImplApi

Creates a new subgroup of the existing group. (Stores group to underlaying data source)

Specified by:

createGroup in interface GroupsManagerImplApi

group - group.name must contain only shortName (without ":"). Hierarchy is defined by parentGroup parameter.

Returns:

newly created sub group with full group.Name with ":"

Throws:

GroupExistsException

deleteGroup

public void deleteGroup(PerunSession sess,
 Vo vo,
 Group group)
                 throws GroupAlreadyRemovedException

Description copied from interface: GroupsManagerImplApi

Deletes group. Delete it from table of parentgroups, table of groups_members and groups table.

Specified by:

deleteGroup in interface GroupsManagerImplApi

group - group to delete

Throws:

GroupAlreadyRemovedException - if there are 0 rows affected by deleting from DB

deleteGroupFromAutoRegistration

public void deleteGroupFromAutoRegistration(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Deletes group from list of groups which can be registered into during vo registration.

Specified by:

deleteGroupFromAutoRegistration in interface GroupsManagerImplApi

Parameters:

sess - session

group - group to delete

deleteGroupFromAutoRegistration

public void deleteGroupFromAutoRegistration(PerunSession sess,
 Group group,
 ApplicationFormItem formItem)
                                     throws FormItemNotExistsException

Description copied from interface: GroupsManagerImplApi

Deletes group from list of groups which can be registered into during vo or group registration and are representing options of the specified application form item.

Specified by:

deleteGroupFromAutoRegistration in interface GroupsManagerImplApi

Parameters:

sess - session

group - group to delete

Throws:

FormItemNotExistsException

disallowGroupToHierarchicalVo

public void disallowGroupToHierarchicalVo(PerunSession sess,
 Group group,
 Vo vo)

Description copied from interface: GroupsManagerImplApi

Unsets flag required for including group to parent vo in a vo hierarchy

Specified by:

disallowGroupToHierarchicalVo in interface GroupsManagerImplApi

Parameters:

sess - perun session

group - group

vo - parent vo

getAdmins

public List<User> getAdmins(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Gets list of all administrators of this group. If some group is administrator of the given group, all VALID members are included in the list.

Specified by:

getAdmins in interface GroupsManagerImplApi

Returns:

list of all administrators

getAllAllowedGroupsToHierarchicalVo

public List<Group> getAllAllowedGroupsToHierarchicalVo(PerunSession sess,
 Vo vo)

Description copied from interface: GroupsManagerImplApi

Returns all groups which can be included to VO.

Specified by:

getAllAllowedGroupsToHierarchicalVo in interface GroupsManagerImplApi

Parameters:

sess - session

vo - vo

Returns:

list of allowed groups to hierarchical VO

getAllAllowedGroupsToHierarchicalVo

public List<Group> getAllAllowedGroupsToHierarchicalVo(PerunSession sess,
 Vo vo,
 Vo memberVo)

Description copied from interface: GroupsManagerImplApi

Returns groups which can be included to VO from specific member VO.

Specified by:

getAllAllowedGroupsToHierarchicalVo in interface GroupsManagerImplApi

Parameters:

sess - session

vo - parent VO

memberVo - member VO

Returns:

list of allowed groups to hierarchical VO

getAllGroups

public List<Group> getAllGroups(PerunSession sess)

Description copied from interface: GroupsManagerImplApi

Get all groups from all vos.

Specified by:

getAllGroups in interface GroupsManagerImplApi

Parameters:

sess - session

Returns:

list of all groups

getAllGroups

public List<Group> getAllGroups(PerunSession sess,
 Vo vo)

Description copied from interface: GroupsManagerImplApi

Get all groups of the VO.

Specified by:

getAllGroups in interface GroupsManagerImplApi

Returns:

list of groups

getAllGroupsForAutoRegistration

public List<Group> getAllGroupsForAutoRegistration(PerunSession sess)

Description copied from interface: GroupsManagerImplApi

Returns all groups which can be registered into during any vo registration. This method serves only for migration to new functionality related to the new table.

Specified by:

getAllGroupsForAutoRegistration in interface GroupsManagerImplApi

Parameters:

sess - session

Returns:

list of groups

getAllGroupsWhereMemberIsActive

public List<Group> getAllGroupsWhereMemberIsActive(PerunSession sess,
 Member member)

Description copied from interface: GroupsManagerImplApi

Returns all member's groups where member is in active state (is valid there) Included members group.

Specified by:

getAllGroupsWhereMemberIsActive in interface GroupsManagerImplApi

Parameters:

sess - perun session

member - member to get groups for

Returns:

list of groups where member is in active state (valid)

getAllMemberGroups

public List<Group> getAllMemberGroups(PerunSession sess,
 Member member)

Description copied from interface: GroupsManagerImplApi

Return all members groups. Included 'members' group.

Specified by:

getAllMemberGroups in interface GroupsManagerImplApi

Returns:

getAssignedGroupsToFacility

public List<Group> getAssignedGroupsToFacility(PerunSession perunSession,
 Facility facility)

Description copied from interface: GroupsManagerImplApi

Return list of assigned groups from all facility resources

Specified by:

getAssignedGroupsToFacility in interface GroupsManagerImplApi

Returns:

list of groups, which are assigned on all facility resources

getAssignedGroupsToResource

public List<Group> getAssignedGroupsToResource(PerunSession perunSession,
 Resource resource)

Description copied from interface: GroupsManagerImplApi

Return list of assigned groups on the resource.

Specified by:

getAssignedGroupsToResource in interface GroupsManagerImplApi

Returns:

list of groups, which are assigned on the resource

getAssignedGroupsToResource

public List<Group> getAssignedGroupsToResource(PerunSession perunSession,
 Resource resource,
 Member member)

Description copied from interface: GroupsManagerImplApi

Return list of assigned groups on the resource with specified member.

Specified by:

getAssignedGroupsToResource in interface GroupsManagerImplApi

Returns:

list of groups, which are assigned on the resource with specified member

getAssociatedGroupsToFacility

public List<Group> getAssociatedGroupsToFacility(PerunSession perunSession,
 Facility facility)

Description copied from interface: GroupsManagerImplApi

Return list of all associated groups from all facility resources (does not require ACTIVE group-resource status)

Specified by:

getAssociatedGroupsToFacility in interface GroupsManagerImplApi

Returns:

list of groups, which are associated with all facility resources

getAssociatedGroupsToResource

public List<Group> getAssociatedGroupsToResource(PerunSession perunSession,
 Resource resource)

Description copied from interface: GroupsManagerImplApi

Return list of assigned groups on the resource. Similar to assigned groups, but does not require ACTIVE group-resource status.

Specified by:

getAssociatedGroupsToResource in interface GroupsManagerImplApi

Returns:

list of groups, which are assigned on the resource

getAssociatedGroupsToResource

public List<Group> getAssociatedGroupsToResource(PerunSession perunSession,
 Resource resource,
 Member member)

Description copied from interface: GroupsManagerImplApi

Return list of groups associated with the resource with specified member. Does not require ACTIVE group-resource status.

Specified by:

getAssociatedGroupsToResource in interface GroupsManagerImplApi

Returns:

list of groups, which are assigned on the resource with specified member

getDirectAdmins

public List<User> getDirectAdmins(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Gets list of direct user administrators of this group. 'Direct' means, there aren't included users, who are members of group administrators, in the returned list.

Specified by:

getDirectAdmins in interface GroupsManagerImplApi

Returns:

list of direct administrators

getDirectMemberGroupStatus

public MemberGroupStatus getDirectMemberGroupStatus(PerunSession session,
 Member member,
 Group group)

Description copied from interface: GroupsManagerImplApi

Returns direct members status in given group. If there is no relation, null is returned.

Specified by:

getDirectMemberGroupStatus in interface GroupsManagerImplApi

Parameters:

session - session

member - member

group - group

Returns:

status of member in given group, if there is no relation, null is returned

getFacilitiesWhereGroupIsAdmin

public List<Facility> getFacilitiesWhereGroupIsAdmin(PerunSession session,
 Group group)

Description copied from interface: GroupsManagerImplApi

Returns all facilities where given group is FACILITYADMIN.

Specified by:

getFacilitiesWhereGroupIsAdmin in interface GroupsManagerImplApi

Parameters:

session - session

group - group

Returns:

list of all facilities where given group is FACILITYADMIN

getGroupAdmins

public List<Group> getGroupAdmins(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Gets list of all group administrators of this group.

Specified by:

getGroupAdmins in interface GroupsManagerImplApi

Returns:

list of all group administrators

getGroupApplicationIds

public List<Integer> getGroupApplicationIds(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Return list of IDs of all applications, which belongs to Group.

Specified by:

getGroupApplicationIds in interface GroupsManagerImplApi

Returns:

list of all group applications ids

getGroupById

public Group getGroupById(PerunSession sess,
 int id)
                   throws GroupNotExistsException

Description copied from interface: GroupsManagerImplApi

Search for the group with specified id in all VOs.

Specified by:

getGroupById in interface GroupsManagerImplApi

Returns:

group with specified id or throws GroupNotExistsException

Throws:

GroupNotExistsException

getGroupByName

public Group getGroupByName(PerunSession sess,
 Vo vo,
 String name)
                     throws GroupNotExistsException

Description copied from interface: GroupsManagerImplApi

Search for the group with specified name in specified VO

IMPORTANT: need to use full name of group (ex. 'toplevel:a:b', not the shortname which is in this example 'b')

Specified by:

getGroupByName in interface GroupsManagerImplApi

Returns:

group with specified name or throws GroupNotExistsException in specified VO

Throws:

GroupNotExistsException

getGroupMembers

public List<Member> getGroupMembers(PerunSession sess,
 Group group,
 List<Status> statuses,
 boolean excludeStatus)

Description copied from interface: GroupsManagerImplApi

Return group members.

Specified by:

getGroupMembers in interface GroupsManagerImplApi

statuses - list of statuses, if status is null then return all members

excludeStatus - does the list of statuses means exclude members or include members with these statuses

Returns:

list of members

getGroupMembers

public List<Member> getGroupMembers(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Get all group members ignoring theirs status.

Specified by:

getGroupMembers in interface GroupsManagerImplApi

Returns:

list of members

getGroupMembersById

public List<Member> getGroupMembersById(PerunSession sess,
 Group group,
 int id)

Description copied from interface: GroupsManagerImplApi

Get group members by member ID -> meaning we will get all (DIRECT/INDIRECT) group memberships for specified member (or user, since it will be the same).

Specified by:

getGroupMembersById in interface GroupsManagerImplApi

Returns:

list of members

getGroupMembersByMembership

public List<Member> getGroupMembersByMembership(PerunSession sess,
 Group group,
 MembershipType membershipType)

Description copied from interface: GroupsManagerImplApi

Get only group members which has given membership type ignoring their status.

Specified by:

getGroupMembersByMembership in interface GroupsManagerImplApi

Parameters:

sess - session

group - group

membershipType - type of membership

Returns:

list of direct members

getGroupResourcePairsByAttribute

public List<Pair<Group,Resource>> getGroupResourcePairsByAttribute(PerunSession sess,
 Attribute attribute)

Description copied from interface: GroupsManagerImplApi

Returns all group-resource which have set the attribute with the value. Searching only def and opt attributes.

Specified by:

getGroupResourcePairsByAttribute in interface GroupsManagerImplApi

Returns:

getGroupUsers

public List<User> getGroupUsers(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Return group users sorted by name.

Specified by:

getGroupUsers in interface GroupsManagerImplApi

Returns:

list users sorted or empty list if there are no users on specified page

getGroups

public List<Group> getGroups(PerunSession sess,
 Vo vo)

Description copied from interface: GroupsManagerImplApi

Get all groups of users under the VO.

Specified by:

getGroups in interface GroupsManagerImplApi

Returns:

list of groups

getGroupsByAttribute

public List<Group> getGroupsByAttribute(PerunSession sess,
 Attribute attribute)

Description copied from interface: GroupsManagerImplApi

Returns all groups which have set the attribute with the value. Searching only def and opt attributes.

Specified by:

getGroupsByAttribute in interface GroupsManagerImplApi

Returns:

list of groups

getGroupsByIds

public List<Group> getGroupsByIds(PerunSession perunSession,
 List<Integer> ids)

Description copied from interface: GroupsManagerImplApi

Gets groups by their ids. Silently skips non-existing groups.

Specified by:

getGroupsByIds in interface GroupsManagerImplApi

Returns:

list of groups with specified ids

getGroupsCount

public int getGroupsCount(PerunSession sess,
 Vo vo)

Specified by:

getGroupsCount in interface GroupsManagerImplApi

Returns:

count of VO's groups

getGroupsCount

public int getGroupsCount(PerunSession sess)

Description copied from interface: GroupsManagerImplApi

Get count of all groups.

Specified by:

getGroupsCount in interface GroupsManagerImplApi

Returns:

count of all groups

getGroupsForAutoRegistration

public List<Group> getGroupsForAutoRegistration(PerunSession sess,
 Vo vo)

Description copied from interface: GroupsManagerImplApi

Returns all groups which can be registered into during vo registration and are representing options of the specified application form item.

Specified by:

getGroupsForAutoRegistration in interface GroupsManagerImplApi

Parameters:

sess - session

vo - vo

Returns:

list of groups

getGroupsForAutoRegistration

public List<Group> getGroupsForAutoRegistration(PerunSession sess,
 Vo vo,
 ApplicationFormItem formItem)

Description copied from interface: GroupsManagerImplApi

Returns all groups which can be registered into during vo registration and are representing options of the specified application form item.

Specified by:

getGroupsForAutoRegistration in interface GroupsManagerImplApi

Parameters:

sess - session

vo - vo

formItem - application form item

Returns:

list of groups

getGroupsForAutoRegistration

public List<Group> getGroupsForAutoRegistration(PerunSession sess,
 Group group,
 ApplicationFormItem formItem)

Description copied from interface: GroupsManagerImplApi

Returns all groups which can be registered into during group registration and are representing options of the specified application form item.

Specified by:

getGroupsForAutoRegistration in interface GroupsManagerImplApi

Parameters:

sess - session

group - group

formItem - application form item

Returns:

list of groups

getGroupsIds

public List<Integer> getGroupsIds(PerunSession sess,
 Vo vo)

Description copied from interface: GroupsManagerImplApi

Get all groups ids for given vo.

Specified by:

getGroupsIds in interface GroupsManagerImplApi

Parameters:

sess - perun session

vo - vo

Returns:

list of groups ids

getGroupsPage

public Paginated<Group> getGroupsPage(PerunSession sess,
 Vo vo,
 GroupsPageQuery query)

Description copied from interface: GroupsManagerImplApi

Get page of groups from the given vo.

Specified by:

getGroupsPage in interface GroupsManagerImplApi

Parameters:

sess - session

vo - vo

query - query with page information

Returns:

page of requested groups

getGroupsStructuresToSynchronize

public List<Group> getGroupsStructuresToSynchronize(PerunSession sess)

Description copied from interface: GroupsManagerImplApi

Gets all groups which have enabled group structure synchronization.

Specified by:

getGroupsStructuresToSynchronize in interface GroupsManagerImplApi

Returns:

list of groups structures to synchronize

getGroupsToSynchronize

public List<Group> getGroupsToSynchronize(PerunSession sess)

Gets all groups which have enabled synchronization.

Specified by:

getGroupsToSynchronize in interface GroupsManagerImplApi

Parameters:

sess -

Returns:

list of groups to synchronize

Throws:

InternalErrorException

getGroupsWhereGroupIsAdmin

public List<Group> getGroupsWhereGroupIsAdmin(PerunSession session,
 Group group)

Description copied from interface: GroupsManagerImplApi

Returns all groups where given group is GROUPADMIN.

Specified by:

getGroupsWhereGroupIsAdmin in interface GroupsManagerImplApi

Parameters:

session - session

group - group

Returns:

list of all groups where given group is GROUPADMIN

getGroupsWhereUserIsActiveMember

public List<Group> getGroupsWhereUserIsActiveMember(PerunSession sess,
 User user,
 Vo vo)

Description copied from interface: GroupsManagerImplApi

Returns groups in which the user is active member. Groups are looked up only for the specified VO.

Specified by:

getGroupsWhereUserIsActiveMember in interface GroupsManagerImplApi

Parameters:

sess - session

user - user object

vo - VO object

Returns:

List of groups

getGroupsWithAssignedExtSourceInVo

public List<Group> getGroupsWithAssignedExtSourceInVo(PerunSession sess,
 ExtSource source,
 Vo vo)

Description copied from interface: GroupsManagerImplApi

Get all groups in specific vo with assigned extSource

Specified by:

getGroupsWithAssignedExtSourceInVo in interface GroupsManagerImplApi

Returns:

l

getName

public String getName(int id)

getOperandGroups

public List<Group> getOperandGroups(PerunSession sess,
 int groupId)

Description copied from interface: GroupsManagerImplApi

Return all operand groups of requested result group.

Specified by:

getOperandGroups in interface GroupsManagerImplApi

Parameters:

sess - perun session

groupId - group id

Returns:

list of Group objects

getParentApplicationFormForAutoRegistrationGroup

public ApplicationForm getParentApplicationFormForAutoRegistrationGroup(Group group)

Description copied from interface: GroupsManagerImplApi

Get parent form for auto registration group where this group is involved in auto registration process

Specified by:

getParentApplicationFormForAutoRegistrationGroup in interface GroupsManagerImplApi

Parameters:

group - auto registration group

Returns:

getParentGroup

public Group getParentGroup(PerunSession sess,
 Group group)
                     throws ParentGroupNotExistsException

Description copied from interface: GroupsManagerImplApi

Get parent group.

Specified by:

getParentGroup in interface GroupsManagerImplApi

Returns:

parent group

Throws:

ParentGroupNotExistsException

getResultGroups

public List<Group> getResultGroups(PerunSession sess,
 int groupId)

Description copied from interface: GroupsManagerImplApi

Return all result groups of requested operand group.

Specified by:

getResultGroups in interface GroupsManagerImplApi

Parameters:

sess - perun session

groupId - group id

Returns:

list of Group objects

getResultGroupsIds

public List<Integer> getResultGroupsIds(PerunSession sess,
 int groupId)

Description copied from interface: GroupsManagerImplApi

Return list of all result groups ids of requested operand group.

Specified by:

getResultGroupsIds in interface GroupsManagerImplApi

Parameters:

sess - perun session

groupId - group id

Returns:

list of group ids

getServiceGroupMembers

public List<Member> getServiceGroupMembers(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Gets a list of Members, who are also service users, from a given group.

Specified by:

getServiceGroupMembers in interface GroupsManagerImplApi

Parameters:

sess - perun session

group - group from which are the service users chosen

Returns:

list of Members from given group who are service users

getSubGroups

public List<Group> getSubGroups(PerunSession sess,
 Group parentGroup)

Description copied from interface: GroupsManagerImplApi

Get all immediate subgroups of the parent group under the VO.

Specified by:

getSubGroups in interface GroupsManagerImplApi

Returns:

list of groups

getSubGroupsCount

public int getSubGroupsCount(PerunSession sess,
 Group parentGroup)

Description copied from interface: GroupsManagerImplApi

Returns number of immediate subgroups of the parent group.

Specified by:

getSubGroupsCount in interface GroupsManagerImplApi

Returns:

count of parent group immediate subgroups

getSubgroupsPage

public Paginated<Group> getSubgroupsPage(PerunSession sess,
 Group group,
 GroupsPageQuery query)

Description copied from interface: GroupsManagerImplApi

Get page of subgroups from the given parent group.

Specified by:

getSubgroupsPage in interface GroupsManagerImplApi

Parameters:

sess - session

group - parent group

query - query with page information

Returns:

page of requested groups

getTotalGroupStatusForMembers

public Map<Integer,MemberGroupStatus> getTotalGroupStatusForMembers(PerunSession session,
 Group group,
 List<Member> members)

Description copied from interface: GroupsManagerImplApi

Returns total member's status of given members in given group.

Specified by:

getTotalGroupStatusForMembers in interface GroupsManagerImplApi

Parameters:

session - session

group - group

members - members

Returns:

total status of members in given group

getTotalMemberGroupStatus

public MemberGroupStatus getTotalMemberGroupStatus(PerunSession session,
 Member member,
 Group group)

Description copied from interface: GroupsManagerImplApi

Returns total member's status in given group. If there is no relation, null is returned.

Specified by:

getTotalMemberGroupStatus in interface GroupsManagerImplApi

Parameters:

session - session

member - member

group - group

Returns:

total status of member in given group, if there is no relation, null is returned

getUserGroups

public List<Group> getUserGroups(PerunSession sess,
 User user)

Description copied from interface: GroupsManagerImplApi

Return groups where user is member.

Specified by:

getUserGroups in interface GroupsManagerImplApi

Returns:

list of groups

getUserGroups

public List<Group> getUserGroups(PerunSession sess,
 User user,
 List<Status> memberStatuses,
 List<MemberGroupStatus> memberGroupStatuses)

Description copied from interface: GroupsManagerImplApi

Return groups where user is member with allowed statuses in vo and group. If statuses are empty or null, all statuses are used.

Specified by:

getUserGroups in interface GroupsManagerImplApi

memberStatuses - allowed statuses of member in VO

Returns:

list of groups

getVoId

public int getVoId(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Get the id of the VO which is owner of the group.

Specified by:

getVoId in interface GroupsManagerImplApi

Returns:

id of the VO

getVosWhereGroupIsAdmin

public List<Vo> getVosWhereGroupIsAdmin(PerunSession session,
 Group group)

Description copied from interface: GroupsManagerImplApi

Returns all vos where given group si VOADMIN.

Specified by:

getVosWhereGroupIsAdmin in interface GroupsManagerImplApi

Parameters:

session - session

group - group

Returns:

list of all vos where given group is VOADMIN

groupExists

public boolean groupExists(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Check if group exists in underlaying data source.

Specified by:

groupExists in interface GroupsManagerImplApi

Returns:

true if group exists in underlaying data source, false otherwise

hasGroupAnyManagerRole

public boolean hasGroupAnyManagerRole(PerunSession session,
 Group group)

Description copied from interface: GroupsManagerImplApi

Checks if the given group has any related manager roles

Specified by:

hasGroupAnyManagerRole in interface GroupsManagerImplApi

Parameters:

session - session

group - group

isAllowedGroupToHierarchicalVo

public boolean isAllowedGroupToHierarchicalVo(PerunSession sess,
 Group group,
 Vo vo)

Description copied from interface: GroupsManagerImplApi

Returns flag representing if the group can be included in the (parent) vo's groups

Specified by:

isAllowedGroupToHierarchicalVo in interface GroupsManagerImplApi

Parameters:

sess - perun session

group - group

vo - parent vo

Returns:

true if group can be included in vo's groups, false otherwise

isDirectGroupMember

public boolean isDirectGroupMember(PerunSession sess,
 Group group,
 Member member)

Description copied from interface: GroupsManagerImplApi

Return true if Member is direct member of the Group

Specified by:

isDirectGroupMember in interface GroupsManagerImplApi

Returns:

true if Member is direct member of the Group

isGroupForAnyAutoRegistration

public boolean isGroupForAnyAutoRegistration(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Check if group has automatic registration enabled in any form item.

Specified by:

isGroupForAnyAutoRegistration in interface GroupsManagerImplApi

Parameters:

sess - session

group - group to check

isGroupForAutoRegistration

public boolean isGroupForAutoRegistration(PerunSession sess,
 Group group,
 List<Integer> formItems)

Description copied from interface: GroupsManagerImplApi

Check if group has automatic registration enabled in the given form item.

Specified by:

isGroupForAutoRegistration in interface GroupsManagerImplApi

Parameters:

sess - session

group - group to check

formItems - form items for which the group can be configured

isGroupMember

public boolean isGroupMember(PerunSession sess,
 Group group,
 Member member)

Description copied from interface: GroupsManagerImplApi

Return true if Member is member of the Group

Specified by:

isGroupMember in interface GroupsManagerImplApi

Returns:

true if Member is member of the Group

isOneWayRelationBetweenGroups

public boolean isOneWayRelationBetweenGroups(Group resultGroup,
 Group operandGroup)

Description copied from interface: GroupsManagerImplApi

Checks if relation exists between result group and operand group. It matters which one is result group and which one is operand group.

Specified by:

isOneWayRelationBetweenGroups in interface GroupsManagerImplApi

Parameters:

resultGroup - result group

operandGroup - operand group

Returns:

true if there is a one-way relation, false otherwise

isRelationBetweenGroups

public boolean isRelationBetweenGroups(Group group1,
 Group group2)

Description copied from interface: GroupsManagerImplApi

Checks if relation between groups exists. It checks both ways. Does not matter which one is result group and which one is operand group.

Specified by:

isRelationBetweenGroups in interface GroupsManagerImplApi

Parameters:

group1 - group

group2 - group

Returns:

true if there is a relation, false otherwise

isRelationRemovable

public boolean isRelationRemovable(PerunSession sess,
 Group resultGroup,
 Group operandGroup)

Description copied from interface: GroupsManagerImplApi

Check if the relation between given groups can be deleted. Determined by parent flag (it flags relations created by hierarchical structure). It matters which group is resultGroup and which is operandGroup!!!

Specified by:

isRelationRemovable in interface GroupsManagerImplApi

Returns:

true if it can be deleted; false otherwise

isUserMemberOfGroup

public boolean isUserMemberOfGroup(PerunSession sess,
 User user,
 Group group)

Description copied from interface: GroupsManagerImplApi

Checks whether the user is member of the group.

Specified by:

isUserMemberOfGroup in interface GroupsManagerImplApi

Returns:

true if the user is member of the group

removeAllManagerRolesOfGroup

public void removeAllManagerRolesOfGroup(PerunSession session,
 Group group)

Description copied from interface: GroupsManagerImplApi

Removes all manager roles related to the given group

Specified by:

removeAllManagerRolesOfGroup in interface GroupsManagerImplApi

Parameters:

session - session

group - group

removeGroupUnion

public void removeGroupUnion(PerunSession sess,
 Group resultGroup,
 Group operandGroup)
                      throws GroupRelationDoesNotExist

Description copied from interface: GroupsManagerImplApi

Removes a union between two groups.

Specified by:

removeGroupUnion in interface GroupsManagerImplApi

Parameters:

sess - perun session

resultGroup - result group

operandGroup - operand group

Throws:

GroupRelationDoesNotExist - if the union between the two groups does not exist

removeMember

public void removeMember(PerunSession sess,
 Group group,
 Member member)
                  throws NotGroupMemberException

Description copied from interface: GroupsManagerImplApi

Removes member form the group. The member object MUST have sourceGroupId parameter.

Specified by:

removeMember in interface GroupsManagerImplApi

Parameters:

sess - perun session

group - group

member - member

Throws:

NotGroupMemberException

removeResultGroupRelations

public void removeResultGroupRelations(PerunSession sess,
 Group resultGroup)

Description copied from interface: GroupsManagerImplApi

Removes all relations of this result group.

Specified by:

removeResultGroupRelations in interface GroupsManagerImplApi

Parameters:

sess - perun session

resultGroup - result group

saveGroupRelation

public void saveGroupRelation(PerunSession sess,
 Group resultGroup,
 Group operandGroup,
 boolean parentFlag)

Description copied from interface: GroupsManagerImplApi

Saves union operation between result group and operand group.

Specified by:

saveGroupRelation in interface GroupsManagerImplApi

Parameters:

sess - perun session

resultGroup - group to which members are added

operandGroup - group from which members are taken

parentFlag - if true union cannot be deleted; false otherwise (it flags relations created by hierarchical structure)

setDirectGroupStatus

public void setDirectGroupStatus(PerunSession sess,
 Member member,
 Group group,
 MemberGroupStatus status)

Description copied from interface: GroupsManagerImplApi

Set direct status of the member to specified status in given group.

Specified by:

setDirectGroupStatus in interface GroupsManagerImplApi

member - member whose status will be changed

group - group where member's status will be changed

status - status that will be set

setIndirectGroupStatus

public void setIndirectGroupStatus(PerunSession sess,
 Member member,
 Group group,
 MemberGroupStatus status)

Description copied from interface: GroupsManagerImplApi

Set status of the member to specified status for indirect relations where the given group is the source group.

Specified by:

setIndirectGroupStatus in interface GroupsManagerImplApi

member - member whose status will be changed

group - group where member's status will be changed

status - status that will be set

updateGroup

public Group updateGroup(PerunSession sess,
 Group group)
                  throws GroupExistsException

Description copied from interface: GroupsManagerImplApi

Updates group by ID.

Update shortName and description. Return Group with correctly set parameters

Specified by:

updateGroup in interface GroupsManagerImplApi

group - to update (use only ID, shortName and description)

Returns:

updated group with correctly set parameters

Throws:

GroupExistsException - if group with same name already exists in the same VO

updateGroupName

public Group updateGroupName(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Updates group by ID.

!! IMPORTANT This method allows to change group name the way it doesn't correspond with the groups hierarchy !! Meant for updating subgroups after parent group name is updated !!

Update name (with ":"). Return Group with correctly set parameters

Specified by:

updateGroupName in interface GroupsManagerImplApi

group - to update (use only ID and name)

Returns:

updated group with correctly set parameters

updateParentGroupId

public Group updateParentGroupId(PerunSession sess,
 Group group)

Description copied from interface: GroupsManagerImplApi

Updates parentGroupId.

!! IMPORTANT This method allows to change parentGroupId, but it doesn't update group and subGroup names !!

Specified by:

updateParentGroupId in interface GroupsManagerImplApi

group - to update

Returns:

group with updated parentGroupId