You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Laura Stewart (JIRA)" <de...@db.apache.org> on 2006/09/14 01:46:23 UTC
[jira] Commented: (DERBY-1271) Release documentation for JDBC4
release
[ http://issues.apache.org/jira/browse/DERBY-1271?page=comments#action_12434569 ]
Laura Stewart commented on DERBY-1271:
--------------------------------------
Jean -
Here is my attempt at wordsmithing...
"JDBC 4.0 functionality is not enabled in this Derby release. JDBC 4.0 is part of Java SE 6, which was not generally available for Derby 10.2. When you use Derby with a Java SE 6 virtual machine, JDBC 3.0 is available. JDBC 4.0 is available only to developers who download Java SE 6 and use it to add JDBC 4.0 support to Derby. The Release Notes explain how to build the JDBC 4.0 functionality with Derby 10.2. When Java SE 6 becomes generally available, a follow-on Derby release will include final JDBC 4.0 functionality. "
Comments:
"Attention" is a good choice for this type of note.
I don't like the phrase "JDBC 3.0 is available." It seems incomplete. This is minor :-)
I think that the warning about compatibility with the final version of JDBC 4.0 should be addressed in the Release Notes.
> Release documentation for JDBC4 release
> ---------------------------------------
>
> Key: DERBY-1271
> URL: http://issues.apache.org/jira/browse/DERBY-1271
> Project: Derby
> Issue Type: Improvement
> Components: Documentation, JDBC
> Affects Versions: 10.2.1.0
> Reporter: Rick Hillegas
> Assigned To: Jean T. Anderson
> Fix For: 10.2.1.0
>
> Attachments: adminGuide_v01.tar, derby-1271_adminGuide_v01.diff, derby-1271_copyrights.diff, derby-1271_copyrights_v02.diff, derby-1271_devGuide_v01.diff, derby-1271_refGuide_v01.diff, derby-1271_refGuide_v01.tar, derby-1271_toolsGuide_v01.diff, derby1271-2-html.zip, derby1271-2.diff, devGuide_v01.tar, toolsGuide_v01.tar
>
>
> We can't check in any of this work until we understand how our release trains line up. However, the JDBC4-bearing release will need the following documentation:
> 1) Changes to the user guides. These need to be understood. We can analyze the scope of these changes without checking anything in yet.
> 2) Summary page which explains what pieces of JDBC4 we tackled and what we passed over.
> 3) Verbiage for the Release Notes.
> USER GUIDES
> Admin Guide
> Part One...How to start an embedded server from an application
> For JDBC4, we can omit the Class.forName() line because
> of Driver autoloading.
> Part One...Embedded server example
> For JDBC4, we can omit the Class.forName() line because
> of Driver autoloading.
> Part One...Network client driver examples
> For JDBC4, we can omit the Class.forName() line because
> of Driver autoloading.
> Part One...Accessing the Network Server by using a DataSource
> For JDBC4, we have different DataSources: ClientDateSource40
> and ClientConnectionPoolDataSource40.
> Part One...Using the Derby ij tool with the Network Server
> In case the DRIVER command ends up being needed pre-JDBC4,
> we should note that you don't need it under JDBC4 because
> of Driver autoloading.
> Part One...The NsSample sample program
> Change NsSample to demonstrate driver autoloading under JDBC4.
> Part One...Overview of the SimpleNetworkServerSample program
> Change SimpleNetworkServerSample to demonstrate driver autoloading under JDBC4.
> Part One...Connecting a client to the Network Server with the SimpleNetworkClientSample program
> Change SimpleNetworkClientSample to demonstrate driver autoloading under JDBC4.
> Developer's Guide
> JDBC applications and Derby basics
> Derby embedded basics
> Derby JDBC driver
> Note that you don't need Class.forName() in JDBC4.
> Derby embedded basics
> Embedded Derby JDBC driver
> Note that you don't need Class.forName() in JDBC4.
> Starting Derby as an embedded database
> Note that you don't need Class.forName() or the jdbc.drivers property in JDBC4.
> Controlling Derby application behavior
> Working with Derby SQLExceptions in an application
> Note that with JDBC4, these are refined subclasses
> Example of processing SQLExceptions
> Say something about SQLException.getCause()
> Using Derby as a J2EE resource manager
> Classes that pertain to resource managers
> Mention the JDBC4 variants of these classes.
> Getting a DataSource
> Include example using JDBC4 variants of these classes.
> Shutting down or creating a database
> Include example using JDBC4 variants of these classes.
> Getting Started Guide
> No changes necessary.
> Reference Guide
> Derby exception messages and SQL states
> Describe SQLFeatureNotSupportedException and its SQLStates.
> SQLState and error message reference
> Mention new unimplementedFeature exceptions.
> What to do about new SQLStates.
> JDBC Reference
> "conforms to the JDBC 2.0 and 3.0 APIs"
> ->
> "conforms to the JDBC 2.0, 3.0, and 4.0 APIs"
> java.sql.Driver
> Amend this to note driver autoloading for JDBC4.
> java.sql.Connection
> Connection functionality not supported
> List unsupported Connection methods.
> java.sql.DatabaseMetaData
> Columns in the ResultSet returned by getProcedureColumns
> Add new columns added by JDBC4
> java.sql.Statement
> Note that Derby does not support the execute() and
> executeQuery() overloads which return autogenerated keys.
> Prepared statements and streaming columns
> Note that with JDBC4, you can specify length as a long
> or even omit the length when setting LOB streams.
> java.sql.ResultSetMetaData
> Waiting for feedback from Dag on whether we still don't
> support isDefinitelyWritable(), isReadOnly(), and
> isWritable().
> java.sql.Blob and java.sql.Clob
> Right now this section says that Derby supports the methods in
> the Blob and Clob interfaces. This is not true. We should
> describe the discrepancies, including any additional methods added
> by JDBC4.
> JDBC 4.0-only features
> Add this new section, with a subsection for each SQL interface
> that changed in JDBC4. The subsections should list new methods
> that were added.
> Derby API
> JDBC implementation classes
> Data Source Classes
> List the JDBC4 versions of these classes
> Tools Guide
> Using ij
> Getting started with ij
> Running ij scripts
> You don't need to specify the Derby drivers
> on the command line even under JDBC2.
> ij properties reference
> ij.dataSource
> This is the DataSource for embedded JDBC3. Note that
> this would be different if you are running under
> JDBC4.
> Tuning Guide
> No changes necessary.
> Working With Derby Guide
> Activity 3: Run a JDBC program using the Embedded driver
> The WwdEmbedded program
> Start the Derby engine
> Note that this step (Class.forName() on the embedded driver)
> is not necessary if you are running on jdk 1.6 or higher.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
Re: [jira] Commented: (DERBY-1271) Release documentation for JDBC4
release
Posted by "Jean T. Anderson" <jt...@bristowhill.com>.
Rick Hillegas wrote:
> Jean T. Anderson wrote:
>> Myrna van Lunteren wrote:
...
>>> Nice team-writing, I have 1 more suggestion, how about mentioning
>>> 10.2.1 instead of 10.2?
>
> Small nit: I believe that there's a dita variable for the release
> identifier. I recommend using that variable. That way, we won't have to
> airbrush this text if we build a 10.2.2.2 bugfix distribution which
> still doesn't expose JDBC4.
Thanks, Rick, I'll look for that dita variable.
Also, when I produce a "final" :-) doc patch, we can hold back from
applying it in case Geir's plan succeeds [1].
-jean
[1]
http://mail-archives.apache.org/mod_mbox/db-derby-dev/200609.mbox/%3c4508D53D.80406@pobox.com%3e
> Thanks,
> -Rick
>
>>
>> great suggestion, Myrna,
>>
>> thanks,
>>
>> -jean
Re: [jira] Commented: (DERBY-1271) Release documentation for JDBC4
release
Posted by Rick Hillegas <Ri...@Sun.COM>.
Jean T. Anderson wrote:
>Myrna van Lunteren wrote:
>
>
>>On 9/13/06, Jean T. Anderson <jt...@bristowhill.com> wrote:
>>
>>
>...
>
>
>>>I'll try this on for size and upload a new review draft:
>>>
>>>This release includes JDBC 4.0 functionality based on a pre-release of
>>>Java SE 6. When you use Derby with a Java SE 6 virtual machine, Derby
>>>will use its JDBC 3.0 drivers, just as with 1.4 and 1.5 virtual
>>>machines. JDBC 4.0 is available only to developers who download Java SE
>>>6 and use it to build in support for JDBC 4.0. The Release Notes explain
>>>how to build the JDBC 4.0 functionality with Derby 10.2. When Java SE 6
>>>becomes generally available, a follow-on Derby release will include
>>>final JDBC 4.0 functionality.
>>>
>>>thanks Laura, David, and Myrna,
>>>
>>> -jean
>>>
>>>
>>>
>>Nice team-writing, I have 1 more suggestion, how about mentioning
>>10.2.1 instead of 10.2?
>>
>>
Small nit: I believe that there's a dita variable for the release
identifier. I recommend using that variable. That way, we won't have to
airbrush this text if we build a 10.2.2.2 bugfix distribution which
still doesn't expose JDBC4.
Thanks,
-Rick
>
>great suggestion, Myrna,
>
>thanks,
>
> -jean
>
>
>
>
Re: [jira] Commented: (DERBY-1271) Release documentation for JDBC4
release
Posted by "Jean T. Anderson" <jt...@bristowhill.com>.
Myrna van Lunteren wrote:
> On 9/13/06, Jean T. Anderson <jt...@bristowhill.com> wrote:
...
>> I'll try this on for size and upload a new review draft:
>>
>> This release includes JDBC 4.0 functionality based on a pre-release of
>> Java SE 6. When you use Derby with a Java SE 6 virtual machine, Derby
>> will use its JDBC 3.0 drivers, just as with 1.4 and 1.5 virtual
>> machines. JDBC 4.0 is available only to developers who download Java SE
>> 6 and use it to build in support for JDBC 4.0. The Release Notes explain
>> how to build the JDBC 4.0 functionality with Derby 10.2. When Java SE 6
>> becomes generally available, a follow-on Derby release will include
>> final JDBC 4.0 functionality.
>>
>> thanks Laura, David, and Myrna,
>>
>> -jean
>>
> Nice team-writing, I have 1 more suggestion, how about mentioning
> 10.2.1 instead of 10.2?
great suggestion, Myrna,
thanks,
-jean
Re: [jira] Commented: (DERBY-1271) Release documentation for JDBC4 release
Posted by Myrna van Lunteren <m....@gmail.com>.
On 9/13/06, Jean T. Anderson <jt...@bristowhill.com> wrote:
> David Van Couvering wrote:
> > Jean T. Anderson wrote:
> >> David Van Couvering wrote:
> >>> Laura Stewart (JIRA) wrote:
> >>>> [
> >>>> http://issues.apache.org/jira/browse/DERBY-1271?page=comments#action_12434569
> >>>>
> >>>> ] Laura Stewart commented on DERBY-1271:
> >>>> --------------------------------------
> >>>>
> >>>> Jean -
> >>>> Here is my attempt at wordsmithing...
> >>>>
> >>>> "JDBC 4.0 functionality is not enabled in this Derby release. JDBC 4.0
> >>>> is part of Java SE 6, which was not generally available for Derby
> >>>> 10.2. When you use Derby with a Java SE 6 virtual machine, JDBC 3.0 is
> >>>> available. JDBC 4.0 is available only to developers who download Java
> >>>> SE 6 and use it to add JDBC 4.0 support to Derby. The Release Notes
> >>>> explain how to build the JDBC 4.0 functionality with Derby 10.2. When
> >>>> Java SE 6 becomes generally available, a follow-on Derby release will
> >>>> include final JDBC 4.0 functionality. "
> >>>
> >>>
> >>> - I think 'was not generally available at the time of the Derby 10.2
> >>> release' is a better phrasing
> >>
> >> I really like the positive spin of Myrna's suggested first sentence:
> >
> >>> This release includes JDBC 4.0 functionality based on a pre-release of
> >>> Java SE 6.
> >>
> >> could that replace the first two sentences?
> >
> > Yes
>
> I'll try this on for size and upload a new review draft:
>
> This release includes JDBC 4.0 functionality based on a pre-release of
> Java SE 6. When you use Derby with a Java SE 6 virtual machine, Derby
> will use its JDBC 3.0 drivers, just as with 1.4 and 1.5 virtual
> machines. JDBC 4.0 is available only to developers who download Java SE
> 6 and use it to build in support for JDBC 4.0. The Release Notes explain
> how to build the JDBC 4.0 functionality with Derby 10.2. When Java SE 6
> becomes generally available, a follow-on Derby release will include
> final JDBC 4.0 functionality.
>
> thanks Laura, David, and Myrna,
>
> -jean
>
Nice team-writing, I have 1 more suggestion, how about mentioning
10.2.1 instead of 10.2?
Myrna
Re: [jira] Commented: (DERBY-1271) Release documentation for JDBC4
release
Posted by David Van Couvering <Da...@Sun.COM>.
Sounds very good!
David
Jean T. Anderson wrote:
[snip]
>
> I'll try this on for size and upload a new review draft:
>
> This release includes JDBC 4.0 functionality based on a pre-release of
> Java SE 6. When you use Derby with a Java SE 6 virtual machine, Derby
> will use its JDBC 3.0 drivers, just as with 1.4 and 1.5 virtual
> machines. JDBC 4.0 is available only to developers who download Java SE
> 6 and use it to build in support for JDBC 4.0. The Release Notes explain
> how to build the JDBC 4.0 functionality with Derby 10.2. When Java SE 6
> becomes generally available, a follow-on Derby release will include
> final JDBC 4.0 functionality.
>
> thanks Laura, David, and Myrna,
>
> -jean
Re: [jira] Commented: (DERBY-1271) Release documentation for JDBC4
release
Posted by "Jean T. Anderson" <jt...@bristowhill.com>.
David Van Couvering wrote:
> Jean T. Anderson wrote:
>> David Van Couvering wrote:
>>> Laura Stewart (JIRA) wrote:
>>>> [
>>>> http://issues.apache.org/jira/browse/DERBY-1271?page=comments#action_12434569
>>>>
>>>> ] Laura Stewart commented on DERBY-1271:
>>>> --------------------------------------
>>>>
>>>> Jean -
>>>> Here is my attempt at wordsmithing...
>>>>
>>>> "JDBC 4.0 functionality is not enabled in this Derby release. JDBC 4.0
>>>> is part of Java SE 6, which was not generally available for Derby
>>>> 10.2. When you use Derby with a Java SE 6 virtual machine, JDBC 3.0 is
>>>> available. JDBC 4.0 is available only to developers who download Java
>>>> SE 6 and use it to add JDBC 4.0 support to Derby. The Release Notes
>>>> explain how to build the JDBC 4.0 functionality with Derby 10.2. When
>>>> Java SE 6 becomes generally available, a follow-on Derby release will
>>>> include final JDBC 4.0 functionality. "
>>>
>>>
>>> - I think 'was not generally available at the time of the Derby 10.2
>>> release' is a better phrasing
>>
>> I really like the positive spin of Myrna's suggested first sentence:
>
>>> This release includes JDBC 4.0 functionality based on a pre-release of
>>> Java SE 6.
>>
>> could that replace the first two sentences?
>
> Yes
I'll try this on for size and upload a new review draft:
This release includes JDBC 4.0 functionality based on a pre-release of
Java SE 6. When you use Derby with a Java SE 6 virtual machine, Derby
will use its JDBC 3.0 drivers, just as with 1.4 and 1.5 virtual
machines. JDBC 4.0 is available only to developers who download Java SE
6 and use it to build in support for JDBC 4.0. The Release Notes explain
how to build the JDBC 4.0 functionality with Derby 10.2. When Java SE 6
becomes generally available, a follow-on Derby release will include
final JDBC 4.0 functionality.
thanks Laura, David, and Myrna,
-jean
Re: [jira] Commented: (DERBY-1271) Release documentation for JDBC4
release
Posted by David Van Couvering <Da...@Sun.COM>.
Jean T. Anderson wrote:
> David Van Couvering wrote:
>>
>> Laura Stewart (JIRA) wrote:
>>
>>> [
>>> http://issues.apache.org/jira/browse/DERBY-1271?page=comments#action_12434569
>>> ] Laura Stewart commented on DERBY-1271:
>>> --------------------------------------
>>>
>>> Jean -
>>> Here is my attempt at wordsmithing...
>>>
>>> "JDBC 4.0 functionality is not enabled in this Derby release. JDBC 4.0
>>> is part of Java SE 6, which was not generally available for Derby
>>> 10.2. When you use Derby with a Java SE 6 virtual machine, JDBC 3.0 is
>>> available. JDBC 4.0 is available only to developers who download Java
>>> SE 6 and use it to add JDBC 4.0 support to Derby. The Release Notes
>>> explain how to build the JDBC 4.0 functionality with Derby 10.2. When
>>> Java SE 6 becomes generally available, a follow-on Derby release will
>>> include final JDBC 4.0 functionality. "
>>
>> - I think 'was not generally available at the time of the Derby 10.2
>> release' is a better phrasing
>
> I really like the positive spin of Myrna's suggested first sentence:
>
>> This release includes JDBC 4.0 functionality based on a pre-release of
>> Java SE 6.
>
> could that replace the first two sentences?
Yes
Re: [jira] Commented: (DERBY-1271) Release documentation for JDBC4
release
Posted by "Jean T. Anderson" <jt...@bristowhill.com>.
David Van Couvering wrote:
>
>
> Laura Stewart (JIRA) wrote:
>
>> [
>> http://issues.apache.org/jira/browse/DERBY-1271?page=comments#action_12434569
>> ] Laura Stewart commented on DERBY-1271:
>> --------------------------------------
>>
>> Jean -
>> Here is my attempt at wordsmithing...
>>
>> "JDBC 4.0 functionality is not enabled in this Derby release. JDBC 4.0
>> is part of Java SE 6, which was not generally available for Derby
>> 10.2. When you use Derby with a Java SE 6 virtual machine, JDBC 3.0 is
>> available. JDBC 4.0 is available only to developers who download Java
>> SE 6 and use it to add JDBC 4.0 support to Derby. The Release Notes
>> explain how to build the JDBC 4.0 functionality with Derby 10.2. When
>> Java SE 6 becomes generally available, a follow-on Derby release will
>> include final JDBC 4.0 functionality. "
>
>
> - I think 'was not generally available at the time of the Derby 10.2
> release' is a better phrasing
I really like the positive spin of Myrna's suggested first sentence:
> This release includes JDBC 4.0 functionality based on a pre-release of
> Java SE 6.
could that replace the first two sentences?
> - 'JDBC 3.0 is available' is confusing to me -- available for what? I
> think. Also, note that JDBC 3.0 is also what you are using with 1.4 and
> 1.5 VMs. So I think better wording is:
>
> 'When you use Derby with a Java SE 6 virtual machine, Derby will use its
> JDBC 3.0 drivers, just as with 1.4 and 1.5 virtual machines.'
>
> - Also 'download Java SE 6 and use it to add JDBC 4.0 support' should be
> more clear: 'download Java SE 6 and use it to build in support for JDBC
> 4.0'
both great suggestions, David, thanks!
-jean
Re: [jira] Commented: (DERBY-1271) Release documentation for JDBC4
release
Posted by David Van Couvering <Da...@Sun.COM>.
Laura Stewart (JIRA) wrote:
> [ http://issues.apache.org/jira/browse/DERBY-1271?page=comments#action_12434569 ]
>
> Laura Stewart commented on DERBY-1271:
> --------------------------------------
>
> Jean -
>
> Here is my attempt at wordsmithing...
>
> "JDBC 4.0 functionality is not enabled in this Derby release. JDBC 4.0 is part of Java SE 6, which was not generally available for Derby 10.2. When you use Derby with a Java SE 6 virtual machine, JDBC 3.0 is available. JDBC 4.0 is available only to developers who download Java SE 6 and use it to add JDBC 4.0 support to Derby. The Release Notes explain how to build the JDBC 4.0 functionality with Derby 10.2. When Java SE 6 becomes generally available, a follow-on Derby release will include final JDBC 4.0 functionality. "
- I think 'was not generally available at the time of the Derby 10.2
release' is a better phrasing
- 'JDBC 3.0 is available' is confusing to me -- available for what? I
think. Also, note that JDBC 3.0 is also what you are using with 1.4 and
1.5 VMs. So I think better wording is:
'When you use Derby with a Java SE 6 virtual machine, Derby will use its
JDBC 3.0 drivers, just as with 1.4 and 1.5 virtual machines.'
- Also 'download Java SE 6 and use it to add JDBC 4.0 support' should be
more clear: 'download Java SE 6 and use it to build in support for JDBC 4.0'
Thanks!
David
>
> Comments:
>
> "Attention" is a good choice for this type of note.
> I don't like the phrase "JDBC 3.0 is available." It seems incomplete. This is minor :-)
> I think that the warning about compatibility with the final version of JDBC 4.0 should be addressed in the Release Notes.
>
>> Release documentation for JDBC4 release
>> ---------------------------------------
>>
>> Key: DERBY-1271
>> URL: http://issues.apache.org/jira/browse/DERBY-1271
>> Project: Derby
>> Issue Type: Improvement
>> Components: Documentation, JDBC
>> Affects Versions: 10.2.1.0
>> Reporter: Rick Hillegas
>> Assigned To: Jean T. Anderson
>> Fix For: 10.2.1.0
>>
>> Attachments: adminGuide_v01.tar, derby-1271_adminGuide_v01.diff, derby-1271_copyrights.diff, derby-1271_copyrights_v02.diff, derby-1271_devGuide_v01.diff, derby-1271_refGuide_v01.diff, derby-1271_refGuide_v01.tar, derby-1271_toolsGuide_v01.diff, derby1271-2-html.zip, derby1271-2.diff, devGuide_v01.tar, toolsGuide_v01.tar
>>
>>
>> We can't check in any of this work until we understand how our release trains line up. However, the JDBC4-bearing release will need the following documentation:
>> 1) Changes to the user guides. These need to be understood. We can analyze the scope of these changes without checking anything in yet.
>> 2) Summary page which explains what pieces of JDBC4 we tackled and what we passed over.
>> 3) Verbiage for the Release Notes.
>> USER GUIDES
>> Admin Guide
>> Part One...How to start an embedded server from an application
>> For JDBC4, we can omit the Class.forName() line because
>> of Driver autoloading.
>> Part One...Embedded server example
>> For JDBC4, we can omit the Class.forName() line because
>> of Driver autoloading.
>> Part One...Network client driver examples
>> For JDBC4, we can omit the Class.forName() line because
>> of Driver autoloading.
>> Part One...Accessing the Network Server by using a DataSource
>> For JDBC4, we have different DataSources: ClientDateSource40
>> and ClientConnectionPoolDataSource40.
>> Part One...Using the Derby ij tool with the Network Server
>> In case the DRIVER command ends up being needed pre-JDBC4,
>> we should note that you don't need it under JDBC4 because
>> of Driver autoloading.
>> Part One...The NsSample sample program
>> Change NsSample to demonstrate driver autoloading under JDBC4.
>> Part One...Overview of the SimpleNetworkServerSample program
>> Change SimpleNetworkServerSample to demonstrate driver autoloading under JDBC4.
>> Part One...Connecting a client to the Network Server with the SimpleNetworkClientSample program
>> Change SimpleNetworkClientSample to demonstrate driver autoloading under JDBC4.
>> Developer's Guide
>> JDBC applications and Derby basics
>> Derby embedded basics
>> Derby JDBC driver
>> Note that you don't need Class.forName() in JDBC4.
>> Derby embedded basics
>> Embedded Derby JDBC driver
>> Note that you don't need Class.forName() in JDBC4.
>> Starting Derby as an embedded database
>> Note that you don't need Class.forName() or the jdbc.drivers property in JDBC4.
>> Controlling Derby application behavior
>> Working with Derby SQLExceptions in an application
>> Note that with JDBC4, these are refined subclasses
>> Example of processing SQLExceptions
>> Say something about SQLException.getCause()
>> Using Derby as a J2EE resource manager
>> Classes that pertain to resource managers
>> Mention the JDBC4 variants of these classes.
>> Getting a DataSource
>> Include example using JDBC4 variants of these classes.
>> Shutting down or creating a database
>> Include example using JDBC4 variants of these classes.
>> Getting Started Guide
>> No changes necessary.
>> Reference Guide
>> Derby exception messages and SQL states
>> Describe SQLFeatureNotSupportedException and its SQLStates.
>> SQLState and error message reference
>> Mention new unimplementedFeature exceptions.
>> What to do about new SQLStates.
>> JDBC Reference
>> "conforms to the JDBC 2.0 and 3.0 APIs"
>> ->
>> "conforms to the JDBC 2.0, 3.0, and 4.0 APIs"
>> java.sql.Driver
>> Amend this to note driver autoloading for JDBC4.
>> java.sql.Connection
>> Connection functionality not supported
>> List unsupported Connection methods.
>> java.sql.DatabaseMetaData
>> Columns in the ResultSet returned by getProcedureColumns
>> Add new columns added by JDBC4
>> java.sql.Statement
>> Note that Derby does not support the execute() and
>> executeQuery() overloads which return autogenerated keys.
>> Prepared statements and streaming columns
>> Note that with JDBC4, you can specify length as a long
>> or even omit the length when setting LOB streams.
>> java.sql.ResultSetMetaData
>> Waiting for feedback from Dag on whether we still don't
>> support isDefinitelyWritable(), isReadOnly(), and
>> isWritable().
>> java.sql.Blob and java.sql.Clob
>> Right now this section says that Derby supports the methods in
>> the Blob and Clob interfaces. This is not true. We should
>> describe the discrepancies, including any additional methods added
>> by JDBC4.
>> JDBC 4.0-only features
>> Add this new section, with a subsection for each SQL interface
>> that changed in JDBC4. The subsections should list new methods
>> that were added.
>> Derby API
>> JDBC implementation classes
>> Data Source Classes
>> List the JDBC4 versions of these classes
>> Tools Guide
>> Using ij
>> Getting started with ij
>> Running ij scripts
>> You don't need to specify the Derby drivers
>> on the command line even under JDBC2.
>> ij properties reference
>> ij.dataSource
>> This is the DataSource for embedded JDBC3. Note that
>> this would be different if you are running under
>> JDBC4.
>> Tuning Guide
>> No changes necessary.
>> Working With Derby Guide
>> Activity 3: Run a JDBC program using the Embedded driver
>> The WwdEmbedded program
>> Start the Derby engine
>> Note that this step (Class.forName() on the embedded driver)
>> is not necessary if you are running on jdk 1.6 or higher.
>