es.uvigo.esei.dgss.teama.microstories.service

Class StoryService

java.lang.Object

es.uvigo.esei.dgss.teama.microstories.service.StoryService

public class StoryService
extends Object

EJB for the Stories

Constructor Summary

Constructors

Constructor and Description
StoryService()

Method Summary

Modifier and Type	Method and Description
void	addReading(int storyId) Create or increase a reading depending on whether that story has already been read that day or not.
Integer	countByText(String text) Returns the number of stories that contains in its title or text a string passed by param.
es.uvigo.esei.dgss.teama.microstories.domain.entities.Story	findById(int id) Returns the story identified by id.
List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story>	findByText(String text) Returns a list of stories that contains in its title or text a string passed by param.
List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story>	findByText(String text, int page, int limit) Returns a list of paginated stories that contains in its title or text a string passed by param.
List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story>	findByThemeAndGenreAndDate(es.uvigo.esei.dgss.teama.microstories.domain.enums.Theme theme, es.uvigo.esei.dgss.teama.microstories.domain.enums.Genre genre, es.uvigo.esei.dgss.teama.microstories.domain.enums.DateRange range) Returns a list of stories that matched with the specified params.
List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story>	findByThemeAndGenreAndDate(es.uvigo.esei.dgss.teama.microstories.domain.enums.Theme theme, es.uvigo.esei.dgss.teama.microstories.domain.enums.Genre genre, es.uvigo.esei.dgss.teama.microstories.domain.enums.DateRange range, int page, int limit) Returns a list of stories that matched with the specified params.
List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story>	findMostRead() Return a list of stories most reader of each genre.
List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story>	findRecent() Returns the list of recent stories published.

Methods inherited from class java.lang.Object

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

Constructor Detail

StoryService

public StoryService()

Method Detail

findRecent

@PermitAll
 @Produces(value="application/json")
public List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story> findRecent()

Returns the list of recent stories published.

Returns:

the list of stories that was published. The list was turned at most, the six latest Stories published. They can be empty if there are not any result.

countByText

@PermitAll
 @Produces(value="application/json")
public Integer countByText(String text)

Returns the number of stories that contains in its title or text a string passed by param.

Parameters:

text - the string that we want to use to filter stories.

Returns:

the number of stories that matched with the text passed as param.

findByText

@PermitAll
 @Produces(value="application/json")
public List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story> findByText(String text,
                                                                                                                                    int page,
                                                                                                                                    int limit)

Returns a list of paginated stories that contains in its title or text a string passed by param.

Parameters:

text - the string that we want to use to filter stories.

page - the page number. If it is less than 0 it returns the first page.

limit - the number of stories contained in a page. If it is less than 0 or greater than 100, it returns at most 100 stories.

Returns:

the paginated list stories. It can be empty if no results are found.

findByText

@PermitAll
 @Produces(value="application/json")
public List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story> findByText(String text)

Returns a list of stories that contains in its title or text a string passed by param.

Parameters:

text - the string that we want to use to filter stories.

Returns:

the list of stories that matches with the text param. They can be empty if there are not stories that matches by the param.

findById

@PermitAll
 @Produces(value="application/json")
public es.uvigo.esei.dgss.teama.microstories.domain.entities.Story findById(int id)

Returns the story identified by id.

Parameters:

id - the id of a story.

Returns:

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

Throws:

IllegalArgumentException - if a story with the specified identifier do not exists.

javax.ejb.EJBAccessException - if the story is not published.

findByThemeAndGenreAndDate

@PermitAll
 @Produces(value="application/json")
public List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story> findByThemeAndGenreAndDate(es.uvigo.esei.dgss.teama.microstories.domain.enums.Theme theme,
                                                                                                                                                    es.uvigo.esei.dgss.teama.microstories.domain.enums.Genre genre,
                                                                                                                                                    es.uvigo.esei.dgss.teama.microstories.domain.enums.DateRange range,
                                                                                                                                                    int page,
                                                                                                                                                    int limit)

Returns a list of stories that matched with the specified params.

Parameters:

theme - the theme of the story

genre - the genre of story

range - the date ranges to filter

page - the number o page

limit - the stories in each page

Returns:

the list of stories that matches with the specified params.

findByThemeAndGenreAndDate

@PermitAll
 @Produces(value="application/json")
public List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story> findByThemeAndGenreAndDate(es.uvigo.esei.dgss.teama.microstories.domain.enums.Theme theme,
                                                                                                                                                    es.uvigo.esei.dgss.teama.microstories.domain.enums.Genre genre,
                                                                                                                                                    es.uvigo.esei.dgss.teama.microstories.domain.enums.DateRange range)

Returns a list of stories that matched with the specified params.

Parameters:

theme - the theme of the story

genre - the genre of story

range - the date ranges to filter

Returns:

the list of stories that matches with the specified params

findMostRead

@PermitAll
 @Produces(value="application/json")
public List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story> findMostRead()

Return a list of stories most reader of each genre. There are in the list two STORY, two POETRY and two NANO_STORY, in total, six stories.

Returns:

the list with the most reader stories

addReading

@PermitAll
public void addReading(int storyId)

Create or increase a reading depending on whether that story has already been read that day or not.

Parameters:

storyId - the id of the story read