org.drools.persistence
Interface PersistenceContextManager

All Known Implementing Classes:

JpaPersistenceContextManager, MapPersistenceContextManager

public interface PersistenceContextManager

Method Summary

void	beginCommandScopedEntityManager() This method should be called at the beginning of a CommandExecutor.execute(org.kie.api.command.Command) method, when the given CommandService instance is responsible for handling persistence.
void	dispose() Executes the necessary actions in order to clean up and dispose of the internal fields of this instance.
void	endCommandScopedEntityManager() This method should only called in the Synchronization.afterCompletion(int) method.
PersistenceContext	getApplicationScopedPersistenceContext()
PersistenceContext	getCommandScopedPersistenceContext()

Method Detail

getApplicationScopedPersistenceContext

PersistenceContext getApplicationScopedPersistenceContext()

Returns:

a PersistenceContext instance containing the Application Scoped EntityManager.

getCommandScopedPersistenceContext

PersistenceContext getCommandScopedPersistenceContext()

Returns:

a PersistenceContext instance containing the Command Scoped EntityManager.

beginCommandScopedEntityManager

void beginCommandScopedEntityManager()

This method should be called at the beginning of a CommandExecutor.execute(org.kie.api.command.Command) method, when the given CommandService instance is responsible for handling persistence. See the SingleSessionCommandService class.

The first responsibility of this method is to make sure that the Command Scoped EntityManager (CSEM) joins the ongoing transaction.

When the CSEM is internally managed, this method is also responsible for creating a new CSEM for use during execution of the Command or operation being executed by the KieSession.

endCommandScopedEntityManager

void endCommandScopedEntityManager()

This method should only called in the Synchronization.afterCompletion(int) method.

It is responsible for cleaning up the Command Scoped EntityManager (CSEM) instance, but only when the CSEM is an internal one, and not one supplied (and managed) by the user.

If the CSEM is (internally) managed, then this method will take the necessary actions in order to make sure that a new CSEM can be generated at the beginning of the next operation or command on the persistent KieSession.

if the CSEM is supplied (and managed) by the user, this method will do nothing with the CSEM.

dispose

void dispose()

Executes the necessary actions in order to clean up and dispose of the internal fields of this instance.