You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by km...@apache.org on 2008/02/20 20:21:11 UTC
svn commit: r629580 - /db/derby/docs/trunk/src/ref/crefjavstateautogen.dita
Author: kmarsden
Date: Wed Feb 20 11:21:08 2008
New Revision: 629580
URL: http://svn.apache.org/viewvc?rev=629580&view=rev
Log:
DERBY-2653 (doc) Expose existing auto-generated key functionality through more JDBC APIs in Derby Client.
Document API's available for client and call out limitations of error checking.
Modified:
db/derby/docs/trunk/src/ref/crefjavstateautogen.dita
Modified: db/derby/docs/trunk/src/ref/crefjavstateautogen.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/crefjavstateautogen.dita?rev=629580&r1=629579&r2=629580&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/crefjavstateautogen.dita (original)
+++ db/derby/docs/trunk/src/ref/crefjavstateautogen.dita Wed Feb 20 11:21:08 2008
@@ -42,13 +42,13 @@
<li>An array of the names of the columns in the inserted row that should be
made available. If any column name in the array does <i>not</i> designate
an auto-increment column, <ph conref="../conrefs.dita#prod/productshortname"></ph>
-will throw an error. (This argument is supported only with the <ph conref="../conrefs.dita#prod/productshortname"></ph> embedded
-driver.) </li>
+will throw an error with the <ph conref="../conrefs.dita#prod/productshortname"></ph> embedded
+driver. With the client driver, the one element column name is ignored currently and the value returned corresponds to the identity column. To ensure compatibility with future changes an application should ensure the column described is the identity column. If the column name corresponds to another column or a non-existent column then future changes may result in a value for a different column being returned or an exception being thrown. </li>
<li>An array of the positions of the columns in the inserted row that should
be made available. If any column position in the array does <i>not</i> correlate
to an auto-increment column, <ph conref="../conrefs.dita#prod/productshortname"></ph> will
-throw an error. (This argument is supported only with the <ph conref="../conrefs.dita#prod/productshortname"></ph> embedded
-driver.) </li>
+throw an error with the <ph conref="../conrefs.dita#prod/productshortname"></ph> embedded
+driver. With the client driver, the one element position array is ignored currently and the value returned corresponds to the identity column. To ensure compatibility with future changes an application should ensure the column described is the identity column. If the position corresponds to another column or a non-existent column then future changes may result in a value for a different column being returned or an exception being thrown. </li>
</ul>
<section><title>Example</title> <p>Assume that we have a table TABLE1 defined
as follows:</p> <codeblock>CREATE TABLE TABLE1 (C11 int, C12 int GENERATED ALWAYS AS IDENTITY)