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

A B commented on DERBY-2654:
----------------------------

Hi Kim,

Thanks for addressing this so quickly!

Regarding:

  "This argument is supported only when the application is running in embedded 
mode".

I think one of two options might be better here.  Either:

  1. "This argument is supported only when Derby is running in embedded mode".

or

  2. "This argument is only supported with the Derby embedded driver".

My inclination is toward the latter, but whichever you think works better is 
fine.

Also, Myrna commented on derby-dev as follows:

> Maybe in addition, this could be added to the server guide where some
> differences between client and server are documented? Or can we refer
> in those docs to a bug? If so, we could refer to DERBY-310...

If you feel like tackling this as well, I think one approach would be to create 
a new page and link to it from:

   http://db.apache.org/derby/docs/dev/adminguide/cadminapps.html 

The new page could be as simple as:

<begin>

JDBC 3 Autogenerated Keys

The following JDBC 3 methods are only supported with the Derby embedded driver. 
 Attempts to call these methods with the network client driver will result in a 
"not implemented" error.

  Connection.prepareStatement(String sql, String[] columnNames);
  Connection.prepareStatement(String sql, int[] columnIndexes);

  Statement.execute(String sql, String[] columNames);
  Statement.execute(String sql, int[] columIndexes);
  Statement.executeUpdate(String sql, String[] columnNames);
  Statement.executeUpdate(String sql, int[] columnIndexes);

For more on the use of these methods, see <link to crefjavstateautogen.html>.

<end>

Does that sound okay?

> Document newly-supported (in embedded mode) JDBC methods for autogenerated 
> keys.
> --------------------------------------------------------------------------------
>
>                 Key: DERBY-2654
>                 URL: https://issues.apache.org/jira/browse/DERBY-2654
>             Project: Derby
>          Issue Type: Sub-task
>          Components: Documentation
>    Affects Versions: 10.3.0.0
>            Reporter: A B
>            Assignee: Kim Haase
>             Fix For: 10.3.0.0
>
>         Attachments: changes.txt, changes.txt, DERBY-2654-2.diff, 
> DERBY-2654-2.zip, DERBY-2654-3.diff, DERBY-2654.diff, DERBY-2654.zip, 
> DERBY-2654.zip
>
>
> Several JDBC methods for specifying auto-generated key columns were 
> implemented in embedded mode as part of DERBY-2631. Derby documentation 
> should be updated to reflect those changes.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to