类 SQLErrorCodeSQLExceptionTranslator

构造器详细资料

• SQLErrorCodeSQLExceptionTranslator

  public SQLErrorCodeSQLExceptionTranslator()

  Constructor for use as a JavaBean. The SqlErrorCodes or DataSource property must be set.

• SQLErrorCodeSQLExceptionTranslator

  public SQLErrorCodeSQLExceptionTranslator​(DataSource dataSource)

  Create an SQL error code translator for the given DataSource. Invoking this constructor will cause a Connection to be obtained from the DataSource to get the meta-data.

  参数:

  dataSource - the DataSource to use to find meta-data and establish which error codes are usable

  另请参阅:

  SQLErrorCodesFactory

• SQLErrorCodeSQLExceptionTranslator

  public SQLErrorCodeSQLExceptionTranslator​(String dbName)

  Create an SQL error code translator for the given database product name. Invoking this constructor will avoid obtaining a Connection from the DataSource to get the meta-data.

  参数:

  dbName - the database product name that identifies the error codes entry

  另请参阅:

  SQLErrorCodesFactory, DatabaseMetaData.getDatabaseProductName()

• SQLErrorCodeSQLExceptionTranslator

  public SQLErrorCodeSQLExceptionTranslator​(SQLErrorCodes sec)

  Create an SQLErrorCode translator given these error codes. Does not require a database meta-data lookup to be performed using a connection.

  参数:

  sec - error codes

方法详细资料

• setDataSource

  public void setDataSource​(DataSource dataSource)

  Set the DataSource for this translator.

  Setting this property will cause a Connection to be obtained from the DataSource to get the meta-data.

  参数:

  dataSource - the DataSource to use to find meta-data and establish which error codes are usable

  另请参阅:

  SQLErrorCodesFactory.getErrorCodes(javax.sql.DataSource), DatabaseMetaData.getDatabaseProductName()

• setDatabaseProductName

  public void setDatabaseProductName​(String dbName)

  Set the database product name for this translator.

  Setting this property will avoid obtaining a Connection from the DataSource to get the meta-data.

  参数:

  dbName - the database product name that identifies the error codes entry

  另请参阅:

  SQLErrorCodesFactory.getErrorCodes(String), DatabaseMetaData.getDatabaseProductName()

• setSqlErrorCodes

  public void setSqlErrorCodes​(@Nullable
                               SQLErrorCodes sec)

  Set custom error codes to be used for translation.

  参数:

  sec - custom error codes to use

• getSqlErrorCodes

  @Nullable
  public SQLErrorCodes getSqlErrorCodes()

  Return the error codes used by this translator. Usually determined via a DataSource.

  另请参阅:

  setDataSource(javax.sql.DataSource)

• doTranslate

  @Nullable
  protected DataAccessException doTranslate​(String task,
                                            @Nullable
                                            String sql,
                                            SQLException ex)

  从类复制的说明: AbstractFallbackSQLExceptionTranslator
  Template method for actually translating the given exception.

  The passed-in arguments will have been pre-checked. Furthermore, this method is allowed to return null to indicate that no exception match has been found and that fallback translation should kick in.

  指定者:

  doTranslate 在类中 AbstractFallbackSQLExceptionTranslator

  参数:

  task - readable text describing the task being attempted

  sql - the SQL query or update that caused the problem (if known)

  ex - the offending SQLException

  返回:

  the DataAccessException, wrapping the SQLException; or null if no exception match found

• customTranslate

  @Nullable
  protected DataAccessException customTranslate​(String task,
                                                @Nullable
                                                String sql,
                                                SQLException sqlEx)

  Subclasses can override this method to attempt a custom mapping from SQLException to DataAccessException.

  参数:

  task - readable text describing the task being attempted

  sql - the SQL query or update that caused the problem (may be null)

  sqlEx - the offending SQLException

  返回:

  null if no custom translation applies, otherwise a DataAccessException resulting from custom translation. This exception should include the sqlEx parameter as a nested root cause. This implementation always returns null, meaning that the translator always falls back to the default error codes.

• createCustomException

  @Nullable
  protected DataAccessException createCustomException​(String task,
                                                      @Nullable
                                                      String sql,
                                                      SQLException sqlEx,
                                                      Class<?> exceptionClass)

  Create a custom DataAccessException, based on a given exception class from a CustomSQLErrorCodesTranslation definition.

  参数:

  task - readable text describing the task being attempted

  sql - the SQL query or update that caused the problem (may be null)

  sqlEx - the offending SQLException

  exceptionClass - the exception class to use, as defined in the CustomSQLErrorCodesTranslation definition

  返回:

  null if the custom exception could not be created, otherwise the resulting DataAccessException. This exception should include the sqlEx parameter as a nested root cause.

  另请参阅:

  CustomSQLErrorCodesTranslation.setExceptionClass(java.lang.Class<?>)