es.uvigo.esei.xcs.service

Class PetService

java.lang.Object

es.uvigo.esei.xcs.service.PetService

@RolesAllowed(value="OWNER")
public class PetService
extends Object

EJB for the Pets. Only owners have access to this class, and only to their own pets.

Author:

Miguel Reboiro Jato

Constructor Summary

Constructors

Constructor and Description
PetService()

Method Summary

Modifier and Type	Method and Description
es.uvigo.esei.xcs.domain.entities.Pet	create(es.uvigo.esei.xcs.domain.entities.Pet pet) Creates a new pet owned by the current user.
es.uvigo.esei.xcs.domain.entities.Pet	get(int id) Returns a pet identified by the provided id.
List<es.uvigo.esei.xcs.domain.entities.Pet>	list() Returns the complete list of pets of the current owner.
void	remove(int id) Deletes a pet.
es.uvigo.esei.xcs.domain.entities.Pet	update(es.uvigo.esei.xcs.domain.entities.Pet pet) Updates the information of a pet.

Methods inherited from class java.lang.Object

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

Constructor Detail

PetService

public PetService()

Method Detail

get

public es.uvigo.esei.xcs.domain.entities.Pet get(int id)

Returns a pet identified by the provided id. If an owner tries to access a pet that does now own, an EJBAccessException will be thrown.

Parameters:

id - the identified of a pet.

Returns:

a pet identified by the provided identifier or null if no pet exists with the provided identifier.

Throws:

javax.ejb.EJBAccessException - if the current owner does not owns the pet.

list

public List<es.uvigo.esei.xcs.domain.entities.Pet> list()

Returns the complete list of pets of the current owner.

Returns:

the complete list of pets of the current owner.

create

public es.uvigo.esei.xcs.domain.entities.Pet create(es.uvigo.esei.xcs.domain.entities.Pet pet)

Creates a new pet owned by the current user.

Parameters:

pet - a new pet to be stored.

Returns:

the persistent version of the pet created.

Throws:

javax.ejb.EJBAccessException - if the pet already has an owner and it is not the current user. If the pet has no owner, this exception will be never thrown.

IllegalArgumentException - if a pet with the same identifier already exists.

update

public es.uvigo.esei.xcs.domain.entities.Pet update(es.uvigo.esei.xcs.domain.entities.Pet pet)

Updates the information of a pet. If the pet is not stored, it will be created.

Parameters:

pet - a pet to be updated.

Returns:

the updated pet.

Throws:

IllegalArgumentException - if the pet has no owner.

javax.ejb.EJBAccessException - if the pet's owner is not the current user.

remove

public void remove(int id)

Deletes a pet.

Parameters:

id - the identifier of the pet to be deleted.

Throws:

IllegalArgumentException - if there is no pet with the provided identifier.

javax.ejb.EJBAccessException - if the pet's owner is not the current user.