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

Class UserService

java.lang.Object

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

public class UserService
extends Object

EJB for the Author

Constructor Summary

Constructors

Constructor and Description
UserService()

Method Summary

Modifier and Type	Method and Description
es.uvigo.esei.dgss.teama.microstories.domain.entities.Author	createAuthor(es.uvigo.esei.dgss.teama.microstories.domain.entities.Author author) Creates a new author.
es.uvigo.esei.dgss.teama.microstories.domain.entities.Story	createStory(es.uvigo.esei.dgss.teama.microstories.domain.entities.Story story) Creates a new story.
List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story>	findStoriesByAuthor(String login) Returns a list of microstories of an author.
List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story>	findStoriesByAuthor(String login, int page, int limit) Returns a paginated list of microstories of an author.
es.uvigo.esei.dgss.teama.microstories.domain.entities.Story	findStoryById(int id) Returns the story identified by id.
es.uvigo.esei.dgss.teama.microstories.domain.entities.Story	updateStory(es.uvigo.esei.dgss.teama.microstories.domain.entities.Story story) Updates a new story.

Methods inherited from class java.lang.Object

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

Constructor Detail

UserService

public UserService()

Method Detail

findStoriesByAuthor

@RolesAllowed(value="AUTHOR")
 @Produces(value="application/json")
public List<es.uvigo.esei.dgss.teama.microstories.domain.entities.Story> findStoriesByAuthor(String login)

Returns a list of microstories of an author.

Parameters:

login - the author login.

Returns:

the list of microstories published by an author.

findStoriesByAuthor

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

Returns a paginated list of microstories of an author.

Parameters:

login - the author login

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 list of microstories published by an author.

createAuthor

@PermitAll
 @Produces(value="application/json")
public es.uvigo.esei.dgss.teama.microstories.domain.entities.Author createAuthor(es.uvigo.esei.dgss.teama.microstories.domain.entities.Author author)

Creates a new author. If the author already has microstories, they will be created too.

Parameters:

author - a new author to be stored.

Returns:

the persistent version of the author created.

Throws:

IllegalArgumentException - if author is null.

javax.persistence.EntityExistsException - if an author with the same login already exists.

createStory

@RolesAllowed(value="AUTHOR")
 @Produces(value="application/json")
public es.uvigo.esei.dgss.teama.microstories.domain.entities.Story createStory(es.uvigo.esei.dgss.teama.microstories.domain.entities.Story story)

Creates a new story. If the story already has readings, they will be created too.

Parameters:

story - a new story to be stored.

Returns:

the persistent version of the story created.

Throws:

IllegalArgumentException - if author is null.

javax.ejb.EJBAccessException - if the story's author is not the current user.

updateStory

@RolesAllowed(value="AUTHOR")
 @Produces(value="application/json")
public es.uvigo.esei.dgss.teama.microstories.domain.entities.Story updateStory(es.uvigo.esei.dgss.teama.microstories.domain.entities.Story story)

Updates a new story. If the story is not stored, it will be persisted.

Parameters:

story - an story to be updated.

Returns:

the updated story.

Throws:

IllegalArgumentException - if story is null.

javax.ejb.EJBAccessException - if the story's author is not the current user.

findStoryById

@RolesAllowed(value="AUTHOR")
 @Produces(value="application/json")
public es.uvigo.esei.dgss.teama.microstories.domain.entities.Story findStoryById(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's author is not the current user.