Package cz.metacentrum.perun.core.blImpl

Class ResourcesManagerBlImpl

java.lang.Object

cz.metacentrum.perun.core.blImpl.ResourcesManagerBlImpl

All Implemented Interfaces:

ResourcesManagerBl

public class ResourcesManagerBlImpl
extends Object
implements ResourcesManagerBl

Author:

Slavek Licehammer glory@ics.muni.cz

Constructor Summary

Constructors

Constructor	Description
ResourcesManagerBlImpl(ResourcesManagerImplApi resourcesManagerImpl)

Method Summary

Modifier and Type	Method	Description
void	activateGroupResourceAssignment(PerunSession sess, Group group, Resource resource, boolean async)	Try to activate the group-resource status.
void	addResourceSelfServiceGroup(PerunSession sess, Resource resource, Group group)	Sets ResourceSelfService role to given group for given resource.
void	addResourceSelfServiceUser(PerunSession sess, Resource resource, User user)	Sets ResourceSelfService role to given user for given resource.
void	assignAutomaticGroupToResource(PerunSession perunSession, Group sourceGroup, Group groupToAssign, Resource resource)	Asynchronously assigns single subgroup to resource as automatically assigned source group's subgroup.
void	assignGroupsToResource(PerunSession perunSession, Iterable<Group> groups, Resource resource, boolean async, boolean assignInactive, boolean autoAssignSubgroups)	Assign groups to a resource.
void	assignGroupToResource(PerunSession sess, Group group, Resource resource, boolean async, boolean assignInactive, boolean autoAssignSubgroups)	Assign group to a resource.
void	assignGroupToResources(PerunSession perunSession, Group group, List<Resource> resources, boolean async, boolean assignInactive, boolean autoAssignSubgroups)	Assign group to the resources.
void	assignResourceTagsToResource(PerunSession perunSession, List<ResourceTag> resourceTags, Resource resource)	Assign existing ResourceTags on existing Resource.
void	assignResourceTagToResource(PerunSession perunSession, ResourceTag resourceTag, Resource resource)	Assign existing ResourceTag on existing Resource.
void	assignService(PerunSession sess, Resource resource, Service service)	Assign service to resource.
void	assignServices(PerunSession sess, Resource resource, List<Service> services)	Assign services to resource.
void	assignServicesPackage(PerunSession sess, Resource resource, ServicesPackage servicesPackage)	Assign all services from services package to resource.
boolean	banExists(PerunSession sess, int banId)	Get true if any band defined by id exists for any user and facility.
boolean	banExists(PerunSession sess, int memberId, int resourceId)	Get true if any ban for member and resource exists.
void	checkBanExists(PerunSession sess, int banId)	Check if ban already exists.
void	checkBanExists(PerunSession sess, int memberId, int resourceId)	Check if ban already exists.
void	checkResourceExists(PerunSession sess, Resource resource)
void	checkResourceTagExists(PerunSession sess, ResourceTag resourceTag)
void	checkSemanticsOfFacilityAndResourceRequiredAttributes(PerunSession sess, Resource resource)	Checks semantics of all required attributes of given resource and its facility.
EnrichedResource	convertToEnrichedResource(PerunSession sess, Resource resource, List<String> attrNames)	Creates enrichedResource from given resource and load attributes with given names.
void	copyAttributes(PerunSession sess, Resource sourceResource, Resource destinationResource)	Copy all attributes of the source resource to the destination resource.
void	copyGroups(PerunSession sess, Resource sourceResource, Resource destinationResource)	Copy all groups of the source resource to the destination resource.
Resource	copyResource(PerunSession sess, Resource templateResource, Resource destinationResource, boolean withGroups)	Copy "template" settings from user's another existing resource and create new resource with this template.
void	copyServices(PerunSession sess, Resource sourceResource, Resource destinationResource)	Copy all services of the source resource to the destination resource.
Resource	createResource(PerunSession sess, Resource resource, Vo vo, Facility facility)	Inserts resource into DB.
ResourceTag	createResourceTag(PerunSession perunSession, ResourceTag resourceTag, Vo vo)	Create new Resource tag.
void	deactivateGroupResourceAssignment(PerunSession sess, Group group, Resource resource)	Deactivates the group-resource assignment.
void	deleteAllResources(PerunSession sess, Vo vo)	Deletes all resources for the VO.
void	deleteAllResourcesTagsForVo(PerunSession perunSession, Vo vo)	Delete all ResourcesTags for specific VO.
void	deleteResource(PerunSession sess, Resource resource)	Deletes resource by id.
void	deleteResourceTag(PerunSession perunSession, ResourceTag resourceTag)	Delete existing Resource tag.
void	fillAndSetRequiredAttributesForGroups(PerunSession sess, List<Service> services, Resource resource)	Fill and set group and group-resource attributes required by given services for all groups which are assigned to the given resource.
EnrichedResource	filterOnlyAllowedAttributes(PerunSession sess, EnrichedResource enrichedResource)	Filter attributes in given enrichedResources, which are allowed for current principal.
List<Group>	getAdminGroups(PerunSession sess, Resource resource)	Gets list of all group administrators of the Resource.
List<User>	getAdmins(PerunSession perunSession, Resource resource, boolean onlyDirectAdmins)	Gets list of all user administrators of the Resource.
List<BanOnResource>	getAllExpiredBansOnResources(PerunSession sess)	Get all expired bans on any resource to now date
List<Member>	getAllowedMembers(PerunSession sess, Resource resource)	Returns all members who can access the resource.
List<Member>	getAllowedMembersNotExpiredInGroups(PerunSession sess, Resource resource)	Returns all members who can access the resource and who are also valid in at least one group associated to the resource.
List<Resource>	getAllowedResources(PerunSession sess, Facility facility, User user)	Return all resources which are under the facility and has member of the user with status other than INVALID.
List<Resource>	getAllowedResources(PerunSession sess, Member member)	Get all resources which have the member access on.
List<User>	getAllowedUsers(PerunSession sess, Resource resource)	Get all users, who can assess the resource.
List<User>	getAllowedUsersNotExpiredInGroups(PerunSession sess, Resource resource)	Get all users, who can assess the resource and who are not expired in at least one group associated to the resource.
List<Resource>	getAllResources(PerunSession sess)	Get all resources from database.
List<Resource>	getAllResourcesByResourceTag(PerunSession perunSession, ResourceTag resourceTag)	Get all resources in specific Vo (specific by resourceTag.getVoId) for existing resourceTag
List<ResourceTag>	getAllResourcesTagsForResource(PerunSession perunSession, Resource resource)	Get all resourcesTags for existing Resource
List<ResourceTag>	getAllResourcesTagsForVo(PerunSession perunSession, Vo vo)	Get all resourcesTags for existing Vo.
List<Group>	getAssignedGroups(PerunSession sess, Resource resource)	List all groups associated with the resource.
List<Group>	getAssignedGroups(PerunSession sess, Resource resource, Member member)	List all groups associated with the resource where Member is a member.
List<Member>	getAssignedMembers(PerunSession sess, Resource resource)	Returns all members assigned to the resource.
List<AssignedMember>	getAssignedMembersWithStatus(PerunSession sess, Resource resource)	Returns members of groups assigned to resource with status of group-resource assignment.
List<Resource>	getAssignedResources(PerunSession sess, Group group)	List all resources to which the group is assigned.
List<Resource>	getAssignedResources(PerunSession sess, Member member)	Get all resources where the member is assigned.
List<Resource>	getAssignedResources(PerunSession sess, Member member, Service service)	Get all resources where the member and the service are assigned.
List<Resource>	getAssignedResources(PerunSession sess, User user, Vo vo)	Return List of assigned resources to user on the vo.
List<AssignedResource>	getAssignedResourcesWithStatus(PerunSession sess, Member member)	Returns all assigned resources where member is assigned through the groups.
List<RichMember>	getAssignedRichMembers(PerunSession sess, Resource resource)	Returns all members assigned to the resource as RichMembers.
List<RichResource>	getAssignedRichResources(PerunSession sess, Group group)	List all rich resources associated with the group with facility property filled.
List<RichResource>	getAssignedRichResources(PerunSession sess, Member member)	Get all rich resources where the member is assigned with facility property filled.
List<RichResource>	getAssignedRichResources(PerunSession sess, Member member, Service service)	Get all rich resources where the service and the member are assigned with facility property filled.
List<Service>	getAssignedServices(PerunSession sess, Resource resource)	List all services associated with the resource.
List<User>	getAssignedUsers(PerunSession sess, Resource resource)	Returns all users assigned to the resource.
List<Group>	getAssociatedGroups(PerunSession sess, Resource resource, Member member)	Return list of groups associated with the resource with specified member.
List<Member>	getAssociatedMembers(PerunSession sess, Resource resource)	Returns all members who are associated with the resource.
List<Resource>	getAssociatedResources(PerunSession sess, Group group)	List all resources associated with the group.
List<Resource>	getAssociatedResources(PerunSession sess, Member member)	Returns all resources with which the member is associated through the groups.
List<User>	getAssociatedUsers(PerunSession sess, Resource resource)	Returns all users who are associated with the defined resource.
BanOnResource	getBan(PerunSession sess, int memberId, int resourceId)	Get specific resource ban.
BanOnResource	getBanById(PerunSession sess, int banId)	Get Ban for member on resource by it's id
List<BanOnResource>	getBansForMember(PerunSession sess, int memberId)	Get all resources bans for member.
List<BanOnResource>	getBansForResource(PerunSession sess, int resourceId)	Get all members bans for resource
List<EnrichedBanOnResource>	getEnrichedBansForResource(PerunSession sess, Resource resource, List<String> attrNames)	Get all enriched bans for members on the resource with user and member attributes
List<EnrichedBanOnResource>	getEnrichedBansForUser(PerunSession sess, User user, List<String> attrNames)	Get enriched bans for user on all resources where user is assigned with user and member attributes
EnrichedResource	getEnrichedResourceById(PerunSession sess, int id, List<String> attrNames)	Find resource for given id and returns it with given attributes.
List<EnrichedResource>	getEnrichedRichResourcesForFacility(PerunSession sess, Facility facility, List<String> attrNames)	Find resources for given facility and attributes for given names.
List<EnrichedResource>	getEnrichedRichResourcesForVo(PerunSession sess, Vo vo, List<String> attrNames)	Find resources for given vo and attributes for given names.
Facility	getFacility(PerunSession sess, Resource resource)	Get facility which belongs to the concrete resource.
List<AssignedGroup>	getGroupAssignments(PerunSession sess, Resource resource, List<String> attrNames)	Lists all of the assigned groups for the given resource.
List<GroupResourceAssignment>	getGroupResourceAssignments(PerunSession sess, List<GroupResourceStatus> statuses)	Lists all group-resource assignments with given statuses.
List<RichResource>	getMailingServiceRichResourcesWithMember(PerunSession sess, Member member)	Return all rich resources with mailing service(s) where given member is assigned.
PerunBl	getPerunBl()	Gets the perunBl.
List<AssignedResource>	getResourceAssignments(PerunSession sess, Group group, List<String> attrNames)	Lists all of the resource assignments for the given group.
Resource	getResourceById(PerunSession sess, int id)	Searches for the Resource with specified id.
Resource	getResourceByName(PerunSession sess, Vo vo, Facility facility, String name)	Return resource by its name.
List<Resource>	getResources(PerunSession sess)	Finds all resources.
List<Resource>	getResources(PerunSession sess, User user, List<Status> memberStatuses, List<MemberGroupStatus> memberGroupStatuses, List<GroupResourceStatus> groupResourceStatuses)	Return all resources where user is assigned.
List<Resource>	getResources(PerunSession sess, Vo vo)	Get all VO resources.
List<Resource>	getResourcesByAttribute(PerunSession sess, Attribute attribute)	Returns all resource which have set the attribute with the value.
List<Resource>	getResourcesByIds(PerunSession sess, List<Integer> ids)	Searches for the Resources with specified ids.
int	getResourcesCount(PerunSession sess)	Get count of all resources.
int	getResourcesCount(PerunSession sess, Vo vo)	Get all VO resources count.
ResourcesManagerImplApi	getResourcesManagerImpl()	Gets the resourcesManagerImpl.
List<Resource>	getResourcesWhereGroupIsAdmin(PerunSession sess, Facility facility, Vo vo, Group authorizedGroup)	Return all resources for the facility and the vo where the group is authorized as resource manager.
List<Resource>	getResourcesWhereUserIsAdmin(PerunSession sess, Facility facility, Vo vo, User authorizedUser)	Return all resources for the facility and the vo where user is authorized as resource manager.
List<Resource>	getResourcesWhereUserIsAdmin(PerunSession sess, User user)	Returns list of resources, where the user is an admin.
List<Resource>	getResourcesWhereUserIsAdmin(PerunSession sess, Vo vo, User authorizedUser)	Return all resources for the vo where user is authorized as resource manager.
List<RichUser>	getRichAdmins(PerunSession perunSession, Resource resource, List<String> specificAttributes, boolean allUserAttributes, boolean onlyDirectAdmins)	Gets list of all richUser administrators of the Resource.
RichResource	getRichResourceById(PerunSession sess, int id)	Searches for the RichResource with specified id.
List<RichResource>	getRichResources(PerunSession sess, Vo vo)	Get all VO rich resources with facility property filled.
List<RichResource>	getRichResourcesByIds(PerunSession sess, List<Integer> ids)	Searches for the RichResources with specified ids.
Vo	getVo(PerunSession sess, Resource resource)	Get Vo which is tied to specified resource.
boolean	groupResourceAssignmentExists(PerunSession sess, Resource resource, Group group)	Returns true if the group is assigned to the current resource with any status, false otherwise.
boolean	isGroupAssigned(PerunSession sess, Resource resource, Group group)	Returns true if the group is assigned to the current resource with ACTIVE status, false otherwise.
boolean	isGroupManuallyAssigned(PerunSession sess, Group group, Resource resource)	Returns true if the group is assigned to the given resource manually, false otherwise.
boolean	isUserAllowed(PerunSession sess, User user, Resource resource)	Returns true if the user is allowed to the current resource, false otherwise.
boolean	isUserAssigned(PerunSession sess, User user, Resource resource)	Returns true if the user is assigned to the current resource, false otherwise.
void	processGroupResourceActivationAsync(PerunSession sess, Group group, Resource resource)	Asynchronously processes group-resource activation.
void	removeAllExpiredBansOnResources(PerunSession sess)	Remove all expired bans on resources to now date.
void	removeAllResourcesTagFromResource(PerunSession perunSession, Resource resource)	Remove all existing Resource tags for specific resource.
void	removeAutomaticGroupFromResource(PerunSession sess, Group group, Resource resource, int sourceGroupId)	Remove automatically assigned group from resource.
void	removeBan(PerunSession sess, int banId)	Remove ban by id from resources bans.
void	removeBan(PerunSession sess, int memberId, int resourceId)	Remove ban by member_id and facility_id
void	removeGroupFromResource(PerunSession sess, Group group, Resource resource)	Remove group from a resource.
void	removeGroupFromResources(PerunSession perunSession, Group group, List<Resource> resources)	Remove group from resources.
void	removeGroupsFromResource(PerunSession perunSession, List<Group> groups, Resource resource)	Remove groups from a resource.
void	removeResourceSelfServiceGroup(PerunSession sess, Resource resource, Group group)	Unset ResourceSelfService role to given group for given resource.
void	removeResourceSelfServiceUser(PerunSession sess, Resource resource, User user)	Unset ResourceSelfService role to given user for given resource.
void	removeResourceTagFromResource(PerunSession perunSession, ResourceTag resourceTag, Resource resource)	Remove specific ResourceTag from existing Resource.
void	removeResourceTagsFromResource(PerunSession perunSession, List<ResourceTag> resourceTags, Resource resource)	Remove specific ResourceTags from existing Resource.
void	removeService(PerunSession sess, Resource resource, Service service)	Remove service from resource.
void	removeServices(PerunSession sess, Resource resource, List<Service> services)	Remove services from resource.
void	removeServicesPackage(PerunSession sess, Resource resource, ServicesPackage servicesPackage)	Remove from resource all services from services package.
BanOnResource	setBan(PerunSession sess, BanOnResource banOnResource)	Set ban for member on resource
void	setPerunBl(PerunBl perunBl)
void	updateAllRequiredAttributesForAllowedMembers(PerunSession sess, Resource resource, List<Service> services)	For given resource, finds all allowed members and sets them attributes, (member-resource, member, user-facility and user) that are required by given services.
BanOnResource	updateBan(PerunSession sess, BanOnResource banOnResource)	Update description and validity timestamp of specific ban.
Resource	updateResource(PerunSession sess, Resource resource)	Updates Resource.
ResourceTag	updateResourceTag(PerunSession perunSession, ResourceTag resourceTag)	Update existing Resource tag.

Methods inherited from class java.lang.Object

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

Constructor Details

ResourcesManagerBlImpl

public ResourcesManagerBlImpl(ResourcesManagerImplApi resourcesManagerImpl)

Method Details

activateGroupResourceAssignment

public void activateGroupResourceAssignment(PerunSession sess,
 Group group,
 Resource resource,
 boolean async)
                                     throws WrongReferenceAttributeValueException,
GroupResourceMismatchException,
WrongAttributeValueException,
GroupNotDefinedOnResourceException

Description copied from interface: ResourcesManagerBl

Try to activate the group-resource status. If the async is set to false, the validation is performed synchronously. The assignment will be either ACTIVE, in case of a successful synchronous call, or it will be PROCESSING in case of an asynchronous call. After the async validation, the state can be either ACTIVE or FAILED.

Specified by:

activateGroupResourceAssignment in interface ResourcesManagerBl

Parameters:

sess - session

group - group

resource - resource

async - if true the validation is performed asynchronously

Throws:

WrongReferenceAttributeValueException - when an attribute value has wrong/illegal semantics

GroupResourceMismatchException - when the given group and resource are not from the same VO

WrongAttributeValueException - when an attribute value has wrong/illegal syntax

GroupNotDefinedOnResourceException - when the group-resource assignment doesn't exist

addResourceSelfServiceGroup

public void addResourceSelfServiceGroup(PerunSession sess,
 Resource resource,
 Group group)
                                 throws AlreadyAdminException

Description copied from interface: ResourcesManagerBl

Sets ResourceSelfService role to given group for given resource.

Specified by:

addResourceSelfServiceGroup in interface ResourcesManagerBl

Parameters:

sess - session

resource - resource

group - group

Throws:

AlreadyAdminException - already has role

addResourceSelfServiceUser

public void addResourceSelfServiceUser(PerunSession sess,
 Resource resource,
 User user)
                                throws AlreadyAdminException

Description copied from interface: ResourcesManagerBl

Sets ResourceSelfService role to given user for given resource.

Specified by:

addResourceSelfServiceUser in interface ResourcesManagerBl

Parameters:

sess - session

resource - resource

user - user

Throws:

AlreadyAdminException - already has role

assignAutomaticGroupToResource

public void assignAutomaticGroupToResource(PerunSession perunSession,
 Group sourceGroup,
 Group groupToAssign,
 Resource resource)
                                    throws GroupResourceMismatchException,
GroupAlreadyAssignedException,
WrongReferenceAttributeValueException,
WrongAttributeValueException

Description copied from interface: ResourcesManagerBl

Asynchronously assigns single subgroup to resource as automatically assigned source group's subgroup. Source group must have existing assignment on resource with autoAssignSubgroups set to true.

Specified by:

assignAutomaticGroupToResource in interface ResourcesManagerBl

Parameters:

perunSession - sess

sourceGroup - source group (containing groupToAssign in hierarchy as a subgroup)

groupToAssign - source group's subgroup to be assigned on resource as by automatic assignment

resource - resource

Throws:

GroupResourceMismatchException

GroupAlreadyAssignedException

WrongReferenceAttributeValueException

WrongAttributeValueException

assignGroupToResource

public void assignGroupToResource(PerunSession sess,
 Group group,
 Resource resource,
 boolean async,
 boolean assignInactive,
 boolean autoAssignSubgroups)
                           throws WrongAttributeValueException,
WrongReferenceAttributeValueException,
GroupResourceMismatchException

Description copied from interface: ResourcesManagerBl

Assign group to a resource. Check if attributes for each member form group are valid. Fill members' attributes with missing value. Provide options for creating inactive or automatic subgroups group-resource assignments.

Specified by:

assignGroupToResource in interface ResourcesManagerBl

Throws:

WrongAttributeValueException

WrongReferenceAttributeValueException

GroupResourceMismatchException

assignGroupToResources

public void assignGroupToResources(PerunSession perunSession,
 Group group,
 List<Resource> resources,
 boolean async,
 boolean assignInactive,
 boolean autoAssignSubgroups)
                            throws WrongAttributeValueException,
WrongReferenceAttributeValueException,
GroupResourceMismatchException

Description copied from interface: ResourcesManagerBl

Assign group to the resources. Check if attributes for each member from group are valid. Fill members' attributes with missing values. Provide options for creating inactive or automatic subgroups group-resource assignments.

If the group is already assigned to some of the resources, the assignment is silently skipped.

Specified by:

assignGroupToResources in interface ResourcesManagerBl

group - the group

resources - list of resources

Throws:

WrongAttributeValueException

WrongReferenceAttributeValueException

GroupResourceMismatchException

assignGroupsToResource

public void assignGroupsToResource(PerunSession perunSession,
 Iterable<Group> groups,
 Resource resource,
 boolean async,
 boolean assignInactive,
 boolean autoAssignSubgroups)
                            throws WrongAttributeValueException,
WrongReferenceAttributeValueException,
GroupResourceMismatchException

Description copied from interface: ResourcesManagerBl

Assign groups to a resource. Check if attributes for each member from all groups are valid. Fill members' attributes with missing values. Provide options for creating inactive or automatic subgroups group-resource assignments.

Already assigned groups are silently skipped.

Specified by:

assignGroupsToResource in interface ResourcesManagerBl

groups - groups to assign

Throws:

WrongAttributeValueException

WrongReferenceAttributeValueException

GroupResourceMismatchException

assignResourceTagToResource

public void assignResourceTagToResource(PerunSession perunSession,
 ResourceTag resourceTag,
 Resource resource)
                                 throws ResourceTagAlreadyAssignedException

Description copied from interface: ResourcesManagerBl

Assign existing ResourceTag on existing Resource.

Specified by:

assignResourceTagToResource in interface ResourcesManagerBl

Throws:

ResourceTagAlreadyAssignedException

assignResourceTagsToResource

public void assignResourceTagsToResource(PerunSession perunSession,
 List<ResourceTag> resourceTags,
 Resource resource)
                                  throws ResourceTagAlreadyAssignedException

Description copied from interface: ResourcesManagerBl

Assign existing ResourceTags on existing Resource.

Specified by:

assignResourceTagsToResource in interface ResourcesManagerBl

Throws:

ResourceTagAlreadyAssignedException

assignService

public void assignService(PerunSession sess,
 Resource resource,
 Service service)
                   throws ServiceAlreadyAssignedException,
WrongAttributeValueException,
WrongReferenceAttributeValueException

Description copied from interface: ResourcesManagerBl

Assign service to resource.

Specified by:

assignService in interface ResourcesManagerBl

Throws:

ServiceAlreadyAssignedException

WrongAttributeValueException

WrongReferenceAttributeValueException

assignServices

public void assignServices(PerunSession sess,
 Resource resource,
 List<Service> services)
                    throws ServiceAlreadyAssignedException,
WrongAttributeValueException,
WrongReferenceAttributeValueException

Description copied from interface: ResourcesManagerBl

Assign services to resource.

Specified by:

assignServices in interface ResourcesManagerBl

Parameters:

sess - session

resource - resource

services - services to be assigned

Throws:

ServiceAlreadyAssignedException

WrongAttributeValueException

WrongReferenceAttributeValueException

assignServicesPackage

public void assignServicesPackage(PerunSession sess,
 Resource resource,
 ServicesPackage servicesPackage)
                           throws WrongAttributeValueException,
WrongReferenceAttributeValueException

Description copied from interface: ResourcesManagerBl

Assign all services from services package to resource.

Specified by:

assignServicesPackage in interface ResourcesManagerBl

Throws:

WrongAttributeValueException

WrongReferenceAttributeValueException

banExists

public boolean banExists(PerunSession sess,
 int memberId,
 int resourceId)

Description copied from interface: ResourcesManagerBl

Get true if any ban for member and resource exists.

Specified by:

banExists in interface ResourcesManagerBl

memberId - id of member

resourceId - id of resource

Returns:

true if ban exists

banExists

public boolean banExists(PerunSession sess,
 int banId)

Description copied from interface: ResourcesManagerBl

Get true if any band defined by id exists for any user and facility.

Specified by:

banExists in interface ResourcesManagerBl

banId - id of ban

Returns:

true if ban exists

checkBanExists

public void checkBanExists(PerunSession sess,
 int memberId,
 int resourceId)
                    throws BanNotExistsException

Description copied from interface: ResourcesManagerBl

Check if ban already exists.

Throw exception if no.

Specified by:

checkBanExists in interface ResourcesManagerBl

memberId - user id

resourceId - facility id

Throws:

BanNotExistsException

checkBanExists

public void checkBanExists(PerunSession sess,
 int banId)
                    throws BanNotExistsException

Description copied from interface: ResourcesManagerBl

Check if ban already exists.

Throw exception if no.

Specified by:

checkBanExists in interface ResourcesManagerBl

banId - ban id

Throws:

BanNotExistsException

checkResourceExists

public void checkResourceExists(PerunSession sess,
 Resource resource)
                         throws ResourceNotExistsException

Specified by:

checkResourceExists in interface ResourcesManagerBl

Throws:

ResourceNotExistsException

checkResourceTagExists

public void checkResourceTagExists(PerunSession sess,
 ResourceTag resourceTag)
                            throws ResourceTagNotExistsException

Specified by:

checkResourceTagExists in interface ResourcesManagerBl

Throws:

ResourceTagNotExistsException

checkSemanticsOfFacilityAndResourceRequiredAttributes

public void checkSemanticsOfFacilityAndResourceRequiredAttributes(PerunSession sess,
 Resource resource)
                                                           throws WrongReferenceAttributeValueException,
WrongAttributeAssignmentException

Checks semantics of all required attributes of given resource and its facility.

Parameters:

sess - session

resource - resource used to get facility and attributes

Throws:

WrongReferenceAttributeValueException - WrongReferenceAttributeValueException

WrongAttributeAssignmentException - WrongAttributeAssignmentException

convertToEnrichedResource

public EnrichedResource convertToEnrichedResource(PerunSession sess,
 Resource resource,
 List<String> attrNames)

Description copied from interface: ResourcesManagerBl

Creates enrichedResource from given resource and load attributes with given names. If the attrNames are null or emtpy, all resource attributes are added.

Specified by:

convertToEnrichedResource in interface ResourcesManagerBl

Parameters:

sess - session

resource - resource

attrNames - names of attributes to return

Returns:

EnrichedResource for given resource with desired attributes

copyAttributes

public void copyAttributes(PerunSession sess,
 Resource sourceResource,
 Resource destinationResource)
                    throws WrongReferenceAttributeValueException

Description copied from interface: ResourcesManagerBl

Copy all attributes of the source resource to the destination resource. The attributes, that are in the destination resource and aren't in the source resource, are retained. The common attributes are replaced with attributes from the source resource. The virtual attributes are not copied.

Specified by:

copyAttributes in interface ResourcesManagerBl

Throws:

WrongReferenceAttributeValueException

copyGroups

public void copyGroups(PerunSession sess,
 Resource sourceResource,
 Resource destinationResource)

Description copied from interface: ResourcesManagerBl

Copy all groups of the source resource to the destination resource. The groups, that are in the destination resource and aren't in the source resource, are retained. The common groups are replaced with the groups from source resource.

Specified by:

copyGroups in interface ResourcesManagerBl

copyResource

public Resource copyResource(PerunSession sess,
 Resource templateResource,
 Resource destinationResource,
 boolean withGroups)
                      throws ResourceExistsException

Description copied from interface: ResourcesManagerBl

Copy "template" settings from user's another existing resource and create new resource with this template. The settings are attributes, services, tags (if exists), groups and their members (if the resources are from the same VO and withGroups is true) Template Resource can be from any of user's facilities.

Specified by:

copyResource in interface ResourcesManagerBl

templateResource - template resource to copy

destinationResource - destination resource containing IDs of destination facility, VO and resource name.

withGroups - if set to true and resources ARE from the same VO we also copy all group-resource and member-resource attributes and assign all groups same as on templateResource, if set to true and resources ARE NOT from the same VO InternalErrorException is thrown, if set to false we will NOT copy groups and group related attributes.

Throws:

ResourceExistsException

copyServices

public void copyServices(PerunSession sess,
 Resource sourceResource,
 Resource destinationResource)
                  throws WrongAttributeValueException,
WrongReferenceAttributeValueException

Description copied from interface: ResourcesManagerBl

Copy all services of the source resource to the destination resource. The services, that are in the destination resource and aren't in the source resource, are retained. The common services are replaced with services from source resource.

Specified by:

copyServices in interface ResourcesManagerBl

Throws:

WrongAttributeValueException

WrongReferenceAttributeValueException

createResource

public Resource createResource(PerunSession sess,
 Resource resource,
 Vo vo,
 Facility facility)
                        throws ResourceExistsException

Description copied from interface: ResourcesManagerBl

Inserts resource into DB.

Specified by:

createResource in interface ResourcesManagerBl

resource - resource to create

Throws:

ResourceExistsException

createResourceTag

public ResourceTag createResourceTag(PerunSession perunSession,
 ResourceTag resourceTag,
 Vo vo)

Description copied from interface: ResourcesManagerBl

Create new Resource tag.

Specified by:

createResourceTag in interface ResourcesManagerBl

Returns:

new created resourceTag

deactivateGroupResourceAssignment

public void deactivateGroupResourceAssignment(PerunSession sess,
 Group group,
 Resource resource)
                                       throws GroupNotDefinedOnResourceException,
GroupResourceStatusException

Description copied from interface: ResourcesManagerBl

Deactivates the group-resource assignment. The assignment will become INACTIVE and will not be used to allow users from the given group to the resource.

Specified by:

deactivateGroupResourceAssignment in interface ResourcesManagerBl

group - group

resource - resource

Throws:

GroupNotDefinedOnResourceException - when the group-resource assignment doesn't exist

GroupResourceStatusException - when trying to deactivate an assignment in PROCESSING state

deleteAllResources

public void deleteAllResources(PerunSession sess,
 Vo vo)
                        throws ResourceAlreadyRemovedException,
GroupAlreadyRemovedFromResourceException

Description copied from interface: ResourcesManagerBl

Deletes all resources for the VO.

Specified by:

deleteAllResources in interface ResourcesManagerBl

Throws:

ResourceAlreadyRemovedException - if there is at least 1 resource not affected by deleting from DB

GroupAlreadyRemovedFromResourceException - if there is at least 1 group not affected by deleting from DB

deleteAllResourcesTagsForVo

public void deleteAllResourcesTagsForVo(PerunSession perunSession,
 Vo vo)
                                 throws ResourceTagAlreadyAssignedException

Description copied from interface: ResourcesManagerBl

Delete all ResourcesTags for specific VO.

Specified by:

deleteAllResourcesTagsForVo in interface ResourcesManagerBl

Throws:

ResourceTagAlreadyAssignedException

deleteResource

public void deleteResource(PerunSession sess,
 Resource resource)
                    throws ResourceAlreadyRemovedException,
GroupAlreadyRemovedFromResourceException

Description copied from interface: ResourcesManagerBl

Deletes resource by id.

Specified by:

deleteResource in interface ResourcesManagerBl

Throws:

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

GroupAlreadyRemovedFromResourceException - if there is at least 1 group not affected by deleting from DB

deleteResourceTag

public void deleteResourceTag(PerunSession perunSession,
 ResourceTag resourceTag)
                       throws ResourceTagAlreadyAssignedException

Description copied from interface: ResourcesManagerBl

Delete existing Resource tag.

Specified by:

deleteResourceTag in interface ResourcesManagerBl

Throws:

ResourceTagAlreadyAssignedException

fillAndSetRequiredAttributesForGroups

public void fillAndSetRequiredAttributesForGroups(PerunSession sess,
 List<Service> services,
 Resource resource)
                                           throws GroupResourceMismatchException,
WrongAttributeAssignmentException,
WrongAttributeValueException,
WrongReferenceAttributeValueException

Fill and set group and group-resource attributes required by given services for all groups which are assigned to the given resource.

Parameters:

sess - session

services - services of which required attributes are set

resource - resource

Throws:

GroupResourceMismatchException - GroupResourceMismatchException

WrongAttributeAssignmentException - WrongAttributeAssignmentException

WrongAttributeValueException - WrongAttributeValueException

WrongReferenceAttributeValueException - WrongReferenceAttributeValueException

filterOnlyAllowedAttributes

public EnrichedResource filterOnlyAllowedAttributes(PerunSession sess,
 EnrichedResource enrichedResource)

Description copied from interface: ResourcesManagerBl

Filter attributes in given enrichedResources, which are allowed for current principal.

Specified by:

filterOnlyAllowedAttributes in interface ResourcesManagerBl

Parameters:

sess - session

enrichedResource - resource with attributes to filter

Returns:

resource with attributes that are allowed for current principal

getAdminGroups

public List<Group> getAdminGroups(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Gets list of all group administrators of the Resource.

Specified by:

getAdminGroups in interface ResourcesManagerBl

Returns:

list of Groups that are admins in the resource

getAdmins

public List<User> getAdmins(PerunSession perunSession,
 Resource resource,
 boolean onlyDirectAdmins)

Description copied from interface: ResourcesManagerBl

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

If onlyDirectAdmins is true, return only direct users of the group for supported role.

Supported roles: ResourceAdmin, VOAdmin

Specified by:

getAdmins in interface ResourcesManagerBl

onlyDirectAdmins - if true, get only direct user administrators (if false, get both direct and indirect)

Returns:

list of all user administrators of the given resource for supported role

getAllExpiredBansOnResources

public List<BanOnResource> getAllExpiredBansOnResources(PerunSession sess)

Description copied from interface: ResourcesManagerBl

Get all expired bans on any resource to now date

Specified by:

getAllExpiredBansOnResources in interface ResourcesManagerBl

Returns:

list of expired bans for any resource

getAllResources

public List<Resource> getAllResources(PerunSession sess)

Description copied from interface: ResourcesManagerBl

Get all resources from database.

Specified by:

getAllResources in interface ResourcesManagerBl

Parameters:

sess - Perun session

Returns:

list of all resources

getAllResourcesByResourceTag

public List<Resource> getAllResourcesByResourceTag(PerunSession perunSession,
 ResourceTag resourceTag)

Description copied from interface: ResourcesManagerBl

Get all resources in specific Vo (specific by resourceTag.getVoId) for existing resourceTag

Specified by:

getAllResourcesByResourceTag in interface ResourcesManagerBl

Returns:

list of Resources

getAllResourcesTagsForResource

public List<ResourceTag> getAllResourcesTagsForResource(PerunSession perunSession,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Get all resourcesTags for existing Resource

Specified by:

getAllResourcesTagsForResource in interface ResourcesManagerBl

Returns:

list of ResourcesTags

getAllResourcesTagsForVo

public List<ResourceTag> getAllResourcesTagsForVo(PerunSession perunSession,
 Vo vo)

Description copied from interface: ResourcesManagerBl

Get all resourcesTags for existing Vo.

Specified by:

getAllResourcesTagsForVo in interface ResourcesManagerBl

Returns:

list of all resourcesTags for existing Vo

getAllowedMembers

public List<Member> getAllowedMembers(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Returns all members who can access the resource.

Specified by:

getAllowedMembers in interface ResourcesManagerBl

Returns:

list of members assigned to the resource

getAllowedMembersNotExpiredInGroups

public List<Member> getAllowedMembersNotExpiredInGroups(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Returns all members who can access the resource and who are also valid in at least one group associated to the resource.

Specified by:

getAllowedMembersNotExpiredInGroups in interface ResourcesManagerBl

Returns:

list of members assigned to the resource

getAllowedResources

public List<Resource> getAllowedResources(PerunSession sess,
 Member member)

Description copied from interface: ResourcesManagerBl

Get all resources which have the member access on.

Specified by:

getAllowedResources in interface ResourcesManagerBl

Returns:

list of resources which have the member access on

getAllowedResources

public List<Resource> getAllowedResources(PerunSession sess,
 Facility facility,
 User user)

Description copied from interface: ResourcesManagerBl

Return all resources which are under the facility and has member of the user with status other than INVALID.

Specified by:

getAllowedResources in interface ResourcesManagerBl

Returns:

list of resources allowed for user (user has there member with status other than INVALID)

getAllowedUsers

public List<User> getAllowedUsers(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Get all users, who can assess the resource.

Specified by:

getAllowedUsers in interface ResourcesManagerBl

Returns:

list of users

getAllowedUsersNotExpiredInGroups

public List<User> getAllowedUsersNotExpiredInGroups(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Get all users, who can assess the resource and who are not expired in at least one group associated to the resource.

Specified by:

getAllowedUsersNotExpiredInGroups in interface ResourcesManagerBl

Returns:

list of users

getAssignedGroups

public List<Group> getAssignedGroups(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

List all groups associated with the resource.

Specified by:

getAssignedGroups in interface ResourcesManagerBl

Returns:

list of assigned group

getAssignedGroups

public List<Group> getAssignedGroups(PerunSession sess,
 Resource resource,
 Member member)

Description copied from interface: ResourcesManagerBl

List all groups associated with the resource where Member is a member.

Specified by:

getAssignedGroups in interface ResourcesManagerBl

Returns:

list of assigned groups

getAssignedMembers

public List<Member> getAssignedMembers(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Returns all members assigned to the resource.

Specified by:

getAssignedMembers in interface ResourcesManagerBl

Returns:

list of members assigned to the resource

getAssignedMembersWithStatus

public List<AssignedMember> getAssignedMembersWithStatus(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Returns members of groups assigned to resource with status of group-resource assignment.

Specified by:

getAssignedMembersWithStatus in interface ResourcesManagerBl

Parameters:

sess - perunSession

resource - resource

Returns:

list of members of groups assigned to given resource

getAssignedResources

public List<Resource> getAssignedResources(PerunSession sess,
 Group group)

Description copied from interface: ResourcesManagerBl

List all resources to which the group is assigned.

Specified by:

getAssignedResources in interface ResourcesManagerBl

Returns:

list of assigned resources

getAssignedResources

public List<Resource> getAssignedResources(PerunSession sess,
 Member member)

Description copied from interface: ResourcesManagerBl

Get all resources where the member is assigned.

Specified by:

getAssignedResources in interface ResourcesManagerBl

Returns:

getAssignedResources

public List<Resource> getAssignedResources(PerunSession sess,
 Member member,
 Service service)

Description copied from interface: ResourcesManagerBl

Get all resources where the member and the service are assigned.

Specified by:

getAssignedResources in interface ResourcesManagerBl

Returns:

list of resources

getAssignedResources

public List<Resource> getAssignedResources(PerunSession sess,
 User user,
 Vo vo)

Description copied from interface: ResourcesManagerBl

Return List of assigned resources to user on the vo. If user is not member of Vo, return empty List;

Specified by:

getAssignedResources in interface ResourcesManagerBl

Returns:

return list of assigned resources or empty list if user is not member of Vo

getAssignedResourcesWithStatus

public List<AssignedResource> getAssignedResourcesWithStatus(PerunSession sess,
 Member member)

Description copied from interface: ResourcesManagerBl

Returns all assigned resources where member is assigned through the groups.

Specified by:

getAssignedResourcesWithStatus in interface ResourcesManagerBl

Parameters:

sess - perun session

member - member

Returns:

list of assigned resources

getAssignedRichMembers

public List<RichMember> getAssignedRichMembers(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Returns all members assigned to the resource as RichMembers.

Specified by:

getAssignedRichMembers in interface ResourcesManagerBl

Returns:

list of rich members assigned to the resource

getAssignedRichResources

public List<RichResource> getAssignedRichResources(PerunSession sess,
 Group group)

Description copied from interface: ResourcesManagerBl

List all rich resources associated with the group with facility property filled.

Specified by:

getAssignedRichResources in interface ResourcesManagerBl

Returns:

list of assigned rich resources

getAssignedRichResources

public List<RichResource> getAssignedRichResources(PerunSession sess,
 Member member)

Description copied from interface: ResourcesManagerBl

Get all rich resources where the member is assigned with facility property filled.

Specified by:

getAssignedRichResources in interface ResourcesManagerBl

Returns:

list of resources

getAssignedRichResources

public List<RichResource> getAssignedRichResources(PerunSession sess,
 Member member,
 Service service)

Description copied from interface: ResourcesManagerBl

Get all rich resources where the service and the member are assigned with facility property filled.

Specified by:

getAssignedRichResources in interface ResourcesManagerBl

Returns:

list of resources

getAssignedServices

public List<Service> getAssignedServices(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

List all services associated with the resource.

Specified by:

getAssignedServices in interface ResourcesManagerBl

Returns:

list of assigned resources

getAssignedUsers

public List<User> getAssignedUsers(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Returns all users assigned to the resource.

Specified by:

getAssignedUsers in interface ResourcesManagerBl

Returns:

list of users assigned to the resource

getAssociatedGroups

public List<Group> getAssociatedGroups(PerunSession sess,
 Resource resource,
 Member member)

Description copied from interface: ResourcesManagerBl

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

Specified by:

getAssociatedGroups in interface ResourcesManagerBl

Returns:

list of groups, which are associated with the resource with specified member

getAssociatedMembers

public List<Member> getAssociatedMembers(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Returns all members who are associated with the resource. Does not require ACTIVE group-resource status or any specific member status.

Specified by:

getAssociatedMembers in interface ResourcesManagerBl

Returns:

list of members

getAssociatedResources

public List<Resource> getAssociatedResources(PerunSession sess,
 Group group)

Description copied from interface: ResourcesManagerBl

List all resources associated with the group. Does not require ACTIVE group-resource status.

Specified by:

getAssociatedResources in interface ResourcesManagerBl

Returns:

list of associated resources

getAssociatedResources

public List<Resource> getAssociatedResources(PerunSession sess,
 Member member)

Description copied from interface: ResourcesManagerBl

Returns all resources with which the member is associated through the groups. Does not require ACTIVE group-resource status.

Specified by:

getAssociatedResources in interface ResourcesManagerBl

Returns:

list of resources

getAssociatedUsers

public List<User> getAssociatedUsers(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Returns all users who are associated with the defined resource. Does not require ACTIVE group-resource status.

Specified by:

getAssociatedUsers in interface ResourcesManagerBl

Returns:

list of users

getBan

public BanOnResource getBan(PerunSession sess,
 int memberId,
 int resourceId)
                     throws BanNotExistsException

Description copied from interface: ResourcesManagerBl

Get specific resource ban.

Specified by:

getBan in interface ResourcesManagerBl

memberId - the member id

resourceId - the resource id

Returns:

specific resource ban

Throws:

BanNotExistsException

getBanById

public BanOnResource getBanById(PerunSession sess,
 int banId)
                         throws BanNotExistsException

Description copied from interface: ResourcesManagerBl

Get Ban for member on resource by it's id

Specified by:

getBanById in interface ResourcesManagerBl

banId - the ban id

Returns:

resource ban by it's id

Throws:

BanNotExistsException

getBansForMember

public List<BanOnResource> getBansForMember(PerunSession sess,
 int memberId)

Description copied from interface: ResourcesManagerBl

Get all resources bans for member.

Specified by:

getBansForMember in interface ResourcesManagerBl

memberId - the member id

Returns:

list of bans for member on any resource

getBansForResource

public List<BanOnResource> getBansForResource(PerunSession sess,
 int resourceId)

Description copied from interface: ResourcesManagerBl

Get all members bans for resource

Specified by:

getBansForResource in interface ResourcesManagerBl

resourceId - the resource id

Returns:

list of all members bans on resource

getEnrichedBansForResource

public List<EnrichedBanOnResource> getEnrichedBansForResource(PerunSession sess,
 Resource resource,
 List<String> attrNames)
                                                       throws AttributeNotExistsException

Description copied from interface: ResourcesManagerBl

Get all enriched bans for members on the resource with user and member attributes

Specified by:

getEnrichedBansForResource in interface ResourcesManagerBl

resource - resource

attrNames - names of attributes

Returns:

list of all enriched bans on resource

Throws:

AttributeNotExistsException

getEnrichedBansForUser

public List<EnrichedBanOnResource> getEnrichedBansForUser(PerunSession sess,
 User user,
 List<String> attrNames)
                                                   throws AttributeNotExistsException

Description copied from interface: ResourcesManagerBl

Get enriched bans for user on all resources where user is assigned with user and member attributes

Specified by:

getEnrichedBansForUser in interface ResourcesManagerBl

user - user

attrNames - names of attributes

Returns:

list of all user's bans on resources

Throws:

AttributeNotExistsException

getEnrichedResourceById

public EnrichedResource getEnrichedResourceById(PerunSession sess,
 int id,
 List<String> attrNames)
                                         throws ResourceNotExistsException

Description copied from interface: ResourcesManagerBl

Find resource for given id and returns it with given attributes. If attrNames are null or empty, all resource attributes are returned.

Specified by:

getEnrichedResourceById in interface ResourcesManagerBl

Parameters:

sess - session

id - resource id

attrNames - names of attributes to return

Returns:

resource for given id with desired attributes

Throws:

ResourceNotExistsException - if there is no resource with given id

getEnrichedRichResourcesForFacility

public List<EnrichedResource> getEnrichedRichResourcesForFacility(PerunSession sess,
 Facility facility,
 List<String> attrNames)

Description copied from interface: ResourcesManagerBl

Find resources for given facility and attributes for given names. If the attrNames are empty or null, return all attributes.

Specified by:

getEnrichedRichResourcesForFacility in interface ResourcesManagerBl

Parameters:

sess - session

facility - facility

attrNames - names of attributes to return

Returns:

resources with desired attributes

getEnrichedRichResourcesForVo

public List<EnrichedResource> getEnrichedRichResourcesForVo(PerunSession sess,
 Vo vo,
 List<String> attrNames)

Description copied from interface: ResourcesManagerBl

Find resources for given vo and attributes for given names. If the attrNames are empty or null, return all attributes.

Specified by:

getEnrichedRichResourcesForVo in interface ResourcesManagerBl

Parameters:

sess - session

vo - vo

attrNames - names of attributes to return

Returns:

resources with desired attributes

getFacility

public Facility getFacility(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Get facility which belongs to the concrete resource.

Specified by:

getFacility in interface ResourcesManagerBl

Returns:

facility belonging to the resource

getGroupAssignments

public List<AssignedGroup> getGroupAssignments(PerunSession sess,
 Resource resource,
 List<String> attrNames)

Description copied from interface: ResourcesManagerBl

Lists all of the assigned groups for the given resource. Also, returns specified attributes for the groups. If attrNames are null, all group attributes are returned.

Specified by:

getGroupAssignments in interface ResourcesManagerBl

Parameters:

sess - session

resource - resource

attrNames - names of attributes to return

Returns:

list of assigned groups for given resource with specified attributes

getGroupResourceAssignments

public List<GroupResourceAssignment> getGroupResourceAssignments(PerunSession sess,
 List<GroupResourceStatus> statuses)

Description copied from interface: ResourcesManagerBl

Lists all group-resource assignments with given statuses. If statuses are empty or null, lists assignments with all statuses.

Specified by:

getGroupResourceAssignments in interface ResourcesManagerBl

Parameters:

sess - session

statuses - list of allowed statuses

Returns:

list of group-resource assignments with given statuses

getMailingServiceRichResourcesWithMember

public List<RichResource> getMailingServiceRichResourcesWithMember(PerunSession sess,
 Member member)

Description copied from interface: ResourcesManagerBl

Return all rich resources with mailing service(s) where given member is assigned.

Specified by:

getMailingServiceRichResourcesWithMember in interface ResourcesManagerBl

Parameters:

sess - session

member - member

Returns:

list of corresponding rich resources

getPerunBl

public PerunBl getPerunBl()

Gets the perunBl.

Returns:

The perunBl.

getResourceAssignments

public List<AssignedResource> getResourceAssignments(PerunSession sess,
 Group group,
 List<String> attrNames)

Description copied from interface: ResourcesManagerBl

Lists all of the resource assignments for the given group. Also, returns specified attributes and resource tags for the resources. If attrNames are null or empty, all resource attributes are returned.

Specified by:

getResourceAssignments in interface ResourcesManagerBl

Parameters:

sess - session

group - group

attrNames - names of attributes to return

Returns:

list of assigned resources for given group with specified attributes and resource tags

getResourceById

public Resource getResourceById(PerunSession sess,
 int id)
                         throws ResourceNotExistsException

Description copied from interface: ResourcesManagerBl

Searches for the Resource with specified id.

Specified by:

getResourceById in interface ResourcesManagerBl

Returns:

Resource with specified id

Throws:

ResourceNotExistsException

getResourceByName

public Resource getResourceByName(PerunSession sess,
 Vo vo,
 Facility facility,
 String name)
                           throws ResourceNotExistsException

Description copied from interface: ResourcesManagerBl

Return resource by its name.

Specified by:

getResourceByName in interface ResourcesManagerBl

Returns:

resource

Throws:

ResourceNotExistsException

getResources

public List<Resource> getResources(PerunSession sess,
 Vo vo)

Description copied from interface: ResourcesManagerBl

Get all VO resources.

Specified by:

getResources in interface ResourcesManagerBl

Returns:

list of resources

getResources

public List<Resource> getResources(PerunSession sess,
 User user,
 List<Status> memberStatuses,
 List<MemberGroupStatus> memberGroupStatuses,
 List<GroupResourceStatus> groupResourceStatuses)

Description copied from interface: ResourcesManagerBl

Return all resources where user is assigned. Checks member's status in VO and group and status of group-resource assignment. If statuses are null or empty all statuses are used.

Specified by:

getResources in interface ResourcesManagerBl

memberStatuses - allowed member's statuses in VO

memberGroupStatuses - allowed member's statuses in group

groupResourceStatuses - allowed statuses of group-resource assignment

Returns:

List of allowed resources for the user

getResources

public List<Resource> getResources(PerunSession sess)

Description copied from interface: ResourcesManagerBl

Finds all resources.

Specified by:

getResources in interface ResourcesManagerBl

Parameters:

sess - session

Returns:

list of all resources

getResourcesByAttribute

public List<Resource> getResourcesByAttribute(PerunSession sess,
 Attribute attribute)
                                       throws WrongAttributeAssignmentException

Description copied from interface: ResourcesManagerBl

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

Specified by:

getResourcesByAttribute in interface ResourcesManagerBl

Returns:

Throws:

WrongAttributeAssignmentException

getResourcesByIds

public List<Resource> getResourcesByIds(PerunSession sess,
 List<Integer> ids)

Description copied from interface: ResourcesManagerBl

Searches for the Resources with specified ids.

Specified by:

getResourcesByIds in interface ResourcesManagerBl

Returns:

Resources with specified ids

getResourcesCount

public int getResourcesCount(PerunSession sess,
 Vo vo)

Description copied from interface: ResourcesManagerBl

Get all VO resources count.

Specified by:

getResourcesCount in interface ResourcesManagerBl

Returns:

count fo vo resources

getResourcesCount

public int getResourcesCount(PerunSession sess)

Description copied from interface: ResourcesManagerBl

Get count of all resources.

Specified by:

getResourcesCount in interface ResourcesManagerBl

Returns:

count of all resources

getResourcesManagerImpl

public ResourcesManagerImplApi getResourcesManagerImpl()

Gets the resourcesManagerImpl.

Returns:

The resourcesManagerImpl.

getResourcesWhereGroupIsAdmin

public List<Resource> getResourcesWhereGroupIsAdmin(PerunSession sess,
 Facility facility,
 Vo vo,
 Group authorizedGroup)

Description copied from interface: ResourcesManagerBl

Return all resources for the facility and the vo where the group is authorized as resource manager.

Specified by:

getResourcesWhereGroupIsAdmin in interface ResourcesManagerBl

facility - the facility to which resources should be assigned to

vo - the vo to which resources should be assigned to

authorizedGroup - group with resource manager role for all those resources

Returns:

list of defined resources where groups has role resource manager

getResourcesWhereUserIsAdmin

public List<Resource> getResourcesWhereUserIsAdmin(PerunSession sess,
 User user)

Description copied from interface: ResourcesManagerBl

Returns list of resources, where the user is an admin. Including resources, where the user is a VALID member of authorized group.

Specified by:

getResourcesWhereUserIsAdmin in interface ResourcesManagerBl

Returns:

list of resources, where the user is an admin.

getResourcesWhereUserIsAdmin

public List<Resource> getResourcesWhereUserIsAdmin(PerunSession sess,
 Facility facility,
 Vo vo,
 User authorizedUser)

Description copied from interface: ResourcesManagerBl

Return all resources for the facility and the vo where user is authorized as resource manager. Including resources, where the user is a VALID member of authorized group.

Specified by:

getResourcesWhereUserIsAdmin in interface ResourcesManagerBl

facility - the facility to which resources should be assigned to

vo - the vo to which resources should be assigned to

authorizedUser - user with resource manager role for all those resources

Returns:

list of defined resources where user has role resource manager

getResourcesWhereUserIsAdmin

public List<Resource> getResourcesWhereUserIsAdmin(PerunSession sess,
 Vo vo,
 User authorizedUser)

Description copied from interface: ResourcesManagerBl

Return all resources for the vo where user is authorized as resource manager. Including resources, where the user is a VALID member of authorized group.

Specified by:

getResourcesWhereUserIsAdmin in interface ResourcesManagerBl

vo - the vo to which resources should be assigned to

authorizedUser - user with resource manager role for all those resources

Returns:

list of defined resources where user has role resource manager

getRichAdmins

public List<RichUser> getRichAdmins(PerunSession perunSession,
 Resource resource,
 List<String> specificAttributes,
 boolean allUserAttributes,
 boolean onlyDirectAdmins)
                             throws UserNotExistsException

Description copied from interface: ResourcesManagerBl

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

Supported roles: ResourceAdmin, VOAdmin

If "onlyDirectAdmins" is "true", return only direct users of the group for supported role with specific attributes. If "allUserAttributes" is "true", do not specify attributes through list and return them all in objects richUser . Ignoring list of specific attributes.

Specified by:

getRichAdmins in interface ResourcesManagerBl

specificAttributes - list of specified attributes which are needed in object richUser

allUserAttributes - if true, get all possible user attributes and ignore list of specificAttributes (if false, get only specific attributes)

onlyDirectAdmins - if true, get only direct user administrators (if false, get both direct and indirect)

Returns:

list of RichUser administrators for the resource and supported role with attributes

Throws:

UserNotExistsException

getRichResourceById

public RichResource getRichResourceById(PerunSession sess,
 int id)
                                 throws ResourceNotExistsException

Description copied from interface: ResourcesManagerBl

Searches for the RichResource with specified id.

Specified by:

getRichResourceById in interface ResourcesManagerBl

Returns:

RichResource with specified id

Throws:

ResourceNotExistsException

getRichResources

public List<RichResource> getRichResources(PerunSession sess,
 Vo vo)

Description copied from interface: ResourcesManagerBl

Get all VO rich resources with facility property filled.

Specified by:

getRichResources in interface ResourcesManagerBl

Returns:

list of rich resources

getRichResourcesByIds

public List<RichResource> getRichResourcesByIds(PerunSession sess,
 List<Integer> ids)

Description copied from interface: ResourcesManagerBl

Searches for the RichResources with specified ids.

Specified by:

getRichResourcesByIds in interface ResourcesManagerBl

Returns:

RichResources with specified ids

getVo

public Vo getVo(PerunSession sess,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Get Vo which is tied to specified resource.

Specified by:

getVo in interface ResourcesManagerBl

Returns:

vo tied to specified resource

groupResourceAssignmentExists

public boolean groupResourceAssignmentExists(PerunSession sess,
 Resource resource,
 Group group)

Description copied from interface: ResourcesManagerBl

Returns true if the group is assigned to the current resource with any status, false otherwise.

Specified by:

groupResourceAssignmentExists in interface ResourcesManagerBl

Returns:

true if the group is assigned to the current resource.

isGroupAssigned

public boolean isGroupAssigned(PerunSession sess,
 Resource resource,
 Group group)

Description copied from interface: ResourcesManagerBl

Returns true if the group is assigned to the current resource with ACTIVE status, false otherwise.

Specified by:

isGroupAssigned in interface ResourcesManagerBl

Returns:

true if the group is assigned to the current resource with active status.

isGroupManuallyAssigned

public boolean isGroupManuallyAssigned(PerunSession sess,
 Group group,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Returns true if the group is assigned to the given resource manually, false otherwise.

Specified by:

isGroupManuallyAssigned in interface ResourcesManagerBl

Returns:

true if the group is assigned to the given resource manually.

isUserAllowed

public boolean isUserAllowed(PerunSession sess,
 User user,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Returns true if the user is allowed to the current resource, false otherwise.

Specified by:

isUserAllowed in interface ResourcesManagerBl

Returns:

true if the user is allowed to the current resource.

isUserAssigned

public boolean isUserAssigned(PerunSession sess,
 User user,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Returns true if the user is assigned to the current resource, false otherwise.

Specified by:

isUserAssigned in interface ResourcesManagerBl

Returns:

true if the user is assigned to the current resource.

processGroupResourceActivationAsync

@Async
public void processGroupResourceActivationAsync(PerunSession sess,
 Group group,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Asynchronously processes group-resource activation. Sets assignment status of given group and resource to ACTIVE. Check if attributes for each member from group are valid. Fill members' attributes with missing values. In case of error during activation, the group-resource assignment status is set to FAILED.

Specified by:

processGroupResourceActivationAsync in interface ResourcesManagerBl

Parameters:

sess - session

group - group

resource - resource

removeAllExpiredBansOnResources

public void removeAllExpiredBansOnResources(PerunSession sess)

Description copied from interface: ResourcesManagerBl

Remove all expired bans on resources to now date.

Get all expired bans and remove them one by one with auditing process. This method is for purpose of removing expired bans using some cron tool.

Specified by:

removeAllExpiredBansOnResources in interface ResourcesManagerBl

removeAllResourcesTagFromResource

public void removeAllResourcesTagFromResource(PerunSession perunSession,
 Resource resource)

Description copied from interface: ResourcesManagerBl

Remove all existing Resource tags for specific resource.

Specified by:

removeAllResourcesTagFromResource in interface ResourcesManagerBl

removeAutomaticGroupFromResource

public void removeAutomaticGroupFromResource(PerunSession sess,
 Group group,
 Resource resource,
 int sourceGroupId)
                                      throws GroupNotDefinedOnResourceException,
GroupAlreadyRemovedFromResourceException

Description copied from interface: ResourcesManagerBl

Remove automatically assigned group from resource. After removing, check attributes and fix them if it is needed.

Specified by:

removeAutomaticGroupFromResource in interface ResourcesManagerBl

group - the group

resource - the resource

sourceGroupId - id of a source group through which was the group automatically assigned

Throws:

GroupNotDefinedOnResourceException - when there is no such automatic group-resource assignment

GroupAlreadyRemovedFromResourceException - when the group was already removed

removeBan

public void removeBan(PerunSession sess,
 int banId)
               throws BanNotExistsException

Description copied from interface: ResourcesManagerBl

Remove ban by id from resources bans.

Specified by:

removeBan in interface ResourcesManagerBl

banId - id of specific ban

Throws:

BanNotExistsException

removeBan

public void removeBan(PerunSession sess,
 int memberId,
 int resourceId)
               throws BanNotExistsException

Description copied from interface: ResourcesManagerBl

Remove ban by member_id and facility_id

Specified by:

removeBan in interface ResourcesManagerBl

memberId - the id of member

resourceId - the id of resource

Throws:

BanNotExistsException

removeGroupFromResource

public void removeGroupFromResource(PerunSession sess,
 Group group,
 Resource resource)
                             throws GroupNotDefinedOnResourceException,
GroupAlreadyRemovedFromResourceException

Description copied from interface: ResourcesManagerBl

Remove group from a resource. After removing, check attributes and fix them if it is needed.

Specified by:

removeGroupFromResource in interface ResourcesManagerBl

Throws:

GroupNotDefinedOnResourceException - Group was never assigned to this resource

GroupAlreadyRemovedFromResourceException - there are 0 rows affected by deleting from DB

removeGroupFromResources

public void removeGroupFromResources(PerunSession perunSession,
 Group group,
 List<Resource> resources)
                              throws GroupNotDefinedOnResourceException,
GroupAlreadyRemovedFromResourceException

Description copied from interface: ResourcesManagerBl

Remove group from resources. After removing, check attributes and fix them if it is needed.

Specified by:

removeGroupFromResources in interface ResourcesManagerBl

group - the group

resources - list of resources

Throws:

GroupNotDefinedOnResourceException

GroupAlreadyRemovedFromResourceException

removeGroupsFromResource

public void removeGroupsFromResource(PerunSession perunSession,
 List<Group> groups,
 Resource resource)
                              throws GroupNotDefinedOnResourceException,
GroupAlreadyRemovedFromResourceException

Description copied from interface: ResourcesManagerBl

Remove groups from a resource. After removing, check attributes and fix them if it is needed.

Specified by:

removeGroupsFromResource in interface ResourcesManagerBl

groups - list of groups

Throws:

GroupNotDefinedOnResourceException

GroupAlreadyRemovedFromResourceException

removeResourceSelfServiceGroup

public void removeResourceSelfServiceGroup(PerunSession sess,
 Resource resource,
 Group group)
                                    throws GroupNotAdminException

Description copied from interface: ResourcesManagerBl

Unset ResourceSelfService role to given group for given resource.

Specified by:

removeResourceSelfServiceGroup in interface ResourcesManagerBl

Parameters:

sess - session

resource - resource

group - group

Throws:

GroupNotAdminException - group did not have the role

removeResourceSelfServiceUser

public void removeResourceSelfServiceUser(PerunSession sess,
 Resource resource,
 User user)
                                   throws UserNotAdminException

Description copied from interface: ResourcesManagerBl

Unset ResourceSelfService role to given user for given resource.

Specified by:

removeResourceSelfServiceUser in interface ResourcesManagerBl

Parameters:

sess - session

resource - resource

user - user

Throws:

UserNotAdminException - user did not have the role

removeResourceTagFromResource

public void removeResourceTagFromResource(PerunSession perunSession,
 ResourceTag resourceTag,
 Resource resource)
                                   throws ResourceTagNotAssignedException

Description copied from interface: ResourcesManagerBl

Remove specific ResourceTag from existing Resource.

Specified by:

removeResourceTagFromResource in interface ResourcesManagerBl

Throws:

ResourceTagNotAssignedException

removeResourceTagsFromResource

public void removeResourceTagsFromResource(PerunSession perunSession,
 List<ResourceTag> resourceTags,
 Resource resource)
                                    throws ResourceTagNotAssignedException

Description copied from interface: ResourcesManagerBl

Remove specific ResourceTags from existing Resource.

Specified by:

removeResourceTagsFromResource in interface ResourcesManagerBl

Throws:

ResourceTagNotAssignedException

removeService

public void removeService(PerunSession sess,
 Resource resource,
 Service service)
                   throws ServiceNotAssignedException

Description copied from interface: ResourcesManagerBl

Remove service from resource.

Specified by:

removeService in interface ResourcesManagerBl

Throws:

ServiceNotAssignedException

removeServices

public void removeServices(PerunSession sess,
 Resource resource,
 List<Service> services)
                    throws ServiceNotAssignedException

Description copied from interface: ResourcesManagerBl

Remove services from resource.

Specified by:

removeServices in interface ResourcesManagerBl

Throws:

ServiceNotAssignedException

removeServicesPackage

public void removeServicesPackage(PerunSession sess,
 Resource resource,
 ServicesPackage servicesPackage)

Description copied from interface: ResourcesManagerBl

Remove from resource all services from services package.

Specified by:

removeServicesPackage in interface ResourcesManagerBl

setBan

public BanOnResource setBan(PerunSession sess,
 BanOnResource banOnResource)
                     throws BanAlreadyExistsException

Description copied from interface: ResourcesManagerBl

Set ban for member on resource

Specified by:

setBan in interface ResourcesManagerBl

banOnResource - the ban

Returns:

ban on resource

Throws:

BanAlreadyExistsException

setPerunBl

public void setPerunBl(PerunBl perunBl)

updateAllRequiredAttributesForAllowedMembers

public void updateAllRequiredAttributesForAllowedMembers(PerunSession sess,
 Resource resource,
 List<Service> services)
                                                  throws MemberResourceMismatchException,
WrongAttributeAssignmentException,
AttributeNotExistsException,
WrongReferenceAttributeValueException,
WrongAttributeValueException

For given resource, finds all allowed members and sets them attributes, (member-resource, member, user-facility and user) that are required by given services.

Parameters:

sess - session

resource - resource from where allowed members are taken

services - services, for which the required attributes are set

Throws:

MemberResourceMismatchException - MemberResourceMismatchException

WrongAttributeAssignmentException - WrongAttributeAssignmentException

AttributeNotExistsException - AttributeNotExistsException

WrongReferenceAttributeValueException - WrongReferenceAttributeValueException

WrongAttributeValueException - WrongAttributeValueException

updateBan

public BanOnResource updateBan(PerunSession sess,
 BanOnResource banOnResource)

Description copied from interface: ResourcesManagerBl

Update description and validity timestamp of specific ban.

Specified by:

updateBan in interface ResourcesManagerBl

banOnResource - ban to be updated

Returns:

updated ban

updateResource

public Resource updateResource(PerunSession sess,
 Resource resource)
                        throws ResourceExistsException

Description copied from interface: ResourcesManagerBl

Updates Resource.

Specified by:

updateResource in interface ResourcesManagerBl

Returns:

returns updated Resource

Throws:

ResourceExistsException

updateResourceTag

public ResourceTag updateResourceTag(PerunSession perunSession,
 ResourceTag resourceTag)

Description copied from interface: ResourcesManagerBl

Update existing Resource tag.

Specified by:

updateResourceTag in interface ResourcesManagerBl

Returns:

updated ResourceTag