程序包 org.hibernate.engine.jdbc.spi

类 SqlExceptionHelper

java.lang.Object

org.hibernate.engine.jdbc.spi.SqlExceptionHelper

public class SqlExceptionHelper
extends Object

Helper for handling SQLExceptions in various manners.

作者:

Steve Ebersole

嵌套类概要

嵌套类

修饰符和类型	类	说明
static class	SqlExceptionHelper.StandardWarningHandler	Standard SQLWarning handler for logging warnings
static interface	SqlExceptionHelper.WarningHandler	Contract for handling warnings
static class	SqlExceptionHelper.WarningHandlerLoggingSupport	Basic support for SqlExceptionHelper.WarningHandler implementations which handle warnings

字段概要

字段

修饰符和类型	字段	说明
static SqlExceptionHelper.StandardWarningHandler	STANDARD_WARNING_HANDLER	Static access to the standard handler for logging warnings

构造器概要

构造器

构造器	说明
SqlExceptionHelper(boolean logWarnings)	Create an exception helper with a default exception converter.
SqlExceptionHelper(SQLExceptionConverter sqlExceptionConverter, boolean logWarnings)	Create an exception helper with a specific exception converter.

方法概要

修饰符和类型	方法	说明
JDBCException	convert(SQLException sqlException, String message)	Convert an SQLException using the current converter, doing some logging first.
JDBCException	convert(SQLException sqlException, String message, String sql)	Convert an SQLException using the current converter, doing some logging first.
SQLExceptionConverter	getSqlExceptionConverter()	Access the current exception converter being used internally.
void	handleAndClearWarnings(Connection connection, SqlExceptionHelper.WarningHandler handler)	General purpose handling of warnings associated with a JDBC Connection.
void	handleAndClearWarnings(Statement statement, SqlExceptionHelper.WarningHandler handler)	General purpose handling of warnings associated with a JDBC Statement.
void	logAndClearWarnings(Connection connection)	Standard (legacy) behavior for logging warnings associated with a JDBC Connection and clearing them.
void	logAndClearWarnings(Statement statement)
void	logExceptions(SQLException sqlException, String message)	Log the given (and any nested) exception.
void	setSqlExceptionConverter(SQLExceptionConverter sqlExceptionConverter)	Inject the exception converter to use.
void	walkWarnings(SQLWarning warning, SqlExceptionHelper.WarningHandler handler)	Generic algorithm to walk the hierarchy of SQLWarnings

从类继承的方法 java.lang.Object

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

字段详细资料

STANDARD_WARNING_HANDLER

public static final SqlExceptionHelper.StandardWarningHandler STANDARD_WARNING_HANDLER

Static access to the standard handler for logging warnings

构造器详细资料

SqlExceptionHelper

public SqlExceptionHelper(boolean logWarnings)

Create an exception helper with a default exception converter.

SqlExceptionHelper

public SqlExceptionHelper(SQLExceptionConverter sqlExceptionConverter,
                          boolean logWarnings)

Create an exception helper with a specific exception converter.

参数:

sqlExceptionConverter - The exception converter to use.

方法详细资料

getSqlExceptionConverter

public SQLExceptionConverter getSqlExceptionConverter()

Access the current exception converter being used internally.

返回:

The current exception converter.

setSqlExceptionConverter

public void setSqlExceptionConverter(SQLExceptionConverter sqlExceptionConverter)

Inject the exception converter to use.

NOTE : null is allowed and signifies to use the default.

参数:

sqlExceptionConverter - The converter to use.

convert

public JDBCException convert(SQLException sqlException,
                             String message)

Convert an SQLException using the current converter, doing some logging first.

参数:

sqlException - The exception to convert

message - An error message.

返回:

The converted exception

convert

public JDBCException convert(SQLException sqlException,
                             String message,
                             String sql)

Convert an SQLException using the current converter, doing some logging first.

参数:

sqlException - The exception to convert

message - An error message.

sql - The SQL being executed when the exception occurred

返回:

The converted exception

logExceptions

public void logExceptions(SQLException sqlException,
                          String message)

Log the given (and any nested) exception.

参数:

sqlException - The exception to log

message - The message text to use as a preamble.

walkWarnings

public void walkWarnings(SQLWarning warning,
                         SqlExceptionHelper.WarningHandler handler)

Generic algorithm to walk the hierarchy of SQLWarnings

参数:

warning - The warning to walk

handler - The handler

logAndClearWarnings

public void logAndClearWarnings(Connection connection)

Standard (legacy) behavior for logging warnings associated with a JDBC Connection and clearing them.

Calls handleAndClearWarnings(Connection, WarningHandler) using STANDARD_WARNING_HANDLER

参数:

connection - The JDBC connection potentially containing warnings

logAndClearWarnings

public void logAndClearWarnings(Statement statement)

handleAndClearWarnings

public void handleAndClearWarnings(Connection connection,
                                   SqlExceptionHelper.WarningHandler handler)

General purpose handling of warnings associated with a JDBC Connection.

参数:

connection - The JDBC connection potentially containing warnings

handler - The handler for each individual warning in the stack.

另请参阅:

walkWarnings(java.sql.SQLWarning, org.hibernate.engine.jdbc.spi.SqlExceptionHelper.WarningHandler)

handleAndClearWarnings

public void handleAndClearWarnings(Statement statement,
                                   SqlExceptionHelper.WarningHandler handler)

General purpose handling of warnings associated with a JDBC Statement.

参数:

statement - The JDBC statement potentially containing warnings

handler - The handler for each individual warning in the stack.

另请参阅:

walkWarnings(java.sql.SQLWarning, org.hibernate.engine.jdbc.spi.SqlExceptionHelper.WarningHandler)