Package org.dellroad.stuff.schema

Class UpdatingDataSource

java.lang.Object

org.dellroad.stuff.schema.AbstractUpdatingDataSource

org.dellroad.stuff.schema.UpdatingDataSource

All Implemented Interfaces:

Wrapper, CommonDataSource, DataSource

public class UpdatingDataSource
extends AbstractUpdatingDataSource

A DataSource that wraps an inner DataSource and automatically applies a configured SQLCommandList on first access.

See Also:

• SQLCommandList

Constructor Summary

Constructors

Constructor	Description
UpdatingDataSource()

Method Summary

Modifier and Type	Method	Description
void	setSQLCommandList(SQLCommandList action)	Configure the SQLCommandList to be applied to the database on first access.
void	setTransactional(boolean transactional)	Configure whether the SQLCommandList is applied transactionally or not.
protected void	updateDataSource(DataSource dataSource)	Update the inner DataSource.

Methods inherited from class org.dellroad.stuff.schema.AbstractUpdatingDataSource

getConnection, getConnection, getInnerDataSource, getLoginTimeout, getLogWriter, getParentLogger, getUpdateCompleteFuture, getUpdatedDataSource, isAsynchronous, isUpdated, isWrapperFor, setAsynchronous, setDataSource, setLoginTimeout, setLogWriter, triggerUpdate, triggerUpdate, unwrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.sql.CommonDataSource

createShardingKeyBuilder

Methods inherited from interface javax.sql.DataSource

createConnectionBuilder

Constructor Details

UpdatingDataSource

public UpdatingDataSource()

Method Details

setSQLCommandList

public void setSQLCommandList(SQLCommandList action)

Configure the SQLCommandList to be applied to the database on first access. Required property.

Parameters:

action - SQL command(s) to apply exactly once to the underlying DataSource

setTransactional

public void setTransactional(boolean transactional)

Configure whether the SQLCommandList is applied transactionally or not. Default is true.

Parameters:

transactional - true for transactional application of SQL command(s)

updateDataSource

protected void updateDataSource(DataSource dataSource)
                         throws SQLException

Description copied from class: AbstractUpdatingDataSource

Update the inner DataSource.

This method will be invoked at most once.

Specified by:

updateDataSource in class AbstractUpdatingDataSource

Parameters:

dataSource - the DataSource to update

Throws:

SQLException - if the update attempt fails