| java.lang.Object
 org.apache.derby.jdbc.EmbeddedSimpleDataSource
| EmbeddedSimpleDataSource | | final public class EmbeddedSimpleDataSource implements DataSource(Code) | | EmbeddedSimpleDataSource is Derby's DataSource implementation
for J2ME/CDC/Foundation. It is also supports J2SE platforms.
Supports the same properties as EmbeddedDataSource, see that class for details.
EmbeddedSimpleDataSource automatically supports the correct JDBC specification version
for the Java Virtual Machine's environment.
- JDBC Optional Package for CDC/Foundation Profile(JSR-169) - J2ME - CDC/Foundation
- JDBC 3.0 - Java 2 - JDK 1.4, J2SE 5.0
- JDBC 2.0 - Java 2 - JDK 1.2,1.3
See Also: EmbeddedDataSource |
| Method Summary | |
| final public Connection | getConnection()
Attempt to establish a database connection. | | final public Connection | getConnection(String username, String password)
Attempt to establish a database connection with the given username and
password. | | final public String | getConnectionAttributes()
| | final public String | getCreateDatabase()
| | final public String | getDataSourceName()
| | public String | getDatabaseName()
| | final public String | getDescription()
| | public PrintWriter | getLogWriter()
Get the log writer for this data source.
The log writer is a character output stream to which all logging and
tracing messages for this data source object instance will be printed.
This includes messages printed by the methods of this object, messages
printed by methods of other objects manufactured by this object, and so
on. | | public int | getLoginTimeout()
Gets the maximum time in seconds that this data source can wait while
attempting to connect to a database. | | final public String | getPassword()
| | final public String | getShutdownDatabase()
| | final public String | getUser()
| | final public void | setConnectionAttributes(String prop)
Set this property to pass in more Cloudscape specific connection URL
attributes.
Any attributes that can be set using a property of this DataSource implementation
(e.g user, password) should not be set in connectionAttributes. | | final public void | setCreateDatabase(String create)
Set this property to create a new database. | | final public void | setDataSourceName(String dsn)
Set the data source name. | | final public synchronized void | setDatabaseName(String databaseName)
Set the database name. | | final public void | setDescription(String desc)
Set the data source descripton. | | public void | setLogWriter(PrintWriter out)
Set the log writer for this data source.
The log writer is a character output stream to which all logging and
tracing messages for this data source object instance will be printed.
This includes messages printed by the methods of this object, messages
printed by methods of other objects manufactured by this object, and so
on. | | public void | setLoginTimeout(int seconds)
Sets the maximum time in seconds that this data source will wait while
attempting to connect to a database. | | final public void | setPassword(String password)
Set the password property for the data source. | | final public void | setShutdownDatabase(String shutdown)
Set this property if one wishes to shutdown the database identified by
databaseName. | | final public void | setUser(String user)
Set the user property for the data source. |
| EmbeddedSimpleDataSource | | public EmbeddedSimpleDataSource()(Code) | | No-arg constructor.
|
| getConnection | | final public Connection getConnection() throws SQLException(Code) | | Attempt to establish a database connection.
a Connection to the database
exception:
SQLException - if a database-access error occurs. |
| getConnection | | final public Connection getConnection(String username, String password) throws SQLException(Code) | | Attempt to establish a database connection with the given username and
password. If the attributeAsPassword property is set to true then the
password argument is taken to be a list of connection attributes with the
same format as the connectionAttributes property.
Parameters:
username - the database user on whose behalf the Connection is being made
Parameters:
password - the user's password a Connection to the database
exception:
SQLException - if a database-access error occurs. |
| getConnectionAttributes | | final public String getConnectionAttributes()(Code) | | Cloudscape specific connection URL attributes |
| getCreateDatabase | | final public String getCreateDatabase()(Code) | | "create" if create is set, or null if not |
| getDataSourceName | | final public String getDataSourceName()(Code) | | data source name |
| getDescription | | final public String getDescription()(Code) | | description |
| getLogWriter | | public PrintWriter getLogWriter() throws SQLException(Code) | | Get the log writer for this data source.
The log writer is a character output stream to which all logging and
tracing messages for this data source object instance will be printed.
This includes messages printed by the methods of this object, messages
printed by methods of other objects manufactured by this object, and so
on. Messages printed to a data source specific log writer are not printed
to the log writer associated with the java.sql.Drivermanager class. When
a data source object is created the log writer is initially null, in
other words, logging is disabled.
the log writer for this data source, null if disabled
exception:
SQLException - if a database-access error occurs. |
| getLoginTimeout | | public int getLoginTimeout() throws SQLException(Code) | | Gets the maximum time in seconds that this data source can wait while
attempting to connect to a database. A value of zero means that the
timeout is the default system timeout if there is one; otherwise it means
that there is no timeout. When a data source object is created, the login
timeout is initially zero.
the data source login time limit
exception:
SQLException - if a database access error occurs. |
| getShutdownDatabase | | final public String getShutdownDatabase()(Code) | | "shutdown" if shutdown is set, or null if not |
| setConnectionAttributes | | final public void setConnectionAttributes(String prop)(Code) | | Set this property to pass in more Cloudscape specific connection URL
attributes.
Any attributes that can be set using a property of this DataSource implementation
(e.g user, password) should not be set in connectionAttributes. Conflicting
settings in connectionAttributes and properties of the DataSource will lead to
unexpected behaviour.
Parameters:
prop - set to the list of Cloudscape connection attributes separatedby semi-colons. E.g., to specify an encryption bootPassword of"x8hhk2adf", and set upgrade to true, do the following:ds.setConnectionAttributes("bootPassword=x8hhk2adf;upgrade=true");See Cloudscape's documentation for complete list. |
| setCreateDatabase | | final public void setCreateDatabase(String create)(Code) | | Set this property to create a new database. If this property is not set,
the database (identified by databaseName) is assumed to be already
existing.
Parameters:
create - if set to the string "create", this data source will try tocreate a new database of databaseName, or boot the database ifone by that name already exists. |
| setDataSourceName | | final public void setDataSourceName(String dsn)(Code) | | Set the data source name. The property is not mandatory. It is used for
informational purposes only.
Parameters:
dsn - the name of the data source |
| setDatabaseName | | final public synchronized void setDatabaseName(String databaseName)(Code) | | Set the database name. Setting this property is mandatory. If a database
named wombat at g:/db needs to be accessed, database name should be set
to "g:/db/wombat". The database will be booted if it is not already
running in the system.
Parameters:
databaseName - the name of the database |
| setDescription | | final public void setDescription(String desc)(Code) | | Set the data source descripton. This property is not mandatory. It is
used for informational purposes only.
Parameters:
desc - the description of the data source |
| setLogWriter | | public void setLogWriter(PrintWriter out) throws SQLException(Code) | | Set the log writer for this data source.
The log writer is a character output stream to which all logging and
tracing messages for this data source object instance will be printed.
This includes messages printed by the methods of this object, messages
printed by methods of other objects manufactured by this object, and so
on. Messages printed to a data source specific log writer are not printed
to the log writer associated with the java.sql.Drivermanager class. When
a data source object is created the log writer is initially null, in
other words, logging is disabled.
Parameters:
out - the new log writer; to disable, set to null
exception:
SQLException - if a database-access error occurs. |
| setLoginTimeout | | public void setLoginTimeout(int seconds) throws SQLException(Code) | | Sets the maximum time in seconds that this data source will wait while
attempting to connect to a database. A value of zero specifies that the
timeout is the default system timeout if there is one; otherwise it
specifies that there is no timeout. When a data source object is created,
the login timeout is initially zero.
Cloudscape ignores this property.
Parameters:
seconds - the data source login time limit
exception:
SQLException - if a database access error occurs. |
| setPassword | | final public void setPassword(String password)(Code) | | Set the password property for the data source. This is
user's password for any data source getConnection() call that takes no
arguments.
|
| setShutdownDatabase | | final public void setShutdownDatabase(String shutdown)(Code) | | Set this property if one wishes to shutdown the database identified by
databaseName.
Parameters:
shutdown - if set to the string "shutdown", this data source willshutdown the database if it is running. |
| setUser | | final public void setUser(String user)(Code) | | Set the user property for the data source. This is user
name for any data source getConnection() call that takes no arguments.
|
|
|