DBSynchronizer (GemFire XD Java API Documentation)

java.lang.Object
- com.pivotal.gemfirexd.callbacks.DBSynchronizer

All Implemented Interfaces:

AsyncEventListener
```
public class DBSynchronizer
extends Object
implements AsyncEventListener
```
DBSynchronizer class instance persists the GemFireXD operations to an external database having a JDBC driver.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`DBSynchronizer.SqlExceptionHandler` Enumeration that defines the action to be performed in case an exception is received during processing by `processEvents(List)`

Field Summary

Fields
Modifier and Type	Field and Description
`protected HashMap<String,PreparedStatement>`	`bulkOpStmntMap` the cached `PreparedStatement`s for other non-primary key based DML operations
`protected Connection`	`conn` the current JDBC connection being used by this instance
`protected static String`	`DBDRIVER`
`protected String`	`dbUrl` the JDBC connection URL for the external database
`protected static String`	`DBURL`
`protected static int`	`DEFAULT_ERROR_TRIES` default number of retries after an error is 3 when `errorFile` is defined
`protected HashMap<String,PreparedStatement>`	`deleteStmntMap` the cached `PreparedStatement`s for primary key based deletes
`protected Driver`	`driver` the `Driver` implementation instance loaded using the `driverClass`
`protected String`	`driverClass` fully qualified name of the implementation class of the JDBC `Driver` interface
`protected String`	`errorFile` file to write errors
`protected static String`	`ERRORFILE`
`protected static String`	`ERRORTRIES`
`protected ConcurrentSkipListMap<com.pivotal.gemfirexd.callbacks.DBSynchronizer.ErrorEvent,Object[]>`	`errorTriesMap` keeps track of the retries that have been done for an event
`protected static String`	`Gfxd_DB_SYNCHRONIZER__1`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__10`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__11`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__12`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__13`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__2`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__3`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__4`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__5`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__6`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__7`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__8`
`protected static String`	`Gfxd_DB_SYNCHRONIZER__9`
`protected AsyncEventHelper`	`helper`
`protected HashMap<String,PreparedStatement>`	`insertStmntMap` the cached `PreparedStatement`s for inserts
`protected static byte`	`JDBC4DRIVER_FALSE` if it is known that the driver is not JDBC4 compliant for BLOB/CLOB related API
`protected static byte`	`JDBC4DRIVER_TRUE` if it is known that the driver is JDBC4 compliant for BLOB/CLOB related API
`protected static byte`	`JDBC4DRIVER_UNKNOWN` if it is unknown whether the driver is JDBC4 compliant for BLOB/CLOB related API
`protected int`	`keySize` the key size of the algorithm being used for encrypted the password
`protected static String`	`KEYSIZE`
`protected Logger`	`logger`
`protected HashMap<String,TableMetaData>`	`metadataMap` the map of table name to its current metadata object
`protected int`	`numErrorTries` number of retries after an error before dumping to `errorFile`
`protected String`	`passwd` password for the user to use for establishing JDBC connection
`protected static String`	`PASSWORD`
`protected HashMap<String,ResultSetMetaData>`	`pkMetadataMap` the map of table name to its current primary key metadata object
`protected static String`	`SECRET`
`protected boolean`	`shutDown` true if this instance has been closed or not initialized
`protected static String`	`SKIP_IDENTITY_COLUMNS`
`protected boolean`	`skipIdentityColumns` if true then skip identity columns in sync else also set the values of identity columns as in GemFireXD
`protected boolean`	`traceDBSynchronizer` true if "TraceDBSynchronizer" debug flag is enabled in this GemFireXD instance (via gemfirexd.debug.true=TraceDBSynchronizer).
`protected boolean`	`traceDBSynchronizerHA` true if "TraceDBSynchronizer" debug flag is enabled in this GemFireXD instance (via gemfirexd.debug.true=TraceDBSynchronizer).
`protected String`	`transformation` the transformation (e.g.
`protected static String`	`TRANSFORMATION`
`protected HashMap<String,PreparedStatement>`	`updtStmntMap` the cached `PreparedStatement`s for primary key based updates
`protected static String`	`USER`
`protected String`	`userName` user name to use for establishing JDBC connection

Constructor Summary

Constructors
Constructor and Description

DBSynchronizer()

Constructors
Constructor and Description
`DBSynchronizer()`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`basicClose()` Basic actions to be performed to close the `DBSynchronizer` instance though the instance will itself not be marked as having shut down.
`protected DBSynchronizer.SqlExceptionHandler`	`checkExceptionString(String message, DBSynchronizer.SqlExceptionHandler defaultHandler)`
`protected DBSynchronizer.SqlExceptionHandler`	`checkExceptionType(SQLException sqle)`
`void`	`close()` Close this `DBSynchronizer` instance.
`protected void`	`closeStatements(Map<String,PreparedStatement> psMap)`
`protected PreparedStatement`	`getExecutableDeletePrepStmntPKBased(Event pkEvent, PreparedStatement prevPS)` Get or create a `PreparedStatement` for a primary key based delete operation.
`protected PreparedStatement`	`getExecutableInsertPrepStmntPKBased(Event pkEvent, PreparedStatement prevPS)` Get or create a `PreparedStatement` for an insert operation.
`protected PreparedStatement`	`getExecutablePrepStmntBulkOp(Event event, PreparedStatement prevPS)` Get or create a `PreparedStatement` for a `Event.Type.isBulkOperation()` type of operation.
`protected PreparedStatement`	`getExecutableUpdatePrepStmntPKBased(Event pkEvent, PreparedStatement prevPS)` Get or create a `PreparedStatement` for a primary key based update operation.
`protected DBSynchronizer.SqlExceptionHandler`	`handleSQLException(SQLException sqle)` Returns an `DBSynchronizer.SqlExceptionHandler` for the given `SQLException`.
`protected DBSynchronizer.SqlExceptionHandler`	`handleSQLException(SQLException sqle, String format, Statement stmt, Event event, String eventString, Logger logger, boolean logWarning)` Log exception including stack traces for fine logging with `traceDBSynchronizer`, and returns an `DBSynchronizer.SqlExceptionHandler` for the given `SQLException`.
`void`	`init(String initParamStr)` Initialize this `DBSynchronizer` instance, creating a new JDBC connection to the backend database as per the provided parameter. The recommended format of the parameter string is: file=<path> The file is a properties file specifying the driver, JDBC URL, user and password. Driver=<driver-class> URL=<JDBC URL> User=<user name> Secret=<encrypted password> Transformation=<transformation for the encryption cipher> KeySize=<size of the private key to use for encryption> -- OR -- Password=<password> The password provided in the "Secret" property should be an encrypted one generated using the "gfxd encrypt-password external" command, else the "Password" property can be used to specify the password in plain-text.
`protected void`	`initConnection()`
`protected void`	`inlineInit(String initParamStr)`
`protected void`	`instantiateConnection()`
`protected boolean`	`isArgPresent(String s, String prefix, StringBuilder extracted)`
`protected byte`	`isJDBC4Driver()` Return `JDBC4DRIVER_TRUE` if this driver is known to be JDBC4 compliant for LOB support, `JDBC4DRIVER_FALSE` if it is known to not be JDBC4 compliant and `JDBC4DRIVER_UNKNOWN` if the status is unknown.
`protected static String`	`maskPassword(String dbUrl)` mask the known password patterns from URL for exception/log messages
`boolean`	`processEvents(List<Event> events)` Process the list of `Event`s.
`protected void`	`setJDBC4Driver(byte status)` Set the JDBC4 status of this driver as per `isJDBC4Driver()`.
`protected void`	`setKeysInPrepStatement(ResultSet pkValues, ResultSetMetaData pkMetaData, PreparedStatement ps, int startIndex)` Set the key column values in `PreparedStatement` for a primary key based update or delete operation.
`protected boolean`	`skipIdentityColumns()` Returns true if this DBSynchronizer has been configured to skip IDENTITY column values when syncing to backend database (the default behaviour) and false if IDENTITY column values from GemFireXD should also be synced
`void`	`start()` This is invoked just prior to starting the async invocation thread for processing the events.
`protected String`	`trimIgnoreCase(String s, String prefix)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - dbUrl
```
protected String dbUrl
```
    the JDBC connection URL for the external database
  - userName
```
protected String userName
```
    user name to use for establishing JDBC connection
  - passwd
```
protected String passwd
```
    password for the user to use for establishing JDBC connection
  - errorFile
```
protected String errorFile
```
    file to write errors
  - numErrorTries
```
protected int numErrorTries
```
    number of retries after an error before dumping to errorFile
  - DEFAULT_ERROR_TRIES
```
protected static final int DEFAULT_ERROR_TRIES
```
    default number of retries after an error is 3 when errorFile is defined
    
    See Also:
    Constant Field Values
  - transformation
```
protected String transformation
```
    the transformation (e.g. AES/ECB/PKCS5Padding or Blowfish) to use for encrypting the password
  - keySize
```
protected int keySize
```
    the key size of the algorithm being used for encrypted the password
  - driverClass
```
protected String driverClass
```
    fully qualified name of the implementation class of the JDBC Driver interface
  - driver
```
protected Driver driver
```
    the Driver implementation instance loaded using the driverClass
  - conn
```
protected Connection conn
```
    the current JDBC connection being used by this instance
  - JDBC4DRIVER_UNKNOWN
```
protected static final byte JDBC4DRIVER_UNKNOWN
```
    if it is unknown whether the driver is JDBC4 compliant for BLOB/CLOB related API
    
    See Also:
    Constant Field Values
  - JDBC4DRIVER_FALSE
```
protected static final byte JDBC4DRIVER_FALSE
```
    if it is known that the driver is not JDBC4 compliant for BLOB/CLOB related API
    
    See Also:
    Constant Field Values
  - JDBC4DRIVER_TRUE
```
protected static final byte JDBC4DRIVER_TRUE
```
    if it is known that the driver is JDBC4 compliant for BLOB/CLOB related API
    
    See Also:
    Constant Field Values
  - shutDown
```
protected volatile boolean shutDown
```
    true if this instance has been closed or not initialized
  - helper
```
protected final AsyncEventHelper helper
```
  - logger
```
protected final Logger logger
```
  - traceDBSynchronizer
```
protected boolean traceDBSynchronizer
```
    true if "TraceDBSynchronizer" debug flag is enabled in this GemFireXD instance (via gemfirexd.debug.true=TraceDBSynchronizer).
  - traceDBSynchronizerHA
```
protected boolean traceDBSynchronizerHA
```
    true if "TraceDBSynchronizer" debug flag is enabled in this GemFireXD instance (via gemfirexd.debug.true=TraceDBSynchronizer).
  - insertStmntMap
```
protected final HashMap<String,PreparedStatement> insertStmntMap
```
    the cached PreparedStatements for inserts
  - updtStmntMap
```
protected final HashMap<String,PreparedStatement> updtStmntMap
```
    the cached PreparedStatements for primary key based updates
  - deleteStmntMap
```
protected final HashMap<String,PreparedStatement> deleteStmntMap
```
    the cached PreparedStatements for primary key based deletes
  - metadataMap
```
protected final HashMap<String,TableMetaData> metadataMap
```
    the map of table name to its current metadata object
  - pkMetadataMap
```
protected final HashMap<String,ResultSetMetaData> pkMetadataMap
```
    the map of table name to its current primary key metadata object
  - bulkOpStmntMap
```
protected final HashMap<String,PreparedStatement> bulkOpStmntMap
```
    the cached PreparedStatements for other non-primary key based DML operations
  - skipIdentityColumns
```
protected boolean skipIdentityColumns
```
    if true then skip identity columns in sync else also set the values of identity columns as in GemFireXD
  - DBDRIVER
```
protected static final String DBDRIVER
```
    See Also:
    Constant Field Values
  - DBURL
```
protected static final String DBURL
```
    See Also:
    Constant Field Values
  - USER
```
protected static final String USER
```
    See Also:
    Constant Field Values
  - PASSWORD
```
protected static final String PASSWORD
```
    See Also:
    Constant Field Values
  - SECRET
```
protected static final String SECRET
```
    See Also:
    Constant Field Values
  - TRANSFORMATION
```
protected static final String TRANSFORMATION
```
    See Also:
    Constant Field Values
  - KEYSIZE
```
protected static final String KEYSIZE
```
    See Also:
    Constant Field Values
  - ERRORFILE
```
protected static final String ERRORFILE
```
    See Also:
    Constant Field Values
  - ERRORTRIES
```
protected static final String ERRORTRIES
```
    See Also:
    Constant Field Values
  - SKIP_IDENTITY_COLUMNS
```
protected static final String SKIP_IDENTITY_COLUMNS
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__1
```
protected static final String Gfxd_DB_SYNCHRONIZER__1
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__2
```
protected static final String Gfxd_DB_SYNCHRONIZER__2
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__3
```
protected static final String Gfxd_DB_SYNCHRONIZER__3
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__4
```
protected static final String Gfxd_DB_SYNCHRONIZER__4
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__5
```
protected static final String Gfxd_DB_SYNCHRONIZER__5
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__6
```
protected static final String Gfxd_DB_SYNCHRONIZER__6
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__7
```
protected static final String Gfxd_DB_SYNCHRONIZER__7
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__8
```
protected static final String Gfxd_DB_SYNCHRONIZER__8
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__9
```
protected static final String Gfxd_DB_SYNCHRONIZER__9
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__10
```
protected static final String Gfxd_DB_SYNCHRONIZER__10
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__11
```
protected static final String Gfxd_DB_SYNCHRONIZER__11
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__12
```
protected static final String Gfxd_DB_SYNCHRONIZER__12
```
    See Also:
    Constant Field Values
  - Gfxd_DB_SYNCHRONIZER__13
```
protected static final String Gfxd_DB_SYNCHRONIZER__13
```
    See Also:
    Constant Field Values
  - errorTriesMap
```
protected final ConcurrentSkipListMap<com.pivotal.gemfirexd.callbacks.DBSynchronizer.ErrorEvent,Object[]> errorTriesMap
```
    keeps track of the retries that have been done for an event
- Constructor Detail
  - DBSynchronizer
```
public DBSynchronizer()
```
- Method Detail
  - close
```
public void close()
```
    Close this DBSynchronizer instance. To prevent a possible concurrency issue between closing thread & the processor thread, access to this method is synchronized on 'this'
    
    Specified by:
    
    close in interface AsyncEventListener
  - basicClose
```
public final void basicClose()
```
    Basic actions to be performed to close the DBSynchronizer instance though the instance will itself not be marked as having shut down. To prevent a possible concurrency issue between closing thread & the processor thread, access to this method is synchronized on 'this'
  - isJDBC4Driver
```
protected final byte isJDBC4Driver()
```
    Return JDBC4DRIVER_TRUE if this driver is known to be JDBC4 compliant for LOB support, JDBC4DRIVER_FALSE if it is known to not be JDBC4 compliant and JDBC4DRIVER_UNKNOWN if the status is unknown.
  - setJDBC4Driver
```
protected final void setJDBC4Driver(byte status)
```
    Set the JDBC4 status of this driver as per isJDBC4Driver().
  - closeStatements
```
protected void closeStatements(Map<String,PreparedStatement> psMap)
```
  - init
```
public void init(String initParamStr)
```
    Initialize this DBSynchronizer instance, creating a new JDBC connection to the backend database as per the provided parameter.
    The recommended format of the parameter string is:
    file=<path>
    The file is a properties file specifying the driver, JDBC URL, user and password.
    Driver=<driver-class>
    URL=<JDBC URL>
    User=<user name>
    
    Secret=<encrypted password>
    Transformation=<transformation for the encryption cipher>
    KeySize=<size of the private key to use for encryption>
    -- OR --
    Password=<password>
    The password provided in the "Secret" property should be an encrypted one generated using the "gfxd encrypt-password external" command, else the "Password" property can be used to specify the password in plain-text. The "Transformation" and "KeySize" properties optionally specify the transformation and key size used for encryption else the defaults are used ("AES" and 128 respectively). User and password are optional and when not provided then JDBC URL will be used as is for connection. The above properties may also be provided inline like below:
    
    <driver-class>,<JDBC URL>[,<user>[,<password>|secret =<secret>][,transformation=<transformation>][,keysize=<key size>]
    
    The user and password parts are optional and can be possibly embedded in the JDBC URL itself. The password can be encrypted one generated using the "gfxd encrypt-password external" command in which case it should be prefixed with "secret=". It can also specify the transformation and keysize using the optional "transformation=..." and "keysize=..." properties.
    
    Specified by:
    
    init in interface AsyncEventListener
    
    Parameters:
    initParamStr - String containing initialisation parameters for the AsyncEventListener
  - inlineInit
```
protected void inlineInit(String initParamStr)
```
  - isArgPresent
```
protected boolean isArgPresent(String s,
                   String prefix,
                   StringBuilder extracted)
```
  - trimIgnoreCase
```
protected String trimIgnoreCase(String s,
                    String prefix)
```
  - initConnection
```
protected void initConnection()
```
  - instantiateConnection
```
protected void instantiateConnection()
```
  - maskPassword
```
protected static final String maskPassword(String dbUrl)
```
    mask the known password patterns from URL for exception/log messages
  - processEvents
```
public boolean processEvents(List<Event> events)
```
    Description copied from interface: AsyncEventListener
    
    Process the list of Events. This method will be invoked asynchronously when events are queued for processing. For AsyncEventListener, the Event.getOldRow() will always return null indicating that old value is not available. Event.getNewRow() will return the column values for a row created. For update operations it will only return meaningful values for modified columns and null for unmodified columns. The positions of columns modified can be obtained from Event.getModifiedColumns()
    
    Specified by:
    
    processEvents in interface AsyncEventListener
    
    Parameters:
    events - The list of Events to process
    
    Returns:
    whether the events were successfully processed. If returned false, the events will not be deleted from the internal queue.
  - getExecutablePrepStmntBulkOp
```
protected PreparedStatement getExecutablePrepStmntBulkOp(Event event,
                                             PreparedStatement prevPS)
                                                  throws SQLException
```
    Get or create a PreparedStatement for a Event.Type.isBulkOperation() type of operation.
    
    Throws:
    
    SQLException
  - getExecutableInsertPrepStmntPKBased
```
protected PreparedStatement getExecutableInsertPrepStmntPKBased(Event pkEvent,
                                                    PreparedStatement prevPS)
                                                         throws SQLException
```
    Get or create a PreparedStatement for an insert operation.
    
    Throws:
    
    SQLException
  - getExecutableDeletePrepStmntPKBased
```
protected PreparedStatement getExecutableDeletePrepStmntPKBased(Event pkEvent,
                                                    PreparedStatement prevPS)
                                                         throws SQLException
```
    Get or create a PreparedStatement for a primary key based delete operation.
    
    Throws:
    
    SQLException
  - getExecutableUpdatePrepStmntPKBased
```
protected PreparedStatement getExecutableUpdatePrepStmntPKBased(Event pkEvent,
                                                    PreparedStatement prevPS)
                                                         throws SQLException
```
    Get or create a PreparedStatement for a primary key based update operation.
    
    Throws:
    
    SQLException
  - setKeysInPrepStatement
```
protected void setKeysInPrepStatement(ResultSet pkValues,
                          ResultSetMetaData pkMetaData,
                          PreparedStatement ps,
                          int startIndex)
                               throws SQLException
```
    Set the key column values in PreparedStatement for a primary key based update or delete operation.
    
    Throws:
    
    SQLException
  - handleSQLException
```
protected DBSynchronizer.SqlExceptionHandler handleSQLException(SQLException sqle)
```
    Returns an DBSynchronizer.SqlExceptionHandler for the given SQLException.
  - checkExceptionType
```
protected DBSynchronizer.SqlExceptionHandler checkExceptionType(SQLException sqle)
```
  - checkExceptionString
```
protected DBSynchronizer.SqlExceptionHandler checkExceptionString(String message,
                                                      DBSynchronizer.SqlExceptionHandler defaultHandler)
```
  - handleSQLException
```
protected DBSynchronizer.SqlExceptionHandler handleSQLException(SQLException sqle,
                                                    String format,
                                                    Statement stmt,
                                                    Event event,
                                                    String eventString,
                                                    Logger logger,
                                                    boolean logWarning)
                                                         throws SQLException
```
    Log exception including stack traces for fine logging with traceDBSynchronizer, and returns an DBSynchronizer.SqlExceptionHandler for the given SQLException.
    
    Throws:
    
    SQLException
  - start
```
public void start()
```
    Description copied from interface: AsyncEventListener
    
    This is invoked just prior to starting the async invocation thread for processing the events. User can do any initialisation like creating the file handles etc , which would be used in processing of events.
    
    Specified by:
    
    start in interface AsyncEventListener
  - skipIdentityColumns
```
protected final boolean skipIdentityColumns()
```
    Returns true if this DBSynchronizer has been configured to skip IDENTITY column values when syncing to backend database (the default behaviour) and false if IDENTITY column values from GemFireXD should also be synced

Class DBSynchronizer

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

dbUrl

userName

passwd

errorFile

numErrorTries

DEFAULT_ERROR_TRIES

transformation

keySize

driverClass

driver

conn

JDBC4DRIVER_UNKNOWN

JDBC4DRIVER_FALSE

JDBC4DRIVER_TRUE

shutDown

helper

logger

traceDBSynchronizer

traceDBSynchronizerHA

insertStmntMap

updtStmntMap

deleteStmntMap

metadataMap

pkMetadataMap

bulkOpStmntMap

skipIdentityColumns

DBDRIVER

DBURL

USER

PASSWORD

SECRET

TRANSFORMATION

KEYSIZE

ERRORFILE

ERRORTRIES

SKIP_IDENTITY_COLUMNS

Gfxd_DB_SYNCHRONIZER__1

Gfxd_DB_SYNCHRONIZER__2

Gfxd_DB_SYNCHRONIZER__3

Gfxd_DB_SYNCHRONIZER__4

Gfxd_DB_SYNCHRONIZER__5

Gfxd_DB_SYNCHRONIZER__6

Gfxd_DB_SYNCHRONIZER__7

Gfxd_DB_SYNCHRONIZER__8

Gfxd_DB_SYNCHRONIZER__9

Gfxd_DB_SYNCHRONIZER__10

Gfxd_DB_SYNCHRONIZER__11

Gfxd_DB_SYNCHRONIZER__12

Gfxd_DB_SYNCHRONIZER__13

errorTriesMap

Constructor Detail

DBSynchronizer

Method Detail

close

basicClose

isJDBC4Driver

setJDBC4Driver

closeStatements

init

inlineInit

isArgPresent

trimIgnoreCase

initConnection

instantiateConnection

maskPassword

processEvents

getExecutablePrepStmntBulkOp

getExecutableInsertPrepStmntPKBased

getExecutableDeletePrepStmntPKBased

getExecutableUpdatePrepStmntPKBased

setKeysInPrepStatement

handleSQLException

checkExceptionType