org.springframework.data.r2dbc.connectionfactory

Class ConnectionFactoryUtils

java.lang.Object

org.springframework.data.r2dbc.connectionfactory.ConnectionFactoryUtils

Deprecated.

since 1.2 in favor of Spring R2DBC. Use ConnectionFactoryUtils instead.

@Deprecated
public abstract class ConnectionFactoryUtils
extends Object

Helper class that provides static methods for obtaining R2DBC Connections from a ConnectionFactory.

Used internally by Spring's DatabaseClient, Spring's R2DBC operation objects. Can also be used directly in application code.

Author:

Mark Paluch, Christoph Strobl

Field Summary

Fields

Modifier and Type	Field and Description
static int	CONNECTION_SYNCHRONIZATION_ORDER Deprecated. Order value for ReactiveTransactionSynchronization objects that clean up R2DBC Connections.

Method Summary

Modifier and Type	Method and Description
static reactor.core.publisher.Mono<Void>	closeConnection(Connection connection, ConnectionFactory connectionFactory) Deprecated. Close the Connection.
static reactor.core.publisher.Mono<ConnectionFactory>	currentConnectionFactory(ConnectionFactory connectionFactory) Deprecated. Obtain the ConnectionFactory from the current subscriber Context.
static reactor.core.publisher.Mono<Void>	doCloseConnection(Connection connection, ConnectionFactory connectionFactory) Deprecated. Close the Connection, unless a SmartConnectionFactory doesn't want us to.
static reactor.core.publisher.Mono<Connection>	doGetConnection(ConnectionFactory connectionFactory) Deprecated. Actually obtain a R2DBC Connection from the given ConnectionFactory.
static reactor.core.publisher.Mono<Void>	doReleaseConnection(Connection connection, ConnectionFactory connectionFactory) Deprecated. Actually close the given Connection, obtained from the given ConnectionFactory.
static reactor.core.publisher.Mono<Connection>	getConnection(ConnectionFactory connectionFactory) Deprecated. Obtain a Connection from the given ConnectionFactory.
static Connection	getTargetConnection(Connection con) Deprecated. Return the innermost target Connection of the given Connection.
static reactor.core.publisher.Mono<Void>	releaseConnection(Connection con, ConnectionFactory connectionFactory) Deprecated. Close the given Connection, obtained from the given ConnectionFactory, if it is not managed externally (that is, not bound to the thread).

Methods inherited from class java.lang.Object

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

Field Detail

CONNECTION_SYNCHRONIZATION_ORDER

public static final int CONNECTION_SYNCHRONIZATION_ORDER

Deprecated.

Order value for ReactiveTransactionSynchronization objects that clean up R2DBC Connections.

See Also:

Constant Field Values

Method Detail

getConnection

public static reactor.core.publisher.Mono<Connection> getConnection(ConnectionFactory connectionFactory)

Deprecated.

Obtain a Connection from the given ConnectionFactory. Translates exceptions into the Spring hierarchy of unchecked generic data access exceptions, simplifying calling code and making any exception that is thrown more meaningful.

Is aware of a corresponding Connection bound to the current Context. Will bind a Connection to the Context if transaction synchronization is active.

Parameters:

connectionFactory - the ConnectionFactory to obtain Connections from.

Returns:

a R2DBC Connection from the given ConnectionFactory.

Throws:

DataAccessResourceFailureException - if the attempt to get a Connection failed.

See Also:

releaseConnection(io.r2dbc.spi.Connection, io.r2dbc.spi.ConnectionFactory)

doGetConnection

public static reactor.core.publisher.Mono<Connection> doGetConnection(ConnectionFactory connectionFactory)

Deprecated.

Actually obtain a R2DBC Connection from the given ConnectionFactory. Same as getConnection(io.r2dbc.spi.ConnectionFactory), but preserving the original exceptions.

Is aware of a corresponding Connection bound to the current Context. Will bind a Connection to the Context if transaction synchronization is active.

Parameters:

connectionFactory - the ConnectionFactory to obtain Connections from.

Returns:

a R2DBC Connection from the given ConnectionFactory.

releaseConnection

public static reactor.core.publisher.Mono<Void> releaseConnection(Connection con,
                                                                  ConnectionFactory connectionFactory)

Deprecated.

Close the given Connection, obtained from the given ConnectionFactory, if it is not managed externally (that is, not bound to the thread).

Parameters:

con - the Connection to close if necessary.

connectionFactory - the ConnectionFactory that the Connection was obtained from.

See Also:

getConnection(io.r2dbc.spi.ConnectionFactory)

doReleaseConnection

public static reactor.core.publisher.Mono<Void> doReleaseConnection(Connection connection,
                                                                    ConnectionFactory connectionFactory)

Deprecated.

Actually close the given Connection, obtained from the given ConnectionFactory. Same as releaseConnection(io.r2dbc.spi.Connection, io.r2dbc.spi.ConnectionFactory), but preserving the original exception.

Parameters:

connection - the Connection to close if necessary.

connectionFactory - the ConnectionFactory that the Connection was obtained from.

See Also:

doGetConnection(io.r2dbc.spi.ConnectionFactory)

closeConnection

public static reactor.core.publisher.Mono<Void> closeConnection(Connection connection,
                                                                ConnectionFactory connectionFactory)

Deprecated.

Close the Connection. Translates exceptions into the Spring hierarchy of unchecked generic data access exceptions, simplifying calling code and making any exception that is thrown more meaningful.

Parameters:

connection - the Connection to close.

connectionFactory - the ConnectionFactory that the Connection was obtained from.

Returns:

a R2DBC Connection from the given ConnectionFactory.

Throws:

DataAccessResourceFailureException - if the attempt to get a Connection failed

doCloseConnection

public static reactor.core.publisher.Mono<Void> doCloseConnection(Connection connection,
                                                                  @Nullable
                                                                  ConnectionFactory connectionFactory)

Deprecated.

Close the Connection, unless a SmartConnectionFactory doesn't want us to.

Parameters:

connection - the Connection to close if necessary.

connectionFactory - the ConnectionFactory that the Connection was obtained from.

See Also:

Connection.close(), SmartConnectionFactory.shouldClose(Connection)

currentConnectionFactory

public static reactor.core.publisher.Mono<ConnectionFactory> currentConnectionFactory(ConnectionFactory connectionFactory)

Deprecated.

Obtain the ConnectionFactory from the current subscriber Context.

Parameters:

connectionFactory - the ConnectionFactory that the Connection was obtained from.

See Also:

TransactionSynchronizationManager

getTargetConnection

public static Connection getTargetConnection(Connection con)

Deprecated.

Return the innermost target Connection of the given Connection. If the given Connection is a proxy, it will be unwrapped until a non-proxy Connection is found. Otherwise, the passed-in Connection will be returned as-is.

Parameters:

con - the Connection proxy to unwrap

Returns:

the innermost target Connection, or the passed-in one if no proxy

See Also:

ConnectionProxy.getTargetConnection()