DataSource (moe.ios.core API)

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

All Methods Instance Methods Abstract Methods
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 Detail
  - 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.