public abstract class

CciDaoSupport

extends DaoSupport
java.lang.Object
   ↳ org.springframework.dao.support.DaoSupport
     ↳ org.springframework.jca.cci.core.support.CciDaoSupport

Class Overview

Convenient super class for CCI-based data access objects.

Requires a javax.resource.cci.ConnectionFactory to be set, providing a CciTemplate based on it to subclasses through the getCciTemplate() method.

This base class is mainly intended for CciTemplate usage but can also be used when working with a Connection directly or when using org.springframework.jca.cci.object classes.

Summary

[Expand]
Inherited Fields
From class org.springframework.dao.support.DaoSupport
Public Constructors
CciDaoSupport()
Public Methods
final CciTemplate getCciTemplate()
Return the CciTemplate for this DAO, pre-initialized with the ConnectionFactory or set explicitly.
final ConnectionFactory getConnectionFactory()
Return the ConnectionFactory used by this DAO.
final void setCciTemplate(CciTemplate cciTemplate)
Set the CciTemplate for this DAO explicitly, as an alternative to specifying a ConnectionFactory.
final void setConnectionFactory(ConnectionFactory connectionFactory)
Set the ConnectionFactory to be used by this DAO.
Protected Methods
final void checkDaoConfig()
Abstract subclasses must override this to check their configuration.
CciTemplate createCciTemplate(ConnectionFactory connectionFactory)
Create a CciTemplate for the given ConnectionFactory.
final CciTemplate getCciTemplate(ConnectionSpec connectionSpec)
Obtain a CciTemplate derived from the main template instance, inheriting the ConnectionFactory and other settings but overriding the ConnectionSpec used for obtaining Connections.
final Connection getConnection()
Get a CCI Connection, either from the current transaction or a new one.
final void releaseConnection(Connection con)
Close the given CCI Connection, created via this bean's ConnectionFactory, if it isn't bound to the thread.
[Expand]
Inherited Methods
From class org.springframework.dao.support.DaoSupport
From class java.lang.Object
From interface org.springframework.beans.factory.InitializingBean

Public Constructors

public CciDaoSupport ()

Public Methods

public final CciTemplate getCciTemplate ()

Return the CciTemplate for this DAO, pre-initialized with the ConnectionFactory or set explicitly.

public final ConnectionFactory getConnectionFactory ()

Return the ConnectionFactory used by this DAO.

public final void setCciTemplate (CciTemplate cciTemplate)

Set the CciTemplate for this DAO explicitly, as an alternative to specifying a ConnectionFactory.

public final void setConnectionFactory (ConnectionFactory connectionFactory)

Set the ConnectionFactory to be used by this DAO.

Protected Methods

protected final void checkDaoConfig ()

Abstract subclasses must override this to check their configuration.

Implementors should be marked as final

protected CciTemplate createCciTemplate (ConnectionFactory connectionFactory)

Create a CciTemplate for the given ConnectionFactory. Only invoked if populating the DAO with a ConnectionFactory reference!

Can be overridden in subclasses to provide a CciTemplate instance with different configuration, or a custom CciTemplate subclass.

Parameters
connectionFactory the CCI ConnectionFactory to create a CciTemplate for
Returns
  • the new CciTemplate instance
See Also
  • #setConnectionFactory(javax.resource.cci.ConnectionFactory)

protected final CciTemplate getCciTemplate (ConnectionSpec connectionSpec)

Obtain a CciTemplate derived from the main template instance, inheriting the ConnectionFactory and other settings but overriding the ConnectionSpec used for obtaining Connections.

Parameters
connectionSpec the CCI ConnectionSpec that the returned template instance is supposed to obtain Connections for
Returns
  • the derived template instance
See Also
  • org.springframework.jca.cci.core.CciTemplate#getDerivedTemplate(javax.resource.cci.ConnectionSpec)

protected final Connection getConnection ()

Get a CCI Connection, either from the current transaction or a new one.

Returns
  • the CCI Connection
Throws
CannotGetCciConnectionException if the attempt to get a Connection failed
See Also
  • org.springframework.jca.cci.connection.ConnectionFactoryUtils#getConnection(javax.resource.cci.ConnectionFactory)

protected final void releaseConnection (Connection con)

Close the given CCI Connection, created via this bean's ConnectionFactory, if it isn't bound to the thread.

Parameters
con Connection to close