There is nothing magic about Derby's implementation of a DataSource.
If i could suggest making a quick scan of DataSource overview in the
JDBC spec as this will give you an overview of how a DataSource is used
in conjunction with JNDI.
Laura Stewart (JIRA) wrote:
[ https://issues.apache.org/jira/browse/DERBY-1934?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12485367 ]
Laura Stewart commented on DERBY-1934:
--------------------------------------
Kim - Would it be acceptable to have this as the text for DataSource:
The Derby implementation of the DataSource interface provides support the Java
Naming and Directory
Interface (JNDI). A DataSource object is a factory for connections to the
physical data source
that the DataSource object represents. An alternative to the DriverManager facility, a DataSource object is the
preferred means of getting a connection. An object that implements the DataSource interface will typically be registered
with a naming service based on the Java Naming and Directory (JNDI) API.
This allows the calling application to access the database by a name (as a
data source) instead of through a database connection URL.
Reference Manual updates - J2EE Compliance: Java Transaction API and javax.sql
Extensions
-----------------------------------------------------------------------------------------
Key: DERBY-1934
URL: https://issues.apache.org/jira/browse/DERBY-1934
Project: Derby
Issue Type: Bug
Components: Documentation
Affects Versions: 10.2.1.6
Reporter: Laura Stewart
Assigned To: Laura Stewart
Attachments: derby1934_1.diff, derby1934_2.diff, derby1934_html2.zip,
rrefjta18596.html
J2EE Compliance: Java Transaction API and javax.sql Extensions:
Section = javax.sql:JDBC Extensions
File = http://db.apache.org/derby/docs/dev/ref/rrefjta18596.html
Update =
This URL no longer exists: (For more details about these extensions, see http://java.sun.com/products/jdbc/jdbc20.stdext.javadoc/javax/sql/package-summary.html). The page that has this information, although you have to browse to the section called JDBC 2.0 Optional Package API is http://java.sun.com/products/jdbc/download.html