es.uvigo.esei.dgss.teamb.ligaaas.service.ejbs

Class PlayerService

java.lang.Object

es.uvigo.esei.dgss.teamb.ligaaas.service.ejbs.PlayerService

@RolesAllowed(value={"ADMIN","USER"})
public class PlayerService
extends Object

EJB for the Players

Constructor Summary

Constructors

Constructor and Description
PlayerService()

Method Summary

Modifier and Type	Method and Description
es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player	create(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player player) Creates a new player
es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player	createProfile(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player player) Creates a new player profile
es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player	findProfile(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.User user) Find a user's profile
es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player	get(int id) Returns the player identified by id.
List<es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player>	getByAdmin(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.User admin) Gets the players managed by a given user.
List<es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player>	list() Returns the complete list of players
void	remove(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player player) Deletes an player.
void	removeProfile(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player player) Delete a user's profile of a user
es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player	update(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player player) Updates the information of this player.

Methods inherited from class java.lang.Object

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

Constructor Detail

PlayerService

public PlayerService()

Method Detail

create

public es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player create(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player player)

Creates a new player

Parameters:

player - a new player to be stored

Returns:

the persistent version of the player created

Throws:

IllegalArgumentException - if player is null

createProfile

public es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player createProfile(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player player)

Creates a new player profile

Parameters:

player - a new player profile to be stored

Returns:

the new player profile

Throws:

IllegalArgumentException - if player is null or this user already has profile

get

public es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player get(int id)

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

Parameters:

id - the id of an player.

Returns:

the player with the provided id or null if there is no player with the specified id.

Throws:

IllegalArgumentException - if id is null or it does not identifies a valid player.

update

public es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player update(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player player)

Updates the information of this player.

Parameters:

player - a player to be updated.

Returns:

the updated player.

Throws:

IllegalArgumentException - if player is null.

remove

public void remove(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player player)

Deletes an player. The elimination is logical

Parameters:

player - the player to be deleted.

Throws:

IllegalArgumentException - if player if null.

removeProfile

public void removeProfile(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player player)

Delete a user's profile of a user

Parameters:

player - the profile of the player to be eliminated

list

public List<es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player> list()

Returns the complete list of players

Returns:

the complete list of players

getByAdmin

public List<es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player> getByAdmin(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.User admin)

Gets the players managed by a given user.

Parameters:

admin - the user that manages the players

Returns:

the list of managed players

Throws:

javax.ejb.EJBAccessException - if the players admin is not the current user.

IllegalArgumentException - if admin is null.

findProfile

public es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.Player findProfile(es.uvigo.esei.dgss.teamb.ligaaas.domain.entities.User user)

Find a user's profile

Parameters:

user - the user to search the profile

Returns:

the user profile of the user or null if there is no such profile