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] [Comment Edited] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
Date Thu, 31 Jan 2013 04:23:12 GMT

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

Dag H. Wanvik edited comment on DERBY-6059 at 1/31/13 4:22 AM:
---------------------------------------------------------------

Going through the docs looking for what you are referring to and found these items:

refman

- I see we mention the new *40 data sources in the section on JDBC 4.0
  and 4.1 features in the manual, maybe we should put something there
  for the new ones, too?

- Just before it there is a section on "JDBC Package for Connected
  Device Configuration/Foundation Profile (JSR 169)"; we should
  probably put in a section something about Compact Profiles there,
  too.

- There is a three column table "Table 132. Available tracing levels
  and values" which shows tracing levels for
  ClientDataSource.<TRACECONSTANTS> For CP2 level applications these constants should
be
  referenced via BasicClientDataSource40.<TRACECONSTANTS> instead,
  since the class ClientDataSource is not loadable in a CP2
  environment.

- In the section "J2EE compliance" we mention that our
  implementation(s) of the javax.sql.DataSource interface supports
  JNDI. We should mention that the new data sources are an exception
  to that.

- In the section "Data Source Implementation Classes", we should
  include the new ones, too

dev guide:

- Section "Classes that pertain to resource managers" describe two
  variants, we now have three for each level, so needs
  update. Probably best the keep the existing section contents more or
  less intact, and just add description of the new at the end of it,
  or in a subsection?

Not sure if any of these cover what you are referring to, though :)

In the jdbc package Javadoc there is now an updated overview, cf. my attachment "javadoc-snapshot".


                
      was (Author: dagw):
    Going through the docs looking for what you are referring to and found these items:

refman

- I see we mention the new *40 data sources in the section on JDBC 4.0
  and 4.1 features in the manual, maybe we should put something there
  for the new ones, too?

- Just before it there is a section on "JDBC Package for Connected
  Device Configuration/Foundation Profile (JSR 169)"; we should
  probably put in a section something about Compact Profiles there,
  too.

- There is a three column table "Table 132. Available tracing levels
  and values" which shows tracing levels for
  ClientDataSource.<TRACECONSTANTS> For CP these constants should be
  references via BasicClientDataSource40.<TRACECONSTANTS> instead,
  since the class ClientDataSource is not loadable in a CP2
  environment.

- In the section "J2EE compliance" we mention that our
  implementation(s) of the javax.sql.DataSource interface supports
  JNDI. We should mention that the new data sources are an exception
  to that.

- In the section "Data Source Implementation Classes", we should
  include the new ones, too

dev guide:

- Section "Classes that pertain to resource managers" describe two
  variants, we now have three for each level, so needs
  update. Probably best the keep the existing section contents more or
  less intact, and just add description of the new at the end of it,
  or in a subsection?

Not sure if any of these cover what you are referring to, though :)

In the jdbc package Javadoc there is now an updated overview, cf. my attachment "javadoc-snapshot".


                  
> Document Derby usage running on Java 8 JEP 161 Compact Profiles
> ---------------------------------------------------------------
>
>                 Key: DERBY-6059
>                 URL: https://issues.apache.org/jira/browse/DERBY-6059
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>            Reporter: Dag H. Wanvik
>            Assignee: Kim Haase
>             Fix For: 10.10.0.0
>
>         Attachments: javadoc-snapshot.pdf
>
>
> Document that Derby can run even under constrained Java runtime as planned for Java 8
Compact Profiles 2 and 3 (not 1, the smallest runtime, since it has no JDBC). Cf work in DERBY-5955
which made Derby run gracefully even when some normal Java runtime packages are missing, notably
JNDI and JMX.
> That work introduced six new data sources which have reduced functionality compared with
the corresponding ones for full Java SE, in that there is no JNDI support. The six new data
sources are for the client driver:
> Client/server data sources for use with Java 8 Compact Profile 2 and above:
>     BasicClientDataSource40 - Data source
>     BasicClientConnectionPoolDataSource40 - Connection pooling data source
>     BasicClientXADataSource40 - XA data source 
> Embedded data sources for use with Java 8 Compact Profile 2 and above:
>     BasicEmbeddedDataSource40 - Data source
>     BasicEmbeddedConnectionPoolSource40 - Connection pooling data source
>     BasicEmbeddedXASource40 - XA data source 

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Mime
View raw message