Module org.tquadrat.foundation.sql

Package org.tquadrat.foundation.sql

Class StaticConnectionProvider

java.lang.Object

org.tquadrat.foundation.sql.StaticConnectionProvider

All Implemented Interfaces:

ConnectionProvider

@ClassVersion(sourceVersion="$Id: StaticConnectionProvider.java 1075 2023-10-02 12:37:07Z tquadrat $")
@API(status=STABLE,
     since="0.1.0")
public final class StaticConnectionProvider
extends Object
implements ConnectionProvider

An implementation of ConnectionProvider that returns always the same Connection instance.

This connection provider should not be used for production purposes! It will not allow the connection to be closed, the database session remains open for its whole lifetime. In addition, it is by no means thread-safe!

It can be used for testing purposes, or when the database access is needed for a very short period of.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: StaticConnectionProvider.java 1075 2023-10-02 12:37:07Z tquadrat $

Since:

0.1.0

UML Diagram

⁠

UML Diagram for "org.tquadrat.foundation.sql.StaticConnectionProvider"

⁠

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private final class	StaticConnectionProvider.UncloseableConnection	An implementation of Connection that replaces the implementation of the method StaticConnectionProvider.UncloseableConnection.close() by a dummy that does nothing.

Field Summary

Fields

Modifier and Type	Field	Description
private final Connection	m_Connection	The connection.

Constructor Summary

Constructors

Constructor	Description
StaticConnectionProvider(Connection connection)	Creates a new instance of StaticConnectionProvider.

Method Summary

Modifier and Type	Method	Description
final Status<Connection,Throwable>	getConnection()	Returns a valid database connection.

Methods inherited from class java.lang.Object

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

Field Details

m_Connection

private final Connection m_Connection

The connection.

Constructor Details

StaticConnectionProvider

public StaticConnectionProvider(Connection connection)

Creates a new instance of StaticConnectionProvider.

The provided connection must be open and valid, although this will not be checked here.

Parameters:

connection - The connection that is returned by each call to

Method Details

getConnection

public final Status<Connection,Throwable> getConnection()

Returns a valid database connection.

In case of an error, the method will set the errorCode attribute of the returned Status object.

Specified by:

getConnection in interface ConnectionProvider

Returns:

An instance of Status that holds the retrieved connection.