Package ru.averkiev.greenchat_user.services

Interface BlockingService

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

  • Method Summary

    Modifier and Type
    Method
    Description
    Blocking
    createBlocking(Long userId, Long blockedUserId)
    Создает новую блокировку между пользователями.
    void
    deleteBlockingById(Long blockingId)
    Удаляет блокировку между пользователями по её указанному идентификатору.
    void
    deleteBlockingByUsers(Long userId, Long blockedUserId)
    Удаляет блокировку между пользователями по их идентификаторам.
    Optional<Blocking>
    getBlockingById(Long blockingId)
    Возвращает блокировку между пользователями по её указанному идентификатору.
    Optional<Blocking>
    getBlockingByUsers(Long userId, Long blockedUserId)
    Возвращает блокировку между пользователями по их идентификаторам.

  • Method Details

    • createBlocking

      Blocking createBlocking(Long userId, Long blockedUserId) throws UserNotFoundException, BlockingAlreadyExistsException
      Создает новую блокировку между пользователями.
      Parameters:
      userId - идентификатор инициатора блокировки.
      blockedUserId - идентификатор блокируемого пользователя.
      Returns:
      возвращает объект новой блокировки.
      Throws:
      UserNotFoundException - выбрасывает если пользователь с указанным идентификатором не найден.
      BlockingAlreadyExistsException - выбрасывает если такая блокировка уже существует.

    • getBlockingByUsers

      Optional<Blocking> getBlockingByUsers(Long userId, Long blockedUserId)
      Возвращает блокировку между пользователями по их идентификаторам.
      Parameters:
      userId - идентификатор пользователя инициировавшего блокировку.
      blockedUserId - идентификатор заблокированного пользователя.
      Returns:
      Optional, содержащий найденную блокировку, или пустой Optional, если блокировка не найдена.

    • getBlockingById

      Optional<Blocking> getBlockingById(Long blockingId)
      Возвращает блокировку между пользователями по её указанному идентификатору.
      Parameters:
      blockingId - идентификатор указанной блокировки.
      Returns:
      Optional, содержащий найденную блокировку, или пустой Optional, если блокировка не найдена.

    • deleteBlockingByUsers

      void deleteBlockingByUsers(Long userId, Long blockedUserId) throws BlockingNotFoundException
      Удаляет блокировку между пользователями по их идентификаторам.
      Parameters:
      userId - идентификатор пользователя инициировавшего блокировку.
      blockedUserId - идентификатор заблокированного пользователя.
      Throws:
      BlockingNotFoundException - выбрасывается если блокировка не найдена.

    • deleteBlockingById

      void deleteBlockingById(Long blockingId) throws BlockingNotFoundException
      Удаляет блокировку между пользователями по её указанному идентификатору.
      Parameters:
      blockingId - идентификатор указанной блокировки
      Throws:
      BlockingNotFoundException - выбрасывает если блокировка не найдена.