svn commit: r201685 - in /incubator/derby/docs/trunk/src/ref: refderby.ditamap rrefjdbcjsr169.dita

[jt...@apache.org]

Author: jta
Date: Fri Jun 24 14:59:41 2005
New Revision: 201685

URL: http://svn.apache.org/viewcvs?rev=201685&view=rev
Log:
DERBY-376 Committed Jeff Levitt's patch that documents supporting 
J2ME/CDC/Foundation with JSR169 JDBC subset.

Added:
    incubator/derby/docs/trunk/src/ref/rrefjdbcjsr169.dita
Modified:
    incubator/derby/docs/trunk/src/ref/refderby.ditamap

Modified: incubator/derby/docs/trunk/src/ref/refderby.ditamap
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/ref/refderby.ditamap?rev=201685&r1=201684&r2=201685&view=diff
==============================================================================
--- incubator/derby/docs/trunk/src/ref/refderby.ditamap (original)
+++ incubator/derby/docs/trunk/src/ref/refderby.ditamap Fri Jun 24 14:59:41 2005
@@ -409,6 +409,7 @@
 </topicref>
 <topicref href="rrefjdbc87220.dita" navtitle="java.sql.BatchUpdateException">
 </topicref>
+<topicref href="rrefjdbcjsr169.dita" navtitle="JDBC Package for Connected Device Configuration/Foundation Profile (JSR169)"></topicref>
 <topicref href="rrefjdbc32593.dita" navtitle="JDBC 3.0-Only Features"></topicref>
 <topicref href="rrefjdbcjavasqlconnection30.dita" navtitle="java.sql.Connection">
 </topicref>

Added: incubator/derby/docs/trunk/src/ref/rrefjdbcjsr169.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/ref/rrefjdbcjsr169.dita?rev=201685&view=auto
==============================================================================
--- incubator/derby/docs/trunk/src/ref/rrefjdbcjsr169.dita (added)
+++ incubator/derby/docs/trunk/src/ref/rrefjdbcjsr169.dita Fri Jun 24 14:59:41 2005
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.  
+
+Licensed under the Apache License, Version 2.0 (the "License");  
+you may not use this file except in compliance with the License.  
+You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<reference id="rrefjdbcjsr169" xml:lang="en-us">
+<title>JDBC Package for Connected Device Configuration/Foundation Profile
+(JSR169)</title>
+<prolog><metadata>
+<keywords><indexterm>JSR169-only features<indexterm>Derby's support for</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><p><ph conref="refconrefs.dita#prod/productshortname"></ph> supports
+the JDBC API defined for the Connected Device Configuration/Foundation Profile,
+also known as JSR169. The features supported are a subset of the JDBC 3.0
+specification. Support for JSR169 is limited to the embedded driver. <ph conref="refconrefs.dita#prod/productshortname"></ph> does
+not support using the Network Server under JSR169.</p></section>
+<section><p>To obtain a connection under JSR169 specifications, use the <codeph>org.apache.derby.jdbc.EmbeddedSimpleDataSource</codeph> class.
+This class is identical in implementation to the <codeph>org.apache.derby.jdbc.EmbeddedDataSource</codeph> class.
+See the <ph conref="refconrefs.dita#pub/citdevelop"></ph> for information
+on using the properties of the <codeph>org.apache.derby.jdbc.EmbeddedDataSource</codeph> class.</p><p>Some
+other features to note concerning the JSR169 implementation using <ph conref="refconrefs.dita#prod/productshortname"></ph>:<ul>
+<li>Applications must get and set <codeph>DECIMAL</codeph> values using alternate
+JDBC <codeph>getXXX</codeph> and <codeph>setXXX</codeph> methods, such as <codeph>getString()</codeph> and <codeph>setString()</codeph>.
+Any alternate method that works against a DECIMAL type with JDBC 2.0 or 3.0
+will work in JSR169.</li>
+<li>Java functions and procedures that use server-side JDBC parameters such
+as <codeph>CONTAINS SQL</codeph>, <codeph>READS SQL DATA</codeph> or <codeph>MODIFIES
+SQL DATA</codeph> are not supported in JSR169.</li>
+<li>The standard API used to obtain a connection (<codeph>jdbc:default:connection</codeph>)
+is not supported in JSR169. A runtime error may occur when the routine tries
+to obtain a connection using <codeph>jdbc:default:connection</codeph>.</li>
+<li>Diagnostic tables are not supported.</li>
+<li>Triggers are not supported.</li>
+<li>Encrypted databases are not supported.</li>
+<li>DriverManager is not supported. You cannot use DriverManager.getConnection()
+to obtain a connection.</li>
+</ul></p></section>
+</refbody>
+</reference>