[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13577672#comment-13577672 ] Kim Haase commented on DERBY-6059: -- Committed patch DERBY-6059.diff to documentation trunk at revision 1445699. Stay tuned for another patch. > 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: DERBY-6059.diff, DERBY-6059.stat, DERBY-6059.zip, > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13577575#comment-13577575 ] Kim Haase commented on DERBY-6059: -- Thanks for catching that, Dag, and for the careful review. I will commit this patch and then file another for the smaller fix. If you see anything else, let me know. > 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: DERBY-6059.diff, DERBY-6059.stat, DERBY-6059.zip, > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13577379#comment-13577379 ] Dag H. Wanvik commented on DERBY-6059: -- Thanks, Kim. Looks good! Nit: rrefattribtracelevel.html: lacking space before "class" in this sentence: "You must use the org.apache.derby.jdbc.BasicClientDataSource40class", at least in my browser (Firefox 18.0.2). > 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: DERBY-6059.diff, DERBY-6059.stat, DERBY-6059.zip, > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13576625#comment-13576625 ] Kristian Waagan commented on DERBY-6059: > I can see that this is tricky to document and puzzling to users. Maybe we > could help users by adding the following factory methods to, say, > EmbeddedDriver and ClientDriver: While this may help in some cases, note that configuring systems using data sources often consists of specifying the data source class as a text string. As such I think it is important that we document this as good as we can. > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13576616#comment-13576616 ] Rick Hillegas commented on DERBY-6059: -- Java 8 will increase the number of JDBC methods which are only available from the 40 data sources. So the distinction is becoming more important for portable applications. I can see that this is tricky to document and puzzling to users. Maybe we could help users by adding the following factory methods to, say, EmbeddedDriver and ClientDriver: public static javax.sql.DataSource getDataSource() public static javax.sql.ConnectionPoolDataSource() getConnectionPoolDataSource() public static javax.sql.XADataSource getXADataSource() Thanks, -Rick > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13576290#comment-13576290 ] Dag H. Wanvik commented on DERBY-6059: -- I still think we should recommend that for Java >= 7, users should use the "40" suffixed versions, although it may not be necessary unless they rely on the getParentLogger method as Knut says. Just to keep it simple(r).. Others opinions on this? > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13575821#comment-13575821 ] Knut Anders Hatlen commented on DERBY-6059: --- Hi Kim, You're right, the 40 classes are not required for Java 7. They are only required if you call the getParentLogger() method, which was new in JDBC 4.1. Since our implementation of that method always throws SQLFeatureNotSupportedException, I don't think it's very likely that our users will have applications that depend on that method. So we have the plain (unsuffixed) data sources that can be used on Java SE 5 and newer, as long as you stick to the JDBC 4.0 subset of the API. And the "40" classes can be used on Java SE 6 and newer, as long as you stick to the JDBC 4.1 subset of the API (or possibly JDBC 4.2, as I don't think any new methods are planned in the data sources for 4.2). > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13575800#comment-13575800 ] Kim Haase commented on DERBY-6059: -- Thanks, Dag and Knut, that clarifies matters a lot. I'm still a little bit confused by the statement that "For Java 7 (JDBC 4.1) it *is* required [to use the '40' data sources]." We have been saying (in http://db.apache.org/derby/docs/10.9/adminguide/cadminnsdatasources.html, for instance) that you can use the old data sources on all platforms: "The Network Server supports the Derby Network Client driver DataSource classes org.apache.derby.jdbc.ClientDataSource and org.apache.derby.jdbc.ClientConnectionPoolDataSource on all supported Java SE platforms." (It's a bit confusing that the XA ones are not mentioned, but they are in the next section.) If you are running on Java SE 7, it seems that you cannot use these but must use the "40" versions? Or is that the case (as we have been saying) only if you want to use the APIs specific to JDBC 4.1? If you have an app that uses only JDBC 3 methods, can you use the basic org.apache.derby.jdbc.ClientDataSource (etc.) DataSources on SE 6, 7, and 8 if you want? Just checking ... Thanks! > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13575724#comment-13575724 ] Knut Anders Hatlen commented on DERBY-6059: --- Dag is correct. DERBY-5880 made the suffix-less data sources more capable, and the javadoc comments were updated to reflect the new reality. The suffix-less data sources can (still) be used on JDBC 3.0 platforms, but now they also support the full JDBC 4.0 API. The data sources with the "40" suffix require at least JDBC 4.0 support in the JVM, otherwise the classes will fail to load. They support the full JDBC 4.1 API. I guess we should add a sentence to the javadoc of the 40-suffixed classes to say that they will also work on Java SE 6/JDBC 4.0. They will have to continue supporting that platform for backward compatibility reasons, and we could just as well say that explicitly in the javadoc. That might make the naming less confusing too. > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13575607#comment-13575607 ] Dag H. Wanvik commented on DERBY-6059: -- Kim, your reading is very observant. I believe at one point (DERBY-5880), we were able to move that 4.0 specific additions into the plain data sources, making the suffix "40" a tad confusing indeed. Using the "40" data sources for Java 1.6 (jdbc 4.0) is still fine, it is just no longer required (and they are slightly more capable than required by 4.0). For Java 7 (JDBC 4.1) it *is* required. Ideally, the classes would now be suffixed with "41"... > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13574823#comment-13574823 ] Kim Haase commented on DERBY-6059: -- We seem to be inconsistent about what our DataSource implementations support. In the updated Javadoc -- for example, https://builds.apache.org/job/Derby-trunk/lastSuccessfulBuild/artifact/trunk/javadoc/engine/org/apache/derby/jdbc/ClientDataSource40.html -- it says that plain ClientDataSource is suitable for Java SE 6 (JDBC 4.0) and below, and that ClientDataSource40 is suitable for Java SE 7 (JDBC 4.1) and above. However, in the Reference Manual (http://db.apache.org/derby/docs/10.9/ref/rrefjdbc4_0dataSource.html and http://db.apache.org/derby/docs/10.9/ref/rrefapi1003363.html, for example) we have been saying that the plain version (ClientDataSource etc.) is for Java SE 5 (JDBC 3) and that ClientDataSource40 is suitable for Java SE 6 (JDBC 4.0) and higher. This is also what we said in the Javadoc at 10.9: http://db.apache.org/derby/docs/10.9/publishedapi/jdbc4/org/apache/derby/jdbc/ClientDataSource40.html On the face of it it would seem as if a class with the "40" suffix should be meant for JDBC 4.0 and above, which is what we have been saying, and that the latest Javadoc needs fixing. Is this so? Thanks! > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13567363#comment-13567363 ] Dag H. Wanvik commented on DERBY-6059: -- Btw, the tracing level tables are duplicated in the reference manual and the admin manual as tables "Table 132. Available tracing levels and values" and "Table 8. Available tracing levels and values" respectively... > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13567352#comment-13567352 ] Dag H. Wanvik commented on DERBY-6059: -- In the admin guide - we have section "Accessing the Network Server by using the network client driver", which describes the client data sources' properties. Again, some constants used there should now be accessed via BasicClientDataSource40 when running on Compact Profile 2, cf Table 7 "Security mechanisms supported by the Derby Network Client", e.g as ClientDataSource.USER_ONLY_SECURITY -> BasicClientDataSource40.USER_ONLY_SECURITY. Table 8 has the same issue. Rather than complicating these explanations by always mentioning the CP alternative, probably it would be better with just saying something about CP 2 in a separate section, or ? I'm sure you'll find a nice way :) - Section "Accessing the Network Server by using a DataSource object" explains what to do for different platforms, add Compact Profile 2 here as well. - The subsection "user authentication differences" mention those constants again; not sure whether it's worth bringing up the CP2 alternative here... > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13567344#comment-13567344 ] Dag H. Wanvik commented on DERBY-6059: -- 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. For CP these constants should be references via BasicClientDataSource40. 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 > > > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13566507#comment-13566507 ] Kim Haase commented on DERBY-6059: -- I seem to remember seeing a 3-column list of the API methods in each of the 3 profiles, somewhere. I was wondering if it would be useful to point to it or reproduce it. Or is it in the Javadoc? > 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 > > > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13566263#comment-13566263 ] Dag H. Wanvik commented on DERBY-6059: -- If you generate the Javadoc on trunk, you'll see in the jdbc package javadoc some more info, too. > 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 > > > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13566261#comment-13566261 ] Dag H. Wanvik commented on DERBY-6059: -- Thanks for taking this on, Kim! Hmm... not sure I understand your question..These new classes represent the API change; do you mean the method details of them? How much do we reproduce in the docs from the Javadocs for the existing data sources? Seen from the user's point of view she needs to configure the appserver and/or change the application code to use "Basic" version of the data source(s) when running under Compact Profile 2. Also, the code should not attempt to use JNDI with them (examples shown in the Javadoc for the fully capable data sources). > 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 > > > 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
[jira] [Commented] (DERBY-6059) Document Derby usage running on Java 8 JEP 161 Compact Profiles
[ https://issues.apache.org/jira/browse/DERBY-6059?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13566145#comment-13566145 ] Kim Haase commented on DERBY-6059: -- Thanks for creating this, Dag. Do you think we should list the supported APIs in addition to the data sources, or just point to them? Maybe you could post a link -- I think there is one somewhere under DERBY-5955, but there's a lot of material there. > 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 > > > 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
