es.uvigo.esei.dgss.teama.microstories.rest

Class StoryResource

java.lang.Object

es.uvigo.esei.dgss.teama.microstories.rest.StoryResource

@Path(value="microstory")
 @Consumes(value="application/json")
 @Produces(value="application/json")
public class StoryResource
extends Object

Resource that represents the stories in the application.

Author:

Bruno Cruz González (bcgonzalez4) Brais Domínguez Álvarez (bdalvarez) Álvaro Suárez Feijoo (asfeijoo)

Constructor Summary

Constructors

Constructor and Description
StoryResource()

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	getRecentStories() Retrieves the most recent stories that are in published status.
javax.ws.rs.core.Response	getStoryById(int id) Returns a history from its identifier.
javax.ws.rs.core.Response	getStoryByText(es.uvigo.esei.dgss.teama.microstories.domain.entities.Genre genre, es.uvigo.esei.dgss.teama.microstories.domain.entities.Theme theme, String publication, int pageNumber, int maxItems) Returns a list stories from a Genre, publication or theme.
javax.ws.rs.core.Response	getStoryByText(String text, int pageNumber, int maxItems) Returns a list stories from a text.

Methods inherited from class java.lang.Object

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

Constructor Detail

StoryResource

public StoryResource()

Method Detail

getRecentStories

@GET
 @Path(value="recent")
public javax.ws.rs.core.Response getRecentStories()

Retrieves the most recent stories that are in published status.

Returns:

The list of recent stories.

getStoryById

@GET
 @Path(value="{id}")
public javax.ws.rs.core.Response getStoryById(@PathParam(value="id")
                                                                        int id)

Returns a history from its identifier. If the history is not found, an exception is thrown.

Parameters:

id - The id of the story to return.

Returns:

The story with the searched id.

getStoryByText

@GET
public javax.ws.rs.core.Response getStoryByText(@QueryParam(value="contains")
                                                     String text,
                                                     @DefaultValue(value="0") @QueryParam(value="pageNumber")
                                                     int pageNumber,
                                                     @DefaultValue(value="10") @QueryParam(value="maxItems")
                                                     int maxItems)

Returns a list stories from a text.

Parameters:

text - The id of the story to return.

pageNumber - The number of the page.

maxItems - The maximum of stories to return by page.

Returns:

The list of stories.

getStoryByText

@GET
public javax.ws.rs.core.Response getStoryByText(@QueryParam(value="genre")
                                                     es.uvigo.esei.dgss.teama.microstories.domain.entities.Genre genre,
                                                     @QueryParam(value="theme")
                                                     es.uvigo.esei.dgss.teama.microstories.domain.entities.Theme theme,
                                                     @QueryParam(value="publication")
                                                     String publication,
                                                     @DefaultValue(value="0") @QueryParam(value="pageNumber")
                                                     int pageNumber,
                                                     @DefaultValue(value="10") @QueryParam(value="maxItems")
                                                     int maxItems)
                                              throws ParseException

Returns a list stories from a Genre, publication or theme.

Parameters:

genre - The Genre of the story to return.

theme - The Theme of the story to return.

publication - The publication of the story to return.

pageNumber - The number of the page.

maxItems - The maximum of stories to return by page.

Returns:

The list of stories.

Throws:

ParseException