java.sql.Driverpublic class EmbeddedDriver
extends java.lang.Object
implements java.sql.Driver
The driver automatically supports the correct JDBC specification version for the Java Virtual Machine's environment.
Loading this JDBC driver boots the database engine within the same Java virtual machine.
The correct code to load the Derby engine using this driver is (with approriate try/catch blocks):
Class.forName("org.apache.derby.jdbc.EmbeddedDriver").newInstance();
// or
new org.apache.derby.jdbc.EmbeddedDriver();
When loaded in this way, the class boots the actual JDBC driver indirectly.
The JDBC specification recommends the Class.ForName method without the .newInstance()
method call, but adding the newInstance() guarantees
that Derby will be booted on any Java Virtual Machine.
Note that you do not need to manually load the driver this way if you are running on Jave SE 6 or later. In that environment, the driver will be automatically loaded for you when your application requests a connection to a Derby database.
Any initial error messages are placed in the PrintStream supplied by the DriverManager. If the PrintStream is null error messages are sent to System.err. Once the Derby engine has set up an error logging facility (by default to derby.log) all subsequent messages are sent to it.
By convention, the class used in the Class.forName() method to boot a JDBC driver implements java.sql.Driver. This class is not the actual JDBC driver that gets registered with the Driver Manager. It proxies requests to the registered Derby JDBC driver.
DriverManager,
DriverManager.getLogStream(),
Driver,
SQLException| Constructor | Description |
|---|---|
EmbeddedDriver() |
| Modifier and Type | Method | Description |
|---|---|---|
boolean |
acceptsURL(java.lang.String url) |
Accept anything that starts with
jdbc:derby:. |
(package private) static void |
boot() |
|
java.sql.Connection |
connect(java.lang.String url,
java.util.Properties info) |
Connect to the URL if possible
|
private java.sql.Driver |
getDriverModule() |
Lookup the booted driver module appropriate to our JDBC level.
|
int |
getMajorVersion() |
Returns the driver's major version number.
|
int |
getMinorVersion() |
Returns the driver's minor version number.
|
java.util.logging.Logger |
getParentLogger() |
|
java.sql.DriverPropertyInfo[] |
getPropertyInfo(java.lang.String url,
java.util.Properties info) |
Returns an array of DriverPropertyInfo objects describing possible properties.
|
boolean |
jdbcCompliant() |
Report whether the Driver is a genuine JDBC COMPLIANT (tm) driver.
|
public boolean acceptsURL(java.lang.String url)
throws java.sql.SQLException
jdbc:derby:.acceptsURL in interface java.sql.Driverjava.sql.SQLException - if a database-access error occurs.Driverpublic java.sql.Connection connect(java.lang.String url,
java.util.Properties info)
throws java.sql.SQLException
connect in interface java.sql.Driverjava.sql.SQLException - illegal url or problem with connectiongDriverpublic java.sql.DriverPropertyInfo[] getPropertyInfo(java.lang.String url,
java.util.Properties info)
throws java.sql.SQLException
getPropertyInfo in interface java.sql.Driverjava.sql.SQLException - if a database-access error occurs.Driverpublic int getMajorVersion()
getMajorVersion in interface java.sql.DriverDriverpublic int getMinorVersion()
getMinorVersion in interface java.sql.DriverDriverpublic boolean jdbcCompliant()
jdbcCompliant in interface java.sql.DriverDriverprivate java.sql.Driver getDriverModule()
throws java.sql.SQLException
java.sql.SQLExceptionstatic void boot()
public java.util.logging.Logger getParentLogger()
throws java.sql.SQLFeatureNotSupportedException
getParentLogger in interface java.sql.Driverjava.sql.SQLFeatureNotSupportedExceptionApache Derby V10.14 Internals - Copyright © 2004,2018 The Apache Software Foundation. All Rights Reserved.