es.uvigo.esei.dgss.lettab.service

Class EventEJB

java.lang.Object

es.uvigo.esei.dgss.lettab.service.EventEJB

@DeclareRoles(value={"admin","user"})
 @RolesAllowed(value="admin")
 @PermitAll
public class EventEJB
extends Object

Constructor Summary

Constructors

Constructor and Description
EventEJB()

Method Summary

Modifier and Type	Method and Description
void	cancelEvent(String userLogin, int eventId) This method is used to cancel a given event.
es.uvigo.esei.dgss.lettab.domain.Event	createEvent(es.uvigo.esei.dgss.lettab.domain.Event event) Create an event and stores it in the database
es.uvigo.esei.dgss.lettab.domain.Event	findEventById(int id) Receives the id of an event and return the event related with it.
List<es.uvigo.esei.dgss.lettab.domain.Event>	findEvents(String text) This method search events by title and description, and order them by ascendant date and descendant participants
List<es.uvigo.esei.dgss.lettab.domain.Event>	getEventsToAssist(String login) This method search signed up user's events, and order them by ascendant date and descendant participants
List<es.uvigo.esei.dgss.lettab.domain.Event>	getFiveRandomEvents() Get five random events using JPQL
List<es.uvigo.esei.dgss.lettab.domain.Event>	getMyEvents(String login) Gives a list with the events created by the user bound to the login passed as a parameter.
List<es.uvigo.esei.dgss.lettab.domain.Event>	getPopularEvents(int numEvents) Get popular active events using JPQL and order them by date asc.
void	linkEventToUser(es.uvigo.esei.dgss.lettab.domain.User participant, es.uvigo.esei.dgss.lettab.domain.Event event) Links an user to an event and increase the number of participants for that event
void	removeLinkEventToUser(es.uvigo.esei.dgss.lettab.domain.User participant, es.uvigo.esei.dgss.lettab.domain.Event event) Removes the relationship between an user who assist to an event
void	updateEvent(es.uvigo.esei.dgss.lettab.domain.Event event, String login) Update an event

Methods inherited from class java.lang.Object

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

Constructor Detail

EventEJB

public EventEJB()

Method Detail

getFiveRandomEvents

@PermitAll
public List<es.uvigo.esei.dgss.lettab.domain.Event> getFiveRandomEvents()

Get five random events using JPQL

Returns:

A list with five random active events

getPopularEvents

@PermitAll
public List<es.uvigo.esei.dgss.lettab.domain.Event> getPopularEvents(int numEvents)

Get popular active events using JPQL and order them by date asc. and participants desc.

Parameters:

numEvents - The number of events to look for

Returns:

A list with the popular events

linkEventToUser

@RolesAllowed(value="user")
public void linkEventToUser(es.uvigo.esei.dgss.lettab.domain.User participant,
                                                        es.uvigo.esei.dgss.lettab.domain.Event event)
                                                 throws EventNotActiveException,
                                                        NullPointerException

Links an user to an event and increase the number of participants for that event

Parameters:

participant - The user that is linked to an event

event - Event assigned to a user

Throws:

EventNotActiveException - thrown if the event were deleted by his owner

NullPointerException - Thrown if the passed event is a null object

removeLinkEventToUser

@RolesAllowed(value="user")
public void removeLinkEventToUser(es.uvigo.esei.dgss.lettab.domain.User participant,
                                                              es.uvigo.esei.dgss.lettab.domain.Event event)
                                                       throws NullPointerException,
                                                              EventNotActiveException,
                                                              IllegalArgumentException

Removes the relationship between an user who assist to an event

Parameters:

participant - The user that is linked to the event

event - The event assigned to the user

Throws:

EventNotActiveException - thrown if the event is inactive

NullPointerException - Thrown if the user is a null parameter

IllegalArgumentException - Thrown if the event/user is null or is a removed entity

createEvent

@RolesAllowed(value="user")
public es.uvigo.esei.dgss.lettab.domain.Event createEvent(es.uvigo.esei.dgss.lettab.domain.Event event)
                                                                               throws IllegalArgumentException,
                                                                                      javax.persistence.EntityExistsException

Create an event and stores it in the database

Parameters:

event - The event that we want to persist

Returns:

Event The created event

Throws:

IllegalArgumentException - When the event we want to persist is null

javax.persistence.EntityExistsException - Happens if the event is already persisted

findEvents

@PermitAll
public List<es.uvigo.esei.dgss.lettab.domain.Event> findEvents(String text)
                                                                   throws SearchNotFoundException

This method search events by title and description, and order them by ascendant date and descendant participants

Parameters:

text - The String that should match with the title or description of the events

Returns:

The result list of events

Throws:

javax.persistence.EntityNotFoundException - if there aren't any active event that matches with the text

SearchNotFoundException

getMyEvents

@PermitAll
public List<es.uvigo.esei.dgss.lettab.domain.Event> getMyEvents(String login)

Gives a list with the events created by the user bound to the login passed as a parameter.

Parameters:

login - The String passed to retrieve the user

Returns:

The result list of events of user

findEventById

@PermitAll
public es.uvigo.esei.dgss.lettab.domain.Event findEventById(int id)
                                                                throws javax.persistence.NoResultException

Receives the id of an event and return the event related with it.

Parameters:

id - The id bound to the event looking for

Returns:

Event The event searched by id

Throws:

javax.persistence.NoResultException - thrown if no result found

updateEvent

@PermitAll
public void updateEvent(es.uvigo.esei.dgss.lettab.domain.Event event,
                                   String login)
                            throws IllegalArgumentException,
                                   javax.persistence.NoResultException,
                                   SecurityException,
                                   DateBeforeTodayException

Update an event

Parameters:

event - the event update

login - the login of the user

Throws:

IllegalArgumentException - Happens when the event does not exist and the event date is not future

SecurityException - Happens when the user is not the owner

DateBeforeTodayException - Thrown when the new date is before the actual date

javax.persistence.NoResultException - When the event cannot be found

getEventsToAssist

@PermitAll
public List<es.uvigo.esei.dgss.lettab.domain.Event> getEventsToAssist(String login)
                                                                          throws javax.persistence.NoResultException,
                                                                                 IllegalArgumentException

This method search signed up user's events, and order them by ascendant date and descendant participants

Parameters:

login - The User of which we will obtain the signed up event's list

Returns:

the result list of events

Throws:

javax.persistence.EntityNotFoundException - if there aren't any event of which the user is signed

IllegalArgumentException - if the user is null

javax.persistence.NoResultException

cancelEvent

@PermitAll
public void cancelEvent(String userLogin,
                                   int eventId)
                            throws javax.persistence.NoResultException,
                                   SecurityException,
                                   IllegalArgumentException,
                                   UserNotActiveException,
                                   EventAlreadyCancelledException

This method is used to cancel a given event. The method also receives the logged user login and check if it can be cancelled

Parameters:

userLogin - The user who wants to cancel the event

eventId - The event to cancel

Throws:

javax.persistence.NoResultException - Returns that when the user cannot be found

UserNotActiveException - If the user is not active

SecurityException - When the login is not the creator of the event

IllegalArgumentException - When the login is null

EventAlreadyCancelledException - When the event is already cancelled