db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rhille...@apache.org
Subject svn commit: r425417 - /db/derby/docs/trunk/src/ref/
Date Tue, 25 Jul 2006 15:20:09 GMT
Author: rhillegas
Date: Tue Jul 25 08:20:08 2006
New Revision: 425417

URL: http://svn.apache.org/viewvc?rev=425417&view=rev
Log:
DERBY-1271: Commit derby-1271_refGuide_v01.diff, the JDBC4-related changes to the Reference
Guide.

Added:
    db/derby/docs/trunk/src/ref/rrefjdbc4_0connection.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefjdbc4_0dataSource.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefjdbc4_0databaseMetaData.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefjdbc4_0sqlexception.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefjdbc4_0statement.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefjdbc4_0summary.dita   (with props)
Modified:
    db/derby/docs/trunk/src/ref/crefjavccns.dita
    db/derby/docs/trunk/src/ref/crefjdbc12657.dita
    db/derby/docs/trunk/src/ref/refderby.ditamap
    db/derby/docs/trunk/src/ref/rrefapi1003363.dita
    db/derby/docs/trunk/src/ref/rrefcrsrgpc1.dita
    db/derby/docs/trunk/src/ref/rrefexcept16677.dita
    db/derby/docs/trunk/src/ref/rrefjavsqlprst.dita
    db/derby/docs/trunk/src/ref/rrefjdbc32052.dita
    db/derby/docs/trunk/src/ref/rrefjdbc40794.dita

Modified: db/derby/docs/trunk/src/ref/crefjavccns.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/crefjavccns.dita?rev=425417&r1=425416&r2=425417&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/crefjavccns.dita (original)
+++ db/derby/docs/trunk/src/ref/crefjavccns.dita Tue Jul 25 08:20:08 2006
@@ -21,8 +21,19 @@
 <title>Connection functionality not supported</title>
 <conbody>
 <p><ph conref="refconrefs.dita#prod/productshortname"></ph> does not use
catalog
-names; the <i>getCatalog</i> and <i>setCatalog</i> methods result
in a "Feature
-not implemented" <i>SQLException</i> with an <i>SQLState</i> of XJZZZ.</p>
+names. In addition, the following optional methods raise "Feature not
+supported" exceptions:
+</p>
+<ul>
+<li><i>createArrayOf( java.lang.String, java.lang.Object[] )</i></li>
+<li><i>createNClob( )</i></li>
+<li><i>createSQLXML( )</i></li>
+<li><i>createStruct( java.lang.String, java.lang.Object[] )</i></li>
+<li><i>getTypeMap( )</i></li>
+<li><i>prepareStatement( java.lang.String, int[] )</i></li>
+<li><i>prepareStatement( java.lang.String, java.lang.String[] )</i></li>
+<li><i>setTypeMap( java.util.Map )</i></li>
+</ul>
 </conbody>
 </concept>
 

Modified: db/derby/docs/trunk/src/ref/crefjdbc12657.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/crefjdbc12657.dita?rev=425417&r1=425416&r2=425417&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/crefjdbc12657.dita (original)
+++ db/derby/docs/trunk/src/ref/crefjdbc12657.dita Tue Jul 25 08:20:08 2006
@@ -30,7 +30,7 @@
 defined by Sun).</p>
 <p>This chapter provides reference information about <ph conref="refconrefs.dita#prod/productshortname"></ph>'s
 implementation of the JDBC API and documents the way it conforms to the JDBC
-2.0 and 3.0 APIs.</p>
+2.0, 3.0, and 4.0 APIs.</p>
 <p>See the <cite><ph conref="refconrefs.dita#pub/citdevelop"></ph></cite>
for
 task-oriented instructions on working with the driver.</p>
 <p>This JDBC driver implements the standard JDBC interface defined by Sun.

Modified: db/derby/docs/trunk/src/ref/refderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/refderby.ditamap?rev=425417&r1=425416&r2=425417&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/refderby.ditamap (original)
+++ db/derby/docs/trunk/src/ref/refderby.ditamap Tue Jul 25 08:20:08 2006
@@ -399,7 +399,7 @@
 </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 collection-type="family" href="rrefjdbc32593.dita" navtitle="JDBC 3.0-only features
">
 <topicref href="rrefjdbcjavasqlconnection30.dita" navtitle="java.sql.Connection ">
 </topicref>
 <topicref href="rrefjdbcdatabasemetadata30.dita" navtitle="java.sql.DatabaseMetaData ">
@@ -419,6 +419,14 @@
 <topicref collection-type="family" href="rrefjdbcjavasqlstatement30.dita"
 navtitle="java.sql.Statement">
 <topicref href="crefjavstateautogen.dita" navtitle="Autogenerated keys"></topicref>
+</topicref>
+</topicref>
+<topicref collection-type="family" href="rrefjdbc4_0summary.dita" navtitle="JDBC 4.0-only
features ">
+<topicref href="rrefjdbc4_0sqlexception.dita" navtitle="Refined subclasses of SQLException"></topicref>
+<topicref href="rrefjdbc4_0connection.dita" navtitle="java.sql.Connection"></topicref>
+<topicref href="rrefjdbc4_0databaseMetaData.dita" navtitle="java.sql.DatabaseMetaData"></topicref>
+<topicref href="rrefjdbc4_0statement.dita" navtitle="java.sql.Statement"></topicref>
+<topicref href="rrefjdbc4_0dataSource.dita" navtitle="javax.sql.DataSource"></topicref>
 </topicref>
 <topicref collection-type="family" href="rrefjdbc1020262.dita" navtitle="JDBC escape syntax
">
 <topicref href="rrefjdbc70824.dita" navtitle="JDBC escape keyword for call statements">

Modified: db/derby/docs/trunk/src/ref/rrefapi1003363.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefapi1003363.dita?rev=425417&r1=425416&r2=425417&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefapi1003363.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefapi1003363.dita Tue Jul 25 08:20:08 2006
@@ -19,24 +19,40 @@
 <reference id="rrefapi1003363" xml:lang="en-us">
 <title>Data Source Classes</title>
 <prolog><metadata>
-<keywords><indexterm>org.apache.derby.jdbc. EmbeddedConnection PoolDataSource</indexterm>
-<indexterm>org.apache.derby.jdbc. EmbeddedXADataSource</indexterm><indexterm>org.apache.derby.jdbc.
-EmbeddedDataSource</indexterm><indexterm>org.apache.derby.jdbc. ClientConnection
-PoolDataSource</indexterm><indexterm>org.apache.derby.jdbc. ClientXADataSource</indexterm>
-<indexterm>org.apache.derby.jdbc. ClientDataSource</indexterm></keywords>
+<keywords>
+<indexterm>org.apache.derby.jdbc. EmbeddedConnection PoolDataSource</indexterm>
+<indexterm>org.apache.derby.jdbc. EmbeddedXADataSource</indexterm>
+<indexterm>org.apache.derby.jdbc. EmbeddedDataSource</indexterm>
+<indexterm>org.apache.derby.jdbc. ClientConnection PoolDataSource</indexterm>
+<indexterm>org.apache.derby.jdbc. ClientXADataSource</indexterm>
+<indexterm>org.apache.derby.jdbc. ClientDataSource</indexterm>
+<indexterm>org.apache.derby.jdbc. EmbeddedConnection40 PoolDataSource</indexterm>
+<indexterm>org.apache.derby.jdbc. EmbeddedXADataSource40</indexterm>
+<indexterm>org.apache.derby.jdbc. EmbeddedDataSource40</indexterm>
+<indexterm>org.apache.derby.jdbc. ClientConnection40 PoolDataSource</indexterm>
+<indexterm>org.apache.derby.jdbc. ClientXADataSource40</indexterm>
+<indexterm>org.apache.derby.jdbc. ClientDataSource40</indexterm>
+</keywords>
 </metadata></prolog>
 <refbody>
 <section><p>These classes are all related to <ph conref="refconrefs.dita#prod/productshortname"></ph>'s
 implementation of <i>javax.sql.DataSource</i> and related APIs. For more information,
-see the <cite><ph conref="refconrefs.dita#pub/citdevelop"></ph></cite>.
  </p><p>Embedded
+see the <cite><ph
+conref="refconrefs.dita#pub/citdevelop"></ph></cite>.   </p>
+<p>
+Each of these classes has two variants. Use the first variant if your
+application runs on JDK 1.5 or lower. Use the second variant (the one
+ending in "40") if your application runs on JDK 1.6 or higher.
+</p>
+<p>Embedded
 environment:<ul>
-<li><i>org.apache.derby.jdbc.EmbeddedDataSource</i></li>
-<li><i>org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource</i></li>
-<li><i>org.apache.derby.jdbc.EmbeddedXADataSource</i></li>
+<li><i>org.apache.derby.jdbc.EmbeddedDataSource</i> and <i>org.apache.derby.jdbc.EmbeddedDataSource40</i></li>
+<li><i>org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource</i> and <i>org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource40</i></li>
+<li><i>org.apache.derby.jdbc.EmbeddedXADataSource</i> and <i>org.apache.derby.jdbc.EmbeddedXADataSource40</i></li>
 </ul></p><p>Client-server environment<ul>
-<li><i>org.apache.derby.jdbc.ClientDataSource</i></li>
-<li><i>org.apache.derby.jdbc.ClientConnectionPoolDataSource</i></li>
-<li><i>org.apache.derby.jdbc.ClientXADataSource</i></li>
+<li><i>org.apache.derby.jdbc.ClientDataSource</i> and <i>org.apache.derby.jdbc.ClientDataSource40</i></li>
+<li><i>org.apache.derby.jdbc.ClientConnectionPoolDataSource</i> and <i>org.apache.derby.jdbc.ClientConnectionPoolDataSource40</i></li>
+<li><i>org.apache.derby.jdbc.ClientXADataSource</i> and <i>org.apache.derby.jdbc.ClientXADataSource40</i></li>
 </ul></p></section>
 </refbody>
 </reference>

Modified: db/derby/docs/trunk/src/ref/rrefcrsrgpc1.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefcrsrgpc1.dita?rev=425417&r1=425416&r2=425417&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefcrsrgpc1.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefcrsrgpc1.dita Tue Jul 25 08:20:08 2006
@@ -35,6 +35,16 @@
 primitive parameters and <i>DatabaseMetaData.procedureNullable</i> for object
 parameters</p></li>
 <li>REMARKS   <p>a String describing the java type of the method parameter</p></li>
+<li>COLUMN_DEF   <p>a String describing the default value for the
+column (may be null)</p></li>
+<li>SQL_DATA_TYPE   <p>reserved by JDBC spec for future use</p></li>
+<li>SQL_DATETIME_SUB   <p>reserved by JDBC spec for future use</p></li>
+<li>CHAR_OCTET_LENGTH   <p>the maximum length of binary and character
+based columns (or any other datatype the returned value is a NULL)</p></li>
+<li>ORDINAL_POSITION   <p>the ordinal position, starting from 1, for the input
and output parameters for a procedure.</p></li>
+<li>IS_NULLABLE   <p>a String describing the parameter's nullability
+(YES means parameter can include NULLs, NO means it can't)</p></li>
+<li>SPECIFIC_NAME   <p>the name which uniquely identifies this procedure within
its schema</p></li>
 <li>METHOD_ID   <p>a <ph conref="refconrefs.dita#prod/productshortname"></ph>-specific
 column.</p></li>
 <li>PARAMETER_ID  <p>a <ph conref="refconrefs.dita#prod/productshortname"></ph>-specific

Modified: db/derby/docs/trunk/src/ref/rrefexcept16677.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefexcept16677.dita?rev=425417&r1=425416&r2=425417&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefexcept16677.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefexcept16677.dita Tue Jul 25 08:20:08 2006
@@ -29,8 +29,10 @@
 </keywords>
 </metadata></prolog>
 <refbody>
-<section><p>Unimplemented aspects of the JDBC driver return an <i>SQLException</i>
with
-a message starting "Feature not implemented" and an <i>SQLState</i> of <codeph>XJZZZ</codeph>.
+<section><p>Unimplemented aspects of the JDBC driver return a <i>SQLException</i>
with
+a <i>SQLState</i> starting with <codeph>0A</codeph>. If your
+application runs on JDK 1.6 or higher, then the exception class is
+<i>java.sql.SQLFeatureNotSupportedException</i>.
 These unimplemented parts are for features not supported by <ph conref="refconrefs.dita#prod/productshortname"></ph>.</p></section>
 <section><p><ph conref="refconrefs.dita#prod/productshortname"></ph>
supplies
 values for the message and <i>SQLState</i> fields. In addition, <ph conref="refconrefs.dita#prod/productshortname"></ph>
sometimes

Modified: db/derby/docs/trunk/src/ref/rrefjavsqlprst.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjavsqlprst.dita?rev=425417&r1=425416&r2=425417&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjavsqlprst.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefjavsqlprst.dita Tue Jul 25 08:20:08 2006
@@ -41,8 +41,14 @@
 <li><i><ph><indexterm>setUnicodeStream</indexterm></ph><ph><indexterm>Unicode<indexterm>setUnicodeStream</indexterm></indexterm></ph>setUnicodeStream</i
 >   <p>for streams containing Unicode characters</p></li>
 </ul></p></section>
-<section><p><indexterm>Stream</indexterm>JDBC requires that you specify
the
-length of the stream. The stream object passed to these three methods can
+<section><p><indexterm>Stream</indexterm>JDBC 2.0 and JDBC 3.0 require
that you specify the
+length of the stream and <ph conref="refconrefs.dita#prod/productshortname"></ph>
+enforces this requirement if your application runs on JDK 1.5 or earlier. If your application
runs
+on JDK 1.6, then <ph conref="refconrefs.dita#prod/productshortname"></ph> exposes
a JDBC
+4.0 implementation, which
+lets you use the streaming interfaces without having to specify the
+stream length.
+The stream object passed to these three methods can
 be either a standard Java stream object or the user's own subclass that implements
 the standard <i>java.io.InputStream</i> interface.</p></section>
 <section><p>According to the JDBC standard, streams can be stored only in

Modified: db/derby/docs/trunk/src/ref/rrefjdbc32052.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbc32052.dita?rev=425417&r1=425416&r2=425417&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbc32052.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefjdbc32052.dita Tue Jul 25 08:20:08 2006
@@ -27,6 +27,9 @@
 local JDBC driver is the class <i>org.apache.derby.jdbc.EmbeddedDriver</i>.
 Listed below are some of the ways to create instances of that class. Do not use the class
directly through the <i>java.sql.Driver</i> interface.
 Use the <i>DriverManager</i> class to create connections.   <ul id="i1012571">
+<li>If your application runs on JDK 1.6 or higher, you do not need to
+do any of the following. The EmbeddedDriver will load automatically
+when your application asks for its first Connection.<p> </p></li>
 <li id="i1012580"><i id="jdbc10841">Class.forName("org.apache.derby.jdbc.EmbeddedDriver")</i>

  <p>Our recommended manner, because it ensures that the class is loaded in
 all JVMs by creating an instance at the same time.</p></li>

Modified: db/derby/docs/trunk/src/ref/rrefjdbc40794.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbc40794.dita?rev=425417&r1=425416&r2=425417&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbc40794.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefjdbc40794.dita Tue Jul 25 08:20:08 2006
@@ -23,10 +23,17 @@
 </metadata></prolog>
 <refbody>
 <section><p><ph conref="refconrefs.dita#prod/productshortname"></ph>
does
-not implement the following JDBC 1.2 methods of <i>java.sql.Statement</i>:
-  <ul>
-<li><i>cancel</i></li>
-<li><i>setEscapeProcessing</i></li>
-</ul></p> </section>
+not implement the JDBC 1.2 <i>setEscapeProcessing</i> method of <i>java.sql.Statement</i>.
+In addition, the following optional methods raise "Feature not
+supported" exceptions:
+</p>
+<ul>
+<li><i>cancel( )</i></li>
+<li><i>execute( java.lang.String, int[] )</i></li>
+<li><i>execute( java.lang.String, String[] )</i></li>
+<li><i>executeUpdate( java.lang.String, int[] )</i></li>
+<li><i>executeUpdate( java.lang.String, String[] )</i></li>
+</ul>
+</section>
 </refbody>
 </reference>

Added: db/derby/docs/trunk/src/ref/rrefjdbc4_0connection.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbc4_0connection.dita?rev=425417&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbc4_0connection.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefjdbc4_0connection.dita Tue Jul 25 08:20:08 2006
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Copyright 2006 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.
+-->
+
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefjdbc4_0connection" xml:lang="en-us">
+<title>java.sql.Connection</title>
+<prolog><metadata>
+<keywords>
+<indexterm>LOB creation</indexterm>
+<indexterm>Ease of development</indexterm>
+<indexterm>Validity tracking</indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section>
+<p>
+JDBC 4.0 adds new capabilities to Connections:
+</p>
+<ul>
+<li><b>LOB creation</b> - New methods, <i>createBlob()</i>
and
+<i>createClob()</i> let you create empty Blobs and Clobs, which you
+can then fill up before stuffing into a column.</li>
+<li><b>Ease of development</b> - JDBC 4.0 introduces DataSet, a simple
+mechanism to iterate through a table. You obtain
+a DataSet by passing an annotated query to
+your Connection's <i>createQueryObject</i> method.</li>
+<li><b>Validity tracking</b> - The <i>isValid</i> method tells
you
+whether your Connection is still alive.</li>
+</ul>
+</section>
+</refbody>
+</reference>
+

Propchange: db/derby/docs/trunk/src/ref/rrefjdbc4_0connection.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefjdbc4_0dataSource.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbc4_0dataSource.dita?rev=425417&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbc4_0dataSource.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefjdbc4_0dataSource.dita Tue Jul 25 08:20:08 2006
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Copyright 2006 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.
+-->
+
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefjdbc4_0dataSource" xml:lang="en-us">
+<title>javax.sql.DataSource</title>
+<prolog><metadata>
+<keywords>
+<indexterm>Ease of development</indexterm>
+<indexterm>DataSource</indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section>
+<p>
+JDBC 4.0 introduces a simpler mechanism for
+iterating through a table. You use this mechanism by passing an
+annotated query to your DataSource's <i>createQueryObject</i> method.
+To expose this <i>createQueryObject</i> method,
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+adds new JDBC 4.0-specific DataSources. Use these DataSources if your
+application runs on JDK 1.6 or higher.
+</p>
+<ul>
+<li><b>org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource40</b></li>
+<li><b>org.apache.derby.jdbc.EmbeddedDataSource40</b></li>
+<li><b>org.apache.derby.jdbc.EmbeddedDriver</b></li>
+<li><b>org.apache.derby.jdbc.EmbeddedXADataSource40</b></li>
+<li><b>org.apache.derby.jdbc.ClientConnectionPoolDataSource40</b></li>
+<li><b>org.apache.derby.jdbc.ClientDataSource40</b></li>
+<li><b>org.apache.derby.jdbc.ClientDriver</b></li>
+<li><b>org.apache.derby.jdbc.ClientXADataSource40</b></li>
+</ul>
+</section>
+</refbody>
+</reference>
+

Propchange: db/derby/docs/trunk/src/ref/rrefjdbc4_0dataSource.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefjdbc4_0databaseMetaData.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbc4_0databaseMetaData.dita?rev=425417&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbc4_0databaseMetaData.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefjdbc4_0databaseMetaData.dita Tue Jul 25 08:20:08 2006
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Copyright 2006 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.
+-->
+
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefjdbc4_0databaseMetaData" xml:lang="en-us">
+<title>java.sql.DatabaseMetaData</title>
+<prolog><metadata>
+<keywords>
+<indexterm>Capability reports</indexterm>
+<indexterm>Column metadata</indexterm>
+<indexterm>Function metadata</indexterm>
+<indexterm>Procedure metadata</indexterm>
+<indexterm>Schema metadata</indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section>
+<p>
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+implements all of the new metadata methods added by JDBC 4.0.
+</p>
+<ul>
+<li><b>Capability reports</b> - JDBC 4.0 adds new methods for
+querying the capabilities of a database. These include
+<i>autoCommitFailureClosesAllResultSets</i>,
+<i>providesQueryObjectGenerator</i>,
+<i>getClientInfoProperties</i>,
+and <i>supportsStoredFunctionsUsingCallSyntax</i>.
+</li>
+<li><b>Column metadata</b> - The <i>getColumns</i> method
+reports <i>IS_AUTOINCREMENT</i> = YES if a column is generated.</li>
+<li><b>Function metadata</b> - JDBC 4.0 adds new methods for
+inspecting the arguments and return types of functions, including
+user-defined functions.
+These new methods are <i>getFunctions</i> and
+<i>getFunctionColumns</i>. These methods behave similarly to <i>getProcedures</i>
and
+<i>getProcedureColumns</i>.</li>
+<li><b>Procedure metadata</b> - The <i>getProcedureColumns</i>
method
+reports additional information about procedure arguments. For more
+information, see the javadoc for this method. The new columns in the
+ResultSet returned by <i>getProcedureColumns</i> are:
+<i>COLUMN_DEF</i>,
+<i>SQL_DATA_TYPE</i>,
+<i>SQL_DATETIME_SUB</i>,
+<i>CHAR_OCTET_LENGTH</i>,
+<i>ORDINAL_POSITION</i>,
+<i>IS_NULLABLE</i>,
+and <i>SPECIFIC_NAME</i>.</li>
+<li><b>Schema metadata</b> - JDBC 4.0 adds a new <i>getSchemas</i>
+overload, which lets you look up schemas based on a name
+pattern.</li>
+</ul>
+</section>
+</refbody>
+</reference>
+

Propchange: db/derby/docs/trunk/src/ref/rrefjdbc4_0databaseMetaData.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefjdbc4_0sqlexception.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbc4_0sqlexception.dita?rev=425417&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbc4_0sqlexception.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefjdbc4_0sqlexception.dita Tue Jul 25 08:20:08 2006
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Copyright 2006 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.
+-->
+
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefjdbc4_0sqlexception" xml:lang="en-us">
+<title>Refined subclasses of SQLException</title>
+<prolog><metadata>
+<keywords><indexterm>SQLException</indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section>
+<p>
+If your application runs on JDK 1.6 or higher, exceptions raised by
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+will generally be one of the refined subclasses of SQLException,
+introduced by JDBC 4.0. These refined exceptions are raised under the
+conditions described by their respective javadoc.
+</p>
+<ul>
+<li><b>java.sql.SQLClientInfoException</b></li>
+<li><b>java.sql.SQLDataException</b></li>
+<li><b>java.sql.SQLFeatureNotSupportedException</b></li>
+<li><b>java.sql.SQLIntegrityConstraintViolationException</b></li>
+<li><b>java.sql.SQLInvalidAuthorizationSpecException</b></li>
+<li><b>java.sql.SQLSyntaxErrorException</b></li>
+<li><b>java.sql.SQLTransactionRollbackException</b></li>
+<li><b>java.sql.SQLTransientConnectionException</b></li>
+</ul>
+</section>
+</refbody>
+</reference>
+

Propchange: db/derby/docs/trunk/src/ref/rrefjdbc4_0sqlexception.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefjdbc4_0statement.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbc4_0statement.dita?rev=425417&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbc4_0statement.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefjdbc4_0statement.dita Tue Jul 25 08:20:08 2006
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Copyright 2006 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.
+-->
+
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefjdbc4_0statement" xml:lang="en-us">
+<title>java.sql.Statement</title>
+<prolog><metadata>
+<keywords>
+<indexterm>Pooling support</indexterm>
+<indexterm>Validity tracking</indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section>
+<p>
+<ph conref="refconrefs.dita#prod/productshortname"></ph>'s
+Statements implement the following new metadata methods added by JDBC 4.0.
+</p>
+<ul>
+<li><b>Pooling support</b> - JDBC 4.0 adds new methods
+to help application servers manage pooled Statements:
+<i>isPoolable</i>
+and <i>setPoolable</i>.
+</li>
+<li><b>Validity tracking</b> - JDBC 4.0 lets you track the validity of
+a Statement through the new
+<i>isClosed</i> method.
+</li>
+</ul>
+</section>
+</refbody>
+</reference>
+

Propchange: db/derby/docs/trunk/src/ref/rrefjdbc4_0statement.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefjdbc4_0summary.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbc4_0summary.dita?rev=425417&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbc4_0summary.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefjdbc4_0summary.dita Tue Jul 25 08:20:08 2006
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Copyright 2006 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.
+-->
+
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefjdbc4_0summary" xml:lang="en-us">
+<title>JDBC 4.0-only features </title>
+<prolog><metadata>
+<keywords>
+<indexterm>JDBC 4.0</indexterm>
+<indexterm>Ease of development</indexterm>
+<indexterm>Driver autoloading</indexterm>
+<indexterm>SQLException subclasses</indexterm>
+<indexterm>Wrappers</indexterm>
+<indexterm>Statement events</indexterm>
+<indexterm>Streaming APIs</indexterm>
+<indexterm>Pooling support</indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section>
+<p>
+JDBC 4.0 adds some functionality to the core API. This section
+documents the features supported by <ph conref="refconrefs.dita#prod/productshortname"></ph>.
+</p>
+<p><note>These features are present only in a JDK 1.6 or higher
+environment.
+</note></p>
+</section>
+<section><p>These features are:</p>
+<ul>
+<li><b>DataSources.</b> To support the JDBC 4.0 ease of development,
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+introduces new implementations of
+<i><xref href="rrefjdbc4_0dataSource.dita#rrefjdbc4_0dataSource"></xref></i>.
+</li>
+<li><b>Autoloading of JDBC drivers.</b> In earlier versions of JDBC,
+applications had to manually register drivers before requesting
+Connections. With JDBC 4.0, applications no longer need to issue a
+Class.forName() on the driver name; instead, the DriverManager will
+find an appropriate JDBC driver when the application requests a Connection.
+</li>
+<li><b>SQLExceptions.</b> JDBC 4.0 introduces refined subclasses of SQLException.
See <i><xref href="rrefjdbc4_0sqlexception.dita#rrefjdbc4_0sqlexception"></xref>.</i></li>
+<li><b>Wrappers.</b> JDBC 4.0 introduces the concept of wrapped JDBC
+objects. This is a formal mechanism by which application servers can
+look for vendor-specific extensions inside standard JDBC objects like
+Connections, Statements, and ResultSets. For
+<ph conref="refconrefs.dita#prod/productshortname"></ph>,
+this is a vacuous exercise because
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+does not expose any of these extensions.</li>
+<li><b>Statement events.</b> With JDBC 4.0, Connection pools can listen
for Statement closing and Statement error events. New methods were added to <i>javax.sql.PooledConnection</i>:
<i>addStatementEventListener</i> and <i>removeStatementEventListener</i>.</li>
+<li><b>Streaming APIs.</b> JDBC 4.0 adds new overloads of the streaming
methods in CallableStatement, PreparedStatement, and ResultSet. These are the <i>setXXX</i>
and <i>updateXXX</i> methods which take <i>java.io.InputStream</i>
and <i>java.io.Reader</i> arguments. The new overloads allow you to omit the length
arguments or to specify <i>long</i> lengths.</li>
+<li><b>New methods.</b> New methods were added to the following interfaces:
<i><xref href="rrefjdbc4_0connection.dita#rrefjdbc4_0connection"></xref>,</i>
<i><xref href="rrefjdbc4_0databaseMetaData.dita#rrefjdbc4_0databaseMetaData"></xref>,</i>
<i><xref href="rrefjdbc4_0statement.dita#rrefjdbc4_0statement"></xref></i>.</li>
+</ul></section>
+</refbody>
+</reference>
+

Propchange: db/derby/docs/trunk/src/ref/rrefjdbc4_0summary.dita
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message