db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-1934) Reference Manual updates - J2EE Compliance: Java Transaction API and javax.sql Extensions
Date Thu, 29 Mar 2007 20:49:25 GMT

    [ https://issues.apache.org/jira/browse/DERBY-1934?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12485344

Kim Haase commented on DERBY-1934:

Thanks, Laura -- These look excellent.

However, I have since gotten more feedback from Lance (between ===):

The page is not consistent as it should just describe what a DataSource is  to align with
what it states for the other interfaces.

You can borrow from the spec or from the javadoc for DataSource.

The problem i have with the wording, is you can use a DataSource without JNDI and it can (and
typically is) looked up as a resource via JNDI.

Also need to migrate to referring to Java EE vs J2EE as well.

The last bit can wait, but we may as well reword the description based on the javadoc. Here
is some text that can replace the first two sentences. I think the last sentence ("This allows
the calling application to access the database by a name (as a data source) instead of through
a database connection URL.") can stay as is.

"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(TM) Naming and Directory

Interesting in view of the fact that our Working With Derby example uses DriverManager; at
some point perhaps it should be changed to use DataSource, but that is yet another task.

BTW, did you also change the title of rrefjta16677.dita in the map file?

> 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:
>            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  

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

View raw message