org.springframework.orm.ibatis.support
Class SqlMapClientDaoSupport

java.lang.Object
  org.springframework.orm.ibatis.support.SqlMapClientDaoSupport

All Implemented Interfaces:

InitializingBean

public abstract class SqlMapClientDaoSupport

extends Object

implements InitializingBean

Convenient super class for iBATIS SqlMapClient data access objects. Requires a SqlMapClient to be set, providing a SqlMapClientTemplate based on it to subclasses.

Instead of a plain SqlMapClient, you can also pass a preconfigured SqlMapClientTemplate instance in. This allows you to share your SqlMapClientTemplate configuration for all your DAOs, for example a custom SQLExceptionTranslator to use.

Since:

24.02.2004

Author:

Juergen Hoeller

See Also:

setSqlMapClient(com.ibatis.sqlmap.client.SqlMapClient), setSqlMapClientTemplate(org.springframework.orm.ibatis.SqlMapClientTemplate), SqlMapClientTemplate, JdbcAccessor.setExceptionTranslator(org.springframework.jdbc.support.SQLExceptionTranslator)

Field Summary

protected Log

logger

Constructor Summary

SqlMapClientDaoSupport()

Method Summary

void	afterPropertiesSet() Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).
DataSource	getDataSource() Return the JDBC DataSource used by this DAO.
SqlMapClient	getSqlMapClient() Return the iBATIS Database Layer SqlMapClient that this template works with.
SqlMapClientTemplate	getSqlMapClientTemplate() Return the SqlMapClientTemplate for this DAO, pre-initialized with the SqlMapClient or set explicitly.
protected void	initDao() Subclasses can override this for custom initialization behavior.
void	setDataSource(DataSource dataSource) Set the JDBC DataSource to be used by this DAO.
void	setSqlMapClient(SqlMapClient sqlMapClient) Set the iBATIS Database Layer SqlMapClient to work with.
void	setSqlMapClientTemplate(SqlMapClientTemplate sqlMapClientTemplate) Set the SqlMapClientTemplate for this DAO explicitly, as an alternative to specifying a SqlMapClient.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final Log logger

Constructor Detail

SqlMapClientDaoSupport

public SqlMapClientDaoSupport()

Method Detail

setDataSource

public final void setDataSource(DataSource dataSource)

Set the JDBC DataSource to be used by this DAO. Not required: The SqlMapClient might carry a shared DataSource.

See Also:

setSqlMapClient(com.ibatis.sqlmap.client.SqlMapClient)

getDataSource

public final DataSource getDataSource()

Return the JDBC DataSource used by this DAO.

setSqlMapClient

public final void setSqlMapClient(SqlMapClient sqlMapClient)

Set the iBATIS Database Layer SqlMapClient to work with. Either this or a "sqlMapClientTemplate" is required.

See Also:

setSqlMapClientTemplate(org.springframework.orm.ibatis.SqlMapClientTemplate)

getSqlMapClient

public final SqlMapClient getSqlMapClient()

Return the iBATIS Database Layer SqlMapClient that this template works with.

setSqlMapClientTemplate

public final void setSqlMapClientTemplate(SqlMapClientTemplate sqlMapClientTemplate)

Set the SqlMapClientTemplate for this DAO explicitly, as an alternative to specifying a SqlMapClient.

See Also:

setSqlMapClient(com.ibatis.sqlmap.client.SqlMapClient)

getSqlMapClientTemplate

public final SqlMapClientTemplate getSqlMapClientTemplate()

Return the SqlMapClientTemplate for this DAO, pre-initialized with the SqlMapClient or set explicitly.

afterPropertiesSet

public final void afterPropertiesSet()
                              throws Exception

Description copied from interface: InitializingBean

Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).

This method allows the bean instance to perform initialization only possible when all bean properties have been set and to throw an exception in the event of misconfiguration.

Specified by:

afterPropertiesSet in interface InitializingBean

Throws:

Exception - in the event of misconfiguration (such as failure to set an essential property) or if initialization fails.

initDao

protected void initDao()
                throws Exception

Subclasses can override this for custom initialization behavior. Gets called after population of this instance's bean properties.

Throws:

Exception - if initialization fails