Interface SmartDataSource
- All Superinterfaces:
CommonDataSource
,DataSource
,Wrapper
- All Known Implementing Classes:
SingleConnectionDataSource
public interface SmartDataSource extends DataSource
Extension of thejavax.sql.DataSource
interface, to be implemented by special DataSources that return JDBC Connections in an unwrapped fashion.Classes using this interface can query whether or not the Connection should be closed after an operation. Spring's DataSourceUtils and JdbcTemplate classes automatically perform such a check.
- Author:
- Rod Johnson, Juergen Hoeller
- See Also:
SingleConnectionDataSource.shouldClose(java.sql.Connection)
,DataSourceUtils.releaseConnection(java.sql.Connection, javax.sql.DataSource)
,JdbcTemplate
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description boolean
shouldClose(Connection con)
Should we close this Connection, obtained from this DataSource?Methods inherited from interface javax.sql.CommonDataSource
createShardingKeyBuilder, getParentLogger
Methods inherited from interface javax.sql.DataSource
createConnectionBuilder, getConnection, getConnection, getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter
Methods inherited from interface java.sql.Wrapper
isWrapperFor, unwrap
Method Detail
shouldClose
boolean shouldClose(Connection con)
Should we close this Connection, obtained from this DataSource?Code that uses Connections from a SmartDataSource should always perform a check via this method before invoking
close()
.Note that the JdbcTemplate class in the 'jdbc.core' package takes care of releasing JDBC Connections, freeing application code of this responsibility.
- Parameters:
con
- the Connection to check- Returns:
- whether the given Connection should be closed
- See Also:
Connection.close()