es.uvigo.esei.microstories.services

Class StoryService

java.lang.Object

es.uvigo.esei.microstories.services.StoryService

@PermitAll
public class StoryService
extends Object

Service class for managing stories.

Constructor Summary

Constructors

Constructor and Description
StoryService()

Method Summary

Modifier and Type	Method and Description
es.uvigo.esei.microstories.domain.entities.Story	addReadingLogEntryForA_Story_aux(es.uvigo.esei.microstories.domain.entities.Story story, Date date)
void	addReadingLogEntryForA_Story(Long id) Adds a new reading log entry for a specific story.
Long	countAllPublishedStories() Counts the total number of published stories.
Long	countStoriesByFilter(es.uvigo.esei.microstories.domain.types.GenreType genre, es.uvigo.esei.microstories.domain.types.ThemeType theme, Date initialDate, Date finalDate) Counts the number of stories matching the given filters.
Long	countStoriesByText(String text) Counts the number of stories matching the given text in either title or content.
Long	countStoriesByUser(String username)
StoryResponseDto	createStory(StoryCreateDto storyDto) Creates a new story for the authenticated CREATOR user.
void	deleteStory(Long id) Deletes an existing story owned by the authenticated CREATOR user.
List<StoryResponseDto>	getRecentStories(int limit)
List<StoryResponseDto>	getStoriesByFilter(es.uvigo.esei.microstories.domain.types.GenreType genre, es.uvigo.esei.microstories.domain.types.ThemeType theme, Date initialDate, Date finalDate, int page, int size) Retrieves stories based on the specified filters with pagination support.
List<StoryResponseDto>	getStoriesByUser_aux(String username, int page, int size)
List<StoryResponseDto>	getStoriesByUser(String username, int page, int size) Retrieves a paginated list of stories authored by a specific user.
StoryResponseDto	getStoryById(Long id)
Map<es.uvigo.esei.microstories.domain.types.GenreType,List<StoryResponseDto>>	getTop2ReadStoriesLastMonthByGenre() Retrieves the top 2 most read stories from last month grouped by genre.
List<StoryResponseDto>	searchStoriesByText(String text, int page, int size) Busca relatos cuyo título o contenido contenga el texto indicado.
StoryResponseDto	updateStory(Long id, StoryCreateDto storyDto) Updates an existing unpublished story owned by the authenticated CREATOR user.

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

getRecentStories

public List<StoryResponseDto> getRecentStories(int limit)

getStoryById

public StoryResponseDto getStoryById(Long id)

searchStoriesByText

public List<StoryResponseDto> searchStoriesByText(String text,
                                                  int page,
                                                  int size)

Busca relatos cuyo título o contenido contenga el texto indicado. La búsqueda es insensible a mayúsculas/minúsculas y puede paginarse.

Parameters:

text - el texto a buscar en el título o contenido de los relatos

page - el número de página (0-based index)

size - el número de relatos por página

Returns:

una lista de StoryResponseDto que coinciden con el texto de búsqueda

Throws:

IllegalArgumentException - si el texto está vacío, page es negativo o size es menor que 1

countStoriesByText

public Long countStoriesByText(String text)

Counts the number of stories matching the given text in either title or content.

Parameters:

text - the text to search for in the title or content of the stories

Returns:

the count of stories matching the text

Throws:

IllegalArgumentException - if the search text is empty

countAllPublishedStories

public Long countAllPublishedStories()

Counts the total number of published stories.

Returns:

the count of all published stories

countStoriesByFilter

public Long countStoriesByFilter(es.uvigo.esei.microstories.domain.types.GenreType genre,
                                 es.uvigo.esei.microstories.domain.types.ThemeType theme,
                                 Date initialDate,
                                 Date finalDate)

Counts the number of stories matching the given filters.

Parameters:

genre - the genre to filter by, or null to not filter by genre

theme - the theme to filter by, or null to not filter by theme

initialDate - the start of the publication date range (inclusive), or null if not filtering by date

finalDate - the end of the publication date range (inclusive), or null if not filtering by date

Returns:

the count of stories matching the filters

Throws:

IllegalArgumentException - if only one of initialDate or finalDate is provided, or if initialDate is after finalDate

getStoriesByFilter

public List<StoryResponseDto> getStoriesByFilter(es.uvigo.esei.microstories.domain.types.GenreType genre,
                                                 es.uvigo.esei.microstories.domain.types.ThemeType theme,
                                                 Date initialDate,
                                                 Date finalDate,
                                                 int page,
                                                 int size)

Retrieves stories based on the specified filters with pagination support.

This method allows filtering stories by genre, theme, and/or publication date range. When filtering by date, both initial and final dates must be provided together.

Parameters:

genre - the genre to filter by, or null to not filter by genre

theme - the theme to filter by, or null to not filter by theme

initialDate - the start of the publication date range (inclusive), or null if not filtering by date

finalDate - the end of the publication date range (inclusive), or null if not filtering by date

page - the page number (0-based index)

size - the number of items per page (must be greater than 0)

Returns:

a list of StoryResponseDto objects matching the specified filters

Throws:

IllegalArgumentException - if only one of initialDate or finalDate is provided, or if initialDate is after finalDate, or if page is negative, or size is less than 1

getTop2ReadStoriesLastMonthByGenre

public Map<es.uvigo.esei.microstories.domain.types.GenreType,List<StoryResponseDto>> getTop2ReadStoriesLastMonthByGenre()

Retrieves the top 2 most read stories from last month grouped by genre.

Stories are ranked by the number of views they received during the previous calendar month. For each genre, up to 2 stories are returned, ordered by view count (descending) and then by publication date (descending).

Returns:

A map where keys are genre types and values are lists containing up to 2 story DTOs per genre, ordered by popularity.

addReadingLogEntryForA_Story

public void addReadingLogEntryForA_Story(Long id)

Adds a new reading log entry for a specific story.

This method retrieves a story by its identifier and records a new reading event associated with the current date and time. If the story does not exist, an EntityNotFoundException is thrown. The updated story, including the newly added reading log entry, is then merged back into the persistence context and flushed to the database.

Parameters:

id - The unique identifier of the story for which a reading log entry should be added. Must not be null.

Throws:

EntityNotFoundException - if no story exists with the provided id.

addReadingLogEntryForA_Story_aux

public es.uvigo.esei.microstories.domain.entities.Story addReadingLogEntryForA_Story_aux(es.uvigo.esei.microstories.domain.entities.Story story,
                                                                                         Date date)

getStoriesByUser

public List<StoryResponseDto> getStoriesByUser(String username,
                                               int page,
                                               int size)

Retrieves a paginated list of stories authored by a specific user.

This method fetches stories written by the given username, ordered by publication date in descending order (newest first). Pagination is applied based on the provided page number and page size. If either page or size is less than 1, an IllegalArgumentException is thrown.

The resulting list of Story entities is transformed into StoryResponseDto objects before being returned.

Parameters:

username - the username of the author whose stories are to be retrieved; must not be null.

page - the page number to retrieve (1-based index); must be >= 1.

size - the number of stories per page; must be >= 1.

Returns:

a list of StoryResponseDto objects representing the stories authored by the specified user, limited and ordered according to the pagination parameters.

Throws:

IllegalArgumentException - if page < 1 or size < 1.

getStoriesByUser_aux

public List<StoryResponseDto> getStoriesByUser_aux(String username,
                                                   int page,
                                                   int size)

countStoriesByUser

public Long countStoriesByUser(String username)

createStory

@RolesAllowed(value="CREATOR")
public StoryResponseDto createStory(StoryCreateDto storyDto)

Creates a new story for the authenticated CREATOR user.

Draft stories are initially created without a publication date.

Parameters:

storyDto - the story data

Returns:

a StoryResponseDto representing the newly created story.

Throws:

UnauthorizedAccessException - if the user is not authenticated or not a CREATOR

IllegalArgumentException - if validation fails (e.g., invalid title, too many themes)

updateStory

@RolesAllowed(value="CREATOR")
public StoryResponseDto updateStory(Long id,
                                                                   StoryCreateDto storyDto)

Updates an existing unpublished story owned by the authenticated CREATOR user.

Parameters:

id - the unique identifier of the story to update; must not be null.

storyDto - the updated story data.

Returns:

a StoryResponseDto representing the updated story.

Throws:

UnauthorizedAccessException - if the user is not authenticated, not a CREATOR, or not the author

EntityNotFoundException - if no story exists with the given ID

IllegalArgumentException - if the story is published or validation fails

deleteStory

@RolesAllowed(value="CREATOR")
public void deleteStory(Long id)

Deletes an existing story owned by the authenticated CREATOR user.

Parameters:

id - the unique identifier of the story to delete; must not be null.

Throws:

UnauthorizedAccessException - if the user is not authenticated, not a CREATOR, or not the author

EntityNotFoundException - if no story exists with the given ID