Package javax.sql

Interface DataSource

All Superinterfaces:

CommonDataSource, Wrapper

public interface DataSource
extends CommonDataSource, Wrapper

An interface for the creation of Connection objects which represent a connection to a database. This interface is an alternative to the java.sql.DriverManager.

A class which implements the DataSource interface is typically registered with a JNDI naming service directory and is retrieved from there by name.

The DataSource interface is typically implemented by the writer of a JDBC driver. There are three variants of the DataSource interface, which produce connections with different characteristics:

1. Standard DataSource: produces standard Connection objects with no special features.
2. Connection Pool DataSource: produces PooledConnection objects which require a connection pool manager as an intermediary component.
3. Distributed transaction DataSource ("XADataSource"): produces XAConnection objects which can be used to handle distributed transactions which typically require an intermediary transaction manager component. XAConnection objects also provide connection pooling capabilities as well as distributed transaction capabilities.

Note that a JDBC driver which is accessed via the DataSource interface is loaded via a JNDI lookup process. A driver loaded in this way does not register itself with the DriverManager.

Method Summary

Modifier and Type	Method	Description
Connection	getConnection()	Creates a connection to the database represented by this DataSource.
Connection	getConnection(String theUsername, String thePassword)	Creates a connection to the database represented by this DataSource, using the supplied user name and password.

Methods inherited from interface javax.sql.CommonDataSource

getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Method Details

getConnection

Connection getConnection()
                  throws SQLException

Creates a connection to the database represented by this DataSource.

Returns:

a Connection object which is a connection to the database.

Throws:

SQLException - if there is a problem accessing the database.

getConnection

Connection getConnection(String theUsername,
String thePassword)
                  throws SQLException

Creates a connection to the database represented by this DataSource, using the supplied user name and password.

Parameters:

theUsername - the a user name for the database login.

thePassword - the password associated with the user identified by theUsername.

Returns:

the Connection object which is the connection to the database.

Throws:

SQLException - if there is a problem accessing the database.