Package org.springframework.data.neo4j.core.transaction

Class Neo4jTransactionManager

java.lang.Object

org.springframework.transaction.support.AbstractPlatformTransactionManager

org.springframework.data.neo4j.core.transaction.Neo4jTransactionManager

All Implemented Interfaces:

Serializable, Aware, ApplicationContextAware, ConfigurableTransactionManager, PlatformTransactionManager, TransactionManager

@API(status=STABLE,
     since="6.0")
public final class Neo4jTransactionManager
extends AbstractPlatformTransactionManager
implements ApplicationContextAware

Dedicated PlatformTransactionManager for native Neo4j transactions. This transaction manager will synchronize a pair of a native Neo4j session/transaction with the transaction.

Since:

6.0

Author:

Michael J. Simons

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	Neo4jTransactionManager.Builder	A builder for Neo4jTransactionManager.

Nested classes/interfaces inherited from class org.springframework.transaction.support.AbstractPlatformTransactionManager

AbstractPlatformTransactionManager.SuspendedResourcesHolder

Field Summary

Fields inherited from class org.springframework.transaction.support.AbstractPlatformTransactionManager

logger, SYNCHRONIZATION_ALWAYS, SYNCHRONIZATION_NEVER, SYNCHRONIZATION_ON_ACTUAL_TRANSACTION

Constructor Summary

Constructors

Constructor	Description
Neo4jTransactionManager(org.neo4j.driver.Driver driver)	This will create a transaction manager for the default database.
Neo4jTransactionManager(org.neo4j.driver.Driver driver, DatabaseSelectionProvider databaseSelectionProvider)	This will create a transaction manager targeting whatever the database selection provider determines.
Neo4jTransactionManager(org.neo4j.driver.Driver driver, DatabaseSelectionProvider databaseSelectionProvider, Neo4jBookmarkManager bookmarkManager)	This constructor can be used to configure the bookmark manager being used.

Method Summary

Modifier and Type	Method	Description
protected void	doBegin(Object transaction, TransactionDefinition definition)
protected void	doCleanupAfterCompletion(Object transaction)
protected void	doCommit(DefaultTransactionStatus status)
protected Object	doGetTransaction()
protected void	doResume(Object transaction, Object suspendedResources)
protected void	doRollback(DefaultTransactionStatus status)
protected void	doSetRollbackOnly(DefaultTransactionStatus status)
protected Object	doSuspend(Object transaction)
protected boolean	isExistingTransaction(Object transaction)
static org.neo4j.driver.Transaction	retrieveTransaction(org.neo4j.driver.Driver driver, String targetDatabase)	Deprecated. since 6.2, use #retrieveTransaction(Driver, DatabaseSelection, UserSelection)
static org.neo4j.driver.Transaction	retrieveTransaction(org.neo4j.driver.Driver driver, DatabaseSelection targetDatabase, UserSelection asUser)	This method provides a native Neo4j transaction to be used from within a Neo4jClient.
void	setApplicationContext(ApplicationContext applicationContext)
static Neo4jTransactionManager.Builder	with(org.neo4j.driver.Driver driver)	Start building a new transaction manager for the given driver instance.

Methods inherited from class org.springframework.transaction.support.AbstractPlatformTransactionManager

commit, determineTimeout, getDefaultTimeout, getTransaction, getTransactionExecutionListeners, getTransactionSynchronization, invokeAfterCompletion, isFailEarlyOnGlobalRollbackOnly, isGlobalRollbackOnParticipationFailure, isNestedTransactionAllowed, isRollbackOnCommitFailure, isValidateExistingTransaction, prepareForCommit, prepareSynchronization, registerAfterCompletionWithExistingTransaction, resume, rollback, setDefaultTimeout, setFailEarlyOnGlobalRollbackOnly, setGlobalRollbackOnParticipationFailure, setNestedTransactionAllowed, setRollbackOnCommitFailure, setTransactionExecutionListeners, setTransactionSynchronization, setTransactionSynchronizationName, setValidateExistingTransaction, shouldCommitOnGlobalRollbackOnly, suspend, triggerBeforeCommit, triggerBeforeCompletion, useSavepointForNestedTransaction

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.transaction.ConfigurableTransactionManager

addListener

Constructor Details

Neo4jTransactionManager

public Neo4jTransactionManager(org.neo4j.driver.Driver driver)

This will create a transaction manager for the default database.

Parameters:

driver - A driver instance

Neo4jTransactionManager

public Neo4jTransactionManager(org.neo4j.driver.Driver driver,
 DatabaseSelectionProvider databaseSelectionProvider)

This will create a transaction manager targeting whatever the database selection provider determines.

Parameters:

driver - A driver instance

databaseSelectionProvider - The database selection provider to determine the database in which the transactions should happen

Neo4jTransactionManager

public Neo4jTransactionManager(org.neo4j.driver.Driver driver,
 DatabaseSelectionProvider databaseSelectionProvider,
 Neo4jBookmarkManager bookmarkManager)

This constructor can be used to configure the bookmark manager being used. It is useful when you need to seed the bookmark manager or if you want to capture new bookmarks.

Parameters:

driver - A driver instance

databaseSelectionProvider - The database selection provider to determine the database in which the transactions should happen

bookmarkManager - A bookmark manager

Method Details

with

@API(status=STABLE,
     since="6.2")
public static Neo4jTransactionManager.Builder with(org.neo4j.driver.Driver driver)

Start building a new transaction manager for the given driver instance.

Parameters:

driver - A fixed driver instance.

Returns:

A builder for a transaction manager

setApplicationContext

public void setApplicationContext(ApplicationContext applicationContext)
                           throws BeansException

Specified by:

setApplicationContext in interface ApplicationContextAware

Throws:

BeansException

retrieveTransaction

@Deprecated
@Nullable
public static org.neo4j.driver.Transaction retrieveTransaction(org.neo4j.driver.Driver driver,
 @Nullable
 String targetDatabase)

Deprecated.

since 6.2, use #retrieveTransaction(Driver, DatabaseSelection, UserSelection)

Parameters:

driver - The driver that has been used as a synchronization object.

targetDatabase - The target database

Returns:

An optional managed transaction or null if the method hasn't been called inside an ongoing Spring transaction

See Also:

• retrieveTransaction(Driver, DatabaseSelection, UserSelection)

retrieveTransaction

@Nullable
public static org.neo4j.driver.Transaction retrieveTransaction(org.neo4j.driver.Driver driver,
 DatabaseSelection targetDatabase,
 UserSelection asUser)

This method provides a native Neo4j transaction to be used from within a Neo4jClient. In most cases this the native transaction will be controlled from the Neo4j specific PlatformTransactionManager. However, SDN provides support for other transaction managers as well. This method registers a session synchronization in such cases on the foreign transaction manager.

Parameters:

driver - The driver that has been used as a synchronization object.

targetDatabase - The target database

asUser - The user for which the tx is being retrieved

Returns:

An optional managed transaction or null if the method hasn't been called inside an ongoing Spring transaction

doGetTransaction

protected Object doGetTransaction()
                           throws TransactionException

Specified by:

doGetTransaction in class AbstractPlatformTransactionManager

Throws:

TransactionException

isExistingTransaction

protected boolean isExistingTransaction(Object transaction)
                                 throws TransactionException

Overrides:

isExistingTransaction in class AbstractPlatformTransactionManager

Throws:

TransactionException

doBegin

protected void doBegin(Object transaction,
 TransactionDefinition definition)
                throws TransactionException

Specified by:

doBegin in class AbstractPlatformTransactionManager

Throws:

TransactionException

doSuspend

protected Object doSuspend(Object transaction)
                    throws TransactionException

Overrides:

doSuspend in class AbstractPlatformTransactionManager

Throws:

TransactionException

doResume

protected void doResume(@Nullable
 Object transaction,
 Object suspendedResources)

Overrides:

doResume in class AbstractPlatformTransactionManager

doCommit

protected void doCommit(DefaultTransactionStatus status)
                 throws TransactionException

Specified by:

doCommit in class AbstractPlatformTransactionManager

Throws:

TransactionException

doRollback

protected void doRollback(DefaultTransactionStatus status)
                   throws TransactionException

Specified by:

doRollback in class AbstractPlatformTransactionManager

Throws:

TransactionException

doSetRollbackOnly

protected void doSetRollbackOnly(DefaultTransactionStatus status)
                          throws TransactionException

Overrides:

doSetRollbackOnly in class AbstractPlatformTransactionManager

Throws:

TransactionException

doCleanupAfterCompletion

protected void doCleanupAfterCompletion(Object transaction)

Overrides:

doCleanupAfterCompletion in class AbstractPlatformTransactionManager