Package org.firebirdsql.jdbc

Class FBDriver

java.lang.Object

org.firebirdsql.jdbc.FBDriver

All Implemented Interfaces:

java.sql.Driver, FirebirdDriver

public class FBDriver
extends java.lang.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 java.lang.String	BLOB_BUFFER_LENGTH	Deprecated. Use PropertyNames.blobBufferSize
static java.lang.String	CHARSET	Deprecated.
static java.lang.String	DATABASE	Deprecated.
static java.lang.String	PASSWORD	Deprecated.
static java.lang.String	TPB_MAPPING	Deprecated. Use PropertyNames.tpbMapping
static java.lang.String	USER	Deprecated.
static java.lang.String	USER_NAME	Deprecated. Use PropertyNames.user

Constructor Summary

Constructors

Constructor	Description
FBDriver()

Method Summary

Modifier and Type	Method	Description
boolean	acceptsURL(java.lang.String url)
java.sql.Connection	connect(java.lang.String url, java.util.Properties info)
FirebirdConnection	connect(FirebirdConnectionProperties properties)	Connect to the specified database using the specified connection properties.
int	getMajorVersion()
int	getMinorVersion()
java.util.logging.Logger	getParentLogger()
java.sql.DriverPropertyInfo[]	getPropertyInfo(java.lang.String url, java.util.Properties info)
boolean	jdbcCompliant()
FirebirdConnectionProperties	newConnectionProperties()	Create new instance of FirebirdConnectionProperties that can later be used in FirebirdDriver.connect(FirebirdConnectionProperties) call.
static java.util.Map<java.lang.String,java.lang.String>	normalizeProperties(java.lang.String jdbcUrl, java.util.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 Detail

CHARSET

@Deprecated
public static final java.lang.String CHARSET

Deprecated.

See Also:

Constant Field Values

USER

@Deprecated
public static final java.lang.String USER

Deprecated.

See Also:

Constant Field Values

USER_NAME

@Deprecated
public static final java.lang.String USER_NAME

Deprecated.

Use PropertyNames.user

See Also:

Constant Field Values

PASSWORD

@Deprecated
public static final java.lang.String PASSWORD

Deprecated.

See Also:

Constant Field Values

DATABASE

@Deprecated
public static final java.lang.String DATABASE

Deprecated.

See Also:

Constant Field Values

BLOB_BUFFER_LENGTH

@Deprecated
public static final java.lang.String BLOB_BUFFER_LENGTH

Deprecated.

Use PropertyNames.blobBufferSize

See Also:

Constant Field Values

TPB_MAPPING

@Deprecated
public static final java.lang.String TPB_MAPPING

Deprecated.

Use PropertyNames.tpbMapping

See Also:

Constant Field Values

Constructor Detail

FBDriver

public FBDriver()

Method Detail

connect

public java.sql.Connection connect(java.lang.String url,
                                   java.util.Properties info)
                            throws java.sql.SQLException

Specified by:

connect in interface java.sql.Driver

Throws:

java.sql.SQLException

connect

public FirebirdConnection connect(FirebirdConnectionProperties properties)
                           throws java.sql.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:

java.sql.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(java.lang.String url)
                   throws java.sql.SQLException

Specified by:

acceptsURL in interface java.sql.Driver

Throws:

java.sql.SQLException

getPropertyInfo

public java.sql.DriverPropertyInfo[] getPropertyInfo(java.lang.String url,
                                                     java.util.Properties info)
                                              throws java.sql.SQLException

Specified by:

getPropertyInfo in interface java.sql.Driver

Throws:

java.sql.SQLException

getMajorVersion

public int getMajorVersion()

Specified by:

getMajorVersion in interface java.sql.Driver

getMinorVersion

public int getMinorVersion()

Specified by:

getMinorVersion in interface java.sql.Driver

jdbcCompliant

public boolean jdbcCompliant()

Specified by:

jdbcCompliant in interface java.sql.Driver

getParentLogger

public java.util.logging.Logger getParentLogger()
                                         throws java.sql.SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface java.sql.Driver

Throws:

java.sql.SQLFeatureNotSupportedException

normalizeProperties

public static java.util.Map<java.lang.String,java.lang.String> normalizeProperties(java.lang.String jdbcUrl,
                                                                                         java.util.Properties connectionProperties)
                                                                                  throws java.sql.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. Occurrence of multiple (distinct) aliases for the same property result in a SQLException.

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.

The behaviour of this method does not necessarily match the behaviour of Jaybird when processing properties during connect(String, Properties), as this method performs additional processing that is skipped during connect.

Parameters:

jdbcUrl - JDBC Url

connectionProperties - Properties object

Returns:

New map object with the merged and normalized connection properties

Throws:

java.sql.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