DefaultJdoDialect (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.orm.jdo
Class DefaultJdoDialect

java.lang.Object
  org.springframework.orm.jdo.DefaultJdoDialect

All Implemented Interfaces:: JdoDialect

public class DefaultJdoDialect
extends Object
implements JdoDialect
extends Object
implements JdoDialect

Default implementation of the JdoDialect interface. Updated to leverage the JDO 2.0 API when available, as of Spring 1.2. Used as default dialect by JdoAccessor and JdoTransactionManager.

Simply begins a standard JDO transaction in beginTransaction. Returns a handle for a JDO2 DataStoreConnection on getJdbcConnection. Calls the corresponding JDO2 operations on detachCopy(All), attachCopy(All), flush and newNamedQuery. Ignores a given query timeout in applyQueryTimeout. Uses a Spring SQLExceptionTranslator for exception translation, if applicable.

Note that, even with JDO2, vendor-specific subclasses are still necessary for special transaction semantics and more sophisticated exception translation. Furthermore, vendor-specific subclasses are encouraged to expose the native JDBC Connection on getJdbcConnection, rather than JDO2's wrapper handle.

Since:: 1.1
Author:: Juergen Hoeller
See Also:: setJdbcExceptionTranslator(org.springframework.jdbc.support.SQLExceptionTranslator), JdoAccessor.setJdoDialect(org.springframework.orm.jdo.JdoDialect), JdoTransactionManager.setJdoDialect(org.springframework.orm.jdo.JdoDialect)

Field Summary

protected Log logger


Constructor Summary

DefaultJdoDialect()
          Create a new DefaultJdoDialect.

DefaultJdoDialect(javax.jdo.PersistenceManagerFactory pmf)
          Create a new DefaultJdoDialect.

Method Summary

void applyQueryTimeout(javax.jdo.Query query, int remainingTimeInSeconds)
          This implementation logs a warning that it cannot apply a query timeout.

Object attachCopy(javax.jdo.PersistenceManager pm, Object detachedEntity)
          This implementation delegates to JDO 2.0's attachCopy method, passing in "true" for the "makeTransactional" argument.

Collection attachCopyAll(javax.jdo.PersistenceManager pm, Collection detachedEntities)
          This implementation delegates to JDO 2.0's attachCopyAll method, passing in "true" for the "makeTransactional" argument.

Object beginTransaction(javax.jdo.Transaction transaction, TransactionDefinition definition)
          This implementation invokes the standard JDO Transaction.begin method.

void cleanupTransaction(Object transactionData)
          This implementation does nothing, as the default beginTransaction implementation does not require any cleanup.

Object detachCopy(javax.jdo.PersistenceManager pm, Object entity)
          This implementation delegates to JDO 2.0's detachCopy method.

Collection detachCopyAll(javax.jdo.PersistenceManager pm, Collection entities)
          This implementation delegates to JDO 2.0's detachCopyAll method.

protected String extractSqlStringFromException(javax.jdo.JDOException ex)
          Template method for extracting a SQL String from the given exception.

void flush(javax.jdo.PersistenceManager pm)
          This implementation delegates to JDO 2.0's flush method.

ConnectionHandle getJdbcConnection(javax.jdo.PersistenceManager pm, boolean readOnly)
          This implementation returns a DataStoreConnectionHandle for JDO2, which will also work on JDO1 until actually accessing the JDBC Connection.

SQLExceptionTranslator getJdbcExceptionTranslator()
          Return the JDBC exception translator for this instance.

javax.jdo.PersistenceManagerFactory getPersistenceManagerFactory()
          Return the JDO PersistenceManagerFactory that should be used to create PersistenceManagers.

javax.jdo.Query newNamedQuery(javax.jdo.PersistenceManager pm, Class entityClass, String queryName)
          This implementation delegates to JDO 2.0's newNamedQuery method.

void releaseJdbcConnection(ConnectionHandle conHandle, javax.jdo.PersistenceManager pm)
          This implementation does nothing, assuming that the Connection will implicitly be closed with the PersistenceManager.

void setJdbcExceptionTranslator(SQLExceptionTranslator jdbcExceptionTranslator)
          Set the JDBC exception translator for this dialect.

void setPersistenceManagerFactory(javax.jdo.PersistenceManagerFactory pmf)
          Set the JDO PersistenceManagerFactory, which is used to initialize the default JDBC exception translator if none specified.

DataAccessException translateException(javax.jdo.JDOException ex)
          This implementation delegates to PersistenceManagerFactoryUtils.

Methods inherited from class java.lang.Object

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

Field Summary
`protected Log`	`logger`

Constructor Summary
`DefaultJdoDialect()` Create a new DefaultJdoDialect.
`DefaultJdoDialect(javax.jdo.PersistenceManagerFactory pmf)` Create a new DefaultJdoDialect.

Method Summary
`void`	`applyQueryTimeout(javax.jdo.Query query, int remainingTimeInSeconds)` This implementation logs a warning that it cannot apply a query timeout.
`Object`	`attachCopy(javax.jdo.PersistenceManager pm, Object detachedEntity)` This implementation delegates to JDO 2.0's `attachCopy` method, passing in "true" for the "makeTransactional" argument.
`Collection`	`attachCopyAll(javax.jdo.PersistenceManager pm, Collection detachedEntities)` This implementation delegates to JDO 2.0's `attachCopyAll` method, passing in "true" for the "makeTransactional" argument.
`Object`	`beginTransaction(javax.jdo.Transaction transaction, TransactionDefinition definition)` This implementation invokes the standard JDO `Transaction.begin` method.
`void`	`cleanupTransaction(Object transactionData)` This implementation does nothing, as the default beginTransaction implementation does not require any cleanup.
`Object`	`detachCopy(javax.jdo.PersistenceManager pm, Object entity)` This implementation delegates to JDO 2.0's `detachCopy` method.
`Collection`	`detachCopyAll(javax.jdo.PersistenceManager pm, Collection entities)` This implementation delegates to JDO 2.0's `detachCopyAll` method.
`protected String`	`extractSqlStringFromException(javax.jdo.JDOException ex)` Template method for extracting a SQL String from the given exception.
`void`	`flush(javax.jdo.PersistenceManager pm)` This implementation delegates to JDO 2.0's `flush` method.
`ConnectionHandle`	`getJdbcConnection(javax.jdo.PersistenceManager pm, boolean readOnly)` This implementation returns a DataStoreConnectionHandle for JDO2, which will also work on JDO1 until actually accessing the JDBC Connection.
`SQLExceptionTranslator`	`getJdbcExceptionTranslator()` Return the JDBC exception translator for this instance.
`javax.jdo.PersistenceManagerFactory`	`getPersistenceManagerFactory()` Return the JDO PersistenceManagerFactory that should be used to create PersistenceManagers.
`javax.jdo.Query`	`newNamedQuery(javax.jdo.PersistenceManager pm, Class entityClass, String queryName)` This implementation delegates to JDO 2.0's `newNamedQuery` method.
`void`	`releaseJdbcConnection(ConnectionHandle conHandle, javax.jdo.PersistenceManager pm)` This implementation does nothing, assuming that the Connection will implicitly be closed with the PersistenceManager.
`void`	`setJdbcExceptionTranslator(SQLExceptionTranslator jdbcExceptionTranslator)` Set the JDBC exception translator for this dialect.
`void`	`setPersistenceManagerFactory(javax.jdo.PersistenceManagerFactory pmf)` Set the JDO PersistenceManagerFactory, which is used to initialize the default JDBC exception translator if none specified.
`DataAccessException`	`translateException(javax.jdo.JDOException ex)` This implementation delegates to PersistenceManagerFactoryUtils.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

logger

protected Log logger

Constructor Detail

DefaultJdoDialect

public DefaultJdoDialect()

Create a new DefaultJdoDialect.

DefaultJdoDialect

public DefaultJdoDialect(javax.jdo.PersistenceManagerFactory pmf)

Create a new DefaultJdoDialect.

Parameters:: pmf - the JDO PersistenceManagerFactory, which is used to initialize the default JDBC exception translator

Method Detail

setPersistenceManagerFactory

public void setPersistenceManagerFactory(javax.jdo.PersistenceManagerFactory pmf)

Set the JDO PersistenceManagerFactory, which is used to initialize the default JDBC exception translator if none specified.

See Also:: setJdbcExceptionTranslator(org.springframework.jdbc.support.SQLExceptionTranslator)

getPersistenceManagerFactory

public javax.jdo.PersistenceManagerFactory getPersistenceManagerFactory()

Return the JDO PersistenceManagerFactory that should be used to create PersistenceManagers.

setJdbcExceptionTranslator

public void setJdbcExceptionTranslator(SQLExceptionTranslator jdbcExceptionTranslator)

Set the JDBC exception translator for this dialect. Applied to SQLExceptions that are the cause of JDOExceptions.

The default exception translator is either a SQLErrorCodeSQLExceptionTranslator if a DataSource is available, or a SQLStateSQLExceptionTranslator else.

Parameters:: jdbcExceptionTranslator - exception translator
See Also:: SQLException, JDOException.getCause(), PersistenceManagerFactoryUtils.newJdbcExceptionTranslator(javax.jdo.PersistenceManagerFactory), SQLErrorCodeSQLExceptionTranslator, SQLStateSQLExceptionTranslator

getJdbcExceptionTranslator

public SQLExceptionTranslator getJdbcExceptionTranslator()

Return the JDBC exception translator for this instance.

Creates a default SQLErrorCodeSQLExceptionTranslator or SQLStateSQLExceptionTranslator for the specified PersistenceManagerFactory, if no exception translator explicitly specified.

beginTransaction

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

This implementation invokes the standard JDO Transaction.begin method. Throws an InvalidIsolationLevelException if a non-default isolation level is set.

Specified by:: beginTransaction in interface JdoDialect

Parameters:: transaction - the JDO transaction to begin; definition - the Spring transaction definition that defines semantics
Returns:: an arbitrary object that holds transaction data, if any (to be passed into cleanupTransaction)
Throws:: javax.jdo.JDOException - if thrown by JDO methods; SQLException - if thrown by JDBC methods; TransactionException - in case of invalid arguments
See Also:: Transaction.begin(), InvalidIsolationLevelException

cleanupTransaction

public void cleanupTransaction(Object transactionData)

This implementation does nothing, as the default beginTransaction implementation does not require any cleanup.

Specified by:: cleanupTransaction in interface JdoDialect

Parameters:: transactionData - arbitrary object that holds transaction data, if any (as returned by beginTransaction)
See Also:: beginTransaction(javax.jdo.Transaction, org.springframework.transaction.TransactionDefinition)

getJdbcConnection

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

This implementation returns a DataStoreConnectionHandle for JDO2, which will also work on JDO1 until actually accessing the JDBC Connection.

For pre-JDO2 implementations, override this method to return the Connection through the corresponding vendor-specific mechanism, or null if the Connection is not retrievable.

NOTE: A JDO2 DataStoreConnection is always a wrapper, never the native JDBC Connection. If you need access to the native JDBC Connection (or the connection pool handle, to be unwrapped via a Spring NativeJdbcExtractor), override this method to return the native Connection through the corresponding vendor-specific mechanism.

A JDO2 DataStoreConnection is only "borrowed" from the PersistenceManager: it needs to be returned as early as possible. Effectively, JDO2 requires the fetched Connection to be closed before continuing PersistenceManager work. For this reason, the exposed ConnectionHandle eagerly releases its JDBC Connection at the end of each JDBC data access operation (that is, on DataSourceUtils.releaseConnection).

Specified by:: getJdbcConnection in interface JdoDialect

Parameters:: pm - the current JDO PersistenceManager
Returns:: a handle for the JDBC Connection, to be passed into releaseJdbcConnection, or null if no JDBC Connection can be retrieved
Throws:: javax.jdo.JDOException - if thrown by JDO methods; SQLException - if thrown by JDBC methods
See Also:: 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,
                                  SQLException

This implementation does nothing, assuming that the Connection will implicitly be closed with the PersistenceManager.

If the JDO provider returns a Connection handle that it expects the application to close, the dialect needs to invoke Connection.close here.

Specified by:: releaseJdbcConnection in interface JdoDialect

Parameters:: conHandle - the JDBC Connection handle to release; pm - the current JDO PersistenceManager
Throws:: javax.jdo.JDOException - if thrown by JDO methods; SQLException - if thrown by JDBC methods
See Also:: Connection.close()