Rename TransactionSynchronizationManager#currentTransaction to something more meaningful

[michael-simons]

I am working currently on implementing reactive Transactions with our new Neo4j reactive driver and need to access the reactive transaction synchronisation manager through

...reactive.TransactionSynchronizationManager#currentTransaction

The JavaDoc says "…Return the TransactionSynchronizationManager of the current transaction…"

I understand that TransactionSynchronizationManager is merely a wrapper around the TransactionContext.

Neither the manager nor the context are the transaction itself and therefor I think that the currentTransaction() would benefit from another name, like current TransactionSynchronizationManager() or currentTransactionContext(); it's intentions would be clearer.

cc @mp911de

[sbrannen]

Tentatively slated for 5.2 M3

[mp911de]

To add a bit of background: The reactive TransactionSynchronizationManager isn't associated with a transaction/TransactionContext, it is a wrapper to interact with resources and synchronizations stored in TransactionContext.

Renaming that method to forCurrentTransaction() could be more expressive. current TransactionSynchronizationManager is rather bulky. As Javadoc could be always improved, we could refine it along the lines of Return the TransactionSynchronizationManager that is associated with the current transaction context.

[michael-simons]

A big +1 for forCurrentTransaction(). That reads nice and shows the purpose.

[sbrannen]

A big +1 for forCurrentTransaction(). That reads nice and shows the purpose.

That sounds better to me as well.

So, unless someone objects, I'll go ahead and make the proposed name change and Javadoc improvement.