spring-framework / org.springframework.jdbc.datasource / SimpleDriverDataSource

SimpleDriverDataSource

open class SimpleDriverDataSource : AbstractDriverBasedDataSource

Simple implementation of the standard JDBC javax.sql.DataSource interface, configuring a plain old JDBC java.sql.Driver via bean properties, and returning a new java.sql.Connection from every getConnection call.

NOTE: This class is not an actual connection pool; it does not actually pool Connections. It just serves as simple replacement for a full-blown connection pool, implementing the same standard interface, but creating new Connections on every call.

In a Java EE container, it is recommended to use a JNDI DataSource provided by the container. Such a DataSource can be exposed as a DataSource bean in a Spring ApplicationContext via org.springframework.jndi.JndiObjectFactoryBean, for seamless switching to and from a local DataSource bean like this class.

If you need a "real" connection pool outside of a Java EE container, consider Apache Commons DBCP or C3P0. Commons DBCP's BasicDataSource and C3P0's ComboPooledDataSource are full connection pool beans, supporting the same basic properties as this class plus specific settings (such as minimal/maximal pool size etc).

Author
Juergen Hoeller

Since
2.5.5

See Also
DriverManagerDataSource

Constructors

<init>

SimpleDriverDataSource()

Constructor for bean-style configuration.

SimpleDriverDataSource(driver: Driver, url: String)
SimpleDriverDataSource(driver: Driver, url: String, username: String, password: String)
SimpleDriverDataSource(driver: Driver, url: String, conProps: Properties)

Create a new DriverManagerDataSource with the given standard Driver parameters.

Functions

getDriver

open fun getDriver(): Driver

Return the JDBC Driver instance to use.

setDriver

open fun setDriver(driver: Driver): Unit

Specify the JDBC Driver instance to use.

This allows for passing in a shared, possibly pre-configured Driver instance.

setDriverClass

open fun setDriverClass(driverClass: Class<out Driver>): Unit

Specify the JDBC Driver implementation class to use.

An instance of this Driver class will be created and held within the SimpleDriverDataSource.

Inherited Functions

getCatalog

open fun getCatalog(): String

Return the database catalog to be applied to each Connection, if any.

getConnection

open fun getConnection(): Connection

This implementation delegates to getConnectionFromDriver, using the default username and password of this DataSource.

open fun getConnection(username: String, password: String): Connection

This implementation delegates to getConnectionFromDriver, using the given username and password.

getConnectionProperties

open fun getConnectionProperties(): Properties

Return the connection properties to be passed to the Driver, if any.

getPassword

open fun getPassword(): String

Return the JDBC password to use for connecting through the Driver.

getSchema

open fun getSchema(): String

Return the database schema to be applied to each Connection, if any.

getUrl

open fun getUrl(): String

Return the JDBC URL to use for connecting through the Driver.

getUsername

open fun getUsername(): String

Return the JDBC username to use for connecting through the Driver.

setCatalog

open fun setCatalog(catalog: String): Unit

Specify a database catalog to be applied to each Connection.

setConnectionProperties

open fun setConnectionProperties(connectionProperties: Properties): Unit

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.

setPassword

open fun setPassword(password: String): Unit

Set the JDBC password to use for connecting through the Driver.

setSchema

open fun setSchema(schema: String): Unit

Specify a database schema to be applied to each Connection.

setUrl

open fun setUrl(url: String): Unit

Set the JDBC URL to use for connecting through the Driver.

setUsername

open fun setUsername(username: String): Unit

Set the JDBC username to use for connecting through the Driver.