Class DB2UniversalDataStoreHelper

All Implemented Interfaces:
DataStoreHelper
Direct Known Subclasses:
InformixJccDataStoreHelper

public class DB2UniversalDataStoreHelper extends DB2DataStoreHelper
DB2UniversalDataStoreHelper is a DataStoreHelper implementation customized for the DB2 Universal JDBC driver. When mapping a SQLException, the SQLException mappings from the DB2UniversalDataStoreHelper are searched first. If no match is found, the SQLException mappings from the DB2DataStoreHelper are searched. If still no match is found, the SQLException mappings from the GenericDataStoreHelper are searched. If you have additional requirements on DB2 you should consider subclassing this implementation.
Note: This class and its methods can not be called or referenced directly by user applications.

SQLException mappings specific to the DB2UniversalDataStoreHelper are the following:

Error CodeSQL StatePortableSQLException subclass
-4498StaleConnectionException.class
-4499StaleConnectionException.class
-1776StaleConnectionException.class
  • Constructor Details

    • DB2UniversalDataStoreHelper

      public DB2UniversalDataStoreHelper(Properties props)
      This DB2UniversalDataStoreHelper constructor creates a new DB2UniversalDataStoreHelper based on the DataStoreHelper properties provided. All implementations inheriting from a data store helper must supply this same list of properties to their super class by invoking the constructor of their super class with the list of properties.
      Parameters:
      props - DataStoreHelper properties.
  • Method Details

    • getPrintWriter

      public PrintWriter getPrintWriter()
      This method is used to obtain the log writer to set on the DataSource when database logging is enabled (for example: WAS.database=all=enabled). By default, null is returned and a java.io.PrintWriter instance created by WebSphere is used. You can override this method to return a different java.io.PrintWriter instance instead of the default.
      Specified by:
      getPrintWriter in interface DataStoreHelper
      Overrides:
      getPrintWriter in class DB2DataStoreHelper
      Returns:
      java.io.PrintWriter.
    • getDriverType

      public final int getDriverType()
      This method returns the driverType which is defined for the DB2 Universal JDBC driver.
      Returns:
      driverType - possible value : 2 , 4
    • doStatementCleanup

      public void doStatementCleanup(PreparedStatement stmt) throws SQLException

      This method cleans up a statement before the statement is returned to the statement cache. This method is called only for statements being cached. It is called when at least one of the following statement properties has changed,

      • cursorName
      • fetchDirection
      • maxFieldSize
      • maxRows
      • queryTimeout

      DB2DataStoreHelper resets all of the statement properties listed above

      The following operations do not need to be included in the statement cleanup since they are automatically performed by WebSphere when caching statements:

      • setFetchSize(0)
      • clearParameters()
      • clearWarnings()

      A helper class implementing this method can choose to do additional cleanup for the statement. However, this must never include closing the statement, since the statement is intended to be cached.

      Specified by:
      doStatementCleanup in interface DataStoreHelper
      Overrides:
      doStatementCleanup in class DB2DataStoreHelper
      Parameters:
      stmt - the PreparedStatement.
      Throws:
      SQLException - if an error occurs cleaning up the statement.