db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Dag H. Wanvik (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-2511) reference manual's description of JDBC4 features has misleading sections
Date Wed, 04 Apr 2007 13:39:32 GMT

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

Dag H. Wanvik commented on DERBY-2511:
--------------------------------------



Kim> 
Kim>     [ https://issues.apache.org/jira/browse/DERBY-2511?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12486402
] 
Kim> 
Kim> Kim Haase commented on DERBY-2511:
Kim> ----------------------------------
Kim> 
Kim> Thanks, that's pretty clear. Is there anything else to be said
Kim> about what those JDBC 4.0-specific interfaces are for? Do people
Kim> still need to use them if they want to run on JDK 6?

The 

    EmbeddedConnectionPoolDataSource40 and
    EmbeddedDataSource40
    EmbeddedXADataSource40
    ClientConnectionPoolDataSource40 and
    ClientDataSource40
    ClientXADataSource40

makes available the Wrapper functionality (isWrapperFor, unwrap
methods) described earlier in this section ("JDBC 4.0-only features",
feature bullet "Wrappers"). I think they are only needed if the
application expects to be able to use this functionaliy for
portability reasons (they expose no vendor-specific extensions for
Derby). 

Anything more to be said on this, Rick?

Btw, why are EmbeddedDriver and ClientDriver referred to as DataSource
in this section ("javax.sql.DataSource interface: JDBC 4.0 features")?

Thanks,

Dag

Kim> 
Kim> > reference manual's description of JDBC4 features has misleading sections
Kim> > ------------------------------------------------------------------------
Kim> >
Kim> >                 Key: DERBY-2511
Kim> >                 URL: https://issues.apache.org/jira/browse/DERBY-2511
Kim> >             Project: Derby
Kim> >          Issue Type: Bug
Kim> >          Components: Documentation
Kim> >    Affects Versions: 10.2.1.6, 10.2.2.0
Kim> >            Reporter: Dag H. Wanvik
Kim> >            Priority: Trivial
Kim> >
Kim> > The following sentences under section "javax.sql.DataSource interface: JDBC 4.0
features" should be removed since the feature described is not part of JDBC4 (EoD was withdrawn
prior to final release):
Kim> > "JDBC 4.0 introduces a simpler mechanism for iterating through a table. You use
this mechanism by passing an annotated query to your DataSource's createQueryObject method.
To expose this createQueryObject method,"
Kim> > Also, the section "java.sql.Connection interface: JDBC 4.0 features" contains
these sentences which should be removed:
Kim> > "Ease of development - JDBC 4.0 introduces DataSet, a simple mechanism to iterate
through a table. You obtain a DataSet by passing an annotated query to your Connection's createQueryObject
method."
Kim> > See ref/rrefjdbc4_0dataSource.dita, ca line 34 and  ref/rrefjdbc4_0connection.dita
ca line 42.
Kim> 
Kim> -- 
Kim> This message is automatically generated by JIRA.
Kim> -
Kim> You can reply to this email to add a comment to the issue online.
Kim> 


> reference manual's description of JDBC4 features has misleading sections
> ------------------------------------------------------------------------
>
>                 Key: DERBY-2511
>                 URL: https://issues.apache.org/jira/browse/DERBY-2511
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.2.1.6, 10.2.2.0
>            Reporter: Dag H. Wanvik
>         Assigned To: Kim Haase
>            Priority: Trivial
>         Attachments: DERBY-2511.diff, rrefjdbc4_0connection.html, rrefjdbc4_0dataSource.html
>
>
> The following sentences under section "javax.sql.DataSource interface: JDBC 4.0 features"
should be removed since the feature described is not part of JDBC4 (EoD was withdrawn prior
to final release):
> "JDBC 4.0 introduces a simpler mechanism for iterating through a table. You use this
mechanism by passing an annotated query to your DataSource's createQueryObject method. To
expose this createQueryObject method,"
> Also, the section "java.sql.Connection interface: JDBC 4.0 features" contains these sentences
which should be removed:
> "Ease of development - JDBC 4.0 introduces DataSet, a simple mechanism to iterate through
a table. You obtain a DataSet by passing an annotated query to your Connection's createQueryObject
method."
> See ref/rrefjdbc4_0dataSource.dita, ca line 34 and  ref/rrefjdbc4_0connection.dita ca
line 42.

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