Package org.linuxforhealth.fhir.persistence.jdbc.connection

Class FHIRDbTestConnectionStrategy

java.lang.Object

org.linuxforhealth.fhir.persistence.jdbc.connection.FHIRDbTestConnectionStrategy

All Implemented Interfaces:

FHIRDbConnectionStrategy

public class FHIRDbTestConnectionStrategy
extends java.lang.Object
implements FHIRDbConnectionStrategy

Hides the logic behind obtaining a JDBC Connection from the DAO code. This strategy object is local to a thread, and because we use the same underlying connection to our test database within a transaction, we only need to configure the connection once. We can track this initialization with nothing more complicated than a Boolean flag. Use by unit tests or other scenarios where connections are obtained using an IConnectionProvider implementation, outside the scope of a JEE container. For example, this is used when connecting to in-memory instances of Derby when running persistence layer unit-tests.

Constructor Summary

Constructors

Constructor	Description
FHIRDbTestConnectionStrategy(IConnectionProvider cp, Action action)	Public constructor

Method Summary

Modifier and Type	Method	Description
void	applySearchOptimizerOptions(java.sql.Connection c, boolean isCompartment)	Apply any optimizer options configured to improve search query performance See issue-1911 for details.
java.sql.Connection	getConnection()	Get a connection to the desired data source identified by the current FHIRRequestContext
FHIRDbFlavor	getFlavor()	Get the flavor of the database we are working with to reveal its capabilities
QueryHints	getQueryHints()	Append the given hint to FHIR search queries

Methods inherited from class java.lang.Object

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

Constructor Detail

FHIRDbTestConnectionStrategy

public FHIRDbTestConnectionStrategy(IConnectionProvider cp,
                                    Action action)

Public constructor

Parameters:

cp -

action -

Method Detail

getConnection

public java.sql.Connection getConnection()
                                  throws FHIRPersistenceDBConnectException

Description copied from interface: FHIRDbConnectionStrategy

Get a connection to the desired data source identified by the current FHIRRequestContext

Specified by:

getConnection in interface FHIRDbConnectionStrategy

Returns:

a Connection. Never null.

Throws:

FHIRPersistenceDBConnectException

getFlavor

public FHIRDbFlavor getFlavor()
                       throws FHIRPersistenceDataAccessException

Description copied from interface: FHIRDbConnectionStrategy

Get the flavor of the database we are working with to reveal its capabilities

Specified by:

getFlavor in interface FHIRDbConnectionStrategy

Returns:

the datastore/source flavor from the FHIR configuration

Throws:

FHIRPersistenceDataAccessException - if there is an issue with the configuration

getQueryHints

public QueryHints getQueryHints()

Description copied from interface: FHIRDbConnectionStrategy

Append the given hint to FHIR search queries

Specified by:

getQueryHints in interface FHIRDbConnectionStrategy

Returns:

applySearchOptimizerOptions

public void applySearchOptimizerOptions(java.sql.Connection c,
                                        boolean isCompartment)

Description copied from interface: FHIRDbConnectionStrategy

Apply any optimizer options configured to improve search query performance See issue-1911 for details.

Specified by:

applySearchOptimizerOptions in interface FHIRDbConnectionStrategy

Parameters:

c - the connection to be configured

isCompartment - true if the query is a compartment-based search