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 rh...@apache.org on 2007/10/19 20:35:05 UTC
svn commit: r586573 -
/db/derby/docs/trunk/src/devguide/cdevspecialtfgetxxx.dita
Author: rhillegas
Date: Fri Oct 19 11:35:04 2007
New Revision: 586573
URL: http://svn.apache.org/viewvc?rev=586573&view=rev
Log:
DERBY-3072: Fix description of which getXXX() method we expect Derby to invoke on DECIMAL/NUMERIC columns in table functions when run on JSR 169 platforms.
Modified:
db/derby/docs/trunk/src/devguide/cdevspecialtfgetxxx.dita
Modified: db/derby/docs/trunk/src/devguide/cdevspecialtfgetxxx.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevspecialtfgetxxx.dita?rev=586573&r1=586572&r2=586573&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevspecialtfgetxxx.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevspecialtfgetxxx.dita Fri Oct 19 11:35:04 2007
@@ -22,7 +22,10 @@
<title>Preferred <i>getXXX()</i> methods for Derby-style table functions</title>
<shortdesc>While scanning a Derby-style table function, Derby
calls a preferred <i>getXXX()</i> method for each column, based on the
-column's data type.</shortdesc>
+column's data type. If Derby is running on a small device platform and presenting
+the JSR 169 interface to clients, then the methods which Derby calls are
+slightly different. This is because JSR 169 does not support BigDecimal.
+</shortdesc>
<prolog><metadata>
<keywords><indexterm>Functions<indexterm>table function getXXX() methods</indexterm></indexterm>
</keywords>
@@ -36,13 +39,16 @@
<b><i>getXXX()</i> Methods Called for Declared SQL Types</b>
</title>
-<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="1" colnum="1" colwidth="60*"/>
-<colspec colname="2" colnum="2" colwidth="40*"/>
+<tgroup cols="3" colsep="1" rowsep="1">
+<colspec colname="1" colnum="1" colwidth="60*"/>
+<colspec colname="2" colnum="2" colwidth="20*"/>
+<colspec colname="3" colnum="3" colwidth="20*"/>
<thead>
<row>
<entry align="left" colname="1" valign="bottom">Column Type Declared by CREATE FUNCTION</entry>
-<entry align="left" colname="2" valign="bottom"><i>getXXX()</i> Method Called by Derby</entry>
+<entry align="left" colname="2" valign="bottom"><i>getXXX()</i> Method Called by Derby for JDBC 3.0 and 4.0</entry>
+<entry align="left" colname="3" valign="bottom"><i>getXXX()</i> Method Called by Derby for JSR 169</entry>
</row>
</thead>
@@ -51,107 +57,128 @@
<row>
<entry colname="1">BIGINT</entry>
-<entry colname="2" ><i>getLong()</i></entry>
+<entry colname="2"><i>getLong()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">BLOB</entry>
<entry colname="2"><i>getBlob()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">CHAR</entry>
<entry colname="2"><i>getString()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">CHAR FOR BIT DATA</entry>
<entry colname="2"><i>getBytes()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">CLOB</entry>
<entry colname="2"><i>getClob()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">DATE</entry>
<entry colname="2"><i>getDate()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">DECIMAL</entry>
<entry colname="2"><i>getBigDecimal()</i></entry>
+<entry colname="3"><i>getString()</i></entry>
</row>
<row>
<entry colname="1">DOUBLE</entry>
<entry colname="2"><i>getDouble()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">DOUBLE PRECISION</entry>
<entry colname="2"><i>getDouble()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">FLOAT</entry>
<entry colname="2"><i>getDouble()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">INTEGER</entry>
<entry colname="2"><i>getInt()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">LONG VARCHAR</entry>
<entry colname="2"><i>getString()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">LONG VARCHAR FOR BIT DATA</entry>
<entry colname="2"><i>getBytes()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">NUMERIC</entry>
<entry colname="2"><i>getBigDecimal()</i></entry>
+<entry colname="3"><i>getString()</i></entry>
</row>
<row>
<entry colname="1">REAL</entry>
<entry colname="2"><i>getFloat()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">SMALLINT</entry>
<entry colname="2"><i>getShort()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">TIME</entry>
<entry colname="2"><i>getTime()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">TIMESTAMP</entry>
<entry colname="2"><i>getTimestamp()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">VARCHAR</entry>
<entry colname="2"><i>getString()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">VARCHAR FOR BIT DATA</entry>
<entry colname="2"><i>getBytes()</i></entry>
+<entry colname="3">Same</entry>
</row>
<row>
<entry colname="1">XML</entry>
-<entry colname="2"><b>Not supported.</b></entry>
+<entry colname="2"><b>Not supported</b></entry>
+<entry colname="3"><b>Not supported</b></entry>
</row>
</tbody>