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

Class FHIRDbTenantDatasourceConnectionStrategy

java.lang.Object

org.linuxforhealth.fhir.persistence.jdbc.connection.FHIRDbConnectionStrategyBase

org.linuxforhealth.fhir.persistence.jdbc.connection.FHIRDbTenantDatasourceConnectionStrategy

All Implemented Interfaces:

FHIRDbConnectionStrategy, QueryHints

public class FHIRDbTenantDatasourceConnectionStrategy
extends FHIRDbConnectionStrategyBase

Hides the logic behind obtaining a JDBC Connection from the DAO code. Uses datasource and tenant ids configured in the fhir-server-config to map directly to a managed datasource. All managed datasources must be available when the server starts. This differs from the proxy datasource strategy FHIRDbPropsConnectionStrategy which supports dynamic (programmatic) definition of managed datasources.

Constructor Summary

Constructors

Constructor	Description
FHIRDbTenantDatasourceConnectionStrategy(javax.transaction.TransactionSynchronizationRegistry trxSyncRegistry, Action newConnectionAction, boolean enableReadOnlyReplicas)	Public constructor.

Method Summary

Modifier and Type	Method	Description
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
static java.lang.String	makeTenantDatasourceJNDIName(java.lang.String jndiBase, java.lang.String tenantId, java.lang.String dsId, boolean readOnly)

Methods inherited from class org.linuxforhealth.fhir.persistence.jdbc.connection.FHIRDbConnectionStrategyBase

applySearchOptimizerOptions, configure, getConnection, getHintValue, getQueryHints

Methods inherited from class java.lang.Object

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

Constructor Detail

FHIRDbTenantDatasourceConnectionStrategy

public FHIRDbTenantDatasourceConnectionStrategy(javax.transaction.TransactionSynchronizationRegistry trxSyncRegistry,
                                                Action newConnectionAction,
                                                boolean enableReadOnlyReplicas)
                                         throws FHIRException

Public constructor. The proxy datasource must be present (registered in JNDI) at server startup.

Throws:

FHIRPersistenceDBConnectException - if the proxy datasource is not configured

FHIRException

Method Detail

makeTenantDatasourceJNDIName

public static java.lang.String makeTenantDatasourceJNDIName(java.lang.String jndiBase,
                                                            java.lang.String tenantId,
                                                            java.lang.String dsId,
                                                            boolean readOnly)

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

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

Overrides:

getFlavor in class FHIRDbConnectionStrategyBase

Returns:

the datastore/source flavor from the FHIR configuration

Throws:

FHIRPersistenceDataAccessException - if there is an issue with the configuration