org.springframework.data.r2dbc.connectionfactory

Class SingleConnectionConnectionFactory

java.lang.Object

org.springframework.data.r2dbc.connectionfactory.DelegatingConnectionFactory

org.springframework.data.r2dbc.connectionfactory.SingleConnectionConnectionFactory

All Implemented Interfaces:

ConnectionFactory, Wrapped<ConnectionFactory>, DisposableBean, SmartConnectionFactory

public class SingleConnectionConnectionFactory
extends DelegatingConnectionFactory
implements SmartConnectionFactory, DisposableBean

Implementation of SmartConnectionFactory that wraps a single R2DBC Connection which is not closed after use. Obviously, this is not multi-threading capable.

Note that at shutdown, someone should close the underlying Connection via the close() method. Client code will never call close on the Connection handle if it is SmartDataSource-aware (e.g. uses ConnectionFactoryUtils.releaseConnection(io.r2dbc.spi.Connection, ConnectionFactory)).

If client code will call Connection.close() in the assumption of a pooled Connection, like when using persistence tools, set "suppressClose" to "true". This will return a close-suppressing proxy instead of the physical Connection.

This is primarily intended for testing. For example, it enables easy testing outside an application server, for code that expects to work on a ConnectionFactory.

Author:

Mark Paluch

See Also:

create(), Connection.close(), ConnectionFactoryUtils.releaseConnection(io.r2dbc.spi.Connection, ConnectionFactory)

Constructor Summary

Constructors

Constructor and Description
SingleConnectionConnectionFactory(Connection target, ConnectionFactoryMetadata metadata, boolean suppressClose) Create a new SingleConnectionConnectionFactory with a given Connection and ConnectionFactoryMetadata.
SingleConnectionConnectionFactory(ConnectionFactory targetConnectionFactory) Constructor for bean-style configuration.
SingleConnectionConnectionFactory(String url, boolean suppressClose) Create a new SingleConnectionConnectionFactory using a R2DBC connection URL.

Method Summary

Modifier and Type	Method and Description
reactor.core.publisher.Mono<? extends Connection>	create()
void	destroy() Close the underlying Connection.
protected Boolean	getAutoCommitValue() Return whether the returned Connection's "autoCommit" setting should be overridden.
protected Connection	getCloseSuppressingConnectionProxy(Connection target) Wrap the given Connection with a proxy that delegates every method call to it but suppresses close calls.
protected boolean	isSuppressClose() Return whether the returned Connection will be a close-suppressing proxy or the physical Connection.
protected reactor.core.publisher.Mono<Connection>	prepareConnection(Connection connection) Prepare the Connection before using it.
reactor.core.publisher.Mono<Void>	resetConnection() Reset the underlying shared Connection, to be reinitialized on next access.
void	setAutoCommit(boolean autoCommit) Set whether the returned Connection's "autoCommit" setting should be overridden.
void	setSuppressClose(boolean suppressClose) Set whether the returned Connection should be a close-suppressing proxy or the physical Connection.
boolean	shouldClose(Connection con) This is a single Connection: Do not close it when returning to the "pool".

Methods inherited from class org.springframework.data.r2dbc.connectionfactory.DelegatingConnectionFactory

getMetadata, getTargetConnectionFactory, obtainTargetConnectionFactory, unwrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.r2dbc.spi.ConnectionFactory

getMetadata

Constructor Detail

SingleConnectionConnectionFactory

public SingleConnectionConnectionFactory(ConnectionFactory targetConnectionFactory)

Constructor for bean-style configuration.

SingleConnectionConnectionFactory

public SingleConnectionConnectionFactory(String url,
                                         boolean suppressClose)

Create a new SingleConnectionConnectionFactory using a R2DBC connection URL.

Parameters:

url - the R2DBC URL to use for accessing ConnectionFactory discovery.

suppressClose - if the returned Connection should be a close-suppressing proxy or the physical Connection.

See Also:

ConnectionFactories.get(String)

SingleConnectionConnectionFactory

public SingleConnectionConnectionFactory(Connection target,
                                         ConnectionFactoryMetadata metadata,
                                         boolean suppressClose)

Create a new SingleConnectionConnectionFactory with a given Connection and ConnectionFactoryMetadata.

Parameters:

target - underlying target Connection.

metadata - ConnectionFactory metadata to be associated with this ConnectionFactory.

suppressClose - if the Connection should be wrapped with a Connection that suppresses close() calls (to allow for normal close() usage in applications that expect a pooled Connection but do not know our SmartConnectionFactory interface).

Method Detail

setSuppressClose

public void setSuppressClose(boolean suppressClose)

Set whether the returned Connection should be a close-suppressing proxy or the physical Connection.

isSuppressClose

protected boolean isSuppressClose()

Return whether the returned Connection will be a close-suppressing proxy or the physical Connection.

setAutoCommit

public void setAutoCommit(boolean autoCommit)

Set whether the returned Connection's "autoCommit" setting should be overridden.

getAutoCommitValue

@Nullable
protected Boolean getAutoCommitValue()

Return whether the returned Connection's "autoCommit" setting should be overridden.

Returns:

the "autoCommit" value, or null if none to be applied

create

public reactor.core.publisher.Mono<? extends Connection> create()

Specified by:

create in interface ConnectionFactory

Overrides:

create in class DelegatingConnectionFactory

shouldClose

public boolean shouldClose(Connection con)

This is a single Connection: Do not close it when returning to the "pool".

Specified by:

shouldClose in interface SmartConnectionFactory

Parameters:

con - the Connection to check.

Returns:

whether the given Connection should be closed.

See Also:

Connection.close()

destroy

public void destroy()

Close the underlying Connection. The provider of this ConnectionFactory needs to care for proper shutdown.

As this bean implements DisposableBean, a bean factory will automatically invoke this on destruction of its cached singletons.

Specified by:

destroy in interface DisposableBean

resetConnection

public reactor.core.publisher.Mono<Void> resetConnection()

Reset the underlying shared Connection, to be reinitialized on next access.

prepareConnection

protected reactor.core.publisher.Mono<Connection> prepareConnection(Connection connection)

Prepare the Connection before using it. Applies auto-commit settings if configured.

Parameters:

connection - the requested Connection.

Returns:

the prepared Connection.

getCloseSuppressingConnectionProxy

protected Connection getCloseSuppressingConnectionProxy(Connection target)

Wrap the given Connection with a proxy that delegates every method call to it but suppresses close calls.

Parameters:

target - the original Connection to wrap.

Returns:

the wrapped Connection.