Package org.firebirdsql.jdbc

Class FBDriver

java.lang.Object

org.firebirdsql.jdbc.FBDriver

All Implemented Interfaces:

Driver, FirebirdDriver

public class FBDriver
extends Object
implements FirebirdDriver

The Jaybird JDBC Driver implementation for the Firebird database.

Author:

David Jencks, Mark Rotteveel

Field Summary

Fields

Modifier and Type	Field	Description
static final String	BLOB_BUFFER_LENGTH
static final String	CHARSET
static final String	DATABASE
static final String	PASSWORD
static final String	TPB_MAPPING
static final String	USER
static final String	USER_NAME

Constructor Summary

Constructors

Constructor	Description
FBDriver()

Method Summary

Modifier and Type	Method	Description
boolean	acceptsURL(String url)
Connection	connect(String url, Properties info)
FirebirdConnection	connect(FirebirdConnectionProperties properties)	Connect to the specified database using the specified connection properties.
int	getMajorVersion()
int	getMinorVersion()
Logger	getParentLogger()
DriverPropertyInfo[]	getPropertyInfo(String url, Properties info)
boolean	jdbcCompliant()
FirebirdConnectionProperties	newConnectionProperties()	Create new instance of FirebirdConnectionProperties that can later be used in FirebirdDriver.connect(FirebirdConnectionProperties) call.
static Map<String,String>	normalizeProperties(String jdbcUrl, Properties connectionProperties)	Merges the properties from the JDBC URL and properties object, normalizes them to a standard name.

Methods inherited from class java.lang.Object

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

Field Details

CHARSET

public static final String CHARSET

See Also:

• Constant Field Values

USER

public static final String USER

See Also:

• Constant Field Values

USER_NAME

public static final String USER_NAME

See Also:

• Constant Field Values

PASSWORD

public static final String PASSWORD

See Also:

• Constant Field Values

DATABASE

public static final String DATABASE

See Also:

• Constant Field Values

BLOB_BUFFER_LENGTH

public static final String BLOB_BUFFER_LENGTH

See Also:

• Constant Field Values

TPB_MAPPING

public static final String TPB_MAPPING

See Also:

• Constant Field Values

Constructor Details

FBDriver

public FBDriver()

Method Details

connect

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

Specified by:

connect in interface Driver

Throws:

SQLException

connect

public FirebirdConnection connect(FirebirdConnectionProperties properties)
                           throws SQLException

Description copied from interface: FirebirdDriver

Connect to the specified database using the specified connection properties.

Specified by:

connect in interface FirebirdDriver

Parameters:

properties - instance of FirebirdConnectionProperties created in FirebirdDriver.newConnectionProperties() method.

Returns:

new connection to the Firebird database.

Throws:

SQLException - if an error happened while connecting to the database.

newConnectionProperties

public FirebirdConnectionProperties newConnectionProperties()

Description copied from interface: FirebirdDriver

Create new instance of FirebirdConnectionProperties that can later be used in FirebirdDriver.connect(FirebirdConnectionProperties) call.

Specified by:

newConnectionProperties in interface FirebirdDriver

Returns:

instance of FirebirdConnectionProperties.

acceptsURL

public boolean acceptsURL(String url)
                   throws SQLException

Specified by:

acceptsURL in interface Driver

Throws:

SQLException

getPropertyInfo

public DriverPropertyInfo[] getPropertyInfo(String url,
 Properties info)
                                     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

normalizeProperties

public static Map<String,String> normalizeProperties(String jdbcUrl,
 Properties connectionProperties)
                                              throws SQLException

Merges the properties from the JDBC URL and properties object, normalizes them to a standard name.

If a property with the exact same name is present in both, the property specified in the JDBC url takes precedence. Short and long form isc_dpb properties will be merged if both are present, as will two different (non-isc_dpb) aliases, but precedence is undefined. If a property is specified in the (short or long) isc_dpb form and as an alias, then an exception is thrown.

The property name that is the result of normalization, is implementation specific behaviour, and might change in a future version of Jaybird. When present, the (normalized) property `"database"` will be excluded, this also might change in the future.

Parameters:

jdbcUrl - JDBC Url

connectionProperties - Properties object

Returns:

New map object with the merged and normalized connection properties

Throws:

SQLException - For failures to extract connection properties from jdbcUrl (URL decoding errors), or presence of the same property under multiple aliases.

Since:

4.0.1