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")
public class EventEJB
extends Object

Constructor Summary

Constructors

Constructor and Description
EventEJB()

Method Summary

Modifier and Type	Method and Description
void	createEvent(es.uvigo.esei.dgss.lettab.domain.Event event) Create an event and stores it in the database
List<es.uvigo.esei.dgss.lettab.domain.Event>	findEvent(String text) This method search events by title and description, and order them by ascendant date and descendant participants
es.uvigo.esei.dgss.lettab.domain.Event	findEventById(int id)
String	getCurrentUserLogin()
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 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

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

getCurrentUserLogin

public String getCurrentUserLogin()

getFiveRandomEvents

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

Get five random events using JPQL

Returns:

a list with five random events

getPopularEvents

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

Get popular 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)

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

removeLinkEventToUser

@RolesAllowed(value="user")
public 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

Parameters:

participant - The user that is linked to the event

event - The event assigned to the user

createEvent

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

Create an event and stores it in the database

Parameters:

event - The event that we want to persist

Throws:

IllegalArgumentException - When the event we want to persist is null

javax.persistence.PersistenceException - Happens when there is any error with the persistence

javax.persistence.EntityExistsException

findEvent

@PermitAll
public List<es.uvigo.esei.dgss.lettab.domain.Event> findEvent(String text)
                                                                  throws javax.persistence.EntityNotFoundException

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 event that matches with the text

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

Parameters:

id - The id bound to the event looking for

Returns:

The event searched by id

Throws:

javax.persistence.NoResultException - thrown if no result found

getEventsToAssist

@RolesAllowed(value="user")
 @PermitAll
public List<es.uvigo.esei.dgss.lettab.domain.Event> getEventsToAssist(String login)
                                                                                                       throws javax.persistence.EntityNotFoundException,
                                                                                                              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