Package ru.averkiev.greenchat_user.services

Interface UserService

All Known Implementing Classes:
UserServiceImpl
public interface UserService
Интерфейс определяет функциональность для управления пользователями.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    deleteUser(Long userId)
    Удаляет пользователя по его идентификатору.
    boolean
    existsUserByEmail(String email)
    Проверяет, существует ли пользователь с указанной электронной почтой.
    boolean
    existsUserById(Long userId)
    Проверяет, существует ли пользователь с указанным идентификатором.
    boolean
    existsUserByLogin(String login)
    Проверяет, существует ли пользователь с указанным логином.
    List<User>
    getAllUsers()
    Возвращает список всех пользователей.
    List<Blocking>
    getBlockingInitiatedByUser(Long userId)
    Возвращает список блокировок, инициированных указанным пользователем.
    List<Blocking>
    getBlockingReceivedByUser(Long userId)
    Возвращает список блокировок, адресованных указанному пользователю.
    List<Role>
    getRolesByLogin(String username)
    Возвращает список всех ролей по имени пользователя.
    Optional<User>
    getUserById(Long userId)
    Возвращает пользователя по его идентификатору.
    Optional<User>
    getUserByLogin(String login)
    Возвращает пользователя по его логину.
    UserRegistrationDTO
    register(UserCreateDTO userCreateDTO)
    Регистрирует нового пользователя в системе.
    User
    saveUser(User user)
    Создаёт нового пользователя в системе
    UserStatusDTO
    softDeleteUser(Long userId)
    Помечает пользователя удалённым, но не удаляет физически.
    UserUpdateDTO
    updateUser(Long userId, UserUpdateDTO userUpdateDTO)
    Обновляет информацию о пользователе с указанным идентификатором.
    void
    updateUserPassword(Long userId, UserUpdatePasswordDTO userUpdatePasswordDTO)
    Обновляет пароль пользователя с указанным идентификатором.

  • Method Details

    • register

      UserRegistrationDTO register(UserCreateDTO userCreateDTO) throws RegistrationException
      Регистрирует нового пользователя в системе.
      Parameters:
      userCreateDTO - DTO данные нового пользователя.
      Returns:
      зарегистрированный пользователь.
      Throws:
      RegistrationException - выбрасывает если регистрация пользователя не удалась по каким-либо причинам.

    • saveUser

      User saveUser(User user)
      Создаёт нового пользователя в системе
      Parameters:
      user - новый пользователь.
      Returns:
      созданный пользователь.

    • getUserById

      Optional<User> getUserById(Long userId)
      Возвращает пользователя по его идентификатору.
      Parameters:
      userId - идентификатор искомого пользователя.
      Returns:
      Optional, содержащий найденного пользователя, или пустой Optional, если пользователь не найден.

    • getUserByLogin

      Optional<User> getUserByLogin(String login)
      Возвращает пользователя по его логину.
      Parameters:
      login - логин пользователя.
      Returns:
      Optional, содержащий найденного пользователя, или пустой Optional, если пользователь не найден.

    • updateUser

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

    • updateUserPassword

      void updateUserPassword(Long userId, UserUpdatePasswordDTO userUpdatePasswordDTO) throws UserNotFoundException, PasswordsNotMatchException
      Обновляет пароль пользователя с указанным идентификатором.
      Parameters:
      userId - указанный идентификатор пользователя.
      userUpdatePasswordDTO - объект содержащий новый пароль.
      Throws:
      UserNotFoundException - выбрасывает если пользователь с указанным идентификатором не найден.
      PasswordsNotMatchException

    • deleteUser

      void deleteUser(Long userId)
      Удаляет пользователя по его идентификатору.
      Parameters:
      userId - идентификатор удаляемого пользователя.

    • softDeleteUser

      UserStatusDTO softDeleteUser(Long userId)
      Помечает пользователя удалённым, но не удаляет физически.
      Parameters:
      userId - идентификатор пользователя.
      Returns:
      DTO объект с информацией о статусе

    • getAllUsers

      List<User> getAllUsers()
      Возвращает список всех пользователей.
      Returns:
      список ролей.

    • getRolesByLogin

      List<Role> getRolesByLogin(String username) throws UserNotFoundException
      Возвращает список всех ролей по имени пользователя.
      Parameters:
      username - указанное имя пользователя.
      Returns:
      список пользователей
      Throws:
      RoleNotFoundException - - выбрасывается, если указанная роль не найдена.
      UserNotFoundException

    • getBlockingInitiatedByUser

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

    • getBlockingReceivedByUser

      List<Blocking> getBlockingReceivedByUser(Long userId)
      Возвращает список блокировок, адресованных указанному пользователю.
      Parameters:
      userId - идентификатор указанного пользователя.
      Returns:
      список блокировок.

    • existsUserById

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

    • existsUserByLogin

      boolean existsUserByLogin(String login)
      Проверяет, существует ли пользователь с указанным логином.
      Parameters:
      login - логин проверяемого пользователя.
      Returns:
      true, если пользователь существует, иначе false.

    • existsUserByEmail

      boolean existsUserByEmail(String email)
      Проверяет, существует ли пользователь с указанной электронной почтой.
      Parameters:
      email - электронная почта проверяемого пользователя.
      Returns:
      true, если пользователь существует, иначе false.