org.javasimon.jdbc4

Class Driver

java.lang.Object

org.javasimon.jdbc4.Driver

All Implemented Interfaces:

Driver

public final class Driver
extends Object
implements Driver

Simon JDBC 4.1 Proxy Driver (Java SE 7).

An application should not use this class directly. The application (if standalone) should use DriverManager only. For example:

 Connection conn = DriverManager.getConnection("jdbc:simon:oracle:thin:...", "scott", "tiger");

Simon driver has following format of JDBC connection string:

jdbc:simon:<real driver conn string>;<param1>=<value1>;...

Simon driver recognizes two parameters:

• SIMON_REAL_DRV - if you don't want or can't register real driver for any reason, you can use this parameter and Simon proxy driver will do the registration for you. You don't need to specify real driver parameter for some well known databases. Simon proxy driver recognize database by first key word after JDBC and register.
• SIMON_PREFIX - setting this parameter you can choose different prefix for all monitors for one instance of driver. For example, setting SIMON_PREFIX=com.foo will ensure that all proxy related Simons are located under the subtree specified by the prefix, e.g. com.foo.conn, com.foo.stmt, com.foo.select, etc. If no prefix is set, default org.javasimon.jdbc prefix is used.

` By default, there is no need to load any driver explicitly, because drivers are loaded automatically (since JDK 1.5) if they are in class path and jar have appropriate meta information (see DriverManager). If this is not a case for any reason, you need to register Simon proxy driver at least. For real driver Simon proxy driver contains following procedure for find and register it:

1. Simon proxy driver tries if there is registered driver for driver key word.
2. If not, driver tries if there is real driver parameter in info properties and then registers it.
3. If not, driver tries to find driver by key word within internal list of well known drivers and then registers it. For now, list contains default drivers for Oracle, PostgreSQL, Enterprise DB, H2, MySQL.
4. If not, driver tries to find real driver param within connection string and then registers it.
5. If not, getting new connection fails.

The safest way to get Simon proxy driver work is to load the drivers, the real one (i.e. oracle) and a Simon proxy driver explicitly. This can be done using Class.forName. To load the driver and open a database connection, use following code:

 Class.forName("oracle.jdbc.driver.OracleDriver");  // loads real driver
 Class.forName("org.javasimon.jdbc4.Driver");  // loads Simon proxy driver
 Connection conn = DriverManager.getConnection(
      "jdbc:simon:oracle:thin:...", "scott", "tiger");

Since:

2.4

Author:

Radovan Sninsky, Richard "Virgo" Richter

See Also:

DriverManager.getConnection(String)

Constructor Summary

Constructors

Constructor and Description
Driver() Class constructor.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	acceptsURL(String url)
Connection	connect(String simonUrl, Properties info) Opens new Simon proxy driver connection associated with real connection to the specified database.
int	getMajorVersion()
int	getMinorVersion()
Logger	getParentLogger()
DriverPropertyInfo[]	getPropertyInfo(String s, Properties properties)
boolean	jdbcCompliant()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Driver

public Driver()

Class constructor. It loads well known driver list from resource file drivers.properties.

Method Detail

connect

public Connection connect(String simonUrl,
                 Properties info)
                   throws SQLException

Opens new Simon proxy driver connection associated with real connection to the specified database.

Specified by:

connect in interface Driver

Parameters:

simonUrl - JDBC connection string (i.e. jdbc:simon:h2:file:test)

info - properties for connection

Returns:

open connection to database or null if provided url is not accepted by this driver

Throws:

SQLException - if there is no real driver registered/recognized or opening real connection fails

See Also:

Driver

acceptsURL

public boolean acceptsURL(String url)
                   throws SQLException

Specified by:

acceptsURL in interface Driver

Throws:

SQLException

getPropertyInfo

public DriverPropertyInfo[] getPropertyInfo(String s,
                                   Properties properties)
                                     throws SQLException

Specified by:

getPropertyInfo in interface Driver

Throws:

SQLException

getMajorVersion

public int getMajorVersion()

Specified by:

getMajorVersion in interface Driver

getMinorVersion

public int getMinorVersion()

Specified by:

getMinorVersion in interface Driver

jdbcCompliant

public boolean jdbcCompliant()

Specified by:

jdbcCompliant in interface Driver

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface Driver

Throws:

SQLFeatureNotSupportedException