es.uvigo.esei.dgss.letta.service

Class EventEJB

java.lang.Object

es.uvigo.esei.dgss.letta.service.EventEJB

public class EventEJB
extends Object

EventEJB is a service bean providing all the required event-related methods.

Author:

Aitor Blanco Míguez, Borja Cordeiro González, Alberto Pardellas Soto, Adolfo Álvarez López, Adrián Rodríguez Fariña, Alberto Gutiérrez Jácome

Constructor Summary

Constructors

Constructor and Description
EventEJB()

Method Summary

Modifier and Type	Method and Description
es.uvigo.esei.dgss.letta.domain.entities.Event	createEvent(es.uvigo.esei.dgss.letta.domain.entities.Event event) Creates a new Event in the database, setting its creator as the current identified User.
List<es.uvigo.esei.dgss.letta.domain.entities.Event>	listByDate(int start, int count) Returns a paginated List of Events, sorted by ascending date (which means that older events will be first on the list).
List<es.uvigo.esei.dgss.letta.domain.entities.Event>	listHighlighted(int start, int count) Returns a paginated List of Events with all the currently highlighted events, sorted by a magician.
List<es.uvigo.esei.dgss.letta.domain.entities.Event>	search(String search, int start, int count) Searches for Events matching some given String query, and returns the results as a paginated List.

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

createEvent

@RolesAllowed(value="USER")
public es.uvigo.esei.dgss.letta.domain.entities.Event createEvent(es.uvigo.esei.dgss.letta.domain.entities.Event event)
                                                                                       throws IllegalArgumentException,
                                                                                              SecurityException

Creates a new Event in the database, setting its creator as the current identified User.

Parameters:

event - The Event to be inserted into the database.

Returns:

The created Event object with all its auto-generated fields (the event Event.getId() id) already set.

Throws:

IllegalArgumentException - if the received Event is null

SecurityException - if the currently identified user is not found in the database (!!!).

listByDate

@PermitAll
public List<es.uvigo.esei.dgss.letta.domain.entities.Event> listByDate(int start,
                                                                                  int count)

Returns a paginated List of Events, sorted by ascending date (which means that older events will be first on the list).

Parameters:

start - The first Event position to return, numbered from 0.

count - The number of Events to return.

Returns:

A sorted List with the specified number of Events, sorted by ascending date and counting from the received start point.

listHighlighted

@PermitAll
public List<es.uvigo.esei.dgss.letta.domain.entities.Event> listHighlighted(int start,
                                                                                       int count)

Returns a paginated List of Events with all the currently highlighted events, sorted by a magician.

Parameters:

start - The first Event position to return, numbered from 0.

count - The number of Events to return.

Returns:

A sorted List with the specified number of Events, magically sorted and counting from the received start point.

search

@PermitAll
public List<es.uvigo.esei.dgss.letta.domain.entities.Event> search(String search,
                                                                              int start,
                                                                              int count)
                                                                       throws IllegalArgumentException

Searches for Events matching some given String query, and returns the results as a paginated List. If the given search pattern is null, a NullPointerException will be thrown.
The method will search inside the event's title and short description. Results are sorted by ascending date and descending number of attendees.

Parameters:

search - The search pattern as a simple String.

start - The first Event position to return, from 0.

count - The number of Events to return.

Returns:

A sorted List with the specified number of Events that have matched the search query.

Throws:

IllegalArgumentException - if the received String with the search terms is null.