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-6478) Fix language about supported DataSources for Compact Profiles
Date Mon, 10 Mar 2014 21:28:47 GMT

    [ https://issues.apache.org/jira/browse/DERBY-6478?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13926246#comment-13926246

Dag H. Wanvik commented on DERBY-6478:

Thanks, Kim. Looks good. I see the current version recommends Basic data sources for Compact
Profile 3.
Since only CP2 *needs* the Basic versions, I think we should recommend the full versions for
CP3 (as well as for SE), since the Basic versions have less functionality in that they do
include JNDI support.

> Fix language about supported DataSources for Compact Profiles
> -------------------------------------------------------------
>                 Key: DERBY-6478
>                 URL: https://issues.apache.org/jira/browse/DERBY-6478
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions:
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>            Priority: Minor
>             Fix For:
>         Attachments: DERBY-6478-2.diff, DERBY-6478-2.zip, DERBY-6478-3.diff, DERBY-6478-3.zip,
DERBY-6478.diff, DERBY-6478.stat, DERBY-6478.zip
> Knut Anders Hatlen pointed out the following in his review of a patch for DERBY-6236:
> "One little inaccuracy in the changed text (existing problem, not introduced by the patch):
It seems to imply that only the basic data sources work on Compact Profile 3. That is not
the case. The ordinary data sources are supported on CP3. Only CP2 lacks the necessary classes
(javax.naming.*) and need the basic data sources. (The basic data sources do work on CP3,
though, so it's not a problem if applications choose to use them if they don't need the extra
functionality of the ordinary data sources.)"
> This means that numerous topics in the Admin Guide, Reference Manual, and Developer's
Guide probably need some fixes. For example, the topic "JDBC support for Java SE 8 Compact
Profiles" in the Reference Manual should probably add something like the following at the
end of the topic:
> "Users of Compact Profile 3 on the Java SE 8 platform can use either these DataSource
classes or the Datasource classes for the full Java SE platform." 
> As another example, the topic "Network client security" in the Admin Guide should probably
be changed to something like this:
> "Derby provides two ClientDataSource implementations. Use the org.apache.derby.jdbc.ClientDataSource
class on all supported Java SE versions except Java SE 8 Compact Profiles 1 and 2. On Java
SE 8 Compact Profile 2, use the org.apache.derby.jdbc.BasicClientDataSource40 class."
> Please let me know if these tweaks need further tweaking -- in the meantime I will start
work on implementing them. Thanks.

This message was sent by Atlassian JIRA

View raw message