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.StringBLOB_BUFFER_LENGTHDeprecated.static java.lang.StringCHARSETDeprecated.static java.lang.StringDATABASEDeprecated.static java.lang.StringPASSWORDDeprecated.static java.lang.StringTPB_MAPPINGDeprecated.static java.lang.StringUSERDeprecated.static java.lang.StringUSER_NAMEDeprecated.
-
Constructor Summary
Constructors Constructor Description FBDriver()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description booleanacceptsURL(java.lang.String url)java.sql.Connectionconnect(java.lang.String url, java.util.Properties info)FirebirdConnectionconnect(FirebirdConnectionProperties properties)Connect to the specified database using the specified connection properties.intgetMajorVersion()intgetMinorVersion()java.util.logging.LoggergetParentLogger()java.sql.DriverPropertyInfo[]getPropertyInfo(java.lang.String url, java.util.Properties info)booleanjdbcCompliant()FirebirdConnectionPropertiesnewConnectionProperties()Create new instance ofFirebirdConnectionPropertiesthat can later be used inFirebirdDriver.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.
-
-
-
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.- 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.- See Also:
- Constant Field Values
-
TPB_MAPPING
@Deprecated public static final java.lang.String TPB_MAPPING
Deprecated.- See Also:
- Constant Field Values
-
-
Method Detail
-
connect
public java.sql.Connection connect(java.lang.String url, java.util.Properties info) throws java.sql.SQLException- Specified by:
connectin interfacejava.sql.Driver- Throws:
java.sql.SQLException
-
connect
public FirebirdConnection connect(FirebirdConnectionProperties properties) throws java.sql.SQLException
Description copied from interface:FirebirdDriverConnect to the specified database using the specified connection properties.- Specified by:
connectin interfaceFirebirdDriver- Parameters:
properties- instance ofFirebirdConnectionPropertiescreated inFirebirdDriver.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:FirebirdDriverCreate new instance ofFirebirdConnectionPropertiesthat can later be used inFirebirdDriver.connect(FirebirdConnectionProperties)call.- Specified by:
newConnectionPropertiesin interfaceFirebirdDriver- Returns:
- instance of
FirebirdConnectionProperties.
-
acceptsURL
public boolean acceptsURL(java.lang.String url) throws java.sql.SQLException- Specified by:
acceptsURLin interfacejava.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:
getPropertyInfoin interfacejava.sql.Driver- Throws:
java.sql.SQLException
-
getMajorVersion
public int getMajorVersion()
- Specified by:
getMajorVersionin interfacejava.sql.Driver
-
getMinorVersion
public int getMinorVersion()
- Specified by:
getMinorVersionin interfacejava.sql.Driver
-
jdbcCompliant
public boolean jdbcCompliant()
- Specified by:
jdbcCompliantin interfacejava.sql.Driver
-
getParentLogger
public java.util.logging.Logger getParentLogger() throws java.sql.SQLFeatureNotSupportedException- Specified by:
getParentLoggerin interfacejava.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.SQLExceptionMerges 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 UrlconnectionProperties- Properties object- Returns:
- New map object with the merged and normalized connection properties
- Throws:
java.sql.SQLException- For failures to extract connection properties fromjdbcUrl(URL decoding errors), or presence of the same property under multiple aliases.- Since:
- 4.0.1
-
-