Package com.espacogeek.geek.services.impl

Class UserMediaListServiceImpl

java.lang.Object

com.espacogeek.geek.services.impl.UserMediaListServiceImpl

All Implemented Interfaces:

UserMediaListService

@Service
public class UserMediaListServiceImpl
extends Object
implements UserMediaListService

An implementation class of UserMediaListService @see UserMediaListService

Constructor Summary

Constructors

Constructor	Description
UserMediaListServiceImpl(UserMediaListRepository userMediaListRepository, UserRepository userRepository, MediaRepository mediaRepository, UserCustomStatusRepository userCustomStatusRepository)

Method Summary

Modifier and Type	Method	Description
UserMediaListModel	addMedia(Integer userId, Integer mediaId)	Adds a media item to the user's library with default status (StatusType.PLANNING) and progress 0.
List<UserMediaListModel>	findByUserIdWithFilters(Integer userId, String status, Integer statusId, Integer categoryId, CategoryType categoryName, Integer genreId, String genreName, Integer mediaId, String mediaName, String altTitle)	Retrieves all library entries for the given user, with optional filters.
boolean	removeMedia(Integer userId, Integer mediaId)	Removes a media item from the user's library.
UserMediaListModel	upsertUserMedia(Integer userId, UpdateUserMediaInput input)	Creates or updates the user's library entry for the specified media (upsert).

Methods inherited from class java.lang.Object

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

Constructor Details

UserMediaListServiceImpl

public UserMediaListServiceImpl(UserMediaListRepository userMediaListRepository,
 UserRepository userRepository,
 MediaRepository mediaRepository,
 UserCustomStatusRepository userCustomStatusRepository)

Method Details

findByUserIdWithFilters

public List<UserMediaListModel> findByUserIdWithFilters(Integer userId,
 String status,
 Integer statusId,
 Integer categoryId,
 CategoryType categoryName,
 Integer genreId,
 String genreName,
 Integer mediaId,
 String mediaName,
 String altTitle)

Description copied from interface: UserMediaListService

Retrieves all library entries for the given user, with optional filters.

Specified by:

findByUserIdWithFilters in interface UserMediaListService

Parameters:

userId - the ID of the authenticated user

status - optional user tracking status string filter (e.g. "watching", "completed")

statusId - optional media production status ID filter (MediaStatusModel.id)

categoryId - optional media category ID filter

categoryName - optional media category name filter (e.g. CategoryType.ANIME)

genreId - optional genre ID filter

genreName - optional genre name filter

mediaId - optional media ID filter

mediaName - optional media name filter (partial match)

altTitle - optional alternative title filter (partial match)

Returns:

a list of matching UserMediaListModel entries

See Also:

• UserMediaListService.findByUserIdWithFilters(Integer, String, Integer, Integer, CategoryType, Integer, String, Integer, String, String)

addMedia

@Transactional
public UserMediaListModel addMedia(Integer userId,
 Integer mediaId)

Description copied from interface: UserMediaListService

Adds a media item to the user's library with default status (StatusType.PLANNING) and progress 0. Throws MediaAlreadyInLibraryException if the entry already exists.

Specified by:

addMedia in interface UserMediaListService

Parameters:

userId - the ID of the authenticated user

mediaId - the ID of the media to add

Returns:

the newly created UserMediaListModel entry

See Also:

• UserMediaListService.addMedia(Integer, Integer)

upsertUserMedia

@Transactional
public UserMediaListModel upsertUserMedia(Integer userId,
 UpdateUserMediaInput input)

Description copied from interface: UserMediaListService

Creates or updates the user's library entry for the specified media (upsert). If an entry for the given user and input.mediaId already exists, it is updated with only the non-null fields from input. If no entry exists, a new one is created with the provided fields (status defaults to PLANNING when not specified).

When the resulting status is PLANNING, datePlanned is set to the current timestamp automatically.

Specified by:

upsertUserMedia in interface UserMediaListService

Parameters:

userId - the ID of the authenticated user

input - the input data for the create-or-update operation

Returns:

the persisted (created or updated) UserMediaListModel entry

See Also:

• UserMediaListService.upsertUserMedia(Integer, UpdateUserMediaInput)

removeMedia

@Transactional
public boolean removeMedia(Integer userId,
 Integer mediaId)

Description copied from interface: UserMediaListService

Removes a media item from the user's library.

Specified by:

removeMedia in interface UserMediaListService

Parameters:

userId - the ID of the authenticated user

mediaId - the ID of the media to remove

Returns:

true if the entry was found and deleted, false otherwise

See Also:

• UserMediaListService.removeMedia(Integer, Integer)