Package com.example.blogs.app.api.user.repository.adapter

Interface UserRepositoryAdapter

All Known Implementing Classes:

UserRepositoryAdapterImpl

public interface UserRepositoryAdapter

Abstracts user repository operations with exception translation for domain-specific errors.

Method Summary

Modifier and Type	Method	Description
UserEntity	findById(Long id)	Finds a user by their unique ID.
UserEntity	findByUsername(String username)	Finds a user by username.
UserEntity	findByUsernameOrEmail(String usernameOrEmail)	Finds a user by username or email address.
UserEntity	save(CreateUserCommand command)	Persists a new user entity.
UserEntity	update(UserEntity userEntity)	Updates an existing user entity.

Method Details

save

UserEntity save(CreateUserCommand command)

Persists a new user entity.

Parameters:

command - user creation details

Returns:

the saved user entity

Throws:

UsernameTakenException - if username already exists

EmailTakenException - if email already exists

FailedToCreateUserException - for other persistence failures

findByUsernameOrEmail

UserEntity findByUsernameOrEmail(String usernameOrEmail)

Finds a user by username or email address.

Parameters:

usernameOrEmail - the username or email to search for

Returns:

the matching user entity

Throws:

UserNotFoundException - if no user is found

FailedToFindUserException - for database errors

findByUsername

UserEntity findByUsername(String username)

Finds a user by username.

Parameters:

username - the username to search for

Returns:

the matching user entity

Throws:

UserNotFoundException - if no user is found

FailedToFindUserException - for database errors

findById

UserEntity findById(Long id)

Finds a user by their unique ID.

Parameters:

id - the user ID to search for

Returns:

the matching user entity

Throws:

UserNotFoundException - if no user is found

FailedToFindUserByIdException - for database errors

update

UserEntity update(UserEntity userEntity)

Updates an existing user entity.

Parameters:

userEntity - the user entity with updated values

Returns:

the updated user entity

Throws:

UsernameTakenException - if updated username is already taken

EmailTakenException - if updated email is already taken

FailedToUpdateUserException - for database update failures