Author: djd
Date: Wed Dec 8 17:00:49 2004
New Revision: 111329
URL: http://svn.apache.org/viewcvs?view=rev&rev=111329
Log:
Add some comments to JDBC implementation classes for the
embedded driver, as to which JDBC levels they support.
Modified:
incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedBlob.java
incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedCallableStatement30.java
incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedClob.java
incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedConnection30.java
incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedParameterMetaData30.java
incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedPreparedStatement30.java
incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedSavepoint30.java
incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedStatement.java
Modified: incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedBlob.java
Url: http://svn.apache.org/viewcvs/incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedBlob.java?view=diff&rev=111329&p1=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedBlob.java&r1=111328&p2=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedBlob.java&r2=111329
==============================================================================
--- incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedBlob.java (original)
+++ incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedBlob.java Wed Dec
8 17:00:49 2004
@@ -39,7 +39,7 @@
import java.io.EOFException;
import java.io.IOException;
-/*
+/**
Implements java.sql.Blob (see the JDBC 2.0 spec).
A blob sits on top of a BINARY, VARBINARY or LONG VARBINARY column.
If its data is small (less than 1 page) it is a byte array taken from
@@ -58,9 +58,17 @@
multiple threads and sucks data from the stream (returned from
getBinaryStream()) at the same time as calling the Blob methods.
+ <P><B>Supports</B>
+ <UL>
+ <LI> JSR169 - no subsetting for java.sql.Blob
+ <LI> JDBC 2.0
+ <LI> JDBC 3.0 - no new dependencies on new JDBC 3.0 or JDK 1.4 classes,
+ new update methods can safely be added into implementation.
+ </UL>
+
*/
-class EmbedBlob extends ConnectionChild implements Blob
+final class EmbedBlob extends ConnectionChild implements Blob
{
// clob is either bytes or stream
private boolean isBytes;
Modified: incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedCallableStatement30.java
Url: http://svn.apache.org/viewcvs/incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedCallableStatement30.java?view=diff&rev=111329&p1=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedCallableStatement30.java&r1=111328&p2=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedCallableStatement30.java&r2=111329
==============================================================================
--- incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedCallableStatement30.java
(original)
+++ incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedCallableStatement30.java
Wed Dec 8 17:00:49 2004
@@ -31,9 +31,15 @@
/**
- * This class extends the EmbedCallableStatement class from Local20
+ * This class extends the EmbedCallableStatement20
* in order to support new methods and classes that come with JDBC 3.0.
- *
+
+ <P><B>Supports</B>
+ <UL>
+ <LI> JDBC 3.0 - dependency on java.sql.ParameterMetaData introduced in JDBC 3.0
+ </UL>
+
+ *
* @see org.apache.derby.impl.jdbc.EmbedCallableStatement
*
*/
Modified: incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedClob.java
Url: http://svn.apache.org/viewcvs/incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedClob.java?view=diff&rev=111329&p1=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedClob.java&r1=111328&p2=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedClob.java&r2=111329
==============================================================================
--- incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedClob.java (original)
+++ incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedClob.java Wed Dec
8 17:00:49 2004
@@ -41,7 +41,7 @@
import java.sql.SQLException;
import java.sql.Clob;
-/*
+/**
Implements java.sql.Clob (see the JDBC 2.0 spec).
A clob sits on top of a CHAR, VARCHAR or LONG VARCHAR column.
If its data is small (less than 1 page) it is a byte array taken from
@@ -60,6 +60,13 @@
multiple threads and sucks data from the stream (returned from
getAsciiStream()) at the same time as calling the Clob methods.
+ <P><B>Supports</B>
+ <UL>
+ <LI> JSR169 - no subsetting for java.sql.Clob
+ <LI> JDBC 2.0
+ <LI> JDBC 3.0 - no new dependencies on new JDBC 3.0 or JDK 1.4 classes,
+ new update methods can safely be added into implementation.
+ </UL>
*/
final class EmbedClob extends ConnectionChild implements Clob
{
Modified: incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedConnection30.java
Url: http://svn.apache.org/viewcvs/incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedConnection30.java?view=diff&rev=111329&p1=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedConnection30.java&r1=111328&p2=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedConnection30.java&r2=111329
==============================================================================
--- incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedConnection30.java
(original)
+++ incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedConnection30.java
Wed Dec 8 17:00:49 2004
@@ -42,6 +42,16 @@
/**
* This class extends the EmbedConnection20 class in order to support new
* methods and classes that come with JDBC 3.0.
+
+ <P><B>Supports</B>
+ <UL>
+ <LI> JSR169 - Subsetting only removes getTypeMap and setTypeMap, which references
+ java.util.Map which exists in Foundation and ee.miniumum. Thus the methods can
+ safely be left in the implementation for JSR169.
+
+ <LI> JDBC 3.0 - Separate from JDBC 2.0 implementation as JDBC 3.0 introduces
+ a new class java.sql.Savepoint, which is referenced by java.sql.Connection.
+ </UL>
*
* @see org.apache.derby.impl.jdbc.EmbedConnection20
*
Modified: incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedParameterMetaData30.java
Url: http://svn.apache.org/viewcvs/incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedParameterMetaData30.java?view=diff&rev=111329&p1=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedParameterMetaData30.java&r1=111328&p2=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedParameterMetaData30.java&r2=111329
==============================================================================
--- incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedParameterMetaData30.java
(original)
+++ incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedParameterMetaData30.java
Wed Dec 8 17:00:49 2004
@@ -31,6 +31,11 @@
* But note that the bulk of it resides in its parent class. The reason is
* we want to provide the functionality to the JDKs before JDBC3.0.
*
+ <P><B>Supports</B>
+ <UL>
+ <LI> JDBC 3.0 - java.sql.ParameterMetaData introduced in JDBC3
+ </UL>
+
* @see java.sql.ParameterMetaData
*
*/
Modified: incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedPreparedStatement30.java
Url: http://svn.apache.org/viewcvs/incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedPreparedStatement30.java?view=diff&rev=111329&p1=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedPreparedStatement30.java&r1=111328&p2=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedPreparedStatement30.java&r2=111329
==============================================================================
--- incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedPreparedStatement30.java
(original)
+++ incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedPreparedStatement30.java
Wed Dec 8 17:00:49 2004
@@ -30,10 +30,15 @@
import java.net.URL;
/**
- * This class extends the EmbedPreparedStatement class from Local20
+ * This class extends the EmbedPreparedStatement20 class
* in order to support new methods and classes that come with JDBC 3.0.
- *
- * @see org.apache.derby.impl.jdbc.EmbedPreparedStatement
+
+ <P><B>Supports</B>
+ <UL>
+ <LI> JDBC 3.0 - dependency on java.sql.ParameterMetaData introduced in JDBC 3.0
+ </UL>
+
+ * @see org.apache.derby.impl.jdbc.EmbedPreparedStatement
*
*/
public class EmbedPreparedStatement30 extends EmbedPreparedStatement20
Modified: incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedSavepoint30.java
Url: http://svn.apache.org/viewcvs/incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedSavepoint30.java?view=diff&rev=111329&p1=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedSavepoint30.java&r1=111328&p2=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedSavepoint30.java&r2=111329
==============================================================================
--- incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedSavepoint30.java
(original)
+++ incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedSavepoint30.java
Wed Dec 8 17:00:49 2004
@@ -38,6 +38,11 @@
* control of transactions by marking intermediate points within
* a transaction. Once a savepoint has been set, the transaction
* can be rolled back to that savepoint without affecting preceding work.
+ <P><B>Supports</B>
+ <UL>
+ <LI> JSR169 - no subsetting for java.sql.Savepoint
+ <LI> JDBC 3.0 - class introduced in JDBC 3.0
+ </UL>
*
* @see java.sql.Savepoint
*
Modified: incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedStatement.java
Url: http://svn.apache.org/viewcvs/incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedStatement.java?view=diff&rev=111329&p1=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedStatement.java&r1=111328&p2=incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedStatement.java&r2=111329
==============================================================================
--- incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedStatement.java
(original)
+++ incubator/derby/code/trunk/java/engine/org/apache/derby/impl/jdbc/EmbedStatement.java
Wed Dec 8 17:00:49 2004
@@ -47,6 +47,14 @@
*
* EmbedStatement is a local JDBC statement.
*
+ <P><B>Supports</B>
+ <UL>
+ <LI> JSR169 - no subsetting for java.sql.Statement
+ <LI> JDBC 2.0
+ <LI> JDBC 3.0 - no new dependencies on new JDBC 3.0 or JDK 1.4 classes,
+ new methods can safely be added into implementation.
+ </UL>
+
* @author ames
*/
public class EmbedStatement extends ConnectionChild
|