Package ru.averkiev.greenchat_user.services

Interface ContactService

public interface ContactService
Интерфейс определяет функциональность для управления контактами между пользователями.

  • Method Summary

    Modifier and Type
    Method
    Description
    Contact
    createContact(Long userId, Long contactUserId)
    Создаёт новый контакт для пользователя с указанным идентификатором.
    void
    deleteContactById(Long contactId)
    Удаляет контакт по указанному идентификатору.
    void
    deleteContactByUserId(Long userId, Long contactUserId)
    Удаляет контакт между пользователями.
    boolean
    existsContact(Long userId, Long contactUserId)
    Проверяет существование контакта между пользователями.
    List<Contact>
    getContactByUserId(Long userId)
    Возвращает список контактов для пользователя с указанным идентификатором.

  • Method Details

    • createContact

      Contact createContact(Long userId, Long contactUserId) throws UserNotFoundException, ContactAlreadyExistsException
      Создаёт новый контакт для пользователя с указанным идентификатором.
      Parameters:
      userId - - идентификатор пользователя.
      contactUserId - - идентификатор пользователя, который становится контактом.
      Returns:
      - созданный объект контакта.
      Throws:
      UserNotFoundException - - выбрасывается в случае, если пользователь с указанным идентификатором не найден.
      ContactAlreadyExistsException - - выбрасывается в случае, если контакт уже существует.

    • deleteContactById

      void deleteContactById(Long contactId) throws ContactNotFoundException
      Удаляет контакт по указанному идентификатору.
      Parameters:
      contactId - - идентификатор контакта.
      Throws:
      ContactNotFoundException - - выбрасывается если контакт не найден.

    • deleteContactByUserId

      void deleteContactByUserId(Long userId, Long contactUserId) throws UserNotFoundException, ContactNotFoundException
      Удаляет контакт между пользователями.
      Parameters:
      userId - идентификатор пользователя, для которого удаляется контакт.
      contactUserId - идентификатор пользователя, контакт с которым удаляется.
      Throws:
      UserNotFoundException - если пользователь с указанным ID не найден.
      ContactNotFoundException - если контакт не найден.

    • existsContact

      boolean existsContact(Long userId, Long contactUserId) throws UserNotFoundException
      Проверяет существование контакта между пользователями.
      Parameters:
      userId - - идентификатор пользователя, для которого проверяется существование контакта.
      contactUserId - - идентификатор пользователя, с которым проверяется контакт.
      Returns:
      true, если контакт существует, иначе - false.
      Throws:
      UserNotFoundException - - выбрасывается, если пользователь с указанным идентификатором не найден.

    • getContactByUserId

      List<Contact> getContactByUserId(Long userId) throws UserNotFoundException
      Возвращает список контактов для пользователя с указанным идентификатором.
      Parameters:
      userId - - указанный идентификатор пользователя.
      Returns:
      - список контактов.
      Throws:
      UserNotFoundException - - выбрасывается если пользователь с указанным идентификатором не найден.