17.8.1 JDBC4.0 APIでの追加機能
JDBC4.0 APIで追加された機能のうち,サポートする機能とドライバを次の表に示します。
機能 |
サポートするドライバ |
||
---|---|---|---|
JDBC2.0 |
JDBC4.0 |
JDBC4.3 |
|
java.sql.Driver自動ローディング |
× |
○ |
○ |
BLOB機能拡張 |
× |
○ |
○ |
ラッパーパターン |
× |
○ |
○ |
接続管理 |
× |
○ |
○ |
SQLException拡張 |
× |
○ |
○ |
スカラ関数追加 |
○ |
○ |
○ |
StatementEventListener |
× |
○ |
○ |
- (凡例)
-
○:サポートされます。
×:サポートされません。
- 〈この項の構成〉
(1) java.sql.Driver自動ローディング
JDBC4.0より前の規格では,Java仮想マシンへのDriverクラスの登録が必要でした。JDBC4.0以降は,Driverクラスの登録が不要になります。Driverクラスの登録については,「Driverクラスの登録」を参照してください。なお,JDBC4.0以降でDriverクラスを登録しても,動作に影響はありません。
(2) BLOB機能拡張
JDBC4.0では,BLOBに関するメソッドが複数追加されました。このうち,Blobインタフェースのfree()メソッドをサポートします。free()メソッドについては,「free()」を参照してください。
(3) ラッパーパターン
Connection,DatabaseMetaData,DataSource,ResultSet,ResultSetMetaData,Statement,PreparedStatement,及びCallableStatementの各インタフェースがWrapperインタフェースを継承します。Wrapperインタフェースについては「Wrapperインタフェース」を参照してください。
(4) 接続管理
JDBC4.0では,コネクションの状態を確認するためのメソッド,及びコネクションプーリングを制御するためのメソッドが追加されています。このうち,コネクションの状態を確認するメソッド(ConnectionインタフェースのisValid(int timeout)メソッド)をサポートします。isValid(int timeout)メソッドについては「isValid(int timeout)」を参照してください。
(5) SQLException拡張
JDBC4.0では,SQLExceptionのサブクラスとして複数の例外クラスが追加されています。追加された例外クラスと,サポートの可否を次の表に示します。ただし,これらの例外クラスは,HiRDBサーバで詳細なSQLSTATEが設定されている場合にだけ返却されます。SQLSTATEが詳細に設定されていない場合は,JDBCドライバ内で検知するエラーを除き,JDBC2.0と同様にSQLExceptionが返却されます。
クラス名 |
サポート可否 |
---|---|
SQLNonTransientException |
○ |
SQLFeatureNotSupportedException |
○ |
SQLNonTransientConnectionException |
○ |
SQLDataException |
○ |
SQLIntegrityConstraintViolationException |
○ |
SQLInvalidAuthorizationException |
○ |
SQLSyntaxErrorException |
○ |
SQLTransientException |
○ |
SQLTransientConnectionException |
○ |
SQLTransactionRollbackException |
○ |
SQLTimeoutException |
○ |
SQLRecoverableException |
○ |
SQLClientInfoException |
○ |
- (凡例)
-
○:サポートします。
詳細は,「SQLException拡張機能」を参照してください。
(6) スカラ関数追加
JDBC4.0では,スカラ関数が複数追加されました。追加されたスカラ関数と,サポートの可否を次の表に示します。
スカラ関数 |
サポート可否 |
---|---|
CHARA_LENGTH, CHARACTER_LENGTH |
× |
CURRENT_DATE |
○ |
CURRENT_TIME |
○ |
CURRENT_TIMESTAMP |
○ |
EXTRACT |
× |
OCTET_LENGTH |
× |
POSITION |
○ |
- (凡例)
-
○:サポートします。
×:サポートしません。
(7) StatementEventListener
StatementEventListenerはStatementプールを管理する外部プログラムが使用する機能です。Statementプール機能を実装しているアプリケーションサーバ向けに提供します。
アプリケーションサーバは,PreparedStatementが無効となった場合にJDBCドライバから通知を受けるため,該当インタフェースを実装してJDBCドライバに登録します。PreparedStatementが無効となると,該当インタフェースを通してJDBCドライバからアプリケーションサーバへ通知を行い,アプリケーションサーバは無効となったPreparedStatementをStatementプールから削除します。
なお,上記のPreparedStatementは,CallableStatement(PreparedStatementを継承)も含むものとします(以降も同様です)。
StatementEventListenerのメソッドの呼び出し契機を次の表に示します。
メソッド |
呼び出し契機 |
---|---|
statementClosed |
なし |
statementErrorOccurred |
SQL実行時にエラーとなり,PreparedStatementが無効となった時点 |
PreparedStatementが無効になる契機とstatementErrorOccurredメソッド呼び出し契機を次の表に示します。
メソッド |
statementErrorOccurredメソッド |
||
---|---|---|---|
呼び出し契機 |
対象PreparedStatement |
||
SQLException 発生時 |
接続障害を示すSQLCODE(-720,-722,-723,-728,-732,-735,-932,-1700)※1 |
該当SQLException投入直前 |
SQLExceptionが発生したConnectionで生成したすべてのPreparedStatement |
SQL実行エラーによる暗黙的ロールバック |
|||
トランザクション決着時(STATEMENT_COMMIT_BEHAVIOR=FALSEの場合※2) |
Connection.commit,XAResource.commit実行時 |
無効となったPreparedStatementを使用したことで発生するSQLException(SQLCODE=-901,又は-1512)投入直前 |
SQLException発生時に処理対象としているPreparedStatement |
XAResource.prepareでのトランザクション決着時 |
|||
Connection.rollback,XAResource.rollback実行時 |
|||
CALL文実行時(プロシジャ内でトランザクション決着) |
|||
PURGE TABLE実行時 |
|||
定義系SQL実行時(PDDDLDEAPRPEXE=YES,又はPDDDLDEAPRP=YESの場合※3) |
|||
SET SESSION AUTHORIZATION実行時 |
|||
SQLExceptionを伴わない接続障害発生時 |
XAResourceのメソッド実行時に接続障害によってXAException投入 |
無効となったConnectionを使用したことで発生するSQLException(SQLCODE=-563)投入直前 |
接続障害が発生したConnectionで生成したすべてのPreparedStatement |
InputStreamによるデータ取得時に接続障害によってIOException投入 |
|||
PrdbConnection.checkSession実行時にSESSION_ALIVE以外が返却 |
|||
Connection.isValidでfalseが返却 |
- 注※1
-
ConnectionEventListenerも登録されている場合,StatementEventListenerの呼び出しを先行します。
- 注※2
-
STATEMENT_COMMIT_BEHAVIORの指定方法,及び優先順位については,「接続情報の優先順位」の「ステートメントのコミット実行後の状態」を参照してください。
- 注※3
-
PDDDLDEAPRPEXE,PDDDLDEAPRPの指定方法,及び優先順位については,「接続情報の優先順位」の「そのほかのクライアント環境定義の優先順位」を参照してください。