es.uvigo.esei.xcs.service

Class OwnerService

java.lang.Object

es.uvigo.esei.xcs.service.OwnerService

@RolesAllowed(value="ADMIN")
public class OwnerService
extends Object

EJB for the Owners. Only administrators have access to this class.

Author:

Miguel Reboiro Jato

Constructor Summary

Constructors

Constructor and Description
OwnerService()

Method Summary

Modifier and Type	Method and Description
es.uvigo.esei.xcs.domain.entities.Owner	create(es.uvigo.esei.xcs.domain.entities.Owner owner) Creates a new owner.
List<es.uvigo.esei.xcs.domain.entities.Owner>	findByPetName(String petName) Returns the list of owners that have a pet with the specified name.
es.uvigo.esei.xcs.domain.entities.Owner	get(String login) Returns the owner identified by login.
List<es.uvigo.esei.xcs.domain.entities.Pet>	getPets(String login) Returns the list of pets of an owner.
List<es.uvigo.esei.xcs.domain.entities.Owner>	list() Returns the complete list of owners.
void	remove(String login) Deletes an owner.
es.uvigo.esei.xcs.domain.entities.Owner	update(es.uvigo.esei.xcs.domain.entities.Owner owner) Updates a new owner.

Methods inherited from class java.lang.Object

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

Constructor Detail

OwnerService

public OwnerService()

Method Detail

get

public es.uvigo.esei.xcs.domain.entities.Owner get(String login)

Returns the owner identified by login. If there is no owner with the specified login, null will be returned.

Parameters:

login - the login of an owner.

Returns:

the owner with the provided login or null if there is no owner with the specified login.

Throws:

IllegalArgumentException - if login is null or it does not identifies a valid owner.

list

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

Returns the complete list of owners.

Returns:

the complete list of owners.

findByPetName

public List<es.uvigo.esei.xcs.domain.entities.Owner> findByPetName(String petName)

Returns the list of owners that have a pet with the specified name.

Parameters:

petName - a pet's name.

Returns:

the list of owners that have a pet with the specified name. The list may be empty if any owner has a pet with the specified name.

Throws:

IllegalArgumentException - if petName is null.

create

public es.uvigo.esei.xcs.domain.entities.Owner create(es.uvigo.esei.xcs.domain.entities.Owner owner)

Creates a new owner. If the owner already has pets, they will be created too.

Parameters:

owner - a new owner to be stored.

Returns:

the persistent version of the owner created.

Throws:

IllegalArgumentException - if owner is null.

javax.persistence.EntityExistsException - if an owner with the same login already exists.

update

public es.uvigo.esei.xcs.domain.entities.Owner update(es.uvigo.esei.xcs.domain.entities.Owner owner)

Updates a new owner. If the owner is not stored, it will be persisted.

Parameters:

owner - an owner to be updated.

Returns:

the updated owner.

Throws:

IllegalArgumentException - if owner is null.

remove

public void remove(String login)

Deletes an owner.

Parameters:

login - the login of the owner to be deleted.

Throws:

IllegalArgumentException - if login is null or if it does not identifies a valid owner.

getPets

public List<es.uvigo.esei.xcs.domain.entities.Pet> getPets(String login)

Returns the list of pets of an owner.

Parameters:

login - the login of the owner that owns the pets.

Returns:

the list of pets of an owner.

Throws:

IllegalArgumentException - if login is null or it does not identifies a valid owner.