[Prev] Thread [Next]  |  [Prev] Date [Next]

[jira] Commented: (DERBY-1934) Reference Manual updates - J2EE Compliance: Java Transaction API and javax.sql Extensions Kim Haase (JIRA) Thu Mar 29 18:10:51 2007


Kim Haase commented on DERBY-1934:

Hi, Laura -- I wrote to Lance asking him to comment. I'm not sure if he will do 
so directly, but he did say, "These old optional packages are part of JDBC as 
of JDBC 3.0 so they are not optional." So it is probably better to point people 
to http://java.sun.com/javase/reference/api.jsp -- these interfaces are all 
part of the API documentation for all Java releases starting with 1.4. 

So "extension" is an obsolete term now, and "interface" is the more accurate 
term. If you look at http://java.sun.com/j2se/1.4.2/docs/api/, for instance, 
and click javax.sql in the top left window, you will see in the bottom window 
that DataSource, ConnectionPoolDataSource, PooledConnection, and XADataSource 
are all interfaces.

Technically any package that starts with "javax" instead of plain "java" is an 
extension, but you can see that many such packages are an integral part of the 
Java platform, and we don't usually use the term "extension" to describe them 
any more. It is true that the javax.sql interfaces support the J2EE platform 
(which has now changed its name to "Java EE", actually, but let's not worry 
about that at this point).

> 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, 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.