Package ru.averkiev.socialmediaapi.services

Interface MessageService

All Known Implementing Classes:
MessageServiceImpl
public interface MessageService
Интерфейс определяет функциональность для сообщений пользователей, таких как создание, редактирование, удаление и получение переписки.
Author:
mrGreenNV

  • Method Summary

    Modifier and Type
    Method
    Description
    MessageDTO
    createMessage(MessageDTO messageDTO)
    Позволяет создать сообщение.
    void
    deleteMessage(Long messageId)
    Позволяет удалить сообщение между пользователями.
    MessageDTO
    editMessage(Long messageId, String editContent)
    Позволяет отредактировать текст сообщения.
    List<UserDTO>
    getConversationsForUser()
    Позволяет получить список собеседников пользователя.
    List<MessageDTO>
    getMessagesBetweenUsers(Long interlocutorId)
    Позволяет получить переписку между авторизованным пользователем и конкретным собеседником.

  • Method Details

    • createMessage

      MessageDTO createMessage(MessageDTO messageDTO) throws UserNotFoundException
      Позволяет создать сообщение.
      Parameters:
      messageDTO - DTO сообщения с данными о пользователях и контенте.
      Returns:
      DTO созданного сообщения.
      Throws:
      UserNotFoundException - выбрасывает, если не удалось найти пользователя в базе данных.

    • editMessage

      MessageDTO editMessage(Long messageId, String editContent) throws MessageNotFoundException, AuthException
      Позволяет отредактировать текст сообщения.
      Parameters:
      messageId - идентификатор сообщения.
      editContent - отредактированный контент сообщения.
      Returns:
      DTO отредактированного сообщения.
      Throws:
      MessageNotFoundException - выбрасывает, если сообщение не найдено.
      AuthException - выбрасывает, если недостаточно прав для редактирования сообщения.

    • deleteMessage

      void deleteMessage(Long messageId) throws MessageNotFoundException, AuthException
      Позволяет удалить сообщение между пользователями.
      Parameters:
      messageId - идентификатор удаляемого сообщения.
      Throws:
      MessageNotFoundException - выбрасывает, если сообщение не найдено.
      AuthException - выбрасывает, если недостаточно прав для удаления сообщения.

    • getMessagesBetweenUsers

      List<MessageDTO> getMessagesBetweenUsers(Long interlocutorId) throws UserNotFoundException, AuthException
      Позволяет получить переписку между авторизованным пользователем и конкретным собеседником.
      Parameters:
      interlocutorId - идентификатор собеседника.
      Returns:
      список DTO объектом содержащий сообщения между пользователями.
      Throws:
      UserNotFoundException - выбрасывает, если пользователь не найден.
      AuthException - выбрасывает, если возникнет ошибка аутентификации пользователя в системе.

    • getConversationsForUser

      List<UserDTO> getConversationsForUser() throws AuthException
      Позволяет получить список собеседников пользователя.
      Returns:
      список DTO объектов содержащих данные на собеседников.
      Throws:
      AuthException - выбрасывает если при аутентификации пользователя возникает ошибка.