Package com.invirgance.convirgance.jdbc.datasource

Class DriverDataSource

java.lang.Object

com.invirgance.convirgance.jdbc.datasource.DriverDataSource

All Implemented Interfaces:

Wrapper, CommonDataSource, DataSource

public class DriverDataSource
extends Object
implements DataSource

A JDBC DataSource implementation that wraps a database driver to provide connection services. This class automates the process of establishing database connections using driver-based connectivity. It determines the appropriate JDBC driver based on the connection URL and manages connection credentials. This is particularly useful for scenarios where you need to create DataSources dynamically from existing login information.

Author:

jbanes

Constructor Summary

Constructors

Constructor	Description
DriverDataSource()

Method Summary

Modifier and Type	Method	Description
Connection	getConnection()	Returns a connection to the database using the current username and password.
Connection	getConnection(String username, String password)	Returns a connection to the database using the provided username and password.
static DriverDataSource	getDataSource(String url, String username, String password)	Returns a DriverDataSource created with the provided info.
int	getLoginTimeout()
PrintWriter	getLogWriter()
Logger	getParentLogger()
String	getPassword()	Returns the password.
String	getUrl()	Get the connection URL.
String	getUsername()	Returns the username used when connecting to the database.
boolean	isWrapperFor(Class<?> iface)
void	setLoginTimeout(int seconds)
void	setLogWriter(PrintWriter out)
void	setPassword(String password)	Sets the password that will be used with the username when connecting.
void	setUrl(String url)	Sets the connection URL.
void	setUsername(String username)	Sets the username to use for connecting to the database.
<T> T	unwrap(Class<T> iface)

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

DriverDataSource

public DriverDataSource()

Method Details

getDataSource

public static DriverDataSource getDataSource(String url,
 String username,
 String password)

Returns a DriverDataSource created with the provided info.

Parameters:

url - The connection URL.

username - The username.

password - The password.

Returns:

A DriverDataSource.

getUrl

public String getUrl()

Get the connection URL.

Returns:

The connection string URL.

setUrl

public void setUrl(String url)

Sets the connection URL. Remember to include the connection prefix. Ex: "jdbc:oracle:thin:"

Parameters:

url - The new connection URL.

getUsername

public String getUsername()

Returns the username used when connecting to the database.

Returns:

The username.

setUsername

public void setUsername(String username)

Sets the username to use for connecting to the database.

Parameters:

username - The username.

getPassword

public String getPassword()

Returns the password.

Returns:

The password.

setPassword

public void setPassword(String password)

Sets the password that will be used with the username when connecting.

Parameters:

password - The password.

getConnection

public Connection getConnection()
                         throws SQLException

Returns a connection to the database using the current username and password. The password is optional when connecting with this method.

Specified by:

getConnection in interface DataSource

Returns:

A connection.

Throws:

SQLException - When the username and password are incorrect or the something else.

getConnection

public Connection getConnection(String username,
 String password)
                         throws SQLException

Returns a connection to the database using the provided username and password.

Specified by:

getConnection in interface DataSource

Parameters:

username - The username.

password - The password.

Returns:

A connection.

Throws:

SQLException - When the username and password are incorrect or the something else.

getLogWriter

public PrintWriter getLogWriter()
                         throws SQLException

Specified by:

getLogWriter in interface CommonDataSource

Specified by:

getLogWriter in interface DataSource

Throws:

SQLException

setLogWriter

public void setLogWriter(PrintWriter out)
                  throws SQLException

Specified by:

setLogWriter in interface CommonDataSource

Specified by:

setLogWriter in interface DataSource

Throws:

SQLException

setLoginTimeout

public void setLoginTimeout(int seconds)
                     throws SQLException

Specified by:

setLoginTimeout in interface CommonDataSource

Specified by:

setLoginTimeout in interface DataSource

Throws:

SQLException

getLoginTimeout

public int getLoginTimeout()
                    throws SQLException

Specified by:

getLoginTimeout in interface CommonDataSource

Specified by:

getLoginTimeout in interface DataSource

Throws:

SQLException

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface CommonDataSource

Throws:

SQLFeatureNotSupportedException

unwrap

public <T> T unwrap(Class<T> iface)
             throws SQLException

Specified by:

unwrap in interface Wrapper

Throws:

SQLException

isWrapperFor

public boolean isWrapperFor(Class<?> iface)
                     throws SQLException

Specified by:

isWrapperFor in interface Wrapper

Throws:

SQLException