コンストラクターの詳細

• DefaultJdoDialect

  public DefaultJdoDialect()

  新しい DefaultJdoDialect を作成します。

• DefaultJdoDialect

  public DefaultJdoDialect(java.lang.Object connectionFactory)

  新しい DefaultJdoDialect を作成します。

  パラメーター:

  connectionFactory - デフォルトの JDBC 例外トランスレータを初期化するために使用される JDO PersistenceManagerFactory の接続ファクトリ

  関連事項:

  PersistenceManagerFactory.getConnectionFactory(), PersistenceManagerFactoryUtils.newJdbcExceptionTranslator(Object)

メソッドの詳細

• setJdbcExceptionTranslator

  public void setJdbcExceptionTranslator(SQLExceptionTranslator jdbcExceptionTranslator)

  このダイアレクトの JDBC 例外トランスレータを設定します。

  指定されている場合、JDOException のあらゆる SQLException 根本原因に適用されます。デフォルトでは、JDO プロバイダーのネイティブ例外変換に依存します。

  パラメーター:

  jdbcExceptionTranslator - 例外変換者

  関連事項:

  SQLException, JDOException.getCause(), SQLErrorCodeSQLExceptionTranslator, SQLStateSQLExceptionTranslator

• getJdbcExceptionTranslator

  public SQLExceptionTranslator getJdbcExceptionTranslator()

  このダイアレクトの JDBC 例外トランスレータがあればそれを返します。

• beginTransaction

  public java.lang.Object beginTransaction(javax.jdo.Transaction transaction,
                                           TransactionDefinition definition)
                                    throws javax.jdo.JDOException,
                                           java.sql.SQLException,
                                           TransactionException

  この実装は、標準の JDO Transaction.begin() メソッドを呼び出し、必要に応じて Transaction.setIsolationLevel(String) も呼び出します。

  次で指定:

  インターフェース JdoDialect の beginTransaction 

  パラメーター:

  transaction - JDO 取引を開始する

  definition - セマンティクスを定義する Spring トランザクション定義

  戻り値:

  トランザクションデータがある場合、それを保持する任意のオブジェクト (cleanupTransaction に渡される)

  例外:

  javax.jdo.JDOException - JDO メソッドによってスローされた場合

  java.sql.SQLException - JDBC メソッドによってスローされた場合

  TransactionException - 無効な引数の場合

  関連事項:

  Transaction.begin(), InvalidIsolationLevelException

• getJdoIsolationLevel

  protected java.lang.String getJdoIsolationLevel(TransactionDefinition definition)

  指定された Spring トランザクション定義に使用する JDO 分離レベル文字列を決定します。

  パラメーター:

  definition - Spring トランザクション定義

  戻り値:

  対応する JDO 分離レベル文字列、または分離レベルを明示的に設定しないことを示す null 

  関連事項:

  Transaction.setIsolationLevel(String)、Constants.TX_SERIALIZABLE、Constants.TX_REPEATABLE_READ、Constants.TX_READ_COMMITTED、Constants.TX_READ_UNCOMMITTED

• cleanupTransaction

  public void cleanupTransaction(java.lang.Object transactionData)

  デフォルトの beginTransaction 実装ではクリーンアップが必要ないため、この実装では何も行われません。

  次で指定:

  インターフェース JdoDialect の cleanupTransaction 

  パラメーター:

  transactionData - トランザクションデータを保持する任意のオブジェクト（存在する場合） (beginTransaction によって返された)

  関連事項:

  beginTransaction(javax.jdo.Transaction, org.springframework.transaction.TransactionDefinition)

• getJdbcConnection

  public ConnectionHandle getJdbcConnection(javax.jdo.PersistenceManager pm,
                                            boolean readOnly)
                                     throws javax.jdo.JDOException,
                                            java.sql.SQLException

  この実装は、JDO に対して DataStoreConnectionHandle を返します。

  注意 : JDO DataStoreConnection は常にラッパーであり、ネイティブの JDBC 接続ではありません。ネイティブの JDBC 接続 (または、Spring NativeJdbcExtractor を介してラップ解除される接続プールハンドル) にアクセスする必要がある場合は、このメソッドをオーバーライドして、対応するベンダー固有のメカニズムを通じてネイティブ接続を返します。

  JDO DataStoreConnection は PersistenceManager から「借用」されるだけなので、できるだけ早く返す必要があります。実際、JDO では、PersistenceManager の作業を続行する前に、フェッチされた接続を閉じる必要があります。このため、公開された ConnectionHandle は、各 JDBC データアクセス操作の終了時 (つまり、DataSourceUtils.releaseConnection) に、JDBC 接続を積極的に解放します。

  次で指定:

  インターフェース JdoDialect の getJdbcConnection 

  パラメーター:

  pm - 現在の JDO PersistenceManager

  readOnly - 接続が読み取り専用の目的でのみ必要かどうか

  戻り値:

  JDBC 接続のハンドル。releaseJdbcConnection に渡されます。JDBC 接続を取得できない場合は null に渡される

  例外:

  javax.jdo.JDOException - JDO メソッドによってスローされた場合

  java.sql.SQLException - JDBC メソッドによってスローされた場合

  関連事項:

  PersistenceManager.getDataStoreConnection(), NativeJdbcExtractor, DataSourceUtils.releaseConnection(java.sql.Connection, javax.sql.DataSource)

• releaseJdbcConnection

  public void releaseJdbcConnection(ConnectionHandle conHandle,
                                    javax.jdo.PersistenceManager pm)
                             throws javax.jdo.JDOException,
                                    java.sql.SQLException

  Connection が PersistenceManager で暗黙的に閉じられると仮定すると、この実装は何もしません。

  JDO プロバイダーが、アプリケーションが閉じることを期待する接続ハンドルを返す場合、ダイアレクトはここで Connection.close を呼び出す必要があります。

  次で指定:

  インターフェース JdoDialect の releaseJdbcConnection 

  パラメーター:

  conHandle - 解放する JDBC 接続ハンドル

  pm - 現在の JDO PersistenceManager

  例外:

  javax.jdo.JDOException - JDO メソッドによってスローされた場合

  java.sql.SQLException - JDBC メソッドによってスローされた場合

  関連事項:

  Connection.close()

• translateExceptionIfPossible

  public DataAccessException translateExceptionIfPossible(java.lang.RuntimeException ex)

  Spring の PersistenceExceptionTranslationPostProcessor によって自動検出される PersistenceExceptionTranslator インターフェースの実装。

  JDOException の場合は、この JdoDialect を使用して例外を変換します。それ以外の場合は、不明な例外を示す null を返します。

  次で指定:

  インターフェース PersistenceExceptionTranslator の translateExceptionIfPossible 

  パラメーター:

  ex - 変換する RuntimeException

  戻り値:

  対応する DataAccessException (または、例外を変換できなかった場合は null。この場合、実際の永続性の問題ではなく、ユーザーコードが原因である可能性があります。)

  関連事項:

  PersistenceExceptionTranslationPostProcessor, translateException(javax.jdo.JDOException)

• translateException

  public DataAccessException translateException(javax.jdo.JDOException ex)

  この実装は、PersistenceManagerFactoryUtils に委譲します。

  次で指定:

  インターフェース JdoDialect の translateException 

  パラメーター:

  ex - JDOException がスローされました

  戻り値:

  対応する DataAccessException (null であってはなりません)

  関連事項:

  PersistenceManagerFactoryUtils.convertJdoAccessException(javax.jdo.JDOException)

• extractSqlStringFromException

  protected java.lang.String extractSqlStringFromException(javax.jdo.JDOException ex)

  指定された例外から SQL 文字列を抽出するためのテンプレートメソッド。

  デフォルトの実装では常に null が返されます。サブクラスでオーバーライドして、ベンダー固有の例外クラスの SQL 文字列を抽出できます。

  パラメーター:

  ex - SQLException を含む JDOException

  戻り値:

  SQL 文字列、または見つからない場合は null