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
(JNDI) API."

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

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


Mime
View raw message