org.hawkular.accounts.api.internal.impl

Class ResourceServiceImpl

java.lang.Object

org.hawkular.accounts.api.internal.impl.BaseServiceImpl<Resource>

org.hawkular.accounts.api.internal.impl.ResourceServiceImpl

All Implemented Interfaces:

ResourceService

@PermitAll
public class ResourceServiceImpl
extends BaseServiceImpl<Resource>
implements ResourceService

Main implementation of the ResourceService. Consumers should get an instance of this via CDI. This class should not be directly instantiated by the consumers.

Author:

Juraci Paixão Kröhling

Constructor Summary

Constructors

Constructor and Description
ResourceServiceImpl()

Method Summary

Modifier and Type	Method and Description
PersonaResourceRole	addRoleToPersona(Resource resource, Persona persona, Role role) Adds a Role to a Persona into a Resource
Resource	create(String id, Persona persona) Creates a Resource based on its ID, owned by the specified Persona
Resource	create(String id, Resource parent) Creates a new sub resource, based on a given ID and owning resource
Resource	create(String id, Resource parent, Persona persona) Creates a new sub resource, based on a given ID, parent and owned by the specified Persona
void	delete(String id) Removes a Resource based on its ID.
Resource	get(String id) Retrieves a Resource based on its ID.
Resource	getById(UUID id) Retrieves a Resource based on its ID.
List<Resource>	getByPersona(Persona persona) Lists all the resources that belong to a given persona.
List<PersonaResourceRole>	getRolesForPersona(Resource resource, Persona persona) Retrieves the roles that a given persona has on the given resource.
void	revokeAllForPersona(Resource resource, Persona persona) Revoke all roles that the given persona has on the resource.
void	transfer(Resource resource, Persona persona) Transfers the resource to the given persona.

Methods inherited from class org.hawkular.accounts.api.internal.impl.BaseServiceImpl

getById

Methods inherited from class java.lang.Object

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

Constructor Detail

ResourceServiceImpl

public ResourceServiceImpl()

Method Detail

getById

public Resource getById(UUID id)

Description copied from interface: ResourceService

Retrieves a Resource based on its ID.

Specified by:

getById in interface ResourceService

Parameters:

id - the resource's ID

Returns:

the existing Resource or null if the resource doesn't exists.

get

public Resource get(String id)

Description copied from interface: ResourceService

Retrieves a Resource based on its ID. If the ID is not "UUID-like", then a new UUID is created based on the bytes of the given ID. By "UUID-like", we mean a string that matches a regular expression for the appearance of an UUID such as 'eb66fa08-7cbf-11e5-8cdd-3c970e9648d7'.

Specified by:

get in interface ResourceService

Parameters:

id - the resource's ID

Returns:

the existing Resource or null if the resource doesn't exists.

See Also:

UUID.nameUUIDFromBytes(byte[])

create

public Resource create(String id,
                       Persona persona)

Description copied from interface: ResourceService

Creates a Resource based on its ID, owned by the specified Persona

Specified by:

create in interface ResourceService

Parameters:

id - the ID to be assigned to this resource or null for a new UUID

persona - a valid owner for this resource

Returns:

the newly created Resource

create

public Resource create(String id,
                       Resource parent)

Description copied from interface: ResourceService

Creates a new sub resource, based on a given ID and owning resource

Specified by:

create in interface ResourceService

Parameters:

id - the ID to be assigned to this resource or null for a new UUID

parent - a valid resource to serve as the parent of this sub resource

Returns:

the newly created Resource

create

public Resource create(String id,
                       Resource parent,
                       Persona persona)

Description copied from interface: ResourceService

Creates a new sub resource, based on a given ID, parent and owned by the specified Persona

Specified by:

create in interface ResourceService

Parameters:

id - the ID to be assigned to this resource or null for a new UUID

parent - the resource's parent or null if the owner is provided

persona - the resource's owner or null if the parent is provided

Returns:

the newly created Resource

delete

public void delete(String id)

Description copied from interface: ResourceService

Removes a Resource based on its ID.

Specified by:

delete in interface ResourceService

Parameters:

id - the resource's ID

getByPersona

public List<Resource> getByPersona(Persona persona)

Description copied from interface: ResourceService

Lists all the resources that belong to a given persona.

Specified by:

getByPersona in interface ResourceService

Parameters:

persona - the persona that owns the resources

Returns:

a List of Resource containing the resources owned by the persona

transfer

public void transfer(Resource resource,
                     Persona persona)

Description copied from interface: ResourceService

Transfers the resource to the given persona. Note that the previous owner might still have individual permissions on the resource, so, consider also calling ResourceService.revokeAllForPersona(Resource, Persona) if it's appropriate. This method also revokes all the current permissions of the new owner, replacing all of them by a single "SuperUser" role on the resource.

Specified by:

transfer in interface ResourceService

Parameters:

resource - the resource to receive the new owner

persona - the persona that will be the new owner

revokeAllForPersona

public void revokeAllForPersona(Resource resource,
                                Persona persona)

Description copied from interface: ResourceService

Revoke all roles that the given persona has on the resource. Note that this does not changes the ownership of a resource, so, if the persona is currently the owner of the resource, the persona will still have owner-rights to it, even though no individual roles are given.

Specified by:

revokeAllForPersona in interface ResourceService

Parameters:

resource - the resource that the person currently has roles

persona - the persona to get the access revoked

addRoleToPersona

public PersonaResourceRole addRoleToPersona(Resource resource,
                                            Persona persona,
                                            Role role)

Description copied from interface: ResourceService

Adds a Role to a Persona into a Resource

Specified by:

addRoleToPersona in interface ResourceService

Parameters:

resource - the resource

persona - the persona to get access to the resource

role - the role of the persona on the resource

getRolesForPersona

public List<PersonaResourceRole> getRolesForPersona(Resource resource,
                                                    Persona persona)

Description copied from interface: ResourceService

Retrieves the roles that a given persona has on the given resource.

Specified by:

getRolesForPersona in interface ResourceService

Parameters:

resource - the resource to check

persona - the persona to check

Returns:

a list of PersonaResourceRole, with one entry per combination.