Class AbstractDriverBasedDataSource
java.lang.Object
org.springframework.jdbc.datasource.AbstractDataSource
org.springframework.jdbc.datasource.AbstractDriverBasedDataSource
- All Implemented Interfaces:
Wrapper
,CommonDataSource
,DataSource
- Direct Known Subclasses:
DriverManagerDataSource
,SimpleDriverDataSource
Abstract base class for JDBC
DataSource
implementations
that operate on a JDBC Driver
.- Since:
- 2.5.5
- Author:
- Juergen Hoeller
- See Also:
-
Field Summary
Fields inherited from class org.springframework.jdbc.datasource.AbstractDataSource
logger
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionReturn the database catalog to be applied to each Connection, if any.This implementation delegates togetConnectionFromDriver
, using the default username and password of this DataSource.getConnection
(String username, String password) This implementation delegates togetConnectionFromDriver
, using the given username and password.protected Connection
getConnectionFromDriver
(String username, String password) Build properties for the Driver, including the given username and password (if any), and obtain a corresponding Connection.protected abstract Connection
Obtain a Connection using the given properties.Return the connection properties to be passed to the Driver, if any.Return the JDBC password to use for connecting through the Driver.Return the database schema to be applied to each Connection, if any.getUrl()
Return the JDBC URL to use for connecting through the Driver.Return the JDBC username to use for connecting through the Driver.void
setCatalog
(String catalog) Specify a database catalog to be applied to each Connection.void
setConnectionProperties
(Properties connectionProperties) Specify arbitrary connection properties as key/value pairs, to be passed to the Driver.void
setPassword
(String password) Set the JDBC password to use for connecting through the Driver.void
Specify a database schema to be applied to each Connection.void
Set the JDBC URL to use for connecting through the Driver.void
setUsername
(String username) Set the JDBC username to use for connecting through the Driver.Methods inherited from class org.springframework.jdbc.datasource.AbstractDataSource
getLoginTimeout, getLogWriter, getParentLogger, isWrapperFor, setLoginTimeout, setLogWriter, 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
-
AbstractDriverBasedDataSource
public AbstractDriverBasedDataSource()
-
-
Method Details
-
setUrl
Set the JDBC URL to use for connecting through the Driver. -
getUrl
Return the JDBC URL to use for connecting through the Driver. -
setUsername
Set the JDBC username to use for connecting through the Driver. -
getUsername
Return the JDBC username to use for connecting through the Driver. -
setPassword
Set the JDBC password to use for connecting through the Driver. -
getPassword
Return the JDBC password to use for connecting through the Driver. -
setCatalog
Specify a database catalog to be applied to each Connection.- Since:
- 4.3.2
- See Also:
-
getCatalog
Return the database catalog to be applied to each Connection, if any.- Since:
- 4.3.2
-
setSchema
Specify a database schema to be applied to each Connection.- Since:
- 4.3.2
- See Also:
-
getSchema
Return the database schema to be applied to each Connection, if any.- Since:
- 4.3.2
-
setConnectionProperties
Specify arbitrary connection properties as key/value pairs, to be passed to the Driver.Can also contain "user" and "password" properties. However, any "username" and "password" bean properties specified on this DataSource will override the corresponding connection properties.
-
getConnectionProperties
Return the connection properties to be passed to the Driver, if any. -
getConnection
This implementation delegates togetConnectionFromDriver
, using the default username and password of this DataSource. -
getConnection
This implementation delegates togetConnectionFromDriver
, using the given username and password.- Throws:
SQLException
- See Also:
-
getConnectionFromDriver
protected Connection getConnectionFromDriver(@Nullable String username, @Nullable String password) throws SQLException Build properties for the Driver, including the given username and password (if any), and obtain a corresponding Connection.- Parameters:
username
- the name of the userpassword
- the password to use- Returns:
- the obtained Connection
- Throws:
SQLException
- in case of failure- See Also:
-
getConnectionFromDriver
Obtain a Connection using the given properties.Template method to be implemented by subclasses.
- Parameters:
props
- the merged connection properties- Returns:
- the obtained Connection
- Throws:
SQLException
- in case of failure
-