|
JDBC for CDC/FP Optional Package | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
A factory for connections to the physical data source that this
DataSource
object represents. A replacement for the
DriverManager
facility, a DataSource
object
is the preferred means of getting a connection.
The DataSource
interface is implemented by a driver vendor.
A DataSource
object has properties that can be modified
when necessary. For example, if the data source is moved to a different
server, the property for the server can be changed. The benefit is that
because the data source's properties can be changed, any code accessing
that data source does not need to be changed.
An instance of a DataSource
object can be used in a stand
alone program to create Connection
objects. In the following
example an instance of DataSource
, in this case,
VendorDataSource
is used to create a Connection
to a database on the machine bookserver
which is listening at
port 12345
:
DataSource ds = new VendorDataSource(); ds.setServerName("bookserver"); ds.setPortNumber(12345); Connection conn = ds.getConnection("Bob", "passwd");A list of standard properties is provided in seciton 9.3.1 of the JDBC 3.0 specification. Consult your vendors documentation for a list the supported properties for you
DataSource
.
Connection
Method Summary | |
Connection |
getConnection()
Attempts to establish a connection with the data source that this DataSource object represents. |
Connection |
getConnection(java.lang.String username,
java.lang.String password)
Attempts to establish a connection with the data source that this DataSource object represents. |
int |
getLoginTimeout()
Gets the maximum time in seconds that this data source can wait while attempting to connect to a database. |
java.io.PrintWriter |
getLogWriter()
Retrieves the log writer for this DataSource
object. |
void |
setLoginTimeout(int seconds)
Sets the maximum time in seconds that this data source will wait while attempting to connect to a database. |
void |
setLogWriter(java.io.PrintWriter out)
Sets the log writer for this DataSource
object to the given java.io.PrintWriter object. |
Method Detail |
public Connection getConnection() throws SQLException
Attempts to establish a connection with the data source that
this DataSource
object represents.
SQLException
- if a database access error occurspublic Connection getConnection(java.lang.String username, java.lang.String password) throws SQLException
Attempts to establish a connection with the data source that
this DataSource
object represents.
username
- the database user on whose behalf the connection is
being madepassword
- the user's passwordSQLException
- if a database access error occurspublic java.io.PrintWriter getLogWriter() throws SQLException
Retrieves the log writer for this DataSource
object.
The log writer is a character output stream to which all logging
and tracing messages for this data source 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
DataSource
object is
created, the log writer is initially null; in other words, the
default is for logging to be disabled.
SQLException
- if a database access error occurssetLogWriter(java.io.PrintWriter)
public void setLogWriter(java.io.PrintWriter out) throws SQLException
Sets the log writer for this DataSource
object to the given java.io.PrintWriter
object.
The log writer is a character output stream to which all logging
and tracing messages for this data source 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
DataSource
object is created the log writer is
initially null; in other words, the default is for logging to be
disabled.
out
- the new log writer; to disable logging, set to nullSQLException
- if a database access error occursgetLogWriter()
public void setLoginTimeout(int seconds) throws SQLException
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 DataSource
object is created, the login timeout is
initially zero.
seconds
- the data source login time limitSQLException
- if a database access error occurs.getLoginTimeout()
public int getLoginTimeout() throws SQLException
DataSource
object is created, the login timeout is
initially zero.SQLException
- if a database access error occurs.setLoginTimeout(int)
|
JDBC for CDC/FP Optional Package | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |