Jaybird 2.1 JDBC driver Java Programmer's Manual - Firebird

class are thrown by the GDS implementations. Upper layers either convert these
exceptions into the ones appropriate to that layer or catch them if driver can
handle the error condition.
• Subclasses of javax.resource.ResourceException are thrown by the JCA
layer when an error happens in the JCA-related code. Upper layer converts this
exception into a subclass of java.sql.SQLException. If the
ResourceException was caused by the GDSException, latter is extracted
during conversion preserving the error code. If ResourceException was
caused by an error condition not related to an error returned by the database
engine, error code of the SQLException remains 0.
• Subclasses of javax.transaction.XAException are thrown when an XA
protocol error happens in JCA layer. Similar to the previous case, XAException
can wrap the GDSException, which are extracted during exception conversion
to preserve the error code.
• Subclasses of java.sql.SQLException are thrown by the JDBC layer. Driver
has also few subclasses that might be interesting to the application:
• org.firebirdsql.jdbc.FBDriverConsistencyCheckException – this
exception is thrown when driver detects an internal inconsistent state. SQL
state is SQL_STATE_GENERAL_ERROR.
• org.firebirdsql.jdbc.FBDriverNotCapableException – this exception
is thrown when an unsupported method is called. SQL state is
SQL_STATE_DRIVER_NOT_CAPABLE.
• org.firebirdsql.jdbc.FBSQLParseException – this exception is thrown
when incorrect escaped syntax is detected. SQL state is
SQL_STATE_INVALID_ESCAPE_SEQ.
• org.firebirdsql.jdbc.field.TypeConversionException – this
exception is thrown when the driver is asked to perform a type conversion
that is not defined in the JDBC specification. For a table of allowed type
conversions see Ошибка: источник перекрестной ссылки не найден.
SQL states
Jaybird supports the SQL states from the X/Open standard, however only few
states nicely map into the Firebird error codes. Below is the table containing the
reported SQL states.
Constant name Constant value
SQL_STATE_INVALID_CON_ATTR "01S00"
SQL_STATE_NO_ROW_AVAIL "01S06"
SQL_STATE_GENERAL_ERROR "HY00"
SQL_STATE_DRIVER_NOT_CAPABLE "HYC00"
SQL_STATE_INVALID_COLUMN "HY02"
SQL_STATE_INVALID_PARAM_TYPE "HY105"
SQL_STATE_INVALID_ARG_VALUE "HY009"
Chapter 3. Handling exceptions 27