org.jpox.springframework
Class JPOXJdoDialect

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

All Implemented Interfaces:

org.springframework.orm.jdo.JdoDialect

public class JPOXJdoDialect
extends org.springframework.orm.jdo.DefaultJdoDialect

Dialect for using JPOX within Spring's JDO support, giving finer control over transactions and queries.

Version:

$Revision: 1.5 $

Field Summary

Fields inherited from class org.springframework.orm.jdo.DefaultJdoDialect

logger

Constructor Summary

JPOXJdoDialect()

Method Summary

void	applyQueryTimeout(javax.jdo.Query query, int remainingTimeInSeconds) Method to apply a timeout to the specified query.
java.lang.Object	beginTransaction(javax.jdo.Transaction transaction, org.springframework.transaction.TransactionDefinition definition) Method to start a transaction.
void	flush(javax.jdo.PersistenceManager pm) Method to flush changes to the datastore.
org.springframework.jdbc.datasource.ConnectionHandle	getJdbcConnection(javax.jdo.PersistenceManager pm, boolean readOnly) Accessor for JDBC connection.
void	releaseJdbcConnection(org.springframework.jdbc.datasource.ConnectionHandle conHandle, javax.jdo.PersistenceManager pm) Method to release a previously obtained connection.

Methods inherited from class org.springframework.orm.jdo.DefaultJdoDialect

attachCopy, attachCopyAll, cleanupTransaction, detachCopy, detachCopyAll, extractSqlStringFromException, getJdbcExceptionTranslator, getPersistenceManagerFactory, newNamedQuery, setJdbcExceptionTranslator, setPersistenceManagerFactory, translateException

Methods inherited from class java.lang.Object

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

Constructor Detail

JPOXJdoDialect

public JPOXJdoDialect()

Method Detail

beginTransaction

public java.lang.Object beginTransaction(javax.jdo.Transaction transaction,
                                         org.springframework.transaction.TransactionDefinition definition)
                                  throws javax.jdo.JDOException

Method to start a transaction. Hooks into JPOX's configurability for transactions.

Specified by:

beginTransaction in interface org.springframework.orm.jdo.JdoDialect

Overrides:

beginTransaction in class org.springframework.orm.jdo.DefaultJdoDialect

Parameters:

transaction - The transaction to start

definition - Definition of the transaction

Returns:

The transaction

Throws:

javax.jdo.JDOException

getJdbcConnection

public org.springframework.jdbc.datasource.ConnectionHandle getJdbcConnection(javax.jdo.PersistenceManager pm,
                                                                              boolean readOnly)
                                                                       throws java.sql.SQLException

Accessor for JDBC connection. Hooks into JPOX's datastore connection accessor.

Specified by:

getJdbcConnection in interface org.springframework.orm.jdo.JdoDialect

Overrides:

getJdbcConnection in class org.springframework.orm.jdo.DefaultJdoDialect

Parameters:

pm - The Persistence Manager

readOnly - Whether to open it read only

Returns:

The Connection handle

Throws:

java.sql.SQLException - Thrown if an error occurs in accessing it

releaseJdbcConnection

public void releaseJdbcConnection(org.springframework.jdbc.datasource.ConnectionHandle conHandle,
                                  javax.jdo.PersistenceManager pm)
                           throws java.sql.SQLException

Method to release a previously obtained connection. Hooks into JPOX's datastore connection retriever.

Specified by:

releaseJdbcConnection in interface org.springframework.orm.jdo.JdoDialect

Overrides:

releaseJdbcConnection in class org.springframework.orm.jdo.DefaultJdoDialect

Parameters:

conHandle - The Connection handle

pm - The PersistenceManager

Throws:

java.sql.SQLException - Thrown if an error occurs in returning it

applyQueryTimeout

public void applyQueryTimeout(javax.jdo.Query query,
                              int remainingTimeInSeconds)
                       throws javax.jdo.JDOException

Method to apply a timeout to the specified query.

Specified by:

applyQueryTimeout in interface org.springframework.orm.jdo.JdoDialect

Overrides:

applyQueryTimeout in class org.springframework.orm.jdo.DefaultJdoDialect

Parameters:

query - The query

remainingTimeInSeconds - The timeout to apply

Throws:

javax.jdo.JDOException - Thrown when an error occurs setting the timeout.

flush

public void flush(javax.jdo.PersistenceManager pm)
           throws javax.jdo.JDOException

Method to flush changes to the datastore.

Specified by:

flush in interface org.springframework.orm.jdo.JdoDialect

Overrides:

flush in class org.springframework.orm.jdo.DefaultJdoDialect

Parameters:

pm - The Persistence Manager

Throws:

javax.jdo.JDOException - Thrown if an error occurs in flushing