Package io.github.marcopaglio.booking.repository.postgres

Class ClientPostgresRepository

java.lang.Object

io.github.marcopaglio.booking.repository.postgres.ClientPostgresRepository

All Implemented Interfaces:

ClientRepository

public class ClientPostgresRepository
extends Object
implements ClientRepository

Implementation of repository layer through PostgreSQL for Client entities of the booking application.

Constructor Summary

Constructors

Constructor	Description
ClientPostgresRepository(jakarta.persistence.EntityManager em)	Constructs a repository layer for Client entities using PostgreSQL database.

Method Summary

Modifier and Type	Method	Description
void	delete(Client client)	Removes the unique specified client from the PostgreSQL database, if it exists, otherwise it does nothing.
List<Client>	findAll()	Retrieves all the clients from the PostgreSQL database in a list.
Optional<Client>	findById(UUID id)	Retrieves the unique client with the specified identifier from the PostgreSQL database, if it exists.
Optional<Client>	findByName(String firstName, String lastName)	Retrieves the unique client with the specified name and surname from the PostgreSQL database, if it exists.
Client	save(Client client)	Inserts a new Client in the PostgreSQL database or saves changes of an existing one.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ClientPostgresRepository

public ClientPostgresRepository(jakarta.persistence.EntityManager em)

Constructs a repository layer for Client entities using PostgreSQL database.

Parameters:

em - the EntityManager used to communicate with PostgreSQL database.

Method Details

findAll

public List<Client> findAll()

Retrieves all the clients from the PostgreSQL database in a list.

Specified by:

findAll in interface ClientRepository

Returns:

the List of Clients found in the repository.

findById

public Optional<Client> findById(UUID id)

Retrieves the unique client with the specified identifier from the PostgreSQL database, if it exists.

Specified by:

findById in interface ClientRepository

Parameters:

id - the identifier of the client to find.

Returns:

an Optional contained the Client identified by id, if it exists; an Optional empty, otherwise.

findByName

public Optional<Client> findByName(String firstName,
 String lastName)

Retrieves the unique client with the specified name and surname from the PostgreSQL database, if it exists.

Specified by:

findByName in interface ClientRepository

Parameters:

firstName - the name of the client to find.

lastName - the surname of the client to find.

Returns:

an Optional contained the Client named firstName and lastName, if it exists; an Optional empty, otherwise.

save

public Client save(Client client)
            throws IllegalArgumentException,
UpdateFailureException,
NotNullConstraintViolationException,
UniquenessConstraintViolationException

Inserts a new Client in the PostgreSQL database or saves changes of an existing one. Note: a Client without an identifier is considered to be entered, while with the identifier it will be updated. Note: this method must be executed as part of a transaction.

Specified by:

save in interface ClientRepository

Parameters:

client - the Client to save.

Returns:

the Client saved.

Throws:

IllegalArgumentException - if client is null.

UpdateFailureException - if you try to save changes of a no longer existing client.

NotNullConstraintViolationException - if firstName or lastName of client to save are null.

UniquenessConstraintViolationException - if id or [firstName, lastName] of client to save are already present.

delete

public void delete(Client client)
            throws IllegalArgumentException

Removes the unique specified client from the PostgreSQL database, if it exists, otherwise it does nothing. Note: this method must be executed as part of a transaction.

Specified by:

delete in interface ClientRepository

Parameters:

client - the client to delete.

Throws:

IllegalArgumentException - if client is null.