Module dk.cloudcreate.essentials.components.foundation

Package dk.cloudcreate.essentials.components.foundation.transaction.jdbi

Class GenericHandleAwareUnitOfWorkFactory<UOW extends HandleAwareUnitOfWork>

java.lang.Object

dk.cloudcreate.essentials.components.foundation.transaction.jdbi.GenericHandleAwareUnitOfWorkFactory<UOW>

Type Parameters:

UOW - the concrete HandleAwareUnitOfWork - such as the GenericHandleAwareUnitOfWorkFactory.GenericHandleAwareUnitOfWork

All Implemented Interfaces:

HandleAwareUnitOfWorkFactory<UOW>, UnitOfWorkFactory<UOW>

Direct Known Subclasses:

JdbiUnitOfWorkFactory

public abstract class GenericHandleAwareUnitOfWorkFactory<UOW extends HandleAwareUnitOfWork>
extends Object
implements HandleAwareUnitOfWorkFactory<UOW>

Generic HandleAwareUnitOfWorkFactory variant where the implementation manually manages the UnitOfWork and the underlying database Transaction.
This class is built for inheritance, but can also be used directly - e.g. through the JdbiUnitOfWorkFactory

If you e.g. need to have a UnitOfWork join in with an existing Spring Managed transaction then please use the Spring specific UnitOfWorkFactory, SpringManagedUnitOfWorkFactory, provided with the spring-postgresql-event-store module.

See Also:

• GenericHandleAwareUnitOfWorkFactory.GenericHandleAwareUnitOfWork
• JdbiUnitOfWorkFactory

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	GenericHandleAwareUnitOfWorkFactory.GenericHandleAwareUnitOfWork

Field Summary

Fields inherited from interface dk.cloudcreate.essentials.components.foundation.transaction.UnitOfWorkFactory

unitOfWorkLog

Constructor Summary

Constructors

Constructor	Description
GenericHandleAwareUnitOfWorkFactory(org.jdbi.v3.core.Jdbi jdbi)	Example of using the GenericHandleAwareUnitOfWorkFactory directly

Method Summary

Modifier and Type	Method	Description
protected abstract UOW	createNewUnitOfWorkInstance(GenericHandleAwareUnitOfWorkFactory<UOW> unitOfWorkFactory)
Optional<UOW>	getCurrentUnitOfWork()	Get the currently active UnitOfWork
UOW	getOrCreateNewUnitOfWork()	Get the currently active UnitOfWork or create a new UnitOfWork if one is missing
UOW	getRequiredUnitOfWork()	Get a required active UnitOfWork

Methods inherited from class java.lang.Object

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

Methods inherited from interface dk.cloudcreate.essentials.components.foundation.transaction.UnitOfWorkFactory

usingUnitOfWork, usingUnitOfWork, withUnitOfWork, withUnitOfWork

Constructor Details

GenericHandleAwareUnitOfWorkFactory

public GenericHandleAwareUnitOfWorkFactory(org.jdbi.v3.core.Jdbi jdbi)

Example of using the GenericHandleAwareUnitOfWorkFactory directly

         unitOfWorkFactory = new GenericHandleAwareUnitOfWorkFactory<>(jdbi) {

             @Override
             protected GenericHandleAwareUnitOfWork createNewUnitOfWorkInstance(GenericHandleAwareUnitOfWorkFactory<GenericHandleAwareUnitOfWork> unitOfWorkFactory) {
                 return new GenericHandleAwareUnitOfWork(unitOfWorkFactory);
             }
         };
 

Parameters:

jdbi - the jdbi instance which provides access to the underlying database

Method Details

getRequiredUnitOfWork

public UOW getRequiredUnitOfWork()

Description copied from interface: UnitOfWorkFactory

Get a required active UnitOfWork

Specified by:

getRequiredUnitOfWork in interface UnitOfWorkFactory<UOW extends HandleAwareUnitOfWork>

Returns:

the active UnitOfWork

getOrCreateNewUnitOfWork

public UOW getOrCreateNewUnitOfWork()

Description copied from interface: UnitOfWorkFactory

Get the currently active UnitOfWork or create a new UnitOfWork if one is missing

Specified by:

getOrCreateNewUnitOfWork in interface UnitOfWorkFactory<UOW extends HandleAwareUnitOfWork>

Returns:

a UnitOfWork

createNewUnitOfWorkInstance

protected abstract UOW createNewUnitOfWorkInstance(GenericHandleAwareUnitOfWorkFactory<UOW> unitOfWorkFactory)

getCurrentUnitOfWork

public Optional<UOW> getCurrentUnitOfWork()

Description copied from interface: UnitOfWorkFactory

Get the currently active UnitOfWork

Specified by:

getCurrentUnitOfWork in interface UnitOfWorkFactory<UOW extends HandleAwareUnitOfWork>

Returns:

the currently active UnitOfWork wrapped in an Optional or Optional.empty() in case there isn't a currently active UnitOfWork