Package com.ibm.fhir.persistence.jdbc.dao.impl

Class ParameterDAOImpl

java.lang.Object

com.ibm.fhir.persistence.jdbc.dao.impl.FHIRDbDAOImpl

com.ibm.fhir.persistence.jdbc.dao.impl.ParameterDAOImpl

All Implemented Interfaces:

FHIRDbDAO, ParameterDAO

public class ParameterDAOImpl
extends FHIRDbDAOImpl
implements ParameterDAO

This Data Access Object implements the ParameterDAO interface for creating, updating, and retrieving rows in the IBM FHIR Server parameter-related tables.

Constructor Summary

Constructors

Constructor	Description
ParameterDAOImpl(java.sql.Connection connection, java.lang.String schemaName, FHIRDbFlavor flavor)	Constructs a DAO using the passed externally managed database connection.
ParameterDAOImpl(java.sql.Connection connection, java.lang.String schemaName, FHIRDbFlavor flavor, javax.transaction.TransactionSynchronizationRegistry trxSynchRegistry)	Constructs a DAO instance suitable for acquiring connections from a JDBC Datasource object.

Method Summary

Modifier and Type	Method	Description
int	acquireParameterNameId(java.lang.String parameterName)	Acquire and return the id associated with the passed parameter name.
java.util.Map<java.lang.String,java.lang.Integer>	readAllCodeSystems()	Reads all rows in the Code_Systems table and returns the data as a Map
java.util.Map<java.lang.String,java.lang.Integer>	readAllSearchParameterNames()	Reads all rows in the Parameter_Names table and returns the data as a Map
java.lang.Integer	readCodeSystemId(java.lang.String codeSystemName)	Read the id for the given code system name, but do not create a new record if it doesn't exist.
int	readOrAddCodeSystemId(java.lang.String codeSystemName)	Calls a stored procedure to read the system contained in the passed Parameter in the Code_Systems table.
int	readOrAddParameterNameId(java.lang.String parameterName)	Calls a stored procedure to read the name contained in the passed Parameter in the Parameter_Names table.
java.lang.Integer	readParameterNameId(java.lang.String parameterName)	Read the id for the given parameter name, but do not create a new record if it doesn't exist.

Methods inherited from class com.ibm.fhir.persistence.jdbc.dao.impl.FHIRDbDAOImpl

buildExceptionWithIssue, buildFHIRPersistenceDBConnectException, cleanup, cleanup, createDTO, createDTOs, getConnection, getFlavor, getSchemaName, getTranslator, isDb2Database, runCountQuery, runCountQuery, runQuery, runQuery, runQuery_STR_VALUES, severe, severe

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.ibm.fhir.persistence.jdbc.dao.api.FHIRDbDAO

getConnection, getFlavor, isDb2Database

Constructor Detail

ParameterDAOImpl

public ParameterDAOImpl(java.sql.Connection connection,
                        java.lang.String schemaName,
                        FHIRDbFlavor flavor,
                        javax.transaction.TransactionSynchronizationRegistry trxSynchRegistry)

Constructs a DAO instance suitable for acquiring connections from a JDBC Datasource object.

Parameters:

Connection - - A database connection that will be managed by the caller.

schemaName -

flavor -

trxSynchRegistry -

ParameterDAOImpl

public ParameterDAOImpl(java.sql.Connection connection,
                        java.lang.String schemaName,
                        FHIRDbFlavor flavor)

Constructs a DAO using the passed externally managed database connection. The connection used by this instance for all DB operations will be the passed connection.

Parameters:

Connection - - A database connection that will be managed by the caller.

schemaName -

flavor -

Method Detail

readAllSearchParameterNames

public java.util.Map<java.lang.String,java.lang.Integer> readAllSearchParameterNames()
                                                                                    throws FHIRPersistenceDBConnectException,
                                                                                           FHIRPersistenceDataAccessException

Description copied from interface: ParameterDAO

Reads all rows in the Parameter_Names table and returns the data as a Map

Specified by:

readAllSearchParameterNames in interface ParameterDAO

Returns:

Map - A map containing key=parameter-name, value=parameter-name-id

Throws:

FHIRPersistenceDBConnectException

FHIRPersistenceDataAccessException

readAllCodeSystems

public java.util.Map<java.lang.String,java.lang.Integer> readAllCodeSystems()
                                                                           throws FHIRPersistenceDBConnectException,
                                                                                  FHIRPersistenceDataAccessException

Description copied from interface: ParameterDAO

Reads all rows in the Code_Systems table and returns the data as a Map

Specified by:

readAllCodeSystems in interface ParameterDAO

Returns:

Map - A map containing key=system-name, value=system-id

Throws:

FHIRPersistenceDBConnectException

FHIRPersistenceDataAccessException

readOrAddParameterNameId

public int readOrAddParameterNameId(java.lang.String parameterName)
                             throws FHIRPersistenceDBConnectException,
                                    FHIRPersistenceDataAccessException

Calls a stored procedure to read the name contained in the passed Parameter in the Parameter_Names table. If it's not in the DB, it will be stored and a unique id will be returned.

Specified by:

readOrAddParameterNameId in interface ParameterDAO

Parameters:

parameter -

Returns:

Integer - The generated id of the stored system.

Throws:

FHIRPersistenceDBConnectException

FHIRPersistenceDataAccessException

readOrAddCodeSystemId

public int readOrAddCodeSystemId(java.lang.String codeSystemName)
                          throws FHIRPersistenceDBConnectException,
                                 FHIRPersistenceDataAccessException

Calls a stored procedure to read the system contained in the passed Parameter in the Code_Systems table. If it's not in the DB, it will be stored and a unique id will be returned.

Specified by:

readOrAddCodeSystemId in interface ParameterDAO

Parameters:

parameter -

Returns:

Integer - The generated id of the stored system.

Throws:

FHIRPersistenceDBConnectException

FHIRPersistenceDataAccessException

FHIRPersistenceException

acquireParameterNameId

public int acquireParameterNameId(java.lang.String parameterName)
                           throws FHIRPersistenceException

Acquire and return the id associated with the passed parameter name. Being called here means that we've already had a cache miss in the JDBCIdentityCache

Specified by:

acquireParameterNameId in interface ParameterDAO

Parameters:

parameterName - The name of a valid FHIR search parameter.

Returns:

Integer A parameter id.

Throws:

FHIRPersistenceException

readParameterNameId

public java.lang.Integer readParameterNameId(java.lang.String parameterName)
                                      throws FHIRPersistenceDBConnectException,
                                             FHIRPersistenceDataAccessException

Description copied from interface: ParameterDAO

Read the id for the given parameter name, but do not create a new record if it doesn't exist.

Specified by:

readParameterNameId in interface ParameterDAO

Returns:

the id for the parameter name, or null not found

Throws:

FHIRPersistenceDBConnectException

FHIRPersistenceDataAccessException

readCodeSystemId

public java.lang.Integer readCodeSystemId(java.lang.String codeSystemName)
                                   throws FHIRPersistenceDBConnectException,
                                          FHIRPersistenceDataAccessException

Description copied from interface: ParameterDAO

Read the id for the given code system name, but do not create a new record if it doesn't exist.

Specified by:

readCodeSystemId in interface ParameterDAO

Returns:

Integer - The id associated with the passed code system name, or null if it doesn't exist

Throws:

FHIRPersistenceDBConnectException

FHIRPersistenceDataAccessException