|
Awake SQL v1.2.1 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.awakefw.sql.api.client.AwakeDriver
public class AwakeDriver
The Awake SQL Driver class in order to access remote SQL databases through HTTP.
- Note that The preferred way to connect to a
remote database is AwakeConnection
.
The Driver implementation is provided because it's necessary for usage with
third party programs as SQL client front end (SQuirreL, Netbeans IDE, etc.)
user & password are the only required properties.
Properties:
null
.HttpProtocolParameters
: 'http-client-<name>'
.String
value for String
parametersString
:
'[value.getClass().ClassName(), value.toString()]'
for
parameters of other Java type.'http.socket.timeout'
of 10 seconds, pass the
following property:
'http-client-http.socket.timeout'
.'[java.lang.Integer, 10000]'
.'http.useragent'
of
'www.acme.org User-Agent'
, pass the following property:
'http-client-http.useragent'
.'www.acme.org User-Agent'
.
Constructor Summary | |
---|---|
AwakeDriver()
Constructor. |
Method Summary | |
---|---|
boolean |
acceptsURL(String url)
Retrieves whether the driver thinks that it can open a connection to the given URL. |
Connection |
connect(String url,
Properties info)
Attempts to make a database connection to the given URL. |
int |
getMajorVersion()
Retrieves this driver's major version number. |
int |
getMinorVersion()
Gets the driver's minor version number. |
Logger |
getParentLogger()
Return the parent Logger of all the Loggers used by this driver. |
DriverPropertyInfo[] |
getPropertyInfo(String url,
Properties info)
Gets information about the possible properties for this driver. |
boolean |
jdbcCompliant()
Reports whether this driver is a genuine JDBC CompliantTM driver. |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public AwakeDriver()
Method Detail |
---|
public boolean acceptsURL(String url) throws SQLException
true
if they
understand the subprotocol specified in the URL and false
if
they do not. http(s)://<server-name:port>/<Awake SQL Servlet path>
http://www.acme.com/AwakeSqlManager
acceptsURL
in interface Driver
url
- the URL of the database
true
if this driver understands the given URL;
false
otherwise
SQLException
- if a database access error occurspublic Connection connect(String url, Properties info) throws SQLException
acceptsURL(java.lang.String)
will return
null.
The Awake driver will throwSQLException
if it is the right
driver to connect to the given URL but has trouble connecting to the
database.
The java.util.Properties
argument can be used to pass
arbitrary string tag/value pairs as connection arguments. At least "user"
and "password" properties should be included in the
Properties
object.
connect
in interface Driver
url
- the URL of the database to which to connectinfo
- a list of arbitrary string tag/value pairs as connection
arguments. At least a "user" and "password" property should be
included.
Connection
object that represents a connection to
the URL
SQLException
- if a database access error occurspublic int getMajorVersion()
getMajorVersion
in interface Driver
public int getMinorVersion()
getMinorVersion
in interface Driver
public Logger getParentLogger() throws SQLFeatureNotSupportedException
SQLFeatureNotSupportedException
- if the driver does not use java.util.logging
.public DriverPropertyInfo[] getPropertyInfo(String url, Properties info) throws SQLException
The getPropertyInfo
method is intended to allow a generic
GUI tool to discover what properties it should prompt a human for in
order to get enough information to connect to a database. Note that
depending on the values the human has supplied so far, additional values
may become necessary, so it may be necessary to iterate though several
calls to the getPropertyInfo
method.
getPropertyInfo
in interface Driver
url
- the URL of the database to which to connectinfo
- a proposed list of tag/value pairs that will be sent on
connect open
DriverPropertyInfo
objects describing
possible properties.
SQLException
- if a database access error occurspublic boolean jdbcCompliant()
true
here if it passes the JDBC compliance tests; otherwise
it is required to return false
.
JDBC compliance requires full support for the JDBC API and full support for SQL 92 Entry Level.
Because Awake driver is not a a genuine JDBC CompliantTM driver, method returns false
jdbcCompliant
in interface Driver
false
|
Awake SQL v1.2.1 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |