org.javasimon.jdbcx4

Class SimonDataSource

java.lang.Object

org.javasimon.jdbcx4.AbstractSimonDataSource

org.javasimon.jdbcx4.SimonDataSource

All Implemented Interfaces:

Wrapper, CommonDataSource, DataSource

public final class SimonDataSource
extends AbstractSimonDataSource
implements DataSource

Wrapper class for real DataSource implementation, produces standard Connection object.

To use SimonDataSource, MUST properties are:

• realDataSourceClassName - full qualified classname of real Datasource implementation
• url - JDBC connection URL (no special Simon added tags are needed)
• user - DB user name
• password - DB user name

MAY properties are:

• prefix - Simon prefix (default: org.javasimon.jdbcx4

As mentioned in package description all getConnection methods just invokes real DataSource object methods and wraps obtained Connection with SimonConnection object.

Real DataSource is obtained in method datasource(). It tries to instantiate real datasource object by property realDataSourceClassName (setters and getters for properties are in AbstractSimonDataSource) and then sets basic properties (url, user, password).

Since:

2.4

Author:

Radovan Sninsky, Richard "Virgo" Richter

Field Summary

Fields inherited from class org.javasimon.jdbcx4.AbstractSimonDataSource

configuration, logWriter

Constructor Summary

Constructors

Constructor and Description
SimonDataSource()

Method Summary

Methods

Modifier and Type	Method and Description
protected String	doGetRealDataSourceClassName() Reads DataSource class name from configuration.
Connection	getConnection() Attempts to establish a connection with the data source that this DataSource object represents.
Connection	getConnection(String user, String password) Attempts to establish a connection with the data source that this DataSource object represents.
Logger	getParentLogger()
boolean	isWrapperFor(Class<?> iface)
<T> T	unwrap(Class<T> iface)

Methods inherited from class org.javasimon.jdbcx4.AbstractSimonDataSource

createDataSource, getLoginTimeout, getLogWriter, getPassword, getPrefix, getProperties, getRealDataSourceClassName, getRealUrl, getUrl, getUser, setLoginTimeout, setLogWriter, setPassword, setPrefix, setProperties, setRealDataSourceClassName, setUrl, setUser

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

getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

Constructor Detail

SimonDataSource

public SimonDataSource()

Method Detail

getConnection

public Connection getConnection()
                         throws SQLException

Attempts to establish a connection with the data source that this DataSource object represents.

Specified by:

getConnection in interface DataSource

Returns:

a connection to the data source

Throws:

SQLException - if a database access error occurs

getConnection

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

Attempts to establish a connection with the data source that this DataSource object represents.

Specified by:

getConnection in interface DataSource

Parameters:

user - the database user on whose behalf the connection is being made

password - the user's password

Returns:

a connection to the data source

Throws:

SQLException - if a database access error occurs

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

doGetRealDataSourceClassName

protected String doGetRealDataSourceClassName()

Description copied from class: AbstractSimonDataSource

Reads DataSource class name from configuration.

Specified by:

doGetRealDataSourceClassName in class AbstractSimonDataSource

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface CommonDataSource

Throws:

SQLFeatureNotSupportedException