Commit f2390fad by Bryce McKinlay Committed by Bryce McKinlay

Reformat JDBC classes and add new JDK 1.4 classes and methods.

	* java/sql/ParameterMetaData.java, java/sql/SQLPermission.java,
	java/sql/Savepoint.java: New files.
	* java/sql/Array.java, java/sql/BatchUpdateException.java,
	java/sql/Blob.java, java/sql/CallableStatement.java,
	java/sql/Clob.java, java/sql/Connection.java,
	java/sql/DataTruncation.java, java/sql/DatabaseMetaData.java,
	java/sql/Date.java, java/sql/Driver.java,
	java/sql/DriverManager.java,
	java/sql/DriverPropertyInfo.java, java/sql/PreparedStatement.java,
	java/sql/Ref.java, java/sql/ResultSet.java,
	java/sql/ResultSetMetaData.java, java/sql/SQLData.java
	java/sql/SQLException.java, java/sql/SQLInput.java,
	java/sql/SQLOutput.java, java/sql/SQLWarning.java
	java/sql/Statement.java, java/sql/Struct.java, java/sql/Time.java,
	java/sql/Timestamp.java, java/sql/Types.java: Updated to JDBC 3.0
	(JDK 1.4) specification.
	* javax/sql/ConnectionEvent.java,
	javax/sql/ConnectionEventListener.java,
	javax/sql/ConnectionPoolDataSource.java,
	javax/sql/DataSource.java, javax/sql/PooledConnection.java,
	javax/sql/RowSetEvent.java, javax/sql/RowSetInternal.java,
	javax/sql/RowSet.java, javax/sql/RowSetListener.java,
	javax/sql/RowSetMetaData.java, javax/sql/RowSetReader.java,
	javax/sql/RowSetWriter.java, javax/sql/XAConnection.java,
	javax/sql/XADataSource.java: New files.
	* Makefile.am: Add new files.
	* Makefile.in: Rebuilt.

From-SVN: r54871
parent 00b94a44
2002-06-21 Bryce McKinlay <bryce@waitaki.otago.ac.nz>
Reformat JDBC classes and add new JDK 1.4 classes and methods.
* java/sql/ParameterMetaData.java, java/sql/SQLPermission.java,
java/sql/Savepoint.java: New files.
* java/sql/Array.java, java/sql/BatchUpdateException.java,
java/sql/Blob.java, java/sql/CallableStatement.java,
java/sql/Clob.java, java/sql/Connection.java,
java/sql/DataTruncation.java, java/sql/DatabaseMetaData.java,
java/sql/Date.java, java/sql/Driver.java, java/sql/DriverManager.java,
java/sql/DriverPropertyInfo.java, java/sql/PreparedStatement.java,
java/sql/Ref.java, java/sql/ResultSet.java,
java/sql/ResultSetMetaData.java, java/sql/SQLData.java
java/sql/SQLException.java, java/sql/SQLInput.java,
java/sql/SQLOutput.java, java/sql/SQLWarning.java
java/sql/Statement.java, java/sql/Struct.java, java/sql/Time.java,
java/sql/Timestamp.java, java/sql/Types.java: Updated to JDBC 3.0
(JDK 1.4) specification.
* javax/sql/ConnectionEvent.java,
javax/sql/ConnectionEventListener.java,
javax/sql/ConnectionPoolDataSource.java,
javax/sql/DataSource.java, javax/sql/PooledConnection.java,
javax/sql/RowSetEvent.java, javax/sql/RowSetInternal.java,
javax/sql/RowSet.java, javax/sql/RowSetListener.java,
javax/sql/RowSetMetaData.java, javax/sql/RowSetReader.java,
javax/sql/RowSetWriter.java, javax/sql/XAConnection.java,
javax/sql/XADataSource.java: New files.
* Makefile.am: Add new files.
* Makefile.in: Rebuilt.
2002-06-20 Tom Tromey <tromey@redhat.com> 2002-06-20 Tom Tromey <tromey@redhat.com>
For PR libgcj/7073: For PR libgcj/7073:
......
...@@ -997,6 +997,20 @@ javax/naming/ldap/UnsolicitedNotification.java \ ...@@ -997,6 +997,20 @@ javax/naming/ldap/UnsolicitedNotification.java \
javax/naming/ldap/UnsolicitedNotificationEvent.java \ javax/naming/ldap/UnsolicitedNotificationEvent.java \
javax/naming/ldap/UnsolicitedNotificationListener.java \ javax/naming/ldap/UnsolicitedNotificationListener.java \
javax/naming/OperationNotSupportedException.java \ javax/naming/OperationNotSupportedException.java \
javax/sql/ConnectionEvent.java \
javax/sql/ConnectionEventListener.java \
javax/sql/ConnectionPoolDataSource.java \
javax/sql/DataSource.java \
javax/sql/PooledConnection.java \
javax/sql/RowSetEvent.java \
javax/sql/RowSetInternal.java \
javax/sql/RowSet.java \
javax/sql/RowSetListener.java \
javax/sql/RowSetMetaData.java \
javax/sql/RowSetReader.java \
javax/sql/RowSetWriter.java \
javax/sql/XAConnection.java \
javax/sql/XADataSource.java \
javax/transaction/xa/XAException.java \ javax/transaction/xa/XAException.java \
javax/transaction/xa/XAResource.java \ javax/transaction/xa/XAResource.java \
javax/transaction/xa/Xid.java \ javax/transaction/xa/Xid.java \
...@@ -1604,14 +1618,17 @@ java/sql/Date.java \ ...@@ -1604,14 +1618,17 @@ java/sql/Date.java \
java/sql/Driver.java \ java/sql/Driver.java \
java/sql/DriverManager.java \ java/sql/DriverManager.java \
java/sql/DriverPropertyInfo.java \ java/sql/DriverPropertyInfo.java \
java/sql/ParameterMetaData.java \
java/sql/PreparedStatement.java \ java/sql/PreparedStatement.java \
java/sql/Ref.java \ java/sql/Ref.java \
java/sql/ResultSet.java \ java/sql/ResultSet.java \
java/sql/ResultSetMetaData.java \ java/sql/ResultSetMetaData.java \
java/sql/Savepoint.java \
java/sql/SQLData.java \ java/sql/SQLData.java \
java/sql/SQLException.java \ java/sql/SQLException.java \
java/sql/SQLInput.java \ java/sql/SQLInput.java \
java/sql/SQLOutput.java \ java/sql/SQLOutput.java \
java/sql/SQLPermission.java \
java/sql/SQLWarning.java \ java/sql/SQLWarning.java \
java/sql/Statement.java \ java/sql/Statement.java \
java/sql/Struct.java \ java/sql/Struct.java \
......
...@@ -768,6 +768,20 @@ javax/naming/ldap/UnsolicitedNotification.java \ ...@@ -768,6 +768,20 @@ javax/naming/ldap/UnsolicitedNotification.java \
javax/naming/ldap/UnsolicitedNotificationEvent.java \ javax/naming/ldap/UnsolicitedNotificationEvent.java \
javax/naming/ldap/UnsolicitedNotificationListener.java \ javax/naming/ldap/UnsolicitedNotificationListener.java \
javax/naming/OperationNotSupportedException.java \ javax/naming/OperationNotSupportedException.java \
javax/sql/ConnectionEvent.java \
javax/sql/ConnectionEventListener.java \
javax/sql/ConnectionPoolDataSource.java \
javax/sql/DataSource.java \
javax/sql/PooledConnection.java \
javax/sql/RowSetEvent.java \
javax/sql/RowSetInternal.java \
javax/sql/RowSet.java \
javax/sql/RowSetListener.java \
javax/sql/RowSetMetaData.java \
javax/sql/RowSetReader.java \
javax/sql/RowSetWriter.java \
javax/sql/XAConnection.java \
javax/sql/XADataSource.java \
javax/transaction/xa/XAException.java \ javax/transaction/xa/XAException.java \
javax/transaction/xa/XAResource.java \ javax/transaction/xa/XAResource.java \
javax/transaction/xa/Xid.java \ javax/transaction/xa/Xid.java \
...@@ -1366,14 +1380,17 @@ java/sql/Date.java \ ...@@ -1366,14 +1380,17 @@ java/sql/Date.java \
java/sql/Driver.java \ java/sql/Driver.java \
java/sql/DriverManager.java \ java/sql/DriverManager.java \
java/sql/DriverPropertyInfo.java \ java/sql/DriverPropertyInfo.java \
java/sql/ParameterMetaData.java \
java/sql/PreparedStatement.java \ java/sql/PreparedStatement.java \
java/sql/Ref.java \ java/sql/Ref.java \
java/sql/ResultSet.java \ java/sql/ResultSet.java \
java/sql/ResultSetMetaData.java \ java/sql/ResultSetMetaData.java \
java/sql/Savepoint.java \
java/sql/SQLData.java \ java/sql/SQLData.java \
java/sql/SQLException.java \ java/sql/SQLException.java \
java/sql/SQLInput.java \ java/sql/SQLInput.java \
java/sql/SQLOutput.java \ java/sql/SQLOutput.java \
java/sql/SQLPermission.java \
java/sql/SQLWarning.java \ java/sql/SQLWarning.java \
java/sql/Statement.java \ java/sql/Statement.java \
java/sql/Struct.java \ java/sql/Struct.java \
...@@ -2506,13 +2523,15 @@ DEP_FILES = .deps/$(srcdir)/$(CONVERT_DIR)/gen-from-JIS.P \ ...@@ -2506,13 +2523,15 @@ DEP_FILES = .deps/$(srcdir)/$(CONVERT_DIR)/gen-from-JIS.P \
.deps/java/sql/Connection.P .deps/java/sql/DataTruncation.P \ .deps/java/sql/Connection.P .deps/java/sql/DataTruncation.P \
.deps/java/sql/DatabaseMetaData.P .deps/java/sql/Date.P \ .deps/java/sql/DatabaseMetaData.P .deps/java/sql/Date.P \
.deps/java/sql/Driver.P .deps/java/sql/DriverManager.P \ .deps/java/sql/Driver.P .deps/java/sql/DriverManager.P \
.deps/java/sql/DriverPropertyInfo.P .deps/java/sql/PreparedStatement.P \ .deps/java/sql/DriverPropertyInfo.P .deps/java/sql/ParameterMetaData.P \
.deps/java/sql/Ref.P .deps/java/sql/ResultSet.P \ .deps/java/sql/PreparedStatement.P .deps/java/sql/Ref.P \
.deps/java/sql/ResultSetMetaData.P .deps/java/sql/SQLData.P \ .deps/java/sql/ResultSet.P .deps/java/sql/ResultSetMetaData.P \
.deps/java/sql/SQLException.P .deps/java/sql/SQLInput.P \ .deps/java/sql/SQLData.P .deps/java/sql/SQLException.P \
.deps/java/sql/SQLOutput.P .deps/java/sql/SQLWarning.P \ .deps/java/sql/SQLInput.P .deps/java/sql/SQLOutput.P \
.deps/java/sql/Statement.P .deps/java/sql/Struct.P \ .deps/java/sql/SQLPermission.P .deps/java/sql/SQLWarning.P \
.deps/java/sql/Time.P .deps/java/sql/Timestamp.P .deps/java/sql/Types.P \ .deps/java/sql/Savepoint.P .deps/java/sql/Statement.P \
.deps/java/sql/Struct.P .deps/java/sql/Time.P \
.deps/java/sql/Timestamp.P .deps/java/sql/Types.P \
.deps/java/text/Annotation.P \ .deps/java/text/Annotation.P \
.deps/java/text/AttributedCharacterIterator.P \ .deps/java/text/AttributedCharacterIterator.P \
.deps/java/text/AttributedString.P \ .deps/java/text/AttributedString.P \
...@@ -2659,6 +2678,14 @@ DEP_FILES = .deps/$(srcdir)/$(CONVERT_DIR)/gen-from-JIS.P \ ...@@ -2659,6 +2678,14 @@ DEP_FILES = .deps/$(srcdir)/$(CONVERT_DIR)/gen-from-JIS.P \
.deps/javax/naming/spi/ObjectFactoryBuilder.P \ .deps/javax/naming/spi/ObjectFactoryBuilder.P \
.deps/javax/naming/spi/ResolveResult.P \ .deps/javax/naming/spi/ResolveResult.P \
.deps/javax/naming/spi/Resolver.P .deps/javax/naming/spi/StateFactory.P \ .deps/javax/naming/spi/Resolver.P .deps/javax/naming/spi/StateFactory.P \
.deps/javax/sql/ConnectionEvent.P \
.deps/javax/sql/ConnectionEventListener.P \
.deps/javax/sql/ConnectionPoolDataSource.P .deps/javax/sql/DataSource.P \
.deps/javax/sql/PooledConnection.P .deps/javax/sql/RowSet.P \
.deps/javax/sql/RowSetEvent.P .deps/javax/sql/RowSetInternal.P \
.deps/javax/sql/RowSetListener.P .deps/javax/sql/RowSetMetaData.P \
.deps/javax/sql/RowSetReader.P .deps/javax/sql/RowSetWriter.P \
.deps/javax/sql/XAConnection.P .deps/javax/sql/XADataSource.P \
.deps/javax/transaction/HeuristicCommitException.P \ .deps/javax/transaction/HeuristicCommitException.P \
.deps/javax/transaction/HeuristicMixedException.P \ .deps/javax/transaction/HeuristicMixedException.P \
.deps/javax/transaction/HeuristicRollbackException.P \ .deps/javax/transaction/HeuristicRollbackException.P \
......
/* Array.java -- Interface for accessing SQL array object /* Array.java -- Interface for accessing SQL array object
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -35,80 +35,60 @@ this exception to your version of the library, but you are not ...@@ -35,80 +35,60 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
import java.util.Map; import java.util.Map;
/** /**
* This interface provides methods for accessing SQL array types * This interface provides methods for accessing SQL array types.
* *
* @author Aaron M. Renn (arenn@urbanophile.com) * @author Aaron M. Renn (arenn@urbanophile.com)
*/ */
public interface Array public interface Array
{ {
/**
/** * Returns the name of the SQL type of the elements in this
* This method returns the name of the SQL type of the elements in this
* array. This name is database specific. * array. This name is database specific.
* *
* @param The name of the SQL type of the elements in this array. * @param The name of the SQL type of the elements in this array.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getBaseTypeName() throws SQLException;
getBaseTypeName() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the JDBC type identifier of the elements in this * Returns the JDBC type identifier of the elements in this
* array. This will be one of the values defined in the <code>Types</code> * array. This will be one of the values defined in the
* class. * <code>Types</code> class.
* *
* @return The JDBC type of the elements in this array. * @return The JDBC type of the elements in this array.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see Types * @see Types
*/ */
public abstract int public int getBaseType() throws SQLException;
getBaseType() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the contents of this array. This object returned * Returns the contents of this array. This object returned
* will be an array of Java objects of the appropriate types. * will be an array of Java objects of the appropriate types.
* *
* @return The contents of the array as an array of Java objects. * @return The contents of the array as an array of Java objects.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Object public Object getArray() throws SQLException;
getArray() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the contents of this array. The specified * Returns the contents of this array. The specified
* <code>Map</code> will be used to override selected mappings between * <code>Map</code> will be used to override selected mappings
* SQL types and Java classes. * between SQL types and Java classes.
* *
* @param map A mapping of SQL types to Java classes. * @param map A mapping of SQL types to Java classes.
*
* @return The contents of the array as an array of Java objects. * @return The contents of the array as an array of Java objects.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Object public Object getArray(Map map) throws SQLException;
getArray(Map map) throws SQLException;
/*************************************************************************/ /**
* Returns a portion of this array starting at <code>index</code>
/** * into the array and continuing for <code>count</code>
* This method returns a portion of this array starting at index
* <code>offset</code> into the array and continuing for <code>length</code>
* elements. Fewer than the requested number of elements will be * elements. Fewer than the requested number of elements will be
* returned if the array does not contain the requested number of elements. * returned if the array does not contain the requested number of elements.
* The object returned will be an array of Java objects of * The object returned will be an array of Java objects of
...@@ -116,19 +96,14 @@ getArray(Map map) throws SQLException; ...@@ -116,19 +96,14 @@ getArray(Map map) throws SQLException;
* *
* @param offset The offset into this array to start returning elements from. * @param offset The offset into this array to start returning elements from.
* @param count The requested number of elements to return. * @param count The requested number of elements to return.
*
* @return The requested portion of the array. * @return The requested portion of the array.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Object public Object getArray(long index, int count) throws SQLException;
getArray(long offset, int count) throws SQLException;
/*************************************************************************/
/** /**
* This method returns a portion of this array starting at index * This method returns a portion of this array starting at <code>index</code>
* <code>offset</code> into the array and continuing for <code>length</code> * into the array and continuing for <code>count</code>
* elements. Fewer than the requested number of elements will be * elements. Fewer than the requested number of elements will be
* returned if the array does not contain the requested number of elements. * returned if the array does not contain the requested number of elements.
* The object returned will be an array of Java objects. The specified * The object returned will be an array of Java objects. The specified
...@@ -138,34 +113,24 @@ getArray(long offset, int count) throws SQLException; ...@@ -138,34 +113,24 @@ getArray(long offset, int count) throws SQLException;
* @param offset The offset into this array to start returning elements from. * @param offset The offset into this array to start returning elements from.
* @param count The requested number of elements to return. * @param count The requested number of elements to return.
* @param map A mapping of SQL types to Java classes. * @param map A mapping of SQL types to Java classes.
*
* @return The requested portion of the array. * @return The requested portion of the array.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Object public Object getArray(long index, int count, Map map) throws SQLException;
getArray(long index, int count, Map map) throws SQLException;
/*************************************************************************/ /**
* Returns the elements in the array as a <code>ResultSet</code>.
/**
* This method returns the elements in the array as a <code>ResultSet</code>.
* Each row of the result set will have two columns. The first will be * Each row of the result set will have two columns. The first will be
* the index into the array of that row's contents. The second will be * the index into the array of that row's contents. The second will be
* the actual value of that array element. * the actual value of that array element.
* *
* @return The elements of this array as a <code>ResultSet</code>. * @return The elements of this array as a <code>ResultSet</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract ResultSet public ResultSet getResultSet() throws SQLException;
getResultSet() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the elements in the array as a <code>ResultSet</code>. * This method returns the elements in the array as a <code>ResultSet</code>.
* Each row of the result set will have two columns. The first will be * Each row of the result set will have two columns. The first will be
* the index into the array of that row's contents. The second will be * the index into the array of that row's contents. The second will be
...@@ -174,22 +139,16 @@ getResultSet() throws SQLException; ...@@ -174,22 +139,16 @@ getResultSet() throws SQLException;
* Java classes. * Java classes.
* *
* @param map A mapping of SQL types to Java classes. * @param map A mapping of SQL types to Java classes.
*
* @return The elements of this array as a <code>ResultSet</code>. * @return The elements of this array as a <code>ResultSet</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract ResultSet public ResultSet getResultSet(Map map) throws SQLException;
getResultSet(Map map) throws SQLException;
/*************************************************************************/
/** /**
* This method returns a portion of the array as a <code>ResultSet</code>. * This method returns a portion of the array as a <code>ResultSet</code>.
* The returned portion will start at index <code>offset</code> into the * The returned portion will start at <code>index</code> into the
* array and up to <code>length</code> elements will be returned. * array and up to <code>count</code> elements will be returned.
* <p> * <p>
* Each row of the result set will have two columns. The first will be * Each row of the result set will have two columns. The first will be
* the index into the array of that row's contents. The second will be * the index into the array of that row's contents. The second will be
...@@ -197,22 +156,16 @@ getResultSet(Map map) throws SQLException; ...@@ -197,22 +156,16 @@ getResultSet(Map map) throws SQLException;
* *
* @param offset The index into the array to start returning elements from. * @param offset The index into the array to start returning elements from.
* @param length The requested number of elements to return. * @param length The requested number of elements to return.
*
* @return The requested elements of this array as a <code>ResultSet</code>. * @return The requested elements of this array as a <code>ResultSet</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract ResultSet public ResultSet getResultSet(long index, int count) throws SQLException;
getResultSet(long index, int count) throws SQLException;
/*************************************************************************/
/** /**
* This method returns a portion of the array as a <code>ResultSet</code>. * This method returns a portion of the array as a <code>ResultSet</code>.
* The returned portion will start at index <code>offset</code> into the * The returned portion will start at <code>index</code> into the
* array and up to <code>length</code> elements will be returned. * array and up to <cod>count</code> elements will be returned.
* <p> * <p>
* Each row of the result set will have two columns. The first will be * Each row of the result set will have two columns. The first will be
* the index into the array of that row's contents. The second will be * the index into the array of that row's contents. The second will be
...@@ -223,15 +176,10 @@ getResultSet(long index, int count) throws SQLException; ...@@ -223,15 +176,10 @@ getResultSet(long index, int count) throws SQLException;
* @param offset The index into the array to start returning elements from. * @param offset The index into the array to start returning elements from.
* @param length The requested number of elements to return. * @param length The requested number of elements to return.
* @param map A mapping of SQL types to Java classes. * @param map A mapping of SQL types to Java classes.
*
* @return The requested elements of this array as a <code>ResultSet</code>. * @return The requested elements of this array as a <code>ResultSet</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract ResultSet public ResultSet getResultSet(long index, int count, Map map)
getResultSet(long index, int count, Map map) throws SQLException; throws SQLException;
}
} // interface Array
/* BatchUpdateException.java -- Exception for batch oriented SQL errors /* BatchUpdateException.java -- Exception for batch oriented SQL errors
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -35,7 +35,6 @@ this exception to your version of the library, but you are not ...@@ -35,7 +35,6 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
/** /**
...@@ -47,78 +46,32 @@ package java.sql; ...@@ -47,78 +46,32 @@ package java.sql;
*/ */
public class BatchUpdateException extends SQLException public class BatchUpdateException extends SQLException
{ {
static final long serialVersionUID = 5977529877145521757L;
/*************************************************************************/ /**
/*
* Instance Variables
*/
/**
* This is the array of update counts for the commands which completed * This is the array of update counts for the commands which completed
* successfully prior to the error. * successfully prior to the error.
* @serialized
*/
private int[] updateCounts;
/*************************************************************************/
/*
* Constructors
*/
/**
* This method initializes a new instance of <code>BatchUpdateException</code>
* with no descriptive error message. The SQL state and update count will
* be initialized to <code>null</code> and the vendor specific error code will
* initialized to 0.
*/
public
BatchUpdateException()
{
super();
}
/*************************************************************************/
/**
* This method initializes a new instance of <code>BatchUpdateException</code>
* with the specified update count information and no descriptive error
* message. This SQL state will be initialized to <code>null</code> and
* the vendor specific error code will be initialized to 0.
*
* @param updateCounts The update count array.
*/ */
public private int[] updateCounts;
BatchUpdateException(int[] updateCounts)
{
super();
this.updateCounts = updateCounts; /**
}
/*************************************************************************/
/**
* This method initializes a new instance of <code>BatchUpdateException</code> * This method initializes a new instance of <code>BatchUpdateException</code>
* with the specified descriptive error message and update count information. * with the specified descriptive error message, SQL state, and update count
* The SQL state will be initialized to <code>null</code> and the vendor * information. The vendor specific error code will be initialized to 0.
* specific error code will be initialized to 0.
* *
* @param message The descriptive error message. * @param message The descriptive error message.
* @param SQLState The SQL state information for this error.
* @param vendorCode
* @param updateCounts The update count information for this error. * @param updateCounts The update count information for this error.
*/ */
public public BatchUpdateException(String message, String SQLState, int vendorCode,
BatchUpdateException(String message, int[] updateCounts) int[] updateCounts)
{ {
super(message); super(message, SQLState, vendorCode);
this.updateCounts = updateCounts; this.updateCounts = updateCounts;
} }
/*************************************************************************/
/** /**
* This method initializes a new instance of <code>BatchUpdateException</code> * This method initializes a new instance of <code>BatchUpdateException</code>
* with the specified descriptive error message, SQL state, and update count * with the specified descriptive error message, SQL state, and update count
* information. The vendor specific error code will be initialized to 0. * information. The vendor specific error code will be initialized to 0.
...@@ -127,42 +80,53 @@ BatchUpdateException(String message, int[] updateCounts) ...@@ -127,42 +80,53 @@ BatchUpdateException(String message, int[] updateCounts)
* @param SQLState The SQL state information for this error. * @param SQLState The SQL state information for this error.
* @param updateCounts The update count information for this error. * @param updateCounts The update count information for this error.
*/ */
public public BatchUpdateException(String message, String SQLState,
BatchUpdateException(String message, String SQLState, int[] updateCounts) int[] updateCounts)
{ {
super(message, SQLState); super(message, SQLState);
this.updateCounts = updateCounts; this.updateCounts = updateCounts;
} }
/*************************************************************************/ /**
/**
* This method initializes a new instance of <code>BatchUpdateException</code> * This method initializes a new instance of <code>BatchUpdateException</code>
* with the specified descriptive error message, SQL state, vendor * with the specified descriptive error message and update count information.
* specific error code and update count information. * The SQL state will be initialized to <code>null</code> and the vendor
* specific error code will be initialized to 0.
* *
* @param message The descriptive error message. * @param message The descriptive error message.
* @param SQLState The SQL state information for this error.
* @param vendorCode The vendor specific error code for this error.
* @param updateCounts The update count information for this error. * @param updateCounts The update count information for this error.
*/ */
public public BatchUpdateException(String message, int[] updateCounts)
BatchUpdateException(String message, String SQLState, int vendorCode, {
int[] updateCounts) super(message);
{
super(message, SQLState, vendorCode);
this.updateCounts = updateCounts; this.updateCounts = updateCounts;
} }
/*************************************************************************/ /**
* Initializes a new instance of <code>BatchUpdateException</code>
* with the specified update count information and no descriptive error
* message. This SQL state will be initialized to <code>null</code> and
* the vendor specific error code will be initialized to 0.
*
* @param updateCounts The update count array.
*/
public BatchUpdateException(int[] updateCounts)
{
this.updateCounts = updateCounts;
}
/* /**
* Instance Methods * Initializes a new instance of <code>BatchUpdateException</code>
* with no descriptive error message. The SQL state and update count will
* be initialized to <code>null</code> and the vendor specific error code will
* initialized to 0.
*/ */
public BatchUpdateException()
{
super();
}
/** /**
* This method returns the update count information for this error. If * This method returns the update count information for this error. If
* not <code>null</code> this is an array of <code>int</code>'s that are * not <code>null</code> this is an array of <code>int</code>'s that are
* the update accounts for each command that was successfully executed. * the update accounts for each command that was successfully executed.
...@@ -170,11 +134,8 @@ BatchUpdateException(String message, String SQLState, int vendorCode, ...@@ -170,11 +134,8 @@ BatchUpdateException(String message, String SQLState, int vendorCode,
* *
* @return The update count information, which may be <code>null</code>. * @return The update count information, which may be <code>null</code>.
*/ */
public int[] public int[] getUpdateCounts()
getUpdateCounts() {
{ return updateCounts;
return(updateCounts); }
} }
} // class BatchUpdateException
/* Blob.java -- Access a SQL Binary Large OBject. /* Blob.java -- Access a SQL Binary Large OBject.
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -35,81 +35,61 @@ this exception to your version of the library, but you are not ...@@ -35,81 +35,61 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
import java.io.InputStream; import java.io.InputStream;
import java.io.OutputStream;
/** /**
* This interface specified methods for accessing a SQL BLOB (Binary * This interface specified methods for accessing a SQL BLOB (Binary
* Large OBject) type. * Large OBject) type.
* *
* @author Aaron M. Renn (arenn@urbanophile.com) * @author Aaron M. Renn (arenn@urbanophile.com)
* @since 1.2
*/ */
public interface Blob public interface Blob
{ {
/**
/*************************************************************************/
/**
* This method returns the number of bytes in the BLOB. * This method returns the number of bytes in the BLOB.
* *
* @return The number of bytes in the BLOB. * @return The number of bytes in the BLOB.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract long public long length() throws SQLException;
length() throws SQLException;
/*************************************************************************/
/** /**
* This method returns up to the requested bytes of this BLOB as a * This method returns up to the requested bytes of this BLOB as a
* <code>byte</code> array. * <code>byte</code> array.
* *
* @param offset The index into the BLOB to start returning bytes from. * @param pos The index into the BLOB to start returning bytes from.
* @param length The requested number of bytes to return. * @param length The requested number of bytes to return.
*
* @return The requested bytes from the BLOB. * @return The requested bytes from the BLOB.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract byte[] public byte[] getBytes(long pos, int length) throws SQLException;
getBytes(long offset, int length) throws SQLException;
/*************************************************************************/
/** /**
* This method returns a stream that will read the bytes of the BLOB. * This method returns a stream that will read the bytes of the BLOB.
* *
* @return A stream that will read the bytes of the BLOB. * @return A stream that will read the bytes of the BLOB.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract InputStream public InputStream getBinaryStream() throws SQLException;
getBinaryStream() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the index into the BLOB at which the first instance * This method returns the index into the BLOB at which the first instance
* of the specified bytes occur. The searching starts at the specified * of the specified bytes occur. The searching starts at the specified
* index into the BLOB. * index into the BLOB.
* *
* @param pattern The byte pattern to search for. * @param pattern The byte pattern to search for.
* @param offset The index into the BLOB to starting searching for the pattern. * @param offset The index into the BLOB to starting searching for the pattern.
*
* @return The offset at which the pattern is first found, or -1 if the * @return The offset at which the pattern is first found, or -1 if the
* pattern is not found. * pattern is not found.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract long public long position(byte[] pattern, long start) throws SQLException;
position(byte[] pattern, long offset) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the index into the BLOB at which the first instance * This method returns the index into the BLOB at which the first instance
* of the specified pattern occurs. The searching starts at the specified * of the specified pattern occurs. The searching starts at the specified
* index into this BLOB. The bytes in the specified <code>Blob</code> are * index into this BLOB. The bytes in the specified <code>Blob</code> are
...@@ -118,14 +98,34 @@ position(byte[] pattern, long offset) throws SQLException; ...@@ -118,14 +98,34 @@ position(byte[] pattern, long offset) throws SQLException;
* @param pattern The <code>Blob</code> containing the byte pattern to * @param pattern The <code>Blob</code> containing the byte pattern to
* search for. * search for.
* @param offset The index into the BLOB to starting searching for the pattern. * @param offset The index into the BLOB to starting searching for the pattern.
*
* @return The offset at which the pattern is first found, or -1 if the * @return The offset at which the pattern is first found, or -1 if the
* pattern is not found. * pattern is not found.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract long public long position(Blob pattern, long start) throws SQLException;
position(Blob pattern, long offset) throws SQLException;
} // interface Blob /**
* @exception SQLException If an error occurs.
* @since 1.4
*/
public int setBytes(long pos, byte[] bytes) throws SQLException;
/**
* @exception SQLException If an error occurs.
* @since 1.4
*/
public int setBytes(long pos, byte[] bytes, int offset, int len)
throws SQLException;
/**
* @exception SQLException If an error occurs.
* @since 1.4
*/
public OutputStream setBinaryStream(long pos) throws SQLException;
/**
* @exception SQLException If an error occurs.
* @since 1.4
*/
public void truncate(long len) throws SQLException;
}
/* CallableStatement.java -- A statement for calling stored procedures. /* CallableStatement.java -- A statement for calling stored procedures.
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -35,12 +35,12 @@ this exception to your version of the library, but you are not ...@@ -35,12 +35,12 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
import java.io.InputStream; import java.io.InputStream;
import java.io.Reader; import java.io.Reader;
import java.math.BigDecimal; import java.math.BigDecimal;
import java.net.URL;
import java.util.Calendar; import java.util.Calendar;
import java.util.Map; import java.util.Map;
...@@ -51,415 +51,601 @@ import java.util.Map; ...@@ -51,415 +51,601 @@ import java.util.Map;
*/ */
public interface CallableStatement extends PreparedStatement public interface CallableStatement extends PreparedStatement
{ {
/**
/*************************************************************************/ * This method registers the specified parameter as an output parameter
* of the specified SQL type.
/**
* This method tests whether the value of the last parameter that was fetched
* was actually a SQL NULL value.
*
* @return <code>true</code> if the last parameter fetched was a NULL,
* <code>false</code> otherwise.
* *
* @param index The index of the parameter to register as output.
* @param type The SQL type value from <code>Types</code>.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public void registerOutParameter(int parameterIndex, int sqlType)
wasNull() throws SQLException; throws SQLException;
/*************************************************************************/ /**
* This method registers the specified parameter as an output parameter
/** * of the specified SQL type and scale.
* This method returns the value of the specified parameter as a Java
* <code>String</code>.
*
* @param index The index of the parameter to return.
*
* @return The parameter value as a <code>String</code>.
* *
* @param index The index of the parameter to register as output.
* @param type The SQL type value from <code>Types</code>.
* @param scale The scale of the value that will be returned.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public void registerOutParameter(int parameterIndex, int sqlType, int scale)
getString(int index) throws SQLException; throws SQLException;
/*************************************************************************/ /**
* This method tests whether the value of the last parameter that was fetched
/** * was actually a SQL NULL value.
* This method returns the value of the specified parameter as a Java
* <code>Object</code>.
*
* @param index The index of the parameter to return.
*
* @return The parameter value as an <code>Object</code>.
* *
* @return <code>true</code> if the last parameter fetched was a NULL,
* <code>false</code> otherwise.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Object public boolean wasNull() throws SQLException;
getObject(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>Object</code>. * <code>String</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
* @param map The mapping to use for conversion from SQL to Java types. * @return The parameter value as a <code>String</code>.
*
* @return The parameter value as an <code>Object</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Object public String getString(int parameterIndex) throws SQLException;
getObject(int index, Map map) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>boolean</code>. * <code>boolean</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
*
* @return The parameter value as a <code>boolean</code>. * @return The parameter value as a <code>boolean</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean getBoolean(int parameterIndex) throws SQLException;
getBoolean(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>byte</code>. * <code>byte</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
*
* @return The parameter value as a <code>byte</code>. * @return The parameter value as a <code>byte</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract byte public byte getByte(int parameterIndex) throws SQLException;
getByte(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>short</code>. * <code>short</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
*
* @return The parameter value as a <code>short</code>. * @return The parameter value as a <code>short</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract short public short getShort(int parameterIndex) throws SQLException;
getShort(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>int</code>. * <code>int</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
*
* @return The parameter value as a <code>int</code>. * @return The parameter value as a <code>int</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getInt(int parameterIndex) throws SQLException;
getInt(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>long</code>. * <code>long</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
*
* @return The parameter value as a <code>long</code>. * @return The parameter value as a <code>long</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract long public long getLong(int parameterIndex) throws SQLException;
getLong(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>float</code>. * <code>float</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
*
* @return The parameter value as a <code>float</code>. * @return The parameter value as a <code>float</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract float public float getFloat(int parameterIndex) throws SQLException;
getFloat(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>double</code>. * <code>double</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
*
* @return The parameter value as a <code>double</code>. * @return The parameter value as a <code>double</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract double public double getDouble(int parameterIndex) throws SQLException;
getDouble(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>BigDecimal</code>. * <code>BigDecimal</code>.
* *
* @param index The index of the parameter to return. * @param parameterIndex The index of the parameter to return.
*
* @return The parameter value as a <code>BigDecimal</code>.
*
* @exception SQLException If an error occurs.
*/
public abstract BigDecimal
getBigDecimal(int index) throws SQLException;
/*************************************************************************/
/**
* This method returns the value of the specified parameter as a Java
* <code>BigDecimal</code>.
*
* @param index The index of the parameter to return.
* @param scale The number of digits to the right of the decimal to return. * @param scale The number of digits to the right of the decimal to return.
*
* @return The parameter value as a <code>BigDecimal</code>. * @return The parameter value as a <code>BigDecimal</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @deprecated Use getBigDecimal(int parameterIndex)
* or getBigDecimal(String parameterName) instead.
*/ */
public abstract BigDecimal public BigDecimal getBigDecimal(int parameterIndex, int scale)
getBigDecimal(int index, int scale) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* byte array. * byte array.
* *
* @param index The index of the parameter to return. * @param parameterIndex The index of the parameter to return.
*
* @return The parameter value as a byte array * @return The parameter value as a byte array
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract byte[] public byte[] getBytes(int parameterIndex) throws SQLException;
getBytes(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>java.sql.Date</code>. * <code>java.sql.Date</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
*
* @return The parameter value as a <code>java.sql.Date</code>. * @return The parameter value as a <code>java.sql.Date</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Date public Date getDate(int parameterIndex) throws SQLException;
getDate(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>java.sql.Date</code>. * <code>java.sql.Time</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
* @param calendar The <code>Calendar</code> to use for timezone and locale. * @return The parameter value as a <code>java.sql.Time</code>.
*
* @return The parameter value as a <code>java.sql.Date</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Date public Time getTime(int parameterIndex) throws SQLException;
getDate(int index, Calendar calendar) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>java.sql.Time</code>. * <code>java.sql.Timestamp</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
* * @return The parameter value as a <code>java.sql.Timestamp</code>.
* @return The parameter value as a <code>java.sql.Time</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Time public Timestamp getTimestamp(int parameterIndex) throws SQLException;
getTime(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>java.sql.Time</code>. * <code>Object</code>.
*
* @param index The index of the parameter to return.
* @param calendar The <code>Calendar</code> to use for timezone and locale.
*
* @return The parameter value as a <code>java.sql.Time</code>.
* *
* @param parameterIndex The index of the parameter to return.
* @return The parameter value as an <code>Object</code>.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract java.sql.Time public Object getObject(int parameterIndex) throws SQLException;
getTime(int index, Calendar calendar) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>java.sql.Timestamp</code>. * <code>BigDecimal</code>.
*
* @param index The index of the parameter to return.
*
* @return The parameter value as a <code>java.sql.Timestamp</code>.
* *
* @param parameterIndex The index of the parameter to return.
* @return The parameter value as a <code>BigDecimal</code>.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract java.sql.Timestamp public BigDecimal getBigDecimal(int parameterIndex) throws SQLException;
getTimestamp(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>java.sql.Timestamp</code>. * <code>Object</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
* @param calendar The <code>Calendar</code> to use for timezone and locale. * @param map The mapping to use for conversion from SQL to Java types.
* * @return The parameter value as an <code>Object</code>.
* @return The parameter value as a <code>java.sql.Timestamp</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract java.sql.Timestamp public Object getObject(int index, Map map) throws SQLException;
getTimestamp(int index, Calendar calendar) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>Ref</code>. * <code>Ref</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
*
* @return The parameter value as a <code>Ref</code>. * @return The parameter value as a <code>Ref</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract Ref public Ref getRef(int index) throws SQLException;
getRef(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>Blob</code>. * <code>Blob</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
*
* @return The parameter value as a <code>Blob</code>. * @return The parameter value as a <code>Blob</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract Blob public Blob getBlob(int index) throws SQLException;
getBlob(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>Clob</code>. * <code>Clob</code>.
* *
* @param index The index of the parameter to return. * @param index The index of the parameter to return.
*
* @return The parameter value as a <code>Clob</code>. * @return The parameter value as a <code>Clob</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract Clob public Clob getClob(int index) throws SQLException;
getClob(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified parameter as a Java * This method returns the value of the specified parameter as a Java
* <code>Array</code>. * <code>Array</code>.
* *
* @param index The index of the parameter to return. * @param parameterIndex The index of the parameter to return.
*
* @return The parameter value as a <code>Array</code>. * @return The parameter value as a <code>Array</code>.
* @exception SQLException If an error occurs.
* @since 1.2
*/
public Array getArray(int index) throws SQLException;
/**
* This method returns the value of the specified parameter as a Java
* <code>java.sql.Date</code>.
* *
* @param parameterIndex The index of the parameter to return.
* @param cal The <code>Calendar</code> to use for timezone and locale.
* @return The parameter value as a <code>java.sql.Date</code>.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract Array public Date getDate(int parameterIndex, Calendar cal) throws SQLException;
getArray(int index) throws SQLException;
/*************************************************************************/ /**
* This method returns the value of the specified parameter as a Java
* <code>java.sql.Time</code>.
*
* @param parameterIndex The index of the parameter to return.
* @param cal The <code>Calendar</code> to use for timezone and locale.
* @return The parameter value as a <code>java.sql.Time</code>.
* @exception SQLException If an error occurs.
* @since 1.2
*/
public Time getTime(int parameterIndex, Calendar cal) throws SQLException;
/** /**
* This method returns the value of the specified parameter as a Java
* <code>java.sql.Timestamp</code>.
*
* @param index The index of the parameter to return.
* @return The parameter value as a <code>java.sql.Timestamp</code>.
* @exception SQLException If an error occurs.
* @since 1.2
*/
public Timestamp getTimestamp(int parameterIndex, Calendar cal)
throws SQLException;
/**
* This method registers the specified parameter as an output parameter * This method registers the specified parameter as an output parameter
* of the specified SQL type. * of the specified SQL type.
* *
* @param index The index of the parameter to register as output. * @param index The index of the parameter to register as output.
* @param type The SQL type value from <code>Types</code>. * @param type The SQL type value from <code>Types</code>.
* * @param name The user defined data type name.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract void public void registerOutParameter(int paramIndex, int sqlType,
registerOutParameter(int index, int type) throws SQLException; String typeName)
throws SQLException;
/*************************************************************************/
/** /**
* This method registers the specified parameter as an output parameter * This method registers the specified parameter as an output parameter
* of the specified SQL type. * of the specified SQL type.
* *
* @param index The index of the parameter to register as output. * @param parameterName The name of the parameter to register as output.
* @param type The SQL type value from <code>Types</code>. * @param sqlType The SQL type value from <code>Types</code>.
* @param name The user defined data type name. * @exception SQLException If an error occurs.
* @since 1.4
*/
public void registerOutParameter(String parameterName, int sqlType)
throws SQLException;
/**
* This method registers the specified parameter as an output parameter
* of the specified SQL type. This version of registerOutParameter is used
* for NUMERIC or DECIMAL types.
* *
* @param parameterName The name of the parameter to register as output.
* @param sqlType The SQL type value from <code>Types</code>.
* @param scale Number of digits to the right of the decimal point.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.4
*/ */
public abstract void public void registerOutParameter(String parameterName, int sqlType,
registerOutParameter(int index, int type, String name) throws SQLException; int scale)
throws SQLException;
/*************************************************************************/
/** /**
* This method registers the specified parameter as an output parameter * This method registers the specified parameter as an output parameter
* of the specified SQL type and scale. * of the specified SQL type. This version of registerOutParameter is used
* * for user-named or REF types. If the type of the output parameter does
* @param index The index of the parameter to register as output. * not have such a type, the typeName argument is ignored.
* @param type The SQL type value from <code>Types</code>.
* @param scale The scale of the value that will be returned.
* *
* @param parameterName The name of the parameter to register as output.
* @param sqlType The SQL type value from <code>Types</code>.
* @param typeName The SQL structured type name.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.4
*/
public void registerOutParameter(String parameterName, int sqlType,
String typeName)
throws SQLException;
/**
* @since 1.4
*/
public URL getURL(int parameterIndex) throws SQLException;
/**
* @since 1.4
*/
public void setURL(String parameterName, URL val) throws SQLException;
/**
* @since 1.4
*/
public void setNull(String parameterName, int sqlType) throws SQLException;
/**
* @since 1.4
*/
public void setBoolean(String parameterName, boolean x) throws SQLException;
/**
* @since 1.4
*/
public void setByte(String parameterName, byte x) throws SQLException;
/**
* @since 1.4
*/
public void setShort(String parameterName, short x) throws SQLException;
/**
* @since 1.4
*/
public void setInt(String parameterName, int x) throws SQLException;
/**
* @since 1.4
*/
public void setLong(String parameterName, long x) throws SQLException;
/**
* @since 1.4
*/
public void setFloat(String parameterName, float x) throws SQLException;
/**
* @since 1.4
*/
public void setDouble(String parameterName, double x) throws SQLException;
/**
* @since 1.4
*/ */
public abstract void public void setBigDecimal(String parameterName, BigDecimal x)
registerOutParameter(int index, int type, int scale) throws SQLException; throws SQLException;
} // interface CallableStatement /**
* @since 1.4
*/
public void setString(String parameterName, String x) throws SQLException;
/**
* @since 1.4
*/
public void setBytes(String parameterName, byte[] x) throws SQLException;
/**
* @since 1.4
*/
public void setDate(String parameterName, Date x) throws SQLException;
/**
* @since 1.4
*/
public void setTime(String parameterName, Time x) throws SQLException;
/**
* @since 1.4
*/
public void setTimestamp(String parameterName, Timestamp x)
throws SQLException;
/**
* @since 1.4
*/
public void setAsciiStream(String parameterName, InputStream x, int length)
throws SQLException;
/**
* @since 1.4
*/
public void setBinaryStream(String parameterName, InputStream x, int length)
throws SQLException;
/**
* @since 1.4
*/
public void setObject(String parameterName, Object x, int targetSqlType,
int scale)
throws SQLException;
/**
* @since 1.4
*/
public void setObject(String parameterName, Object x, int targetSqlType)
throws SQLException;
/**
* @since 1.4
*/
public void setObject(String parameterName, Object x) throws SQLException;
/**
* @since 1.4
*/
public void setCharacterStream(String parameterName, Reader reader,
int length)
throws SQLException;
/**
* @since 1.4
*/
public void setDate(String parameterName, Date x, Calendar cal)
throws SQLException;
/**
* @since 1.4
*/
public void setTime(String parameterName, Time x, Calendar cal)
throws SQLException;
/**
* @since 1.4
*/
public void setTimestamp(String parameterName, Timestamp x, Calendar cal)
throws SQLException;
/**
* @since 1.4
*/
public void setNull(String parameterName, int sqlType, String typeName)
throws SQLException;
/**
* @since 1.4
*/
public String getString(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public boolean getBoolean(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public byte getByte(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public short getShort(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public int getInt(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public long getLong(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public float getFloat(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public double getDouble(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public byte[] getBytes(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public Date getDate(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public Time getTime(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public Timestamp getTimestamp(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public Object getObject(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public BigDecimal getBigDecimal(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public Object getObject(String parameterName, Map map) throws SQLException;
/**
* @since 1.4
*/
public Ref getRef(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public Blob getBlob(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public Clob getClob(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public Array getArray(String parameterName) throws SQLException;
/**
* @since 1.4
*/
public Date getDate(String parameterName, Calendar cal) throws SQLException;
/**
* @since 1.4
*/
public Time getTime(String parameterName, Calendar cal) throws SQLException;
/**
* @since 1.4
*/
public Timestamp getTimestamp(String parameterName, Calendar cal)
throws SQLException;
/**
* @since 1.4
*/
public URL getURL(String parameterName) throws SQLException;
}
/* Clob.java -- Access Character Large OBjects /* Clob.java -- Access Character Large OBjects
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -35,11 +35,12 @@ this exception to your version of the library, but you are not ...@@ -35,11 +35,12 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
import java.io.InputStream; import java.io.InputStream;
import java.io.OutputStream;
import java.io.Reader; import java.io.Reader;
import java.io.Writer;
/** /**
* This interface contains methods for accessing a SQL CLOB (Character * This interface contains methods for accessing a SQL CLOB (Character
...@@ -49,99 +50,103 @@ import java.io.Reader; ...@@ -49,99 +50,103 @@ import java.io.Reader;
*/ */
public interface Clob public interface Clob
{ {
/**
/**
* This method returns the number of characters in the CLOB. * This method returns the number of characters in the CLOB.
* *
* @return The number of characters in the CLOB. * @return The number of characters in the CLOB.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract long public long length() throws SQLException;
length() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the specified portion of the CLOB as a * This method returns the specified portion of the CLOB as a
* <code>String</code>. * <code>String</code>.
* *
* @param offset The index into the CLOB (index values start at 1) to * @param offset The index into the CLOB (index values start at 1) to
* start returning characters from. * start returning characters from.
* @param length The requested number of characters to return. * @param length The requested number of characters to return.
*
* @return The requested CLOB section, as a <code>String</code>. * @return The requested CLOB section, as a <code>String</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract String public String getSubString(long pos, int length) throws SQLException;
getSubString(long offset, int length) throws SQLException;
/*************************************************************************/
/** /**
* This method returns a byte stream that reads the contents of the
* CLOB as a series of ASCII bytes.
*
* @return A stream to read the CLOB's contents.
*
* @exception SQLException If an error occurs.
*/
public abstract InputStream
getAsciiStream() throws SQLException;
/*************************************************************************/
/**
* This method returns a character stream that reads the contents of the * This method returns a character stream that reads the contents of the
* CLOB. * CLOB.
* *
* @return A character stream to read the CLOB's contents. * @return A character stream to read the CLOB's contents.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract Reader public Reader getCharacterStream() throws SQLException;
getCharacterStream() throws SQLException;
/*************************************************************************/ /**
* This method returns a byte stream that reads the contents of the
* CLOB as a series of ASCII bytes.
*
* @return A stream to read the CLOB's contents.
* @exception SQLException If an error occurs.
* @since 1.2
*/
public InputStream getAsciiStream() throws SQLException;
/** /**
* This method returns the index into the CLOB of the first occurrence of * This method returns the index into the CLOB of the first occurrence of
* the specified character pattern (supplied by the caller as a * the specified character pattern (supplied by the caller as a
* <code>String</code>). The search begins at the specified index. * <code>String</code>). The search begins at the specified index.
* *
* @param pattern The character pattern to search for, passed as a * @param searchstr The character pattern to search for, passed as a
* <code>String</code>. * <code>String</code>.
* @param offset. The index into the CLOB to start search (indexes start * @param start. The index into the CLOB to start search (indexes start
* at 1). * at 1).
*
* @return The index at which the pattern was found (indexes start at 1), * @return The index at which the pattern was found (indexes start at 1),
* or -1 if the pattern was not found. * or -1 if the pattern was not found.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract long public long position(String searchstr, long start) throws SQLException;
position(String pattern, long offset) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the index into the CLOB of the first occurrence of * This method returns the index into the CLOB of the first occurrence of
* the specified character pattern (supplied by the caller as a * the specified character pattern (supplied by the caller as a
* <code>Clob</code>). The search begins at the specified index. * <code>Clob</code>). The search begins at the specified index.
* *
* @param pattern The character pattern to search for, passed as a * @param searchstr The character pattern to search for, passed as a
* <code>Clob</code>. * <code>Clob</code>.
* @param offset. The index into the CLOB to start search (indexes start * @param start. The index into the CLOB to start search (indexes start
* at 1). * at 1).
*
* @return The index at which the pattern was found (indexes start at 1), * @return The index at which the pattern was found (indexes start at 1),
* or -1 if the pattern was not found. * or -1 if the pattern was not found.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/
public long position(Clob searchstr, long start) throws SQLException;
/**
* @since 1.4
*/
public int setString(long pos, String str) throws SQLException;
/**
* @since 1.4
*/ */
public abstract long public int setString(long pos, String str, int offset, int len)
position(Clob pattern, long offset) throws SQLException; throws SQLException;
} // interface Clob /**
* @since 1.4
*/
public OutputStream setAsciiStream(long pos) throws SQLException;
/**
* @since 1.4
*/
public Writer setCharacterStream(long pos) throws SQLException;
/**
* @since 1.4
*/
public void truncate(long len) throws SQLException;
}
/* Connection.java -- Manage a database connection. /* Connection.java -- Manage a database connection.
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -47,37 +47,36 @@ import java.util.Map; ...@@ -47,37 +47,36 @@ import java.util.Map;
*/ */
public interface Connection public interface Connection
{ {
/**
/**
* This transaction isolation level indicates that transactions are not * This transaction isolation level indicates that transactions are not
* supported. * supported.
*/ */
public static final int TRANSACTION_NONE = 0; public static final int TRANSACTION_NONE = 0;
/** /**
* This transaction isolation level indicates that one transaction can * This transaction isolation level indicates that one transaction can
* read modifications by other transactions before the other transactions * read modifications by other transactions before the other transactions
* have committed their changes. This could result in invalid reads. * have committed their changes. This could result in invalid reads.
*/ */
public static final int TRANSACTION_READ_UNCOMMITTED = 1; public static final int TRANSACTION_READ_UNCOMMITTED = 1;
/** /**
* This transaction isolation leve indicates that only committed data from * This transaction isolation leve indicates that only committed data from
* other transactions will be read. If a transaction reads a row, then * other transactions will be read. If a transaction reads a row, then
* another transaction commits a change to that row, the first transaction * another transaction commits a change to that row, the first transaction
* would retrieve the changed row on subsequent reads of the same row. * would retrieve the changed row on subsequent reads of the same row.
*/ */
public static final int TRANSACTION_READ_COMMITTED = 2; public static final int TRANSACTION_READ_COMMITTED = 2;
/** /**
* This transaction isolation level indicates that only committed data from * This transaction isolation level indicates that only committed data from
* other transactions will be read. It also ensures that data read from * other transactions will be read. It also ensures that data read from
* a row will not be different on a subsequent read even if another * a row will not be different on a subsequent read even if another
* transaction commits a change. * transaction commits a change.
*/ */
public static final int TRANSACTION_REPEATABLE_READ = 4; public static final int TRANSACTION_REPEATABLE_READ = 4;
/** /**
* This transaction isolation level indicates that only committed data from * This transaction isolation level indicates that only committed data from
* other transactions will be read. It also ensures that data read from * other transactions will be read. It also ensures that data read from
* a row will not be different on a subsequent read even if another * a row will not be different on a subsequent read even if another
...@@ -85,93 +84,32 @@ public static final int TRANSACTION_REPEATABLE_READ = 4; ...@@ -85,93 +84,32 @@ public static final int TRANSACTION_REPEATABLE_READ = 4;
* transactions will not affect the result set returned during subsequent * transactions will not affect the result set returned during subsequent
* executions of the same WHERE clause in this transaction. * executions of the same WHERE clause in this transaction.
*/ */
public static final int TRANSACTION_SERIALIZABLE = 8; public static final int TRANSACTION_SERIALIZABLE = 8;
/*************************************************************************/ /**
/**
* This method creates a new SQL statement. The default result set type * This method creates a new SQL statement. The default result set type
* and concurrency will be used. * and concurrency will be used.
* *
* @return A new <code>Statement</code> object. * @return A new <code>Statement</code> object.
*
* @exception SQLException If an error occurs.
*
* @see Statement
*/
public abstract Statement
createStatement() throws SQLException;
/*************************************************************************/
/**
* This method creates a new SQL statement with the specified type and
* concurrency. Valid values for these parameters are specified in the
* <code>ResultSet</code> class.
*
* @param resultSetType The type of result set to use for this statement.
* @param resultSetConcurrency. The type of concurrency to be used in
* the result set for this statement.
*
* @return A new <code>Statement</code> object.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see Statement * @see Statement
* @see ResultSet
*/ */
public abstract Statement public Statement createStatement() throws SQLException;
createStatement(int resultSetType, int resultSetConcurrency)
throws SQLException;
/*************************************************************************/
/** /**
* This method creates a new <code>PreparedStatement</code> for the specified * This method creates a new <code>PreparedStatement</code> for the specified
* SQL string. This method is designed for use with parameterized * SQL string. This method is designed for use with parameterized
* statements. The default result set type and concurrency will be used. * statements. The default result set type and concurrency will be used.
* *
* @param The SQL statement to use in creating this * @param The SQL statement to use in creating this
* <code>PreparedStatement</code>. * <code>PreparedStatement</code>.
*
* @return A new <code>PreparedStatement</code>. * @return A new <code>PreparedStatement</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see PreparedStatement * @see PreparedStatement
*/ */
public abstract PreparedStatement public PreparedStatement prepareStatement(String sql) throws SQLException;
prepareStatement(String sql) throws SQLException;
/*************************************************************************/ /**
/**
* This method creates a new <code>PreparedStatement</code> for the specified
* SQL string. This method is designed for use with parameterized
* statements. The specified result set type and concurrency will be used.
* Valid values for these parameters are specified in the
* <code>ResultSet</code> class.
*
* @param The SQL statement to use in creating this
* <code>PreparedStatement</code>.
* @param resultSetType The type of result set to use for this statement.
* @param resultSetConcurrency. The type of concurrency to be used in
* the result set for this statement.
*
* @return A new <code>PreparedStatement</code>.
*
* @exception SQLException If an error occurs.
*
* @see PreparedStatement
* @see ResultSet
*/
public abstract PreparedStatement
prepareStatement(String sql, int resultSetType, int resultSetConcurrency)
throws SQLException;
/*************************************************************************/
/**
* This method creates a new <code>CallableStatement</code> for the * This method creates a new <code>CallableStatement</code> for the
* specified SQL string. Thie method is designed to be used with * specified SQL string. Thie method is designed to be used with
* stored procedures. The default result set type and concurrency * stored procedures. The default result set type and concurrency
...@@ -179,284 +117,304 @@ prepareStatement(String sql, int resultSetType, int resultSetConcurrency) ...@@ -179,284 +117,304 @@ prepareStatement(String sql, int resultSetType, int resultSetConcurrency)
* *
* @param The SQL statement to use in creating this * @param The SQL statement to use in creating this
* <code>CallableStatement</code>. * <code>CallableStatement</code>.
*
* @return A new <code>CallableStatement</code>.
*
* @exception SQLException If an error occurs.
*
* @see CallableStatement
*/
public abstract CallableStatement
prepareCall(String sql) throws SQLException;
/*************************************************************************/
/**
* This method creates a new <code>CallableStatement</code> for the
* specified SQL string. Thie method is designed to be used with
* stored procedures. The specified result set type and concurrency
* will be used. Valid values for these parameters are specified in the
* <code>ResultSet</code> class.
*
* @param The SQL statement to use in creating this
* <code>PreparedStatement</code>.
* @param resultSetType The type of result set to use for this statement.
* @param resultSetConcurrency. The type of concurrency to be used in
* the result set for this statement.
*
* @return A new <code>CallableStatement</code>. * @return A new <code>CallableStatement</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see CallableStatement * @see CallableStatement
* @see ResultSet
*/ */
public abstract CallableStatement public CallableStatement prepareCall(String sql) throws SQLException;
prepareCall(String sql, int resultSetType, int resultSetConcurrency)
throws SQLException;
/*************************************************************************/ /**
/**
* This method converts the specified generic SQL statement into the * This method converts the specified generic SQL statement into the
* native grammer of the database this object is connected to. * native grammer of the database this object is connected to.
* *
* @param The JDBC generic SQL statement. * @param The JDBC generic SQL statement.
*
* @return The native SQL statement. * @return The native SQL statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String nativeSQL(String sql) throws SQLException;
nativeSQL(String sql) throws SQLException;
/*************************************************************************/ /**
* This method turns auto commit mode on or off. In auto commit mode,
/** * every SQL statement is committed its own transaction. Otherwise a
* This method tests whether or not auto commit mode is currently enabled. * transaction must be explicitly committed or rolled back.
* In auto commit mode, every SQL statement is committed its own transaction.
* Otherwise a transaction must be explicitly committed or rolled back.
*
* @return <code>true</code> if auto commit mode is enabled,
* <code>false</code> otherwise.
* *
* @param autoCommit <code>true</code> to enable auto commit mode,
* <code>false</code> to disable it.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see commit * @see commit
* @see rollback * @see rollback
*/ */
public abstract boolean public void setAutoCommit(boolean autoCommit) throws SQLException;
getAutoCommit() throws SQLException;
/*************************************************************************/ /**
* This method tests whether or not auto commit mode is currently enabled.
/** * In auto commit mode, every SQL statement is committed its own transaction.
* This method turns auto commit mode on or off. In auto commit mode, * Otherwise a transaction must be explicitly committed or rolled back.
* every SQL statement is committed its own transaction. Otherwise a
* transaction must be explicitly committed or rolled back.
* *
* @param autoCommit <code>true</code> to enable auto commit mode, * @return <code>true</code> if auto commit mode is enabled,
* <code>false</code> to disable it. * <code>false</code> otherwise.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* *
* @see commit * @see commit
* @see rollback * @see rollback
*/ */
public abstract void public boolean getAutoCommit() throws SQLException;
setAutoCommit(boolean autoCommit) throws SQLException;
/*************************************************************************/ /**
/**
* This method commits any SQL statements executed on this connection since * This method commits any SQL statements executed on this connection since
* the last commit or rollback. * the last commit or rollback.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void commit() throws SQLException;
commit() throws SQLException;
/*************************************************************************/ /**
/**
* This method rolls back any SQL statements executed on this connection * This method rolls back any SQL statements executed on this connection
* since the last commit or rollback. * since the last commit or rollback.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void rollback() throws SQLException;
rollback() throws SQLException;
/*************************************************************************/ /**
/**
* This method immediately closes this database connection. * This method immediately closes this database connection.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void close() throws SQLException;
close() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not this connection has been closed. * This method tests whether or not this connection has been closed.
* *
* @return <code>true</code> if the connection is closed, <code>false</code> * @return <code>true</code> if the connection is closed, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isClosed() throws SQLException;
isClosed() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the meta data for this database connection. * This method returns the meta data for this database connection.
* *
* @return The meta data for this database. * @return The meta data for this database.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see DatabaseMetaData * @see DatabaseMetaData
*/ */
public abstract DatabaseMetaData public DatabaseMetaData getMetaData() throws SQLException;
getMetaData() throws SQLException;
/*************************************************************************/
/**
* This method tests whether or not this connection is in read only mode.
*
* @return <code>true</code> if the connection is read only <code>false</code>
* otherwise.
*
* @exception SQLException If an error occurs.
*/
public abstract boolean
isReadOnly() throws SQLException;
/*************************************************************************/ /**
/**
* This method turns read only mode on or off. It may not be called while * This method turns read only mode on or off. It may not be called while
* a transaction is in progress. * a transaction is in progress.
* *
* @param readOnly <code>true</code> if this connection is read only, * @param readOnly <code>true</code> if this connection is read only,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setReadOnly(boolean readOnly) throws SQLException;
setReadOnly(boolean readOnly) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the name of the catalog in use by this connection, * This method tests whether or not this connection is in read only mode.
* if any.
*
* @return The name of the catalog, or <code>null</code> if one does not
* exist or catalogs are not supported by this database.
* *
* @return <code>true</code> if the connection is read only <code>false</code>
* otherwise.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public boolean isReadOnly() throws SQLException;
getCatalog() throws SQLException;
/*************************************************************************/
/** /**
* This method sets the name of the catalog in use by this connection. * This method sets the name of the catalog in use by this connection.
* Note that this method does nothing if catalogs are not supported by * Note that this method does nothing if catalogs are not supported by
* this database. * this database.
* *
* @param catalog The name of the catalog to use for this connection. * @param catalog The name of the catalog to use for this connection.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setCatalog(String catalog) throws SQLException;
setCatalog(String catalog) throws SQLException;
/*************************************************************************/ /**
* This method returns the name of the catalog in use by this connection,
/** * if any.
* This method returns the current transaction isolation mode. This will
* be one of the constants defined in this interface.
*
* @return The transaction isolation level.
* *
* @return The name of the catalog, or <code>null</code> if one does not
* exist or catalogs are not supported by this database.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public String getCatalog() throws SQLException;
getTransactionIsolation() throws SQLException;
/*************************************************************************/ /**
/**
* This method sets the current transaction isolation mode. This must * This method sets the current transaction isolation mode. This must
* be one of the constants defined in this interface. * be one of the constants defined in this interface.
* *
* @param level The transaction isolation level. * @param level The transaction isolation level.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setTransactionIsolation(int level) throws SQLException;
setTransactionIsolation(int level) throws SQLException;
/*************************************************************************/ /**
* This method returns the current transaction isolation mode. This will
* be one of the constants defined in this interface.
*
* @return The transaction isolation level.
* @exception SQLException If an error occurs.
*/
public int getTransactionIsolation() throws SQLException;
/** /**
* This method returns the first warning that occurred on this connection, * This method returns the first warning that occurred on this connection,
* if any. If there were any subsequence warnings, they will be chained * if any. If there were any subsequence warnings, they will be chained
* to the first one. * to the first one.
* *
* @return The first <code>SQLWarning</code> that occurred, or * @return The first <code>SQLWarning</code> that occurred, or
* <code>null</code> if there have been no warnings. * <code>null</code> if there have been no warnings.
* @exception SQLException If an error occurs.
*/
public SQLWarning getWarnings() throws SQLException;
/**
* This method clears all warnings that have occurred on this connection.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract SQLWarning public void clearWarnings() throws SQLException;
getWarnings() throws SQLException;
/*************************************************************************/ /**
* This method creates a new SQL statement with the specified type and
* concurrency. Valid values for these parameters are specified in the
* <code>ResultSet</code> class.
*
* @param resultSetType The type of result set to use for this statement.
* @param resultSetConcurrency. The type of concurrency to be used in
* the result set for this statement.
* @return A new <code>Statement</code> object.
* @exception SQLException If an error occurs.
* @see Statement
* @see ResultSet
*/
public Statement createStatement(int resultSetType, int resultSetConcurrency)
throws SQLException;
/** /**
* This method clears all warnings that have occurred on this connection. * This method creates a new <code>PreparedStatement</code> for the specified
* SQL string. This method is designed for use with parameterized
* statements. The specified result set type and concurrency will be used.
* Valid values for these parameters are specified in the
* <code>ResultSet</code> class.
* *
* @param The SQL statement to use in creating this
* <code>PreparedStatement</code>.
* @param resultSetType The type of result set to use for this statement.
* @param resultSetConcurrency. The type of concurrency to be used in
* the result set for this statement.
* @return A new <code>PreparedStatement</code>.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @see PreparedStatement
* @see ResultSet
*/ */
public abstract void public PreparedStatement prepareStatement(String sql, int resultSetType,
clearWarnings() throws SQLException; int resultSetConcurrency) throws SQLException;
/*************************************************************************/ /**
* This method creates a new <code>CallableStatement</code> for the
* specified SQL string. Thie method is designed to be used with
* stored procedures. The specified result set type and concurrency
* will be used. Valid values for these parameters are specified in the
* <code>ResultSet</code> class.
*
* @param The SQL statement to use in creating this
* <code>PreparedStatement</code>.
* @param resultSetType The type of result set to use for this statement.
* @param resultSetConcurrency. The type of concurrency to be used in
* the result set for this statement.
* @return A new <code>CallableStatement</code>.
* @exception SQLException If an error occurs.
* @see CallableStatement
* @see ResultSet
*/
public CallableStatement prepareCall(String sql, int resultSetType, int
resultSetConcurrency) throws SQLException;
/** /**
* This method returns the mapping of SQL types to Java classes * This method returns the mapping of SQL types to Java classes
* currently in use by this connection. This mapping will have no * currently in use by this connection. This mapping will have no
* entries unless they have been manually added. * entries unless they have been manually added.
* *
* @return The SQL type to Java class mapping. * @return The SQL type to Java class mapping.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Map public Map getTypeMap() throws SQLException;
getTypeMap() throws SQLException;
/*************************************************************************/
/** /**
* This method sets the mapping table for SQL types to Java classes. * This method sets the mapping table for SQL types to Java classes.
* Any entries in this map override the defaults. * Any entries in this map override the defaults.
* *
* @param map The new SQL mapping table. * @param map The new SQL mapping table.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setTypeMap(Map map) throws SQLException;
setTypeMap(Map map) throws SQLException;
/**
* @since 1.4
*/
public void setHoldability(int holdability) throws SQLException;
} // interface Connection /**
* @since 1.4
*/
public int getHoldability() throws SQLException;
/**
* @since 1.4
*/
public Savepoint setSavepoint() throws SQLException;
/**
* @since 1.4
*/
public Savepoint setSavepoint(String name) throws SQLException;
/**
* @since 1.4
*/
public void rollback(Savepoint savepoint) throws SQLException;
/**
* @since 1.4
*/
public void releaseSavepoint(Savepoint savepoint) throws SQLException;
/**
* @since 1.4
*/
public Statement createStatement(int resultSetType, int
resultSetConcurrency, int resultSetHoldability) throws SQLException;
/**
* @since 1.4
*/
public PreparedStatement prepareStatement(String sql, int resultSetType, int
resultSetConcurrency, int resultSetHoldability) throws SQLException;
/**
* @since 1.4
*/
public CallableStatement prepareCall(String sql, int resultSetType, int
resultSetConcurrency, int resultSetHoldability) throws SQLException;
/**
* @since 1.4
*/
public PreparedStatement prepareStatement(String sql, int autoGeneratedKeys)
throws SQLException;
/**
* @since 1.4
*/
public PreparedStatement prepareStatement(String sql, int[] columnIndexes)
throws SQLException;
/**
* @since 1.4
*/
public PreparedStatement prepareStatement(String sql, String[] columnNames)
throws SQLException;
}
/* DataTruncation.java -- Warning when data has been truncated. /* DataTruncation.java -- Warning when data has been truncated.
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -35,7 +35,6 @@ this exception to your version of the library, but you are not ...@@ -35,7 +35,6 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
/** /**
...@@ -46,61 +45,34 @@ package java.sql; ...@@ -46,61 +45,34 @@ package java.sql;
*/ */
public class DataTruncation extends SQLWarning public class DataTruncation extends SQLWarning
{ {
static final long serialVersionUID = 6464298989504059473L;
/*************************************************************************/ /**
/*
* Instance Variables
*/
/**
* The original size of the data. * The original size of the data.
* @serialized
*/ */
private int dataSize; private int dataSize;
/** /**
* The index of the parameter or column whose value was truncated. * The index of the parameter or column whose value was truncated.
* @serialized
*/ */
private int index; private int index;
/** /**
* Indicates whether or not a parameter value was truncated. * Indicates whether or not a parameter value was truncated.
* @serialized
*/ */
private boolean parameter; private boolean parameter;
/** /**
* Indicates whether or not a data column value was truncated. * Indicates whether or not a data column value was truncated.
* @serialized
*/ */
private boolean read; private boolean read;
/** /**
* This is the size of the data after truncation. * This is the size of the data after truncation.
* @serialized
*/ */
private int transferSize; private int transferSize;
/*************************************************************************/ /**
/**
* Static Variables
*/
/**
* This is the serialization UID for this class
*/
private static final long serialVersionUID = 6464298989504059473L;
/*************************************************************************/
/*
* Constructors
*/
/**
* This method initializes a new instance of <code>DataTruncation</code> * This method initializes a new instance of <code>DataTruncation</code>
* with the specified values. The descriptive error message for this * with the specified values. The descriptive error message for this
* exception will be "Data truncation", the SQL state will be "01004" * exception will be "Data truncation", the SQL state will be "01004"
...@@ -114,10 +86,9 @@ private static final long serialVersionUID = 6464298989504059473L; ...@@ -114,10 +86,9 @@ private static final long serialVersionUID = 6464298989504059473L;
* @param dataSize The original size of the data. * @param dataSize The original size of the data.
* @param transferSize The size of the data after truncation. * @param transferSize The size of the data after truncation.
*/ */
public public DataTruncation(int index, boolean parameter, boolean read, int
DataTruncation(int index, boolean parameter, boolean read, int dataSize, dataSize, int transferSize)
int transferSize) {
{
super("Data truncation", "01004"); super("Data truncation", "01004");
this.index = index; this.index = index;
...@@ -125,83 +96,62 @@ DataTruncation(int index, boolean parameter, boolean read, int dataSize, ...@@ -125,83 +96,62 @@ DataTruncation(int index, boolean parameter, boolean read, int dataSize,
this.read = read; this.read = read;
this.dataSize = dataSize; this.dataSize = dataSize;
this.transferSize = transferSize; this.transferSize = transferSize;
} }
/*************************************************************************/
/* /**
* Instance Methods
*/
/**
* This method returns the index of the column or parameter that was * This method returns the index of the column or parameter that was
* truncated. * truncated.
* *
* @return The index of the column or parameter that was truncated. * @return The index of the column or parameter that was truncated.
*/ */
public int public int getIndex()
getIndex() {
{ return index;
return(index); }
}
/*************************************************************************/
/** /**
* This method determines whether or not it was a parameter that was * This method determines whether or not it was a parameter that was
* truncated. * truncated.
* *
* @return <code>true</code> if a parameter was truncated, <code>false</code> * @return <code>true</code> if a parameter was truncated, <code>false</code>
* otherwise. * otherwise.
*/ */
public boolean public boolean getParameter()
getParameter() {
{ return parameter;
return(parameter); }
}
/*************************************************************************/ /**
/**
* This method determines whether or not it was a column that was * This method determines whether or not it was a column that was
* truncated. * truncated.
* *
* @return <code>true</code> if a column was truncated, <code>false</code> * @return <code>true</code> if a column was truncated, <code>false</code>
* otherwise. * otherwise.
*/ */
public boolean public boolean getRead()
getRead() {
{ return read;
return(read); }
}
/*************************************************************************/
/** /**
* This method returns the original size of the parameter or column that * This method returns the original size of the parameter or column that
* was truncated. * was truncated.
* *
* @return The original size of the parameter or column that was truncated. * @return The original size of the parameter or column that was truncated.
*/ */
public int public int getDataSize()
getDataSize() {
{ return dataSize;
return(dataSize); }
}
/*************************************************************************/ /**
/**
* This method returns the size of the parameter or column after it was * This method returns the size of the parameter or column after it was
* truncated. * truncated.
* *
* @return The size of the parameter or column after it was truncated. * @return The size of the parameter or column after it was truncated.
*/ */
public int public int getTransferSize()
getTransferSize() {
{ return transferSize;
return(transferSize); }
} }
} // class DataTruncation
/* DatabaseMetaData.java -- Information about the database itself. /* DatabaseMetaData.java -- Information about the database itself.
Copyright (C) 1999, 2000, 2001 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -35,252 +35,248 @@ this exception to your version of the library, but you are not ...@@ -35,252 +35,248 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
/**
* This interface provides a mechanism for obtaining information about
* the database itself, as opposed to data in it.
*
* @author Aaron M. Renn (arenn@urbanophile.com)
*/
public interface DatabaseMetaData public interface DatabaseMetaData
{ {
/**
/**
* The best row may or may not be a pseudo-column.
*/
public static final int bestRowUnknown = 0;
/**
* The best row identifier is not a pseudo-column.
*/
public static final int bestRowNotPseudo = 1;
/**
* The best row identifier is a pseudo-column.
*/
public static final int bestRowPseudo = 2;
/**
* The best row's scope is only guaranteed to be valid so long as the
* row is actually being used.
*/
public static final int bestRowTemporary = 0;
/**
* The best row identifier is valid to the end of the transaction.
*/
public static final int bestRowTransaction = 1;
/**
* The best row identifier is valid to the end of the session.
*/
public static final int bestRowSession = 2;
/**
* It is unknown whether or not the procedure returns a result. * It is unknown whether or not the procedure returns a result.
*/ */
public static final int procedureResultUnknown = 0; public static final int procedureResultUnknown = 0;
/** /**
* The procedure does not return a result. * The procedure does not return a result.
*/ */
public static final int procedureNoResult = 1; public static final int procedureNoResult = 1;
/** /**
* The procedure returns a result. * The procedure returns a result.
*/ */
public static final int procedureReturnsResult = 2; public static final int procedureReturnsResult = 2;
/** /**
* The column type is unknown. * The column type is unknown.
*/ */
public static final int procedureColumnUnknown = 0; public static final int procedureColumnUnknown = 0;
/** /**
* The column type is input. * The column type is input.
*/ */
public static final int procedureColumnIn = 1; public static final int procedureColumnIn = 1;
/** /**
* The column type is input/output. * The column type is input/output.
*/ */
public static final int procedureColumnInOut = 2; public static final int procedureColumnInOut = 2;
/** /**
* The column type is output * The column type is output
*/ */
public static final int procedureColumnOut = 4; public static final int procedureColumnOut = 4;
/** /**
* The column is used for return values. * The column is used for return values.
*/ */
public static final int procedureColumnReturn = 5; public static final int procedureColumnReturn = 5;
/** /**
* The column is used for storing results * The column is used for storing results
*/ */
public static final int procedureColumnResult = 3; public static final int procedureColumnResult = 3;
/** /**
* NULL values are not allowed. * NULL values are not allowed.
*/ */
public static final int procedureNoNulls = 0; public static final int procedureNoNulls = 0;
/** /**
* NULL values are allowed. * NULL values are allowed.
*/ */
public static final int procedureNullable = 1; public static final int procedureNullable = 1;
/** /**
* It is unknown whether or not NULL values are allowed. * It is unknown whether or not NULL values are allowed.
*/ */
public static final int procedureNullableUnknown = 2; public static final int procedureNullableUnknown = 2;
/** /**
* The column does not allow NULL * The column does not allow NULL
*/ */
public static final int columnNoNulls = 0; public static final int columnNoNulls = 0;
/** /**
* The column does allow NULL * The column does allow NULL
*/ */
public static final int columnNullable = 1; public static final int columnNullable = 1;
/** /**
* It is unknown whether or not the column allows NULL * It is unknown whether or not the column allows NULL
*/ */
public static final int columnNullableUnknown = 2; public static final int columnNullableUnknown = 2;
/**
* The best row's scope is only guaranteed to be valid so long as the
* row is actually being used.
*/
public static final int bestRowTemporary = 0;
/** /**
* The best row identifier is valid to the end of the transaction.
*/
public static final int bestRowTransaction = 1;
/**
* The best row identifier is valid to the end of the session.
*/
public static final int bestRowSession = 2;
/**
* The best row may or may not be a pseudo-column.
*/
public static final int bestRowUnknown = 0;
/**
* The best row identifier is not a pseudo-column.
*/
public static final int bestRowNotPseudo = 1;
/**
* The best row identifier is a pseudo-column.
*/
public static final int bestRowPseudo = 2;
/**
* It is unknown whether or not the version column is a pseudo-column. * It is unknown whether or not the version column is a pseudo-column.
*/ */
public static final int versionColumnUnknown = 0; public static final int versionColumnUnknown = 0;
/** /**
* The version column is not a pseudo-column * The version column is not a pseudo-column
*/ */
public static final int versionColumnNotPseudo = 1; public static final int versionColumnNotPseudo = 1;
/** /**
* The version column is a pseudo-column * The version column is a pseudo-column
*/ */
public static final int versionColumnPseudo = 2; public static final int versionColumnPseudo = 2;
/** /**
* Foreign key changes are cascaded in updates or deletes. * Foreign key changes are cascaded in updates or deletes.
*/ */
public static final int importedKeyCascade = 0; public static final int importedKeyCascade = 0;
/** /**
* Column may not be updated or deleted in use as a foreign key. * Column may not be updated or deleted in use as a foreign key.
*/ */
public static final int importedKeyRestrict = 1; public static final int importedKeyRestrict = 1;
/** /**
* When primary key is updated or deleted, the foreign key is set to NULL. * When primary key is updated or deleted, the foreign key is set to NULL.
*/ */
public static final int importedKeySetNull = 2; public static final int importedKeySetNull = 2;
/** /**
* If the primary key is a foreign key, it cannot be udpated or deleted. * If the primary key is a foreign key, it cannot be udpated or deleted.
*/ */
public static final int importedKeyNoAction = 3; public static final int importedKeyNoAction = 3;
/** /**
* If the primary key is updated or deleted, the foreign key is set to * If the primary key is updated or deleted, the foreign key is set to
* a default value. * a default value.
*/ */
public static final int importedKeySetDefault = 4; public static final int importedKeySetDefault = 4;
/** /**
* Wish I knew what this meant. * Wish I knew what this meant.
*/ */
public static final int importedKeyInitiallyDeferred = 5; public static final int importedKeyInitiallyDeferred = 5;
/** /**
* Wish I knew what this meant. * Wish I knew what this meant.
*/ */
public static final int importedKeyInitiallyImmediate = 6; public static final int importedKeyInitiallyImmediate = 6;
/** /**
* Wish I knew what this meant. * Wish I knew what this meant.
*/ */
public static final int importedKeyNotDeferrable = 7; public static final int importedKeyNotDeferrable = 7;
/** /**
* A NULL value is not allowed for this data type. * A NULL value is not allowed for this data type.
*/ */
public static final int typeNoNulls = 0; public static final int typeNoNulls = 0;
/** /**
* A NULL value is allowed for this data type. * A NULL value is allowed for this data type.
*/ */
public static final int typeNullable = 1; public static final int typeNullable = 1;
/** /**
* It is unknown whether or not NULL values are allowed for this data type. * It is unknown whether or not NULL values are allowed for this data type.
*/ */
public static final int typeNullableUnknown = 2; public static final int typeNullableUnknown = 2;
/** /**
* Where clauses are not supported for this type. * Where clauses are not supported for this type.
*/ */
public static final int typePredNone = 0; public static final int typePredNone = 0;
/** /**
* Only "WHERE..LIKE" style WHERE clauses are allowed on this data type. * Only "WHERE..LIKE" style WHERE clauses are allowed on this data type.
*/ */
public static final int typePredChar = 1; public static final int typePredChar = 1;
/** /**
* All WHERE clauses except "WHERE..LIKE" style are allowed on this data type. * All WHERE clauses except "WHERE..LIKE" style are allowed on this data type.
*/ */
public static final int typePredBasic = 2; public static final int typePredBasic = 2;
/** /**
* Any type of WHERE clause is allowed for this data type. * Any type of WHERE clause is allowed for this data type.
*/ */
public static final int typeSearchable = 3; public static final int typeSearchable = 3;
/** /**
* This column contains table statistics. * This column contains table statistics.
*/ */
public static final short tableIndexStatistic = 0; public static final short tableIndexStatistic = 0;
/** /**
* This table index is clustered. * This table index is clustered.
*/ */
public static final short tableIndexClustered = 1; public static final short tableIndexClustered = 1;
/** /**
* This table index is hashed. * This table index is hashed.
*/ */
public static final short tableIndexHashed = 2; public static final short tableIndexHashed = 2;
/** /**
* This table index is of another type. * This table index is of another type.
*/ */
public static final short tableIndexOther = 3; public static final short tableIndexOther = 3;
public static final short attributeNoNulls = 0;
public static final short attributeNullable = 1;
/*************************************************************************/ public static final short attributeNullableUnknown = 2;
/** public static final int sqlStateXOpen = 1;
public static final int sqlStateSQL99 = 2;
/**
* This method tests whether or not all the procedures returned by * This method tests whether or not all the procedures returned by
* the <code>getProcedures</code> method can be called by this user. * the <code>getProcedures</code> method can be called by this user.
* *
* @return <code>true</code> if all the procedures can be called, * @return <code>true</code> if all the procedures can be called,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean allProceduresAreCallable() throws SQLException;
allProceduresAreCallable() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not all the table returned by the * This method tests whether or not all the table returned by the
* <code>getTables</code> method can be selected by this user. * <code>getTables</code> method can be selected by this user.
* *
...@@ -289,172 +285,118 @@ allProceduresAreCallable() throws SQLException; ...@@ -289,172 +285,118 @@ allProceduresAreCallable() throws SQLException;
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean allTablesAreSelectable() throws SQLException;
allTablesAreSelectable() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the URL for this database. * This method returns the URL for this database.
* *
* @return The URL string for this database, or <code>null</code> if it * @return The URL string for this database, or <code>null</code> if it
* is not known. * is not known.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getURL() throws SQLException;
getURL() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the database username for this connection. * This method returns the database username for this connection.
* *
* @return The database username. * @return The database username.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getUserName() throws SQLException;
getUserName() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database is in read only mode. * This method tests whether or not the database is in read only mode.
* *
* @return <code>true</code> if the database is in read only mode, * @return <code>true</code> if the database is in read only mode,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isReadOnly() throws SQLException;
isReadOnly() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not NULL's sort as high values. * This method tests whether or not NULL's sort as high values.
* *
* @return <code>true</code> if NULL's sort as high values, <code>false</code> * @return <code>true</code> if NULL's sort as high values, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean nullsAreSortedHigh() throws SQLException;
nullsAreSortedHigh() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not NULL's sort as low values. * This method tests whether or not NULL's sort as low values.
* *
* @return <code>true</code> if NULL's sort as low values, <code>false</code> * @return <code>true</code> if NULL's sort as low values, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean nullsAreSortedLow() throws SQLException;
nullsAreSortedLow() throws SQLException;
/*************************************************************************/
/** /**
* This method test whether or not NULL's are sorted to the beginning * This method tests whether or not NULL's sort as high values.
* of the list regardless of ascending or descending sort order.
*
* @return <code>true</code> if NULL's always sort to the beginning,
* <code>false</code> otherwise.
* *
* @return <code>true</code> if NULL's sort as high values, <code>false</code>
* otherwise.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean nullsAreSortedAtStart() throws SQLException;
nullsAreSortedAtStart() throws SQLException;
/*************************************************************************/
/** /**
* This method test whether or not NULL's are sorted to the end * This method test whether or not NULL's are sorted to the end
* of the list regardless of ascending or descending sort order. * of the list regardless of ascending or descending sort order.
* *
* @return <code>true</code> if NULL's always sort to the end, * @return <code>true</code> if NULL's always sort to the end,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean nullsAreSortedAtEnd() throws SQLException;
nullsAreSortedAtEnd() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the name of the database product. * This method returns the name of the database product.
* *
* @return The database product. * @return The database product.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getDatabaseProductName() throws SQLException;
getDatabaseProductName() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the version of the database product. * This method returns the version of the database product.
* *
* @return The version of the database product. * @return The version of the database product.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getDatabaseProductVersion() throws SQLException;
getDatabaseProductVersion() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the name of the JDBC driver. * This method returns the name of the JDBC driver.
* *
* @return The name of the JDBC driver. * @return The name of the JDBC driver.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getDriverName() throws SQLException;
getDriverName() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the version of the JDBC driver. * This method returns the version of the JDBC driver.
* *
* @return The version of the JDBC driver. * @return The version of the JDBC driver.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getDriverVersion() throws SQLException;
getDriverVersion() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the major version number of the JDBC driver. * This method returns the major version number of the JDBC driver.
* *
* @return The major version number of the JDBC driver. * @return The major version number of the JDBC driver.
*/ */
public abstract int public int getDriverMajorVersion();
getDriverMajorVersion();
/*************************************************************************/ /**
/**
* This method returns the minor version number of the JDBC driver. * This method returns the minor version number of the JDBC driver.
* *
* @return The minor version number of the JDBC driver. * @return The minor version number of the JDBC driver.
*/ */
public abstract int public int getDriverMinorVersion();
getDriverMinorVersion();
/*************************************************************************/
/** /**
* This method tests whether or not the database uses local files to * This method tests whether or not the database uses local files to
* store tables. * store tables.
* *
...@@ -463,12 +405,9 @@ getDriverMinorVersion(); ...@@ -463,12 +405,9 @@ getDriverMinorVersion();
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean usesLocalFiles() throws SQLException;
usesLocalFiles() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database uses a separate file for * This method tests whether or not the database uses a separate file for
* each table. * each table.
* *
...@@ -477,12 +416,9 @@ usesLocalFiles() throws SQLException; ...@@ -477,12 +416,9 @@ usesLocalFiles() throws SQLException;
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean usesLocalFilePerTable() throws SQLException;
usesLocalFilePerTable() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the database supports identifiers * This method tests whether or not the database supports identifiers
* with mixed case. * with mixed case.
* *
...@@ -491,1278 +427,895 @@ usesLocalFilePerTable() throws SQLException; ...@@ -491,1278 +427,895 @@ usesLocalFilePerTable() throws SQLException;
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsMixedCaseIdentifiers() throws SQLException;
supportsMixedCaseIdentifiers() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database treats mixed case * This method tests whether or not the database treats mixed case
* identifiers as all upper case. * identifiers as all upper case.
* *
* @exception <code>true</code> if the database treats all identifiers as * @exception <code>true</code> if the database treats all identifiers as
* upper case, <code>false</code> otherwise. * upper case, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean storesUpperCaseIdentifiers() throws SQLException;
storesUpperCaseIdentifiers() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database treats mixed case * This method tests whether or not the database treats mixed case
* identifiers as all lower case. * identifiers as all lower case.
* *
* @exception <code>true</code> if the database treats all identifiers as * @exception <code>true</code> if the database treats all identifiers as
* lower case, <code>false</code> otherwise. * lower case, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean storesLowerCaseIdentifiers() throws SQLException;
storesLowerCaseIdentifiers() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database stores mixed case * This method tests whether or not the database stores mixed case
* identifers even if it treats them as case insensitive. * identifers even if it treats them as case insensitive.
* *
* @return <code>true</code> if the database stores mixed case identifiers, * @return <code>true</code> if the database stores mixed case identifiers,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean storesMixedCaseIdentifiers() throws SQLException;
storesMixedCaseIdentifiers() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the database supports quoted identifiers * This method tests whether or not the database supports quoted identifiers
* with mixed case. * with mixed case.
* *
* @return <code>true</code> if the database supports mixed case quoted * @return <code>true</code> if the database supports mixed case quoted
* identifiers, <code>false</code> otherwise. * identifiers, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsMixedCaseQuotedIdentifiers() throws SQLException;
supportsMixedCaseQuotedIdentifiers() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database treats mixed case * This method tests whether or not the database treats mixed case
* quoted identifiers as all upper case. * quoted identifiers as all upper case.
* *
* @exception <code>true</code> if the database treats all quoted identifiers * @exception <code>true</code> if the database treats all quoted identifiers
* as upper case, <code>false</code> otherwise. * as upper case, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean storesUpperCaseQuotedIdentifiers() throws SQLException;
storesUpperCaseQuotedIdentifiers() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database treats mixed case * This method tests whether or not the database treats mixed case
* quoted identifiers as all lower case. * quoted identifiers as all lower case.
* *
* @exception <code>true</code> if the database treats all quoted identifiers * @exception <code>true</code> if the database treats all quoted identifiers
* as lower case, <code>false</code> otherwise. * as lower case, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean storesLowerCaseQuotedIdentifiers() throws SQLException;
storesLowerCaseQuotedIdentifiers() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the database stores mixed case * This method tests whether or not the database stores mixed case
* quoted identifers even if it treats them as case insensitive. * quoted identifers even if it treats them as case insensitive.
* *
* @return <code>true</code> if the database stores mixed case quoted * @return <code>true</code> if the database stores mixed case quoted
* identifiers, <code>false</code> otherwise. * identifiers, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean storesMixedCaseQuotedIdentifiers() throws SQLException;
storesMixedCaseQuotedIdentifiers() throws SQLException;
/*************************************************************************/ /**
/**
* This metohd returns the quote string for SQL identifiers. * This metohd returns the quote string for SQL identifiers.
* *
* @return The quote string for SQL identifers, or a space if quoting * @return The quote string for SQL identifers, or a space if quoting
* is not supported. * is not supported.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getIdentifierQuoteString() throws SQLException;
getIdentifierQuoteString() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns a comma separated list of all the SQL keywords in * This method returns a comma separated list of all the SQL keywords in
* the database that are not in SQL92. * the database that are not in SQL92.
* *
* @return The list of SQL keywords not in SQL92. * @return The list of SQL keywords not in SQL92.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getSQLKeywords() throws SQLException;
getSQLKeywords() throws SQLException;
/*************************************************************************/
/** /**
* This method returns a comma separated list of math functions. * This method returns a comma separated list of math functions.
* *
* @return The list of math functions. * @return The list of math functions.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getNumericFunctions() throws SQLException;
getNumericFunctions() throws SQLException;
/*************************************************************************/
/** /**
* This method returns a comma separated list of string functions. * This method returns a comma separated list of string functions.
* *
* @return The list of string functions. * @return The list of string functions.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getStringFunctions() throws SQLException;
getStringFunctions() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns a comma separated list of of system functions. * This method returns a comma separated list of of system functions.
* *
* @return A comma separated list of system functions. * @return A comma separated list of system functions.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getSystemFunctions() throws SQLException;
getSystemFunctions() throws SQLException;
/*************************************************************************/
/** /**
* This method returns comma separated list of time/date functions. * This method returns comma separated list of time/date functions.
* *
* @return The list of time/date functions. * @return The list of time/date functions.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getTimeDateFunctions() throws SQLException;
getTimeDateFunctions() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the string used to escape wildcards in search strings. * This method returns the string used to escape wildcards in search strings.
* *
* @return The string used to escape wildcards in search strings. * @return The string used to escape wildcards in search strings.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getSearchStringEscape() throws SQLException;
getSearchStringEscape() throws SQLException;
/*************************************************************************/
/** /**
* This methods returns non-standard characters that can appear in * This methods returns non-standard characters that can appear in
* unquoted identifiers. * unquoted identifiers.
* *
* @return Non-standard characters that can appear in unquoted identifiers. * @return Non-standard characters that can appear in unquoted identifiers.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getExtraNameCharacters() throws SQLException;
getExtraNameCharacters() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database supports * This method tests whether or not the database supports
* "ALTER TABLE ADD COLUMN" * "ALTER TABLE ADD COLUMN"
* *
* @return <code>true</code> if column add supported, <code>false</code> * @return <code>true</code> if column add supported, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsAlterTableWithAddColumn() throws SQLException;
supportsAlterTableWithAddColumn() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the database supports * This method tests whether or not the database supports
* "ALTER TABLE DROP COLUMN" * "ALTER TABLE DROP COLUMN"
* *
* @return <code>true</code> if column drop supported, <code>false</code> * @return <code>true</code> if column drop supported, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsAlterTableWithDropColumn() throws SQLException;
supportsAlterTableWithDropColumn() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not column aliasing is supported. * This method tests whether or not column aliasing is supported.
* *
* @return <code>true</code> if column aliasing is supported, * @return <code>true</code> if column aliasing is supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsColumnAliasing() throws SQLException;
supportsColumnAliasing() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether the concatenation of a NULL and non-NULL * This method tests whether the concatenation of a NULL and non-NULL
* value results in a NULL. This will always be true in fully JDBC compliant * value results in a NULL. This will always be true in fully JDBC compliant
* drivers. * drivers.
* *
* @return <code>true</code> if concatenating NULL and a non-NULL value * @return <code>true</code> if concatenating NULL and a non-NULL value
* returns a NULL, <code>false</code> otherwise. * returns a NULL, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean nullPlusNonNullIsNull() throws SQLException;
nullPlusNonNullIsNull() throws SQLException;
/*************************************************************************/ /**
/**
* Tests whether or not CONVERT is supported. * Tests whether or not CONVERT is supported.
* *
* @return <code>true</code> if CONVERT is supported, <code>false</code> * @return <code>true</code> if CONVERT is supported, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsConvert() throws SQLException;
supportsConvert() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not CONVERT can be performed between the * This method tests whether or not CONVERT can be performed between the
* specified types. The types are contants from <code>Types</code>. * specified types. The types are contants from <code>Types</code>.
* *
* @param fromType The SQL type to convert from. * @param fromType The SQL type to convert from.
* @param toType The SQL type to convert to. * @param toType The SQL type to convert to.
*
* @return <code>true</code> if the conversion can be performed, * @return <code>true</code> if the conversion can be performed,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @see Types * @see Types
*/ */
public abstract boolean public boolean supportsConvert(int fromType, int toType) throws
supportsConvert(int fromType, int toType) throws SQLException; SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not table correlation names are * This method tests whether or not table correlation names are
* supported. This will be always be <code>true</code> in a fully JDBC * supported. This will be always be <code>true</code> in a fully JDBC
* compliant driver. * compliant driver.
* *
* @return <code>true</code> if table correlation names are supported, * @return <code>true</code> if table correlation names are supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsTableCorrelationNames() throws SQLException;
supportsTableCorrelationNames() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether correlation names must be different from the * This method tests whether correlation names must be different from the
* name of the table. * name of the table.
* *
* @return <code>true</code> if the correlation name must be different from * @return <code>true</code> if the correlation name must be different from
* the table name, <code>false</code> otherwise. * the table name, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsDifferentTableCorrelationNames() throws SQLException;
supportsDifferentTableCorrelationNames() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not expressions are allowed in an * This method tests whether or not expressions are allowed in an
* ORDER BY lists. * ORDER BY lists.
* *
* @return <code>true</code> if expressions are allowed in ORDER BY * @return <code>true</code> if expressions are allowed in ORDER BY
* lists, <code>false</code> otherwise. * lists, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsExpressionsInOrderBy() throws SQLException;
supportsExpressionsInOrderBy() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or ORDER BY on a non-selected column is * This method tests whether or ORDER BY on a non-selected column is
* allowed. * allowed.
* *
* @return <code>true</code> if a non-selected column can be used in an * @return <code>true</code> if a non-selected column can be used in an
* ORDER BY, <code>false</code> otherwise. * ORDER BY, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsOrderByUnrelated() throws SQLException;
supportsOrderByUnrelated() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not GROUP BY is supported. * This method tests whether or not GROUP BY is supported.
* *
* @return <code>true</code> if GROUP BY is supported, <code>false</code> * @return <code>true</code> if GROUP BY is supported, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsGroupBy() throws SQLException;
supportsGroupBy() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether GROUP BY on a non-selected column is * This method tests whether GROUP BY on a non-selected column is
* allowed. * allowed.
* *
* @return <code>true</code> if a non-selected column can be used in a * @return <code>true</code> if a non-selected column can be used in a
* GROUP BY, <code>false</code> otherwise. * GROUP BY, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsGroupByUnrelated() throws SQLException;
supportsGroupByUnrelated() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not a GROUP BY can add columns not in the * This method tests whether or not a GROUP BY can add columns not in the
* select if it includes all the columns in the select. * select if it includes all the columns in the select.
* *
* @return <code>true</code> if GROUP BY an add columns provided it includes * @return <code>true</code> if GROUP BY an add columns provided it includes
* all columns in the select, <code>false</code> otherwise. * all columns in the select, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsGroupByBeyondSelect() throws SQLException;
supportsGroupByBeyondSelect() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the escape character is supported in * This method tests whether or not the escape character is supported in
* LIKE expressions. A fully JDBC compliant driver will always return * LIKE expressions. A fully JDBC compliant driver will always return
* <code>true</code>. * <code>true</code>.
* *
* @return <code>true</code> if escapes are supported in LIKE expressions, * @return <code>true</code> if escapes are supported in LIKE expressions,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean supportsLikeEscapeClause() throws SQLException; public boolean supportsLikeEscapeClause() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether multiple result sets for a single statement are * This method tests whether multiple result sets for a single statement are
* supported. * supported.
* *
* @return <code>true</code> if multiple result sets are supported for a * @return <code>true</code> if multiple result sets are supported for a
* single statement, <code>false</code> otherwise. * single statement, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsMultipleResultSets() throws SQLException;
supportsMultipleResultSets() throws SQLException;
/*************************************************************************/ /**
/**
* This method test whether or not multiple transactions may be open * This method test whether or not multiple transactions may be open
* at once, as long as they are on different connections. * at once, as long as they are on different connections.
* *
* @return <code>true</code> if multiple transactions on different * @return <code>true</code> if multiple transactions on different
* connections are supported, <code>false</code> otherwise. * connections are supported, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsMultipleTransactions() throws SQLException;
supportsMultipleTransactions() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not columns can be defined as NOT NULL. A * This method tests whether or not columns can be defined as NOT NULL. A
* fully JDBC compliant driver always returns <code>true</code>. * fully JDBC compliant driver always returns <code>true</code>.
* *
* @return <code>true</code> if NOT NULL columns are supported, * @return <code>true</code> if NOT NULL columns are supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsNonNullableColumns() throws SQLException;
supportsNonNullableColumns() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the minimum grammer for ODBC is supported. * This method tests whether or not the minimum grammer for ODBC is supported.
* A fully JDBC compliant driver will always return <code>true</code>. * A fully JDBC compliant driver will always return <code>true</code>.
* *
* @return <code>true</code> if the ODBC minimum grammar is supported, * @return <code>true</code> if the ODBC minimum grammar is supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsMinimumSQLGrammar() throws SQLException;
supportsMinimumSQLGrammar() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the core grammer for ODBC is supported. * This method tests whether or not the core grammer for ODBC is supported.
* *
* @return <code>true</code> if the ODBC core grammar is supported, * @return <code>true</code> if the ODBC core grammar is supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsCoreSQLGrammar() throws SQLException;
supportsCoreSQLGrammar() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the extended grammer for ODBC is supported. * This method tests whether or not the extended grammer for ODBC is supported.
* *
* @return <code>true</code> if the ODBC extended grammar is supported, * @return <code>true</code> if the ODBC extended grammar is supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsExtendedSQLGrammar() throws SQLException;
supportsExtendedSQLGrammar() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the ANSI92 entry level SQL * This method tests whether or not the ANSI92 entry level SQL
* grammar is supported. A fully JDBC compliant drivers must return * grammar is supported. A fully JDBC compliant drivers must return
* <code>true</code>. * <code>true</code>.
* *
* @return <code>true</code> if the ANSI92 entry level SQL grammar is * @return <code>true</code> if the ANSI92 entry level SQL grammar is
* supported, <code>false</code> otherwise. * supported, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsANSI92EntryLevelSQL() throws SQLException;
supportsANSI92EntryLevelSQL() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the ANSI92 intermediate SQL * This method tests whether or not the ANSI92 intermediate SQL
* grammar is supported. * grammar is supported.
* *
* @return <code>true</code> if the ANSI92 intermediate SQL grammar is * @return <code>true</code> if the ANSI92 intermediate SQL grammar is
* supported, <code>false</code> otherwise. * supported, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsANSI92IntermediateSQL() throws SQLException;
supportsANSI92IntermediateSQL() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the ANSI92 full SQL * This method tests whether or not the ANSI92 full SQL
* grammar is supported. * grammar is supported.
* *
* @return <code>true</code> if the ANSI92 full SQL grammar is * @return <code>true</code> if the ANSI92 full SQL grammar is
* supported, <code>false</code> otherwise. * supported, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsANSI92FullSQL() throws SQLException;
supportsANSI92FullSQL() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the SQL integrity enhancement * This method tests whether or not the SQL integrity enhancement
* facility is supported. * facility is supported.
* *
* @return <code>true</code> if the integrity enhancement facility is * @return <code>true</code> if the integrity enhancement facility is
* supported, <code>false</code> otherwise. * supported, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsIntegrityEnhancementFacility() throws SQLException;
supportsIntegrityEnhancementFacility() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the database supports outer joins. * This method tests whether or not the database supports outer joins.
* *
* @return <code>true</code> if outer joins are supported, <code>false</code> * @return <code>true</code> if outer joins are supported, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsOuterJoins() throws SQLException;
supportsOuterJoins() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the database supports full outer joins. * This method tests whether or not the database supports full outer joins.
* *
* @return <code>true</code> if full outer joins are supported, * @return <code>true</code> if full outer joins are supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsFullOuterJoins() throws SQLException;
supportsFullOuterJoins() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database supports limited outer joins. * This method tests whether or not the database supports limited outer joins.
* *
* @return <code>true</code> if limited outer joins are supported, * @return <code>true</code> if limited outer joins are supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsLimitedOuterJoins() throws SQLException;
supportsLimitedOuterJoins() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the vendor's term for "schema". * This method returns the vendor's term for "schema".
* *
* @return The vendor's term for schema. * @return The vendor's term for schema.
*
* @exception SQLException if an error occurs. * @exception SQLException if an error occurs.
*/ */
public abstract String public String getSchemaTerm() throws SQLException;
getSchemaTerm() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the vendor's term for "procedure". * This method returns the vendor's term for "procedure".
* *
* @return The vendor's term for procedure. * @return The vendor's term for procedure.
*
* @exception SQLException if an error occurs. * @exception SQLException if an error occurs.
*/ */
public abstract String public String getProcedureTerm() throws SQLException;
getProcedureTerm() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the vendor's term for "catalog". * This method returns the vendor's term for "catalog".
* *
* @return The vendor's term for catalog. * @return The vendor's term for catalog.
*
* @exception SQLException if an error occurs. * @exception SQLException if an error occurs.
*/ */
public abstract String public String getCatalogTerm() throws SQLException;
getCatalogTerm() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether a catalog name appears at the beginning of * This method tests whether a catalog name appears at the beginning of
* a fully qualified table name. * a fully qualified table name.
* *
* @return <code>true</code> if the catalog name appears at the beginning, * @return <code>true</code> if the catalog name appears at the beginning,
* <code>false</code> if it appears at the end. * <code>false</code> if it appears at the end.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isCatalogAtStart() throws SQLException;
isCatalogAtStart() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the separator between the catalog name and the * This method returns the separator between the catalog name and the
* table name. * table name.
* *
* @return The separator between the catalog name and the table name. * @return The separator between the catalog name and the table name.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getCatalogSeparator() throws SQLException;
getCatalogSeparator() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether a catalog name can appear in a data * This method tests whether a catalog name can appear in a data
* manipulation statement. * manipulation statement.
* *
* @return <code>true</code> if a catalog name can appear in a data * @return <code>true</code> if a catalog name can appear in a data
* manipulation statement, <code>false</code> otherwise. * manipulation statement, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsSchemasInDataManipulation() throws SQLException;
supportsSchemasInDataManipulation() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether a catalog name can appear in a procedure * This method tests whether a catalog name can appear in a procedure
* call * call
* *
* @return <code>true</code> if a catalog name can appear in a procedure * @return <code>true</code> if a catalog name can appear in a procedure
* call, <code>false</code> otherwise. * call, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsSchemasInProcedureCalls() throws SQLException;
supportsSchemasInProcedureCalls() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether a catalog name can appear in a table definition. * This method tests whether a catalog name can appear in a table definition.
* *
* @return <code>true</code> if a catalog name can appear in a table * @return <code>true</code> if a catalog name can appear in a table
* definition, <code>false</code> otherwise. * definition, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsSchemasInTableDefinitions() throws SQLException;
supportsSchemasInTableDefinitions() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether a catalog name can appear in an index definition. * This method tests whether a catalog name can appear in an index definition.
* *
* @return <code>true</code> if a catalog name can appear in an index * @return <code>true</code> if a catalog name can appear in an index
* definition, <code>false</code> otherwise. * definition, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsSchemasInIndexDefinitions() throws SQLException;
supportsSchemasInIndexDefinitions() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether a catalog name can appear in privilege definitions. * This method tests whether a catalog name can appear in privilege definitions.
* *
* @return <code>true</code> if a catalog name can appear in privilege * @return <code>true</code> if a catalog name can appear in privilege
* definition, <code>false</code> otherwise. * definition, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsSchemasInPrivilegeDefinitions() throws SQLException;
supportsSchemasInPrivilegeDefinitions() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether a catalog name can appear in a data * This method tests whether a catalog name can appear in a data
* manipulation statement. * manipulation statement.
* *
* @return <code>true</code> if a catalog name can appear in a data * @return <code>true</code> if a catalog name can appear in a data
* manipulation statement, <code>false</code> otherwise. * manipulation statement, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsCatalogsInDataManipulation() throws SQLException;
supportsCatalogsInDataManipulation() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether a catalog name can appear in a procedure * This method tests whether a catalog name can appear in a procedure
* call * call
* *
* @return <code>true</code> if a catalog name can appear in a procedure * @return <code>true</code> if a catalog name can appear in a procedure
* call, <code>false</code> otherwise. * call, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsCatalogsInProcedureCalls() throws SQLException;
supportsCatalogsInProcedureCalls() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether a catalog name can appear in a table definition. * This method tests whether a catalog name can appear in a table definition.
* *
* @return <code>true</code> if a catalog name can appear in a table * @return <code>true</code> if a catalog name can appear in a table
* definition, <code>false</code> otherwise. * definition, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsCatalogsInTableDefinitions() throws SQLException;
supportsCatalogsInTableDefinitions() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether a catalog name can appear in an index definition. * This method tests whether a catalog name can appear in an index definition.
* *
* @return <code>true</code> if a catalog name can appear in an index * @return <code>true</code> if a catalog name can appear in an index
* definition, <code>false</code> otherwise. * definition, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsCatalogsInIndexDefinitions() throws SQLException;
supportsCatalogsInIndexDefinitions() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether a catalog name can appear in privilege definitions. * This method tests whether a catalog name can appear in privilege definitions.
* *
* @return <code>true</code> if a catalog name can appear in privilege * @return <code>true</code> if a catalog name can appear in privilege
* definition, <code>false</code> otherwise. * definition, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsCatalogsInPrivilegeDefinitions() throws SQLException;
supportsCatalogsInPrivilegeDefinitions() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not that database supports positioned * This method tests whether or not that database supports positioned
* deletes. * deletes.
* *
* @return <code>true</code> if positioned deletes are supported, * @return <code>true</code> if positioned deletes are supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsPositionedDelete() throws SQLException;
supportsPositionedDelete() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not that database supports positioned * This method tests whether or not that database supports positioned
* updates. * updates.
* *
* @return <code>true</code> if positioned updates are supported, * @return <code>true</code> if positioned updates are supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsPositionedUpdate() throws SQLException;
supportsPositionedUpdate() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not SELECT FOR UPDATE is supported by the * This method tests whether or not SELECT FOR UPDATE is supported by the
* database. * database.
* *
* @return <code>true</code> if SELECT FOR UPDATE is supported * @return <code>true</code> if SELECT FOR UPDATE is supported
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsSelectForUpdate() throws SQLException;
supportsSelectForUpdate() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not stored procedures are supported on * This method tests whether or not stored procedures are supported on
* this database. * this database.
* *
* @return <code>true</code> if stored procedures are supported, * @return <code>true</code> if stored procedures are supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsStoredProcedures() throws SQLException;
supportsStoredProcedures() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not subqueries are allowed in comparisons. * This method tests whether or not subqueries are allowed in comparisons.
* A fully JDBC compliant driver will always return <code>true</code>. * A fully JDBC compliant driver will always return <code>true</code>.
* *
* @return <code>true</code> if subqueries are allowed in comparisons, * @return <code>true</code> if subqueries are allowed in comparisons,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsSubqueriesInComparisons() throws SQLException;
supportsSubqueriesInComparisons() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not subqueries are allowed in exists * This method tests whether or not subqueries are allowed in exists
* expressions. A fully JDBC compliant driver will always return * expressions. A fully JDBC compliant driver will always return
* <code>true</code>. * <code>true</code>.
* *
* @return <code>true</code> if subqueries are allowed in exists * @return <code>true</code> if subqueries are allowed in exists
* expressions, <code>false</code> otherwise. * expressions, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsSubqueriesInExists() throws SQLException;
supportsSubqueriesInExists() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether subqueries are allowed in IN statements. * This method tests whether subqueries are allowed in IN statements.
* A fully JDBC compliant driver will always return <code>true</code>. * A fully JDBC compliant driver will always return <code>true</code>.
* *
* @return <code>true</code> if the driver supports subqueries in IN * @return <code>true</code> if the driver supports subqueries in IN
* statements, <code>false</code> otherwise. * statements, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsSubqueriesInIns() throws SQLException;
supportsSubqueriesInIns() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not subqueries are allowed in quantified * This method tests whether or not subqueries are allowed in quantified
* expressions. A fully JDBC compliant driver will always return * expressions. A fully JDBC compliant driver will always return
* <code>true</code>. * <code>true</code>.
* *
* @return <code>true</code> if subqueries are allowed in quantified * @return <code>true</code> if subqueries are allowed in quantified
* expressions, <code>false</code> otherwise. * expressions, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsSubqueriesInQuantifieds() throws SQLException;
supportsSubqueriesInQuantifieds() throws SQLException;
/*************************************************************************/ /**
/**
* This method test whether or not correlated subqueries are allowed. A * This method test whether or not correlated subqueries are allowed. A
* fully JDBC compliant driver will always return <code>true</code>. * fully JDBC compliant driver will always return <code>true</code>.
* *
* @return <code>true</code> if correlated subqueries are allowed, * @return <code>true</code> if correlated subqueries are allowed,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsCorrelatedSubqueries() throws SQLException;
supportsCorrelatedSubqueries() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the UNION statement is supported. * This method tests whether or not the UNION statement is supported.
* *
* @return <code>true</code> if UNION is supported, <code>false</code> * @return <code>true</code> if UNION is supported, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsUnion() throws SQLException;
supportsUnion() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the UNION ALL statement is supported. * This method tests whether or not the UNION ALL statement is supported.
* *
* @return <code>true</code> if UNION ALL is supported, <code>false</code> * @return <code>true</code> if UNION ALL is supported, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsUnionAll() throws SQLException;
supportsUnionAll() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database supports cursors * This method tests whether or not the database supports cursors
* remaining open across commits. * remaining open across commits.
* *
* @return <code>true</code> if cursors can remain open across commits, * @return <code>true</code> if cursors can remain open across commits,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsOpenCursorsAcrossCommit() throws SQLException;
supportsOpenCursorsAcrossCommit() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the database supports cursors * This method tests whether or not the database supports cursors
* remaining open across rollbacks. * remaining open across rollbacks.
* *
* @return <code>true</code> if cursors can remain open across rollbacks, * @return <code>true</code> if cursors can remain open across rollbacks,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsOpenCursorsAcrossRollback() throws SQLException;
supportsOpenCursorsAcrossRollback() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database supports statements * This method tests whether or not the database supports statements
* remaining open across commits. * remaining open across commits.
* *
* @return <code>true</code> if statements can remain open across commits, * @return <code>true</code> if statements can remain open across commits,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsOpenStatementsAcrossCommit() throws SQLException;
supportsOpenStatementsAcrossCommit() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database supports statements * This method tests whether or not the database supports statements
* remaining open across rollbacks. * remaining open across rollbacks.
* *
* @return <code>true</code> if statements can remain open across rollbacks, * @return <code>true</code> if statements can remain open across rollbacks,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsOpenStatementsAcrossRollback() throws SQLException;
supportsOpenStatementsAcrossRollback() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the number of hex characters allowed in an inline * This method returns the number of hex characters allowed in an inline
* binary literal. * binary literal.
* *
* @return The number of hex characters allowed in a binary literal, 0 meaning * @return The number of hex characters allowed in a binary literal, 0 meaning
* either an unknown or unlimited number. * either an unknown or unlimited number.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxBinaryLiteralLength() throws SQLException;
getMaxBinaryLiteralLength() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the maximum length of a character literal. * This method returns the maximum length of a character literal.
* *
* @return The maximum length of a character literal. * @return The maximum length of a character literal.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxCharLiteralLength() throws SQLException;
getMaxCharLiteralLength() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the maximum length of a column name. * This method returns the maximum length of a column name.
* *
* @return The maximum length of a column name. * @return The maximum length of a column name.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxColumnNameLength() throws SQLException;
getMaxColumnNameLength() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the maximum number of columns in a GROUP BY statement. * This method returns the maximum number of columns in a GROUP BY statement.
* *
* @return The maximum number of columns in a GROUP BY statement. * @return The maximum number of columns in a GROUP BY statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxColumnsInGroupBy() throws SQLException;
getMaxColumnsInGroupBy() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the maximum number of columns in an index. * This method returns the maximum number of columns in an index.
* *
* @return The maximum number of columns in an index. * @return The maximum number of columns in an index.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxColumnsInIndex() throws SQLException;
getMaxColumnsInIndex() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the maximum number of columns in an ORDER BY statement. * This method returns the maximum number of columns in an ORDER BY statement.
* *
* @return The maximum number of columns in an ORDER BY statement. * @return The maximum number of columns in an ORDER BY statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxColumnsInOrderBy() throws SQLException;
getMaxColumnsInOrderBy() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the maximum number of columns in a SELECT statement. * This method returns the maximum number of columns in a SELECT statement.
* *
* @return The maximum number of columns in a SELECT statement. * @return The maximum number of columns in a SELECT statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxColumnsInSelect() throws SQLException;
getMaxColumnsInSelect() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the maximum number of columns in a table. * This method returns the maximum number of columns in a table.
* *
* @return The maximum number of columns in a table. * @return The maximum number of columns in a table.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxColumnsInTable() throws SQLException;
getMaxColumnsInTable() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the maximum number of connections this client * This method returns the maximum number of connections this client
* can have to the database. * can have to the database.
* *
* @return The maximum number of database connections. * @return The maximum number of database connections.
*
* @SQLException If an error occurs. * @SQLException If an error occurs.
*/ */
public abstract int public int getMaxConnections() throws SQLException;
getMaxConnections() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the maximum length of a cursor name. * This method returns the maximum length of a cursor name.
* *
* @return The maximum length of a cursor name. * @return The maximum length of a cursor name.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxCursorNameLength() throws SQLException;
getMaxCursorNameLength() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the maximum length of an index. * This method returns the maximum length of an index.
* *
* @return The maximum length of an index. * @return The maximum length of an index.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxIndexLength() throws SQLException;
getMaxIndexLength() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the maximum length of a schema name. * This method returns the maximum length of a schema name.
* *
* @return The maximum length of a schema name. * @return The maximum length of a schema name.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxSchemaNameLength() throws SQLException;
getMaxSchemaNameLength() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the maximum length of a procedure name. * This method returns the maximum length of a procedure name.
* *
* @return The maximum length of a procedure name. * @return The maximum length of a procedure name.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxProcedureNameLength() throws SQLException;
getMaxProcedureNameLength() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the maximum length of a catalog name. * This method returns the maximum length of a catalog name.
* *
* @return The maximum length of a catalog name. * @return The maximum length of a catalog name.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxCatalogNameLength() throws SQLException;
getMaxCatalogNameLength() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the maximum size of a row in bytes. * This method returns the maximum size of a row in bytes.
* *
* @return The maximum size of a row. * @return The maximum size of a row.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxRowSize() throws SQLException;
getMaxRowSize() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the maximum row size includes BLOB's * This method tests whether or not the maximum row size includes BLOB's
* *
* @return <code>true</code> if the maximum row size includes BLOB's, * @return <code>true</code> if the maximum row size includes BLOB's,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean doesMaxRowSizeIncludeBlobs() throws SQLException;
doesMaxRowSizeIncludeBlobs() throws SQLException;
/*************************************************************************/
/** /**
* This method includes the maximum length of a SQL statement. * This method includes the maximum length of a SQL statement.
* *
* @return The maximum length of a SQL statement. * @return The maximum length of a SQL statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxStatementLength() throws SQLException;
getMaxStatementLength() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the maximum number of statements that can be * This method returns the maximum number of statements that can be
* active at any time. * active at any time.
* *
* @return The maximum number of statements that can be active at any time. * @return The maximum number of statements that can be active at any time.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxStatements() throws SQLException;
getMaxStatements() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the maximum length of a table name. * This method returns the maximum length of a table name.
* *
* @return The maximum length of a table name. * @return The maximum length of a table name.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxTableNameLength() throws SQLException;
getMaxTableNameLength() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the maximum number of tables that may be referenced * This method returns the maximum number of tables that may be referenced
* in a SELECT statement. * in a SELECT statement.
* *
* @return The maximum number of tables allowed in a SELECT statement. * @return The maximum number of tables allowed in a SELECT statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxTablesInSelect() throws SQLException;
getMaxTablesInSelect() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the maximum length of a user name. * This method returns the maximum length of a user name.
* *
* @return The maximum length of a user name. * @return The maximum length of a user name.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxUserNameLength() throws SQLException;
getMaxUserNameLength() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the default transaction isolation level of the * This method returns the default transaction isolation level of the
* database. * database.
* *
* @return The default transaction isolation level of the database. * @return The default transaction isolation level of the database.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see Connection * @see Connection
*/ */
public abstract int public int getDefaultTransactionIsolation() throws SQLException;
getDefaultTransactionIsolation() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database supports transactions. * This method tests whether or not the database supports transactions.
* *
* @return <code>true</code> if the database supports transactions, * @return <code>true</code> if the database supports transactions,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsTransactions() throws SQLException;
supportsTransactions() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the database supports the specified * This method tests whether or not the database supports the specified
* transaction isolation level. * transaction isolation level.
* *
...@@ -1770,71 +1323,54 @@ supportsTransactions() throws SQLException; ...@@ -1770,71 +1323,54 @@ supportsTransactions() throws SQLException;
* *
* @return <code>true</code> if the specified transaction isolation level * @return <code>true</code> if the specified transaction isolation level
* is supported, <code>false</code> otherwise. * is supported, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsTransactionIsolationLevel(int level) throws
supportsTransactionIsolationLevel(int level) throws SQLException; SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not DDL and DML statements allowed within * This method tests whether or not DDL and DML statements allowed within
* the same transaction. * the same transaction.
* *
* @return <code>true</code> if DDL and DML statements are allowed in the * @return <code>true</code> if DDL and DML statements are allowed in the
* same transaction, <code>false</code> otherwise. * same transaction, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsDataDefinitionAndDataManipulationTransactions()
supportsDataDefinitionAndDataManipulationTransactions() throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not only DML statement are allowed * This method tests whether or not only DML statement are allowed
* inside a transaction. * inside a transaction.
* *
* @return <code>true</code> if only DML statements are allowed in * @return <code>true</code> if only DML statements are allowed in
* transactions, <code>false</code> otherwise. * transactions, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsDataManipulationTransactionsOnly() throws
supportsDataManipulationTransactionsOnly() throws SQLException; SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not a DDL statement will cause the * This method tests whether or not a DDL statement will cause the
* current transaction to be automatically committed. * current transaction to be automatically committed.
* *
* @return <code>true</code> if DDL causes an immediate transaction commit, * @return <code>true</code> if DDL causes an immediate transaction commit,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean dataDefinitionCausesTransactionCommit() throws SQLException;
dataDefinitionCausesTransactionCommit() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not DDL statements are ignored in * This method tests whether or not DDL statements are ignored in
* transactions. * transactions.
* *
* @return <code>true</code> if DDL statements are ignored in transactions, * @return <code>true</code> if DDL statements are ignored in transactions,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean dataDefinitionIgnoredInTransactions() throws SQLException;
dataDefinitionIgnoredInTransactions() throws SQLException;
/*************************************************************************/
/** /**
* This method returns a list of all the stored procedures matching the * This method returns a list of all the stored procedures matching the
* specified pattern in the given schema and catalog. This is returned * specified pattern in the given schema and catalog. This is returned
* a <code>ResultSet</code> with the following columns: * a <code>ResultSet</code> with the following columns:
...@@ -1860,18 +1396,13 @@ dataDefinitionIgnoredInTransactions() throws SQLException; ...@@ -1860,18 +1396,13 @@ dataDefinitionIgnoredInTransactions() throws SQLException;
* @param schemaPattern A schema pattern for the schemas to return stored * @param schemaPattern A schema pattern for the schemas to return stored
* procedures from, or "" to return procedures from all schemas. * procedures from, or "" to return procedures from all schemas.
* @param namePattern The pattern of procedures names to return. * @param namePattern The pattern of procedures names to return.
*
* @returns A <code>ResultSet</code> with all the requested procedures. * @returns A <code>ResultSet</code> with all the requested procedures.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getProcedures(String catalog, String schemaPattern, String
getProcedures(String catalog, String schemaPattern, String namePattern) procedureNamePattern) throws SQLException;
throws SQLException;
/*************************************************************************/ /**
/**
* This method returns a list of the parameter and result columns for * This method returns a list of the parameter and result columns for
* the requested stored procedures. This is returned in the form of a * the requested stored procedures. This is returned in the form of a
* <code>ResultSet</code> with the following columns: * <code>ResultSet</code> with the following columns:
...@@ -1907,18 +1438,14 @@ getProcedures(String catalog, String schemaPattern, String namePattern) ...@@ -1907,18 +1438,14 @@ getProcedures(String catalog, String schemaPattern, String namePattern)
* procedures from, or "" to return procedures from all schemas. * procedures from, or "" to return procedures from all schemas.
* @param namePattern The pattern of procedures names to return. * @param namePattern The pattern of procedures names to return.
* @param columnPattern The pattern of column names to return. * @param columnPattern The pattern of column names to return.
*
* @returns A <code>ResultSet</code> with all the requested procedures. * @returns A <code>ResultSet</code> with all the requested procedures.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getProcedureColumns(String catalog, String schemaPattern,
getProcedureColumns(String catalog, String schemaPattern, String namePattern, String procedureNamePattern, String columnNamePattern) throws
String columnPattern) throws SQLException; SQLException;
/*************************************************************************/
/** /**
* This method returns a list of the requested table as a * This method returns a list of the requested table as a
* <code>ResultSet</code> with the following columns: * <code>ResultSet</code> with the following columns:
* <p> * <p>
...@@ -1937,60 +1464,43 @@ getProcedureColumns(String catalog, String schemaPattern, String namePattern, ...@@ -1937,60 +1464,43 @@ getProcedureColumns(String catalog, String schemaPattern, String namePattern,
* from, or "" to return tables from all schemas. * from, or "" to return tables from all schemas.
* @param namePattern The pattern of table names to return. * @param namePattern The pattern of table names to return.
* @param types The list of table types to include; null returns all types. * @param types The list of table types to include; null returns all types.
*
* @returns A <code>ResultSet</code> with all the requested tables. * @returns A <code>ResultSet</code> with all the requested tables.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getTables(String catalog, String schemaPattern, String
getTables(String catalog, String schemaPattern, String namePattern, tableNamePattern, String[] types) throws SQLException;
String types[]) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the list of database schemas as a * This method returns the list of database schemas as a
* <code>ResultSet</code>, with one column - TABLE_SCHEM - that is the * <code>ResultSet</code>, with one column - TABLE_SCHEM - that is the
* name of the schema. * name of the schema.
* *
* @return A <code>ResultSet</code> with all the requested schemas. * @return A <code>ResultSet</code> with all the requested schemas.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getSchemas() throws SQLException;
getSchemas() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the list of database catalogs as a * This method returns the list of database catalogs as a
* <code>ResultSet</code> with one column - TABLE_CAT - that is the * <code>ResultSet</code> with one column - TABLE_CAT - that is the
* name of the catalog. * name of the catalog.
* *
* @return A <code>ResultSet</code> with all the requested catalogs. * @return A <code>ResultSet</code> with all the requested catalogs.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getCatalogs() throws SQLException;
getCatalogs() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the list of database table types as a * This method returns the list of database table types as a
* <code>ResultSet</code> with one column - TABLE_TYPE - that is the * <code>ResultSet</code> with one column - TABLE_TYPE - that is the
* name of the table type. * name of the table type.
* *
* @return A <code>ResultSet</code> with all the requested table types. * @return A <code>ResultSet</code> with all the requested table types.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getTableTypes() throws SQLException;
getTableTypes() throws SQLException;
/*************************************************************************/
/** /**
* This method returns a list of the tables columns for * This method returns a list of the tables columns for
* the requested tables. This is returned in the form of a * the requested tables. This is returned in the form of a
* <code>ResultSet</code> with the following columns: * <code>ResultSet</code> with the following columns:
...@@ -2028,18 +1538,13 @@ getTableTypes() throws SQLException; ...@@ -2028,18 +1538,13 @@ getTableTypes() throws SQLException;
* tables from, or "" to return tables from all schemas. * tables from, or "" to return tables from all schemas.
* @param namePattern The pattern of tables names to return. * @param namePattern The pattern of tables names to return.
* @param columnPattern The pattern of column names to return. * @param columnPattern The pattern of column names to return.
*
* @returns A <code>ResultSet</code> with all the requested tables. * @returns A <code>ResultSet</code> with all the requested tables.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getColumns(String catalog, String schemaPattern, String
getColumns(String catalog, String schemaPattern, String namePattern, tableNamePattern, String columnNamePattern) throws SQLException;
String columnPattern) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the access rights that have been granted to the * This method returns the access rights that have been granted to the
* requested columns. This information is returned as a <code>ResultSet</code> * requested columns. This information is returned as a <code>ResultSet</code>
* with the following columns: * with the following columns:
...@@ -2065,18 +1570,13 @@ getColumns(String catalog, String schemaPattern, String namePattern, ...@@ -2065,18 +1570,13 @@ getColumns(String catalog, String schemaPattern, String namePattern,
* to return entities not associated with a schema. * to return entities not associated with a schema.
* @param table The table name to return information for. * @param table The table name to return information for.
* @param columnPattern A pattern of column names to return information for. * @param columnPattern A pattern of column names to return information for.
*
* @return A <code>ResultSet</code> with all the requested privileges. * @return A <code>ResultSet</code> with all the requested privileges.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getColumnPrivileges(String catalog, String schema, String
getColumnPrivileges(String catalog, String schema, String table, table, String columnNamePattern) throws SQLException;
String columnPattern) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the access rights that have been granted to the * This method returns the access rights that have been granted to the
* requested tables. This information is returned as a <code>ResultSet</code> * requested tables. This information is returned as a <code>ResultSet</code>
* with the following columns: * with the following columns:
...@@ -2101,18 +1601,13 @@ getColumnPrivileges(String catalog, String schema, String table, ...@@ -2101,18 +1601,13 @@ getColumnPrivileges(String catalog, String schema, String table,
* to return entities not associated with a schema. * to return entities not associated with a schema.
* @param tablePattern The table name pattern of tables to return * @param tablePattern The table name pattern of tables to return
* information for. * information for.
*
* @return A <code>ResultSet</code> with all the requested privileges. * @return A <code>ResultSet</code> with all the requested privileges.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getTablePrivileges(String catalog, String schemaPattern,
getTablePrivileges(String catalog, String schema, String table) String tableNamePattern) throws SQLException;
throws SQLException;
/*************************************************************************/
/** /**
* This method returns the best set of columns for uniquely identifying * This method returns the best set of columns for uniquely identifying
* a row. It returns this information as a <code>ResultSet</code> with * a row. It returns this information as a <code>ResultSet</code> with
* the following columns: * the following columns:
...@@ -2144,18 +1639,13 @@ getTablePrivileges(String catalog, String schema, String table) ...@@ -2144,18 +1639,13 @@ getTablePrivileges(String catalog, String schema, String table)
* @param scope One of the best row id scope constants from this class. * @param scope One of the best row id scope constants from this class.
* @param nullable <code>true</code> to include columns that are nullable, * @param nullable <code>true</code> to include columns that are nullable,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @return A <code>ResultSet</code> with the best row identifier. * @return A <code>ResultSet</code> with the best row identifier.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getBestRowIdentifier(String catalog, String schema,
getBestRowIdentifier(String catalog, String schema, String table, String table, int scope, boolean nullable) throws SQLException;
int scope, boolean nullable) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the set of columns that are automatically updated * This method returns the set of columns that are automatically updated
* when the row is update. It returns this information as a * when the row is update. It returns this information as a
* <code>ResultSet</code> with the following columns: * <code>ResultSet</code> with the following columns:
...@@ -2182,18 +1672,13 @@ getBestRowIdentifier(String catalog, String schema, String table, ...@@ -2182,18 +1672,13 @@ getBestRowIdentifier(String catalog, String schema, String table,
* to return entities not associated with a schema. * to return entities not associated with a schema.
* @param table The table name to return information for. * @param table The table name to return information for.
* @param columnPattern A pattern of column names to return information for. * @param columnPattern A pattern of column names to return information for.
*
* @return A <code>ResultSet</code> with the version columns. * @return A <code>ResultSet</code> with the version columns.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getVersionColumns(String catalog, String schema,
getVersionColumns(String catalog, String schema, String table) String table) throws SQLException;
throws SQLException;
/*************************************************************************/
/** /**
* This method returns a list of a table's primary key columns. These * This method returns a list of a table's primary key columns. These
* are returned as a <code>ResultSet</code> with the following columns. * are returned as a <code>ResultSet</code> with the following columns.
* <p> * <p>
...@@ -2213,18 +1698,13 @@ getVersionColumns(String catalog, String schema, String table) ...@@ -2213,18 +1698,13 @@ getVersionColumns(String catalog, String schema, String table)
* to return entities not associated with a schema. * to return entities not associated with a schema.
* @param table The table name to return information for. * @param table The table name to return information for.
* @param columnPattern A pattern of column names to return information for. * @param columnPattern A pattern of column names to return information for.
*
* @return A <code>ResultSet</code> with the primary key columns. * @return A <code>ResultSet</code> with the primary key columns.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getPrimaryKeys(String catalog, String schema, String table)
getPrimaryKeys(String catalog, String schema, String table)
throws SQLException; throws SQLException;
/*************************************************************************/ /**
/**
* This method returns a list of the table's foreign keys. These are * This method returns a list of the table's foreign keys. These are
* returned as a <code>ResultSet</code> with the following columns: * returned as a <code>ResultSet</code> with the following columns:
* <p> * <p>
...@@ -2266,13 +1746,10 @@ getPrimaryKeys(String catalog, String schema, String table) ...@@ -2266,13 +1746,10 @@ getPrimaryKeys(String catalog, String schema, String table)
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getImportedKeys(String catalog, String schema,
getImportedKeys(String catalog, String schema, String table) String table) throws SQLException;
throws SQLException;
/*************************************************************************/
/** /**
* This method returns a list of the table's which use this table's * This method returns a list of the table's which use this table's
* primary key as a foreign key. The information is * primary key as a foreign key. The information is
* returned as a <code>ResultSet</code> with the following columns: * returned as a <code>ResultSet</code> with the following columns:
...@@ -2310,18 +1787,13 @@ getImportedKeys(String catalog, String schema, String table) ...@@ -2310,18 +1787,13 @@ getImportedKeys(String catalog, String schema, String table)
* @param schema The schema to retrieve information from, or the empty string * @param schema The schema to retrieve information from, or the empty string
* to return entities not associated with a schema. * to return entities not associated with a schema.
* @param table The table name to return information for. * @param table The table name to return information for.
*
* @return A <code>ResultSet</code> with the requested information * @return A <code>ResultSet</code> with the requested information
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getExportedKeys(String catalog, String schema,
getExportedKeys(String catalog, String schema, String table) String table) throws SQLException;
throws SQLException;
/*************************************************************************/
/** /**
* This method returns a description of how one table imports another * This method returns a description of how one table imports another
* table's primary key as a foreign key. The information is * table's primary key as a foreign key. The information is
* returned as a <code>ResultSet</code> with the following columns: * returned as a <code>ResultSet</code> with the following columns:
...@@ -2367,19 +1839,14 @@ getExportedKeys(String catalog, String schema, String table) ...@@ -2367,19 +1839,14 @@ getExportedKeys(String catalog, String schema, String table)
* to return entities not associated with a schema on the importing side. * to return entities not associated with a schema on the importing side.
* @param forTable The table name to return information for on the importing * @param forTable The table name to return information for on the importing
* side. * side.
*
* @return A <code>ResultSet</code> with the requested information * @return A <code>ResultSet</code> with the requested information
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getCrossReference(String primaryCatalog, String
getCrossReference(String primCatalog, String primSchema, String primTable, primarySchema, String primaryTable, String foreignCatalog, String
String forCatalog, String forSchema, String forTable) foreignSchema, String foreignTable) throws SQLException;
throws SQLException;
/*************************************************************************/
/** /**
* This method returns a list of the SQL types supported by this * This method returns a list of the SQL types supported by this
* database. The information is returned as a <code>ResultSet</code> * database. The information is returned as a <code>ResultSet</code>
* with the following columns: * with the following columns:
...@@ -2416,15 +1883,11 @@ getCrossReference(String primCatalog, String primSchema, String primTable, ...@@ -2416,15 +1883,11 @@ getCrossReference(String primCatalog, String primSchema, String primTable,
* </ol> * </ol>
* *
* @return A <code>ResultSet</code> with the list of available data types. * @return A <code>ResultSet</code> with the list of available data types.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getTypeInfo() throws SQLException;
getTypeInfo() throws SQLException;
/*************************************************************************/
/** /**
* This method returns information about a tables indices and statistics. * This method returns information about a tables indices and statistics.
* It is returned as a <code>ResultSet</code> with the following columns: * It is returned as a <code>ResultSet</code> with the following columns:
* <p> * <p>
...@@ -2454,8 +1917,8 @@ getTypeInfo() throws SQLException; ...@@ -2454,8 +1917,8 @@ getTypeInfo() throws SQLException;
* </ol> * </ol>
* *
* @param catalog The catalog to retrieve information from, or the empty string * @param catalog The catalog to retrieve information from, or the empty string
* to return entities not associated with a catalog, or <code>null</code> * to return entities not associated with a catalog, or
* to return information from all catalogs. * <code>null</code> to return information from all catalogs.
* @param schema The schema to retrieve information from, or the empty string * @param schema The schema to retrieve information from, or the empty string
* to return entities not associated with a schema. * to return entities not associated with a schema.
* @param table The table name to return information for. * @param table The table name to return information for.
...@@ -2463,18 +1926,13 @@ getTypeInfo() throws SQLException; ...@@ -2463,18 +1926,13 @@ getTypeInfo() throws SQLException;
* <code>false</code> otherwise. * <code>false</code> otherwise.
* @param approx <code>true</code> if data values can be approximations, * @param approx <code>true</code> if data values can be approximations,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @return A <code>ResultSet</code> with the requested index information * @return A <code>ResultSet</code> with the requested index information
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getIndexInfo(String catalog, String schema, String table,
getIndexInfo(String catalog, String schema, String table, boolean unique, boolean unique, boolean approximate) throws SQLException;
boolean approx) throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the datbase supports the specified * This method tests whether or not the datbase supports the specified
* result type. * result type.
* *
...@@ -2488,12 +1946,9 @@ getIndexInfo(String catalog, String schema, String table, boolean unique, ...@@ -2488,12 +1946,9 @@ getIndexInfo(String catalog, String schema, String table, boolean unique,
* *
* @see ResultSet * @see ResultSet
*/ */
public abstract boolean public boolean supportsResultSetType(int type) throws SQLException;
supportsResultSetType(int type) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether the specified result set type and result set * This method tests whether the specified result set type and result set
* concurrency type are supported by the database. * concurrency type are supported by the database.
* *
...@@ -2501,204 +1956,141 @@ supportsResultSetType(int type) throws SQLException; ...@@ -2501,204 +1956,141 @@ supportsResultSetType(int type) throws SQLException;
* defined in <code>ResultSet</code>. * defined in <code>ResultSet</code>.
* @param concur The desired concurrency type, which is one of the constants * @param concur The desired concurrency type, which is one of the constants
* defined in <code>ResultSet</code>. * defined in <code>ResultSet</code>.
*
* @return <code>true</code> if the result set type is supported, * @return <code>true</code> if the result set type is supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract boolean public boolean supportsResultSetConcurrency(int type, int concurrency)
supportsResultSetConcurrency(int type, int concur) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the specified result set type sees its * This method tests whether or not the specified result set type sees its
* own updates. * own updates.
* *
* @param type The desired result type, which is one of the constants * @param type The desired result type, which is one of the constants
* defined in <code>ResultSet</code>. * defined in <code>ResultSet</code>.
*
* @return <code>true</code> if the result set type sees its own updates, * @return <code>true</code> if the result set type sees its own updates,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract boolean public boolean ownUpdatesAreVisible(int type) throws SQLException;
ownUpdatesAreVisible(int type) throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the specified result set type sees its * This method tests whether or not the specified result set type sees its
* own deletes. * own deletes.
* *
* @param type The desired result type, which is one of the constants * @param type The desired result type, which is one of the constants
* defined in <code>ResultSet</code>. * defined in <code>ResultSet</code>.
*
* @return <code>true</code> if the result set type sees its own deletes, * @return <code>true</code> if the result set type sees its own deletes,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract boolean public boolean ownDeletesAreVisible(int type) throws SQLException;
ownDeletesAreVisible(int type) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the specified result set type sees its * This method tests whether or not the specified result set type sees its
* own inserts. * own inserts.
* *
* @param type The desired result type, which is one of the constants * @param type The desired result type, which is one of the constants
* defined in <code>ResultSet</code>. * defined in <code>ResultSet</code>.
*
* @return <code>true</code> if the result set type sees its own inserts, * @return <code>true</code> if the result set type sees its own inserts,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract boolean public boolean ownInsertsAreVisible(int type) throws SQLException;
ownInsertsAreVisible(int type) throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the specified result set type sees * This method tests whether or not the specified result set type sees
* updates committed by others. * updates committed by others.
* *
* @param type The desired result type, which is one of the constants * @param type The desired result type, which is one of the constants
* defined in <code>ResultSet</code>. * defined in <code>ResultSet</code>.
*
* @return <code>true</code> if the result set type sees other updates, * @return <code>true</code> if the result set type sees other updates,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract boolean public boolean othersUpdatesAreVisible(int type) throws SQLException;
othersUpdatesAreVisible(int type) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the specified result set type sees * This method tests whether or not the specified result set type sees
* deletes committed by others. * deletes committed by others.
* *
* @param type The desired result type, which is one of the constants * @param type The desired result type, which is one of the constants
* defined in <code>ResultSet</code>. * defined in <code>ResultSet</code>.
*
* @return <code>true</code> if the result set type sees other deletes, * @return <code>true</code> if the result set type sees other deletes,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract boolean public boolean othersDeletesAreVisible(int type) throws SQLException;
othersDeletesAreVisible(int type) throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the specified result set type sees * This method tests whether or not the specified result set type sees
* inserts committed by others. * inserts committed by others.
* *
* @param type The desired result type, which is one of the constants * @param type The desired result type, which is one of the constants
* defined in <code>ResultSet</code>. * defined in <code>ResultSet</code>.
*
* @return <code>true</code> if the result set type sees other inserts, * @return <code>true</code> if the result set type sees other inserts,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract boolean public boolean othersInsertsAreVisible(int type) throws SQLException;
othersInsertsAreVisible(int type) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the specified result set type can detect * This method tests whether or not the specified result set type can detect
* a visible update by calling the <code>rowUpdated</code> method. * a visible update by calling the <code>rowUpdated</code> method.
* *
* @param type The desired result type, which is one of the constants * @param type The desired result type, which is one of the constants
* defined in <code>ResultSet</code>. * defined in <code>ResultSet</code>.
*
* @return <code>true</code> if the result set type can detect visible updates * @return <code>true</code> if the result set type can detect visible updates
* using <code>rowUpdated</code>, <code>false</code> otherwise. * using <code>rowUpdated</code>, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract boolean public boolean updatesAreDetected(int type) throws SQLException;
updatesAreDetected(int type) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the specified result set type can detect * This method tests whether or not the specified result set type can detect
* a visible delete by calling the <code>rowUpdated</code> method. * a visible delete by calling the <code>rowUpdated</code> method.
* *
* @param type The desired result type, which is one of the constants * @param type The desired result type, which is one of the constants
* defined in <code>ResultSet</code>. * defined in <code>ResultSet</code>.
*
* @return <code>true</code> if the result set type can detect visible deletes * @return <code>true</code> if the result set type can detect visible deletes
* using <code>rowUpdated</code>, <code>false</code> otherwise. * using <code>rowUpdated</code>, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract boolean public boolean deletesAreDetected(int type) throws SQLException;
deletesAreDetected(int type) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the specified result set type can detect * This method tests whether or not the specified result set type can detect
* a visible insert by calling the <code>rowUpdated</code> method. * a visible insert by calling the <code>rowUpdated</code> method.
* *
* @param type The desired result type, which is one of the constants * @param type The desired result type, which is one of the constants
* defined in <code>ResultSet</code>. * defined in <code>ResultSet</code>.
*
* @return <code>true</code> if the result set type can detect visible inserts * @return <code>true</code> if the result set type can detect visible inserts
* using <code>rowUpdated</code>, <code>false</code> otherwise. * using <code>rowUpdated</code>, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract boolean public boolean insertsAreDetected(int type) throws SQLException;
insertsAreDetected(int type) throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the database supports batch updates. * This method tests whether or not the database supports batch updates.
* *
* @return <code>true</code> if batch updates are supported, * @return <code>true</code> if batch updates are supported,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean supportsBatchUpdates() throws SQLException;
supportsBatchUpdates() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the list of user defined data types in use. These * This method returns the list of user defined data types in use. These
* are returned as a <code>ResultSet</code> with the following columns: * are returned as a <code>ResultSet</code> with the following columns:
* <p> * <p>
...@@ -2721,27 +2113,102 @@ supportsBatchUpdates() throws SQLException; ...@@ -2721,27 +2113,102 @@ supportsBatchUpdates() throws SQLException;
* @param typePattern The type name pattern to match. * @param typePattern The type name pattern to match.
* @param types The type identifier patterns (from <code>Types</code>) to * @param types The type identifier patterns (from <code>Types</code>) to
* match. * match.
*
* @return A <code>ResultSet</code> with the requested type information * @return A <code>ResultSet</code> with the requested type information
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet getUDTs(String catalog, String schemaPattern, String
getUDTs(String catalog, String schema, String typePattern, int[] types) typeNamePattern, int[] types) throws SQLException;
throws SQLException;
/*************************************************************************/
/** /**
* This method returns the <code>Connection</code> object that was used * This method returns the <code>Connection</code> object that was used
* to generate the metadata in this object. * to generate the metadata in this object.
* *
* @return The connection for this object. * @return The connection for this object.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Connection public Connection getConnection() throws SQLException;
getConnection() throws SQLException;
/**
* @since 1.4
*/
public boolean supportsSavepoints() throws SQLException;
/**
* @since 1.4
*/
public boolean supportsNamedParameters() throws SQLException;
/**
* @since 1.4
*/
public boolean supportsMultipleOpenResults() throws SQLException;
/**
* @since 1.4
*/
public boolean supportsGetGeneratedKeys() throws SQLException;
/**
* @since 1.4
*/
public ResultSet getSuperTypes(String catalog, String schemaPattern,
String typeNamePattern) throws SQLException;
/**
* @since 1.4
*/
public ResultSet getSuperTables(String catalog, String schemaPattern,
String tableNamePattern) throws SQLException;
/**
* @since 1.4
*/
public ResultSet getAttributes(String catalog, String schemaPattern, String
typeNamePattern, String attributeNamePattern) throws SQLException;
/**
* @since 1.4
*/
public boolean supportsResultSetHoldability(int holdability)
throws SQLException;
/**
* @since 1.4
*/
public int getResultSetHoldability() throws SQLException;
/**
* @since 1.4
*/
public int getDatabaseMajorVersion() throws SQLException;
} // interface DatabaseMetaData /**
* @since 1.4
*/
public int getDatabaseMinorVersion() throws SQLException;
/**
* @since 1.4
*/
public int getJDBCMajorVersion() throws SQLException;
/**
* @since 1.4
*/
public int getJDBCMinorVersion() throws SQLException;
/**
* @since 1.4
*/
public int getSQLStateType() throws SQLException;
/**
* @since 1.4
*/
public boolean locatorsUpdateCopy() throws SQLException;
/**
* @since 1.4
*/
public boolean supportsStatementPooling() throws SQLException;
}
...@@ -35,7 +35,6 @@ this exception to your version of the library, but you are not ...@@ -35,7 +35,6 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
import java.text.SimpleDateFormat; import java.text.SimpleDateFormat;
...@@ -48,56 +47,14 @@ import java.text.SimpleDateFormat; ...@@ -48,56 +47,14 @@ import java.text.SimpleDateFormat;
*/ */
public class Date extends java.util.Date public class Date extends java.util.Date
{ {
static final long serialVersionUID = 1511598038487230103L;
/* /**
* Class Variables
*/
/**
* Used for parsing and formatting this date. * Used for parsing and formatting this date.
*/ */
private static SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); private static SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
/** /**
* This is the serialization UID for this class.
*/
private static final long serialVersionUID = 1511598038487230103L;
/*************************************************************************/
/*
* Class Methods
*/
/**
* This method returns a new instance of this class by parsing a
* date in JDBC format into a Java date.
*
* @param str The string to parse.
*
* @return The resulting <code>java.sql.Date</code> value.
*/
public static Date
valueOf(String str)
{
try
{
java.util.Date d = (java.util.Date)sdf.parseObject(str);
return(new Date(d.getTime()));
}
catch(Exception e)
{
return(null);
}
}
/*************************************************************************/
/*
* Constructors
*/
/**
* This method initializes a new instance of this class with the * This method initializes a new instance of this class with the
* specified year, month, and day. * specified year, month, and day.
* *
...@@ -107,43 +64,50 @@ valueOf(String str) ...@@ -107,43 +64,50 @@ valueOf(String str)
* *
* @deprecated * @deprecated
*/ */
public public Date(int year, int month, int day)
Date(int year, int month, int day) {
{
super(year, month, day); super(year, month, day);
} }
/*************************************************************************/
/** /**
* This method initializes a new instance of this class with the * This method initializes a new instance of this class with the
* specified time value representing the number of seconds since * specified time value representing the number of seconds since
* Jan 1, 1970 at 12:00 midnight GMT. * Jan 1, 1970 at 12:00 midnight GMT.
* *
* @param time The time value to intialize this date to. * @param time The time value to intialize this date to.
*/ */
public public Date(long date)
Date(long date) {
{
super(date); super(date);
} }
/*************************************************************************/
/* /**
* Instance Methods * This method returns a new instance of this class by parsing a
* date in JDBC format into a Java date.
*
* @param str The string to parse.
* @return The resulting <code>java.sql.Date</code> value.
*/ */
public static Date valueOf(String str)
{
try
{
java.util.Date d = (java.util.Date) sdf.parseObject(str);
return(new Date(d.getTime()));
}
catch(Exception e)
{
return(null);
}
}
/** /**
* This method returns this date in JDBC format. * This method returns this date in JDBC format.
* *
* @return This date as a string. * @return This date as a string.
*/ */
public String public String toString()
toString() {
{
return(sdf.format(this)); return(sdf.format(this));
}
} }
} // class Date
...@@ -35,7 +35,6 @@ this exception to your version of the library, but you are not ...@@ -35,7 +35,6 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
import java.util.Properties; import java.util.Properties;
...@@ -56,93 +55,69 @@ import java.util.Properties; ...@@ -56,93 +55,69 @@ import java.util.Properties;
*/ */
public interface Driver public interface Driver
{ {
/**
/** * This method connects to the specified database using the connection
* This method returns the major version number of the driver. * properties supplied. If the driver does not understand the database
* * URL, it should return <code>null</code> instead of throwing an
* @return The major version number of the driver. * exception since the <code>DriverManager</code> will probe a driver
*/ * in this manner.
public abstract int
getMajorVersion();
/*************************************************************************/
/**
* This method returns the minor version number of the driver.
* *
* @return The minor version number of the driver. * @param url The URL string for this connection.
* @param properties The list of database connection properties.
* @return A <code>Connection</code> object for the newly established
* connection, or <code>null</code> if the URL is not understood.
* @exception SQLException If an error occurs.
*/ */
public abstract int public Connection connect(String url, Properties info) throws SQLException;
getMinorVersion();
/*************************************************************************/
/** /**
* This method tests whether or not the driver is JDBC compliant. This * This method tests whether or not the driver believes it can connect to
* method should only return <code>true</code> if the driver has been * the specified database. The driver should only test whether it
* certified as JDBC compliant. * understands and accepts the URL. It should not necessarily attempt to
* probe the database for a connection.
* *
* @return <code>true</code> if the driver has been certified JDBC compliant, * @param The database URL string.
* @return <code>true</code> if the drivers can connect to the database,
* <code>false</code> otherwise. * <code>false</code> otherwise.
* @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean acceptsURL(String url) throws SQLException;
jdbcCompliant();
/*************************************************************************/ /**
/**
* This method returns an array of possible properties that could be * This method returns an array of possible properties that could be
* used to connect to the specified database. * used to connect to the specified database.
* *
* @param url The URL string of the database to connect to. * @param url The URL string of the database to connect to.
* @param properties The list of properties the caller is planning to use * @param properties The list of properties the caller is planning to use
* to connect to the database. * to connect to the database.
*
* @return A list of possible additional properties for a connection to this * @return A list of possible additional properties for a connection to this
* database. This list may be empty. * database. This list may be empty.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract DriverPropertyInfo[] public DriverPropertyInfo[] getPropertyInfo(String url, Properties properties)
getPropertyInfo(String url, Properties properties) throws SQLException; throws SQLException;
/*************************************************************************/ /**
* This method returns the major version number of the driver.
/**
* This method tests whether or not the driver believes it can connect to
* the specified database. The driver should only test whether it
* understands and accepts the URL. It should not necessarily attempt to
* probe the database for a connection.
*
* @param The database URL string.
*
* @return <code>true</code> if the drivers can connect to the database,
* <code>false</code> otherwise.
* *
* @exception SQLException If an error occurs. * @return The major version number of the driver.
*/ */
public abstract boolean public int getMajorVersion();
acceptsURL(String url) throws SQLException;
/*************************************************************************/
/** /**
* This method connects to the specified database using the connection * This method returns the minor version number of the driver.
* properties supplied. If the driver does not understand the database
* URL, it should return <code>null</code> instead of throwing an
* exception since the <code>DriverManager</code> will probe a driver
* in this manner.
*
* @param url The URL string for this connection.
* @param properties The list of database connection properties.
*
* @return A <code>Connection</code> object for the newly established
* connection, or <code>null</code> if the URL is not understood.
* *
* @exception SQLException If an error occurs. * @return The minor version number of the driver.
*/ */
public abstract Connection public int getMinorVersion();
connect(String url, Properties properties) throws SQLException;
} // interface Driver
/**
* This method tests whether or not the driver is JDBC compliant. This
* method should only return <code>true</code> if the driver has been
* certified as JDBC compliant.
*
* @return <code>true</code> if the driver has been certified JDBC compliant,
* <code>false</code> otherwise.
*/
public boolean jdbcCompliant();
}
...@@ -35,15 +35,14 @@ this exception to your version of the library, but you are not ...@@ -35,15 +35,14 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
import java.io.PrintStream; import java.io.PrintStream;
import java.io.PrintWriter; import java.io.PrintWriter;
import java.util.Enumeration; import java.util.Enumeration;
import java.util.Properties; import java.util.Properties;
import java.util.StringTokenizer;
import java.util.Vector; import java.util.Vector;
import java.util.StringTokenizer;
/** /**
* This class manages the JDBC drivers in the system. It maintains a * This class manages the JDBC drivers in the system. It maintains a
...@@ -65,36 +64,31 @@ import java.util.Vector; ...@@ -65,36 +64,31 @@ import java.util.Vector;
*/ */
public class DriverManager public class DriverManager
{ {
/**
/*
* Class Variables
*/
/**
* This is the log stream for JDBC drivers. * This is the log stream for JDBC drivers.
*/ */
private static PrintStream log_stream; private static PrintStream log_stream;
/** /**
* This is the log writer for JDBC drivers. * This is the log writer for JDBC drivers.
*/ */
private static PrintWriter log_writer; private static PrintWriter log_writer;
/** /**
* This is the login timeout used by JDBC drivers. * This is the login timeout used by JDBC drivers.
*/ */
private static int login_timeout; private static int login_timeout;
/** /**
* This is the list of JDBC drivers that are loaded. * This is the list of JDBC drivers that are loaded.
*/ */
private static Vector drivers; private static Vector drivers;
// Hmm, seems like we might want to do a Hashtable and lookup by something, // Hmm, seems like we might want to do a Hashtable and lookup by something,
// but what would it be? // but what would it be?
// Load all drivers on startup // Load all drivers on startup
static static
{ {
drivers = new Vector(); drivers = new Vector();
String driver_string = System.getProperty("jdbc.drivers"); String driver_string = System.getProperty("jdbc.drivers");
...@@ -113,118 +107,127 @@ static ...@@ -113,118 +107,127 @@ static
} }
} }
} }
/*************************************************************************/
/*
* Class Methods
*/
/**
* This method returns the login timeout in use by JDBC drivers systemwide.
*
* @return The login timeout.
*/
public static int
getLoginTimeout()
{
return(login_timeout);
}
/*************************************************************************/
/**
* This method set the login timeout used by JDBC drivers. This is a
* system-wide parameter that applies to all drivers.
*
* @param login_timeout The new login timeout value.
*/
public static void
setLoginTimeout(int login_timeout)
{
DriverManager.login_timeout = login_timeout;
}
/*************************************************************************/ /** Can't be instantiated. */
private DriverManager()
{
}
/** /**
* This method returns the log writer being used by all JDBC drivers. * This method returns the log writer being used by all JDBC drivers.
* This method should be used in place of the deprecated * This method should be used in place of the deprecated
* <code>getLogStream</code> method. * <code>getLogStream</code> method.
* *
* @return The log writer in use by JDBC drivers. * @return The log writer in use by JDBC drivers.
*/ */
public static PrintWriter public static PrintWriter getLogWriter()
getLogWriter() {
{ return log_writer;
return(log_writer); }
}
/*************************************************************************/
/** /**
* This method sets the log writer being used by JDBC drivers. This is a * This method sets the log writer being used by JDBC drivers. This is a
* system-wide parameter that affects all drivers. Note that since there * system-wide parameter that affects all drivers. Note that since there
* is no way to retrieve a <code>PrintStream</code> from a * is no way to retrieve a <code>PrintStream</code> from a
* <code>PrintWriter</code>, this method cannot set the log stream in * <code>PrintWriter</code>, this method cannot set the log stream in
* use by JDBC. Thus any older drivers may not see this setting. * use by JDBC. Thus any older drivers may not see this setting.
* *
* @param log_writer The new log writer for JDBC. * @param out The new log writer for JDBC.
*/ */
public static void public static void setLogWriter(PrintWriter out)
setLogWriter(PrintWriter log_writer) {
{ DriverManager.log_writer = out;
DriverManager.log_writer = log_writer; }
}
/*************************************************************************/
/** /**
* This method returns the log stream in use by JDBC. * This method attempts to return a connection to the specified
* JDBC URL string using the specified connection properties.
* *
* @return The log stream in use by JDBC. * @param url The JDBC URL string to connect to.
* @param properties The connection properties.
* *
* @deprecated Use <code>getLogWriter()</code> instead. * @return A <code>Connection</code> to that URL.
*
* @exception SQLException If an error occurs.
*/ */
public static PrintStream public static Connection getConnection(String url, Properties properties)
getLogStream() throws SQLException
{ {
return(log_stream); Driver d = getDriver(url);
} if (d == null)
throw new SQLException("Driver not found for URL: " + url);
/*************************************************************************/ return d.connect(url, properties);
}
/**
* This method sets the log stream in use by JDBC. /**
* * This method attempts to return a connection to the specified
* @param log_stream The log stream in use by JDBC. * JDBC URL string using the specified username and password.
* *
* @deprecated Use <code>setLogWriter</code> instead. * @param url The JDBC URL string to connect to.
* @param user The username to connect with.
* @param password The password to connect with.
* @return A <code>Connection</code> to that URL.
* @exception SQLException If an error occurs.
*/ */
public static void public static Connection getConnection(String url, String user,
setLogStream(PrintStream log_stream) String password) throws SQLException
{ {
DriverManager.log_stream = log_stream; Properties p = new Properties();
}
/*************************************************************************/ if (user != null)
p.setProperty("user", user);
if (password != null)
p.setProperty("password", password);
/** return getConnection(url, p);
* This method prints the specified line to the log stream. }
/**
* This method attempts to return a connection to the specified
* JDBC URL string.
* *
* @param str The string to write to the log stream. * @param url The JDBC URL string to connect to.
*
* @return A <code>Connection</code> to that URL.
*
* @exception SQLException If an error occurs.
*/ */
public static void public static Connection getConnection(String url) throws SQLException
println(String str) {
{ return getConnection(url, new Properties());
if (log_stream != null) // Watch for user not using logging }
log_stream.println(str);
} /**
* This method returns a driver that can connect to the specified
* JDBC URL string. This will be selected from among drivers loaded
* at initialization time and those drivers manually loaded by the
* same class loader as the caller.
*
* @param url The JDBC URL string to find a driver for.
*
* @return A <code>Driver</code> that can connect to the specified
* URL, or <code>null</code> if a suitable driver cannot be found.
*
* @exception SQLException If an error occurs.
*/
public static Driver getDriver(String url) throws SQLException
{
// FIXME: Limit driver search to the appropriate subset of loaded drivers.
Enumeration e = drivers.elements();
while(e.hasMoreElements())
{
Driver d = (Driver)e.nextElement();
if (d.acceptsURL(url))
return d;
}
/*************************************************************************/ return null;
}
/** /**
* This method registers a new driver with the manager. This is normally * This method registers a new driver with the manager. This is normally
* called by the driver itself in a static initializer. * called by the driver itself in a static initializer.
* *
...@@ -232,14 +235,11 @@ println(String str) ...@@ -232,14 +235,11 @@ println(String str)
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public static void public static void registerDriver(Driver driver) throws SQLException
registerDriver(Driver driver) throws SQLException {
{ if (! drivers.contains(driver))
if (!drivers.contains(driver))
drivers.addElement(driver); drivers.addElement(driver);
} }
/*************************************************************************/
/** /**
* This method de-registers a driver from the manager. * This method de-registers a driver from the manager.
...@@ -248,24 +248,20 @@ registerDriver(Driver driver) throws SQLException ...@@ -248,24 +248,20 @@ registerDriver(Driver driver) throws SQLException
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public static void public static void deregisterDriver(Driver driver) throws SQLException
deregisterDriver(Driver driver) throws SQLException {
{
if (drivers.contains(driver)) if (drivers.contains(driver))
drivers.removeElement(driver); drivers.removeElement(driver);
} }
/*************************************************************************/
/** /**
* This method returns a list of all the currently registered JDBC drivers * This method returns a list of all the currently registered JDBC drivers
* that were loaded by the current <code>ClassLoader</code>. * that were loaded by the current <code>ClassLoader</code>.
* *
* @return An <code>Enumeration</code> of all currently loaded JDBC drivers. * @return An <code>Enumeration</code> of all currently loaded JDBC drivers.
*/ */
public static Enumeration public static Enumeration getDrivers()
getDrivers() {
{
Vector v = new Vector(); Vector v = new Vector();
Enumeration e = drivers.elements(); Enumeration e = drivers.elements();
...@@ -280,126 +276,68 @@ getDrivers() ...@@ -280,126 +276,68 @@ getDrivers()
if (loader == null) if (loader == null)
loader = ClassLoader.getSystemClassLoader(); loader = ClassLoader.getSystemClassLoader();
if (!loader.equals(cl)) if (! loader.equals(cl))
continue; continue;
v.addElement(obj); v.addElement(obj);
} }
return(v.elements()); return v.elements();
} }
/*************************************************************************/
/** /**
* This method returns a driver that can connect to the specified * This method set the login timeout used by JDBC drivers. This is a
* JDBC URL string. This will be selected from among drivers loaded * system-wide parameter that applies to all drivers.
* at initialization time and those drivers manually loaded by the
* same class loader as the caller.
*
* @param url The JDBC URL string to find a driver for.
*
* @return A <code>Driver</code> that can connect to the specified
* URL, or <code>null</code> if a suitable driver cannot be found.
* *
* @exception SQLException If an error occurs. * @param login_timeout The new login timeout value.
*/ */
public static Driver public static void setLoginTimeout(int seconds)
getDriver(String url) throws SQLException
{
// FIXME: Limit driver search to the appropriate subset of loaded drivers.
Enumeration e = drivers.elements();
while(e.hasMoreElements())
{ {
Driver d = (Driver)e.nextElement(); DriverManager.login_timeout = login_timeout;
if (d.acceptsURL(url))
return(d);
} }
return(null); /**
} * This method returns the login timeout in use by JDBC drivers systemwide.
/*************************************************************************/
/**
* This method attempts to return a connection to the specified
* JDBC URL string.
*
* @param url The JDBC URL string to connect to.
*
* @return A <code>Connection</code> to that URL.
* *
* @exception SQLException If an error occurs. * @return The login timeout.
*/ */
public static Connection public static int getLoginTimeout()
getConnection(String url) throws SQLException {
{ return login_timeout;
return(getConnection(url, new Properties())); }
}
/*************************************************************************/
/** /**
* This method attempts to return a connection to the specified * This method sets the log stream in use by JDBC.
* JDBC URL string using the specified username and password.
*
* @param url The JDBC URL string to connect to.
* @param user The username to connect with.
* @param password The password to connect with.
* *
* @return A <code>Connection</code> to that URL. * @param log_stream The log stream in use by JDBC.
* *
* @exception SQLException If an error occurs. * @deprecated Use <code>setLogWriter</code> instead.
*/ */
public static Connection public static void setLogStream(PrintStream out)
getConnection(String url, String user, String password) throws SQLException {
{ DriverManager.log_stream = log_stream;
Properties p = new Properties(); }
if (user != null)
p.setProperty("user", user);
if (password != null)
p.setProperty("password", password);
return(getConnection(url, p));
}
/*************************************************************************/
/** /**
* This method attempts to return a connection to the specified * This method returns the log stream in use by JDBC.
* JDBC URL string using the specified connection properties.
*
* @param url The JDBC URL string to connect to.
* @param properties The connection properties.
* *
* @return A <code>Connection</code> to that URL. * @return The log stream in use by JDBC.
* *
* @exception SQLException If an error occurs. * @deprecated Use <code>getLogWriter()</code> instead.
*/ */
public static Connection public static PrintStream getLogStream()
getConnection(String url, Properties properties) throws SQLException {
{ return log_stream;
Driver d = getDriver(url); }
if (d == null)
throw new SQLException("Driver not found for URL: " + url);
return(d.connect(url, properties));
}
/*************************************************************************/
/* /**
* Constructors * This method prints the specified line to the log stream.
*
* @param str The string to write to the log stream.
*/ */
public static void println(String message)
// Keep bozos from trying to instantiate us. {
private if (log_stream != null) // Watch for user not using logging
DriverManager() log_stream.println(message);
{ }
;
} }
} // class DriverManager
...@@ -46,57 +46,43 @@ package java.sql; ...@@ -46,57 +46,43 @@ package java.sql;
*/ */
public class DriverPropertyInfo public class DriverPropertyInfo
{ {
/**
/*
* Instance Variables
*/
/**
* The name of the property. * The name of the property.
*/ */
public String name; public String name;
/** /**
* This is the value of the property.
*/
public String value;
/**
* A description of the property, possibly <code>null</code>. * A description of the property, possibly <code>null</code>.
*/ */
public String description; public String description;
/** /**
* A flag indicating whether or not a value for this property is required * A flag indicating whether or not a value for this property is required
* in order to connect to the database. * in order to connect to the database.
*/ */
public boolean required; public boolean required;
/** /**
* If values are restricted to certain choices, this is the list of valid * This is the value of the property.
* ones. Otherwise it is <code>null</code>.
*/ */
public String[] choices; public String value;
/*************************************************************************/ /**
* If values are restricted to certain choices, this is the list of valid
/* * ones. Otherwise it is <code>null</code>.
* Constructors
*/ */
public String[] choices;
/** /**
* This method initializes a new instance of <code>DriverPropertyInfo</code> * This method initializes a new instance of <code>DriverPropertyInfo</code>
* with the specified name and value. All other fields are defaulted. * with the specified name and value. All other fields are defaulted.
* *
* @param name The name of the property. * @param name The name of the property.
* @param value The value to assign to the property. * @param value The value to assign to the property.
*/ */
public public DriverPropertyInfo(String name, String value)
DriverPropertyInfo(String name, String value) {
{
this.name = name; this.name = name;
this.value = value; this.value = value;
}
} }
} // DriverPropertyInfo
/* ParameterMetaData.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package java.sql;
/**
* @since 1.4
*/
public interface ParameterMetaData
{
public static final int parameterNoNulls = 0;
public static final int parameterNullable = 1;
public static final int parameterNullableUnknown = 2;
public static final int parameterModeUnknown = 0;
public static final int parameterModeIn = 1;
public static final int parameterModeInOut = 2;
public static final int parameterModeOut = 4;
/**
* @since 1.4
*/
public int getParameterCount() throws SQLException;
/**
* @since 1.4
*/
public int isNullable(int param) throws SQLException;
/**
* @since 1.4
*/
public boolean isSigned(int param) throws SQLException;
/**
* @since 1.4
*/
public int getPrecision(int param) throws SQLException;
/**
* @since 1.4
*/
public int getScale(int param) throws SQLException;
/**
* @since 1.4
*/
public int getParameterType(int param) throws SQLException;
/**
* @since 1.4
*/
public String getParameterTypeName(int param) throws SQLException;
/**
* @since 1.4
*/
public String getParameterClassName(int param) throws SQLException;
/**
* @since 1.4
*/
public int getParameterMode(int param) throws SQLException;
}
...@@ -35,12 +35,12 @@ this exception to your version of the library, but you are not ...@@ -35,12 +35,12 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
import java.io.InputStream; import java.io.InputStream;
import java.io.Reader; import java.io.Reader;
import java.math.BigDecimal; import java.math.BigDecimal;
import java.net.URL;
import java.util.Calendar; import java.util.Calendar;
/** /**
...@@ -53,505 +53,386 @@ import java.util.Calendar; ...@@ -53,505 +53,386 @@ import java.util.Calendar;
*/ */
public interface PreparedStatement extends Statement public interface PreparedStatement extends Statement
{ {
/**
/** * This method executes a prepared SQL query and returns its ResultSet.
* This method populates the specified parameter with a SQL NULL value
* for the specified type.
*
* @param index The index of the parameter to set.
* @param type The SQL type identifier of the parameter from <code>Types</code>
* *
* @return The ResultSet of the SQL statement.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public ResultSet executeQuery() throws SQLException;
setNull(int index, int type) throws SQLException;
/*************************************************************************/ /**
* This method executes an SQL INSERT, UPDATE or DELETE statement. SQL
* statements that return nothing such as SQL DDL statements can be executed.
*
* @return The result is either the row count for INSERT, UPDATE or DELETE
* statements; or 0 for SQL statements that return nothing.
* @exception SQLException If an error occurs.
*/
public int executeUpdate() throws SQLException;
/** /**
* This method populates the specified parameter with a SQL NULL value * This method populates the specified parameter with a SQL NULL value
* for the specified type. * for the specified type.
* *
* @param index The index of the parameter to set. * @param index The index of the parameter to set.
* @param type The SQL type identifier of the parameter from <code>Types</code> * @param type The SQL type identifier of the parameter from <code>Types</code>
* @param name The name of the data type, for user defined types.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setNull(int parameterIndex, int sqlType) throws SQLException;
setNull(int index, int type, String name) throws SQLException;
/*************************************************************************/ /**
/**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>boolean</code> value. * <code>boolean</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setBoolean(int parameterIndex, boolean x) throws SQLException;
setBoolean(int index, boolean value) throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>byte</code> value. * <code>byte</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setByte(int parameterIndex, byte x) throws SQLException;
setByte(int index, byte value) throws SQLException;
/*************************************************************************/ /**
/**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>short</code> value. * <code>short</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setShort(int parameterIndex, short x) throws SQLException;
setShort(int index, short value) throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>int</code> value. * <code>int</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setInt(int parameterIndex, int x) throws SQLException;
setInt(int index, int value) throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>long</code> value. * <code>long</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setLong(int parameterIndex, long x) throws SQLException;
setLong(int index, long value) throws SQLException;
/*************************************************************************/ /**
/**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>float</code> value. * <code>float</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setFloat(int parameterIndex, float x) throws SQLException;
setFloat(int index, float value) throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>double</code> value. * <code>double</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setDouble(int parameterIndex, double x) throws SQLException;
setDouble(int index, double value) throws SQLException;
/*************************************************************************/ /**
/**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>String</code> value. * <code>java.math.BigDecimal</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setBigDecimal(int parameterIndex, BigDecimal x) throws
setString(int index, String value) throws SQLException; SQLException;
/*************************************************************************/ /**
/**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>byte</code> array value. * <code>String</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setString(int parameterIndex, String x) throws SQLException;
setBytes(int index, byte[] value) throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>java.math.BigDecimal</code> value. * <code>byte</code> array value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setBytes(int parameterIndex, byte[] x) throws SQLException;
setBigDecimal(int index, java.math.BigDecimal value) throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>java.sql.Date</code> value. * <code>java.sql.Date</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setDate(int parameterIndex, Date x) throws SQLException;
setDate(int index, java.sql.Date value) throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>java.sql.Date</code> value. * <code>java.sql.Time</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
* @param calendar The <code>Calendar</code> to use for timezone and locale.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setTime(int parameterIndex, Time x) throws SQLException;
setDate(int index, java.sql.Date value, Calendar calendar) throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>java.sql.Time</code> value. * <code>java.sql.Timestamp</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setTimestamp(int parameterIndex, Timestamp x)
setTime(int index, java.sql.Time value) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>java.sql.Time</code> value. * ASCII <code>InputStream</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
* @param calendar The <code>Calendar</code> to use for timezone and locale. * @param length The number of bytes in the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setAsciiStream(int parameterIndex, InputStream x, int length)
setTime(int index, java.sql.Time value, Calendar calendar) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>java.sql.Timestamp</code> value. * Unicode UTF-8 <code>InputStream</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
* * @param length The number of bytes in the stream.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @deprecated
*/ */
public abstract void public void setUnicodeStream(int parameterIndex, InputStream x, int length)
setTimestamp(int index, java.sql.Timestamp value) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>java.sql.Timestamp</code> value. * binary <code>InputStream</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
* @param calendar The <code>Calendar</code> to use for timezone and locale. * @param length The number of bytes in the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setBinaryStream(int parameterIndex, InputStream x, int length)
setTimestamp(int index, java.sql.Timestamp value, Calendar calendar)
throws SQLException; throws SQLException;
/*************************************************************************/ /**
* This method clears all of the input parameter that have been
* set on this statement.
*
* @exception SQLException If an error occurs.
*/
public void clearParameters() throws SQLException;
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* ASCII <code>InputStream</code> value. * <code>Object</code> value. The specified SQL object type will be used.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
* @param length The number of bytes in the stream. * @param type The SQL type to use for the parameter, from <code>Types</code>
* * @param scale The scale of the value, for numeric values only.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @see Types
*/ */
public abstract void public void setObject(int parameterIndex, Object x, int targetSqlType,
setAsciiStream(int index, InputStream value, int length) throws SQLException; int scale) throws SQLException;
/*************************************************************************/ /**
/**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* Unicode UTF-8 <code>InputStream</code> value. * <code>Object</code> value. The specified SQL object type will be used.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
* @param length The number of bytes in the stream. * @param type The SQL type to use for the parameter, from <code>Types</code>
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @see Types
*/ */
public abstract void public void setObject(int parameterIndex, Object x, int targetSqlType)
setUnicodeStream(int index, InputStream value, int length) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* binary <code>InputStream</code> value. * <code>Object</code> value. The default object type to SQL type mapping
* will be used.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
* @param length The number of bytes in the stream. * @exception SQLException If an error occurs.
*/
public void setObject(int parameterIndex, Object x) throws SQLException;
/**
* This method executes a prepared SQL query.
* Some prepared statements return multiple results; the execute method
* handles these complex statements as well as the simpler form of
* statements handled by executeQuery and executeUpdate.
* *
* @return The result of the SQL statement.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public boolean execute() throws SQLException;
setBinaryStream(int index, InputStream value, int length) throws SQLException;
/*************************************************************************/ /**
* This method adds a set of parameters to the batch for JDBC 2.0.
* @exception SQLException If an error occurs.
*/
public void addBatch() throws SQLException;
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* character <code>Reader</code> value. * character <code>Reader</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
* @param length The number of bytes in the stream. * @param length The number of bytes in the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setCharacterStream(int parameterIndex, Reader reader,
setCharacterStream(int index, Reader value, int length) throws SQLException; int length) throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>Ref</code> value. The default object type to SQL type mapping * <code>Ref</code> value. The default object type to SQL type mapping
* will be used. * will be used.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setRef(int i, Ref x) throws SQLException;
setRef(int index, Ref value) throws SQLException;
/*************************************************************************/ /**
/**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>Blob</code> value. The default object type to SQL type mapping * <code>Blob</code> value. The default object type to SQL type mapping
* will be used. * will be used.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setBlob(int i, Blob x) throws SQLException;
setBlob(int index, Blob value) throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>Clob</code> value. The default object type to SQL type mapping * <code>Clob</code> value. The default object type to SQL type mapping
* will be used. * will be used.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setClob(int i, Clob x) throws SQLException;
setClob(int index, Clob value) throws SQLException;
/*************************************************************************/ /**
/**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>Array</code> value. The default object type to SQL type mapping * <code>Array</code> value. The default object type to SQL type mapping
* will be used. * will be used.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setArray(int i, Array x) throws SQLException;
setArray(int index, Array value) throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method returns meta data for the result set from this statement.
* <code>Object</code> value. The default object type to SQL type mapping
* will be used.
*
* @param index The index of the parameter value to set.
* @param value The value of the parameter.
* *
* @return Meta data for the result set from this statement.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public ResultSetMetaData getMetaData() throws SQLException;
setObject(int index, Object value) throws SQLException;
/*************************************************************************/ /**
/**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>Object</code> value. The specified SQL object type will be used. * <code>java.sql.Date</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
* @param type The SQL type to use for the parameter, from <code>Types</code> * @param calendar The <code>Calendar</code> to use for timezone and locale.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see Types
*/ */
public abstract void public void setDate(int parameterIndex, Date x, Calendar cal)
setObject(int index, Object value, int type) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method sets the specified parameter from the given Java * This method sets the specified parameter from the given Java
* <code>Object</code> value. The specified SQL object type will be used. * <code>java.sql.Time</code> value.
* *
* @param index The index of the parameter value to set. * @param index The index of the parameter value to set.
* @param value The value of the parameter. * @param value The value of the parameter.
* @param type The SQL type to use for the parameter, from <code>Types</code> * @param calendar The <code>Calendar</code> to use for timezone and locale.
* @param scale The scale of the value, for numeric values only.
*
* @exception SQLException If an error occurs.
*
* @see Types
*/
public abstract void
setObject(int index, Object value, int type, int scale) throws SQLException;
/*************************************************************************/
/**
* This method adds a set of parameters to the batch for JDBC 2.0.
*
* @exception SQLException If an error occurs.
*/
public abstract void
addBatch() throws SQLException;
/*************************************************************************/
/**
* This method clears all of the input parameter that have been
* set on this statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setTime(int parameterIndex, Time x, Calendar cal)
clearParameters() throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method returns meta data for the result set from this statement. * This method sets the specified parameter from the given Java
* * <code>java.sql.Timestamp</code> value.
* @return Meta data for the result set from this statement.
* *
* @param index The index of the parameter value to set.
* @param value The value of the parameter.
* @param calendar The <code>Calendar</code> to use for timezone and locale.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSetMetaData public void setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
getMetaData() throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method executes a prepared SQL query. * This method populates the specified parameter with a SQL NULL value
* Some prepared statements return multiple results; the execute method * for the specified type.
* handles these complex statements as well as the simpler form of
* statements handled by executeQuery and executeUpdate.
*
* @return The result of the SQL statement.
* *
* @param index The index of the parameter to set.
* @param type The SQL type identifier of the parameter from <code>Types</code>
* @param name The name of the data type, for user defined types.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public void setNull(int paramIndex, int sqlType, String typeName)
execute() throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method executes a prepared SQL query and returns its ResultSet. * @since 1.4
*
* @return The ResultSet of the SQL statement.
*
* @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public void setURL(int parameterIndex, URL x) throws SQLException;
executeQuery() throws SQLException;
/*************************************************************************/
/** /**
* This method executes an SQL INSERT, UPDATE or DELETE statement. SQL * @since 1.4
* statements that return nothing such as SQL DDL statements can be executed.
*
* @return The result is either the row count for INSERT, UPDATE or DELETE
* statements; or 0 for SQL statements that return nothing.
*
* @exception SQLException If an error occurs.
*/ */
public abstract int public ParameterMetaData getParameterMetaData() throws SQLException;
executeUpdate() throws SQLException; }
} // interface PreparedStatement
...@@ -35,28 +35,41 @@ this exception to your version of the library, but you are not ...@@ -35,28 +35,41 @@ this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.sql; package java.sql;
import java.util.Map;
/** /**
* This interface provides a mechanism for obtaining information about * This interface provides a mechanism for obtaining information about
* a SQL structured type * a SQL structured type
* *
* @author Aaron M. Renn (arenn@urbanophile.com) * @author Aaron M. Renn (arenn@urbanophile.com)
* @since 1.2
*/ */
public interface Ref public interface Ref
{ {
/**
/**
* This method returns the fully qualified name of the SQL structured * This method returns the fully qualified name of the SQL structured
* type of the referenced item. * type of the referenced item.
* *
* @return The fully qualified name of the SQL structured type. * @return The fully qualified name of the SQL structured type.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @since 1.2
*/ */
public abstract String public String getBaseTypeName() throws SQLException;
getBaseTypeName() throws SQLException;
} // interface Ref /**
* @since 1.4
*/
public Object getObject(Map map) throws SQLException;
/**
* @since 1.4
*/
public Object getObject() throws SQLException;
/**
* @since 1.4
*/
public void setObject(Object value) throws SQLException;
}
/* ResultSet.java -- A SQL statement result set. /* ResultSet.java -- A SQL statement result set.
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -41,6 +41,7 @@ package java.sql; ...@@ -41,6 +41,7 @@ package java.sql;
import java.io.InputStream; import java.io.InputStream;
import java.io.Reader; import java.io.Reader;
import java.math.BigDecimal; import java.math.BigDecimal;
import java.net.URL;
import java.util.Calendar; import java.util.Calendar;
import java.util.Map; import java.util.Map;
...@@ -60,330 +61,213 @@ import java.util.Map; ...@@ -60,330 +61,213 @@ import java.util.Map;
*/ */
public interface ResultSet public interface ResultSet
{ {
/**
/**
* The rows will be processed in order from first to last. * The rows will be processed in order from first to last.
*/ */
public static final int FETCH_FORWARD = 0; public static final int FETCH_FORWARD = 1000;
/** /**
* The rows will be processed in order from last to first. * The rows will be processed in order from last to first.
*/ */
public static final int FETCH_REVERSE = 1; public static final int FETCH_REVERSE = 1001;
/** /**
* The rows will be processed in an unknown order * The rows will be processed in an unknown order
*/ */
public static final int FETCH_UNKNOWN = 2; public static final int FETCH_UNKNOWN = 1002;
/** /**
* This type of result set may only step forward through the rows returned. * This type of result set may only step forward through the rows returned.
*/ */
public static final int TYPE_FORWARD_ONLY = 0; public static final int TYPE_FORWARD_ONLY = 1003;
/** /**
* This type of result set is scrollable and is not sensitive to changes * This type of result set is scrollable and is not sensitive to changes
* made by other statements. * made by other statements.
*/ */
public static final int TYPE_SCROLL_INSENSITIVE = 1; public static final int TYPE_SCROLL_INSENSITIVE = 1004;
/** /**
* This type of result set is scrollable and is also sensitive to changes * This type of result set is scrollable and is also sensitive to changes
* made by other statements. * made by other statements.
*/ */
public static final int TYPE_SCROLL_SENSITIVE = 1; public static final int TYPE_SCROLL_SENSITIVE = 1005;
/** /**
* The concurrency mode of for the result set may not be modified. * The concurrency mode of for the result set may not be modified.
*/ */
public static final int CONCUR_READ_ONLY = 0; public static final int CONCUR_READ_ONLY = 1007;
/** /**
* The concurrency mode of for the result set may be modified. * The concurrency mode of for the result set may be modified.
*/ */
public static final int CONCUR_UPDATABLE = 1; public static final int CONCUR_UPDATABLE = 1008;
/*************************************************************************/ public static final int HOLD_CURSORS_OVER_COMMIT = 1;
/** public static final int CLOSE_CURSORS_AT_COMMIT = 2;
/**
* This method advances to the next row in the result set. Any streams * This method advances to the next row in the result set. Any streams
* open on the current row are closed automatically. * open on the current row are closed automatically.
* *
* @return <code>true</code> if the next row exists, <code>false</code> * @return <code>true</code> if the next row exists, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs.
*/
public abstract boolean
next() throws SQLException;
/*************************************************************************/
/**
* This method moves the current position to the previous row in the
* result set.
*
* @return <code>true</code> if the previous row exists, <code>false</code>
* otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean next() throws SQLException;
previous() throws SQLException;
/*************************************************************************/ /**
/**
* This method closes the result set and frees any associated resources. * This method closes the result set and frees any associated resources.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void close() throws SQLException;
close() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether the value of the last column that was fetched * This method tests whether the value of the last column that was fetched
* was actually a SQL NULL value. * was actually a SQL NULL value.
* *
* @return <code>true</code> if the last column fetched was a NULL, * @return <code>true</code> if the last column fetched was a NULL,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean wasNull() throws SQLException;
wasNull() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>String</code>. * <code>String</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a <code>String</code>. * @return The column value as a <code>String</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getString(int columnIndex) throws SQLException;
getString(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as a Java
* <code>Object</code>.
*
* @param index The index of the column to return.
*
* @return The column value as an <code>Object</code>.
*
* @exception SQLException If an error occurs.
*/
public abstract Object
getObject(int index) throws SQLException;
/*************************************************************************/
/**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>boolean</code>. * <code>boolean</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a <code>boolean</code>. * @return The column value as a <code>boolean</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean getBoolean(int columnIndex) throws SQLException;
getBoolean(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>byte</code>. * <code>byte</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a <code>byte</code>. * @return The column value as a <code>byte</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract byte public byte getByte(int columnIndex) throws SQLException;
getByte(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>short</code>. * <code>short</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a <code>short</code>. * @return The column value as a <code>short</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract short public short getShort(int columnIndex) throws SQLException;
getShort(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>int</code>. * <code>int</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a <code>int</code>. * @return The column value as a <code>int</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getInt(int columnIndex) throws SQLException;
getInt(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>long</code>. * <code>long</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a <code>long</code>. * @return The column value as a <code>long</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract long public long getLong(int columnIndex) throws SQLException;
getLong(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>float</code>. * <code>float</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a <code>float</code>. * @return The column value as a <code>float</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract float public float getFloat(int columnIndex) throws SQLException;
getFloat(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>double</code>. * <code>double</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a <code>double</code>. * @return The column value as a <code>double</code>.
*
* @exception SQLException If an error occurs.
*/
public abstract double
getDouble(int index) throws SQLException;
/*************************************************************************/
/**
* This method returns the value of the specified column as a Java
* <code>BigDecimal</code>.
*
* @param index The index of the column to return.
*
* @return The column value as a <code>BigDecimal</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract BigDecimal public double getDouble(int columnIndex) throws SQLException;
getBigDecimal(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>BigDecimal</code>. * <code>BigDecimal</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
* @param scale The number of digits to the right of the decimal to return. * @param scale The number of digits to the right of the decimal to return.
*
* @return The column value as a <code>BigDecimal</code>. * @return The column value as a <code>BigDecimal</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @deprecated
*/ */
public abstract BigDecimal public BigDecimal getBigDecimal(int columnIndex, int scale)
getBigDecimal(int index, int scale) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* byte array. * byte array.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a byte array * @return The column value as a byte array
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract byte[] public byte[] getBytes(int columnIndex) throws SQLException;
getBytes(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>java.sql.Date</code>. * <code>java.sql.Date</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a <code>java.sql.Date</code>. * @return The column value as a <code>java.sql.Date</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Date public Date getDate(int columnIndex) throws SQLException;
getDate(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>java.sql.Time</code>. * <code>java.sql.Time</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a <code>java.sql.Time</code>. * @return The column value as a <code>java.sql.Time</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Time public Time getTime(int columnIndex) throws SQLException;
getTime(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>java.sql.Timestamp</code>. * <code>java.sql.Timestamp</code>.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a <code>java.sql.Timestamp</code>. * @return The column value as a <code>java.sql.Timestamp</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Timestamp public Timestamp getTimestamp(int columnIndex) throws SQLException;
getTimestamp(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as an ASCII * This method returns the value of the specified column as an ASCII
* stream. Note that all the data from this stream must be read before * stream. Note that all the data from this stream must be read before
* fetching the value of any other column. Please also be aware that * fetching the value of any other column. Please also be aware that
...@@ -391,17 +275,12 @@ getTimestamp(int index) throws SQLException; ...@@ -391,17 +275,12 @@ getTimestamp(int index) throws SQLException;
* will close this stream as well. * will close this stream as well.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as an ASCII <code>InputStream</code>. * @return The column value as an ASCII <code>InputStream</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract InputStream public InputStream getAsciiStream(int columnIndex) throws SQLException;
getAsciiStream(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Unicode UTF-8 * This method returns the value of the specified column as a Unicode UTF-8
* stream. Note that all the data from this stream must be read before * stream. Note that all the data from this stream must be read before
* fetching the value of any other column. Please also be aware that * fetching the value of any other column. Please also be aware that
...@@ -409,17 +288,13 @@ getAsciiStream(int index) throws SQLException; ...@@ -409,17 +288,13 @@ getAsciiStream(int index) throws SQLException;
* will close this stream as well. * will close this stream as well.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a Unicode UTF-8 <code>InputStream</code>. * @return The column value as a Unicode UTF-8 <code>InputStream</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @deprecated Use getCharacterStream instead.
*/ */
public abstract InputStream public InputStream getUnicodeStream(int columnIndex) throws SQLException;
getUnicodeStream(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a raw byte * This method returns the value of the specified column as a raw byte
* stream. Note that all the data from this stream must be read before * stream. Note that all the data from this stream must be read before
* fetching the value of any other column. Please also be aware that * fetching the value of any other column. Please also be aware that
...@@ -427,261 +302,144 @@ getUnicodeStream(int index) throws SQLException; ...@@ -427,261 +302,144 @@ getUnicodeStream(int index) throws SQLException;
* will close this stream as well. * will close this stream as well.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return The column value as a raw byte <code>InputStream</code>. * @return The column value as a raw byte <code>InputStream</code>.
*
* @exception SQLException If an error occurs.
*/
public abstract InputStream
getBinaryStream(int index) throws SQLException;
/*************************************************************************/
/**
* This method returns the value of the specified column as a character
* stream. Note that all the data from this stream must be read before
* fetching the value of any other column. Please also be aware that
* calling <code>next()</code> or <code>close()</code> on this result set
* will close this stream as well.
*
* @param index The index of the column to return.
*
* @return The column value as an character <code>Reader</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Reader public InputStream getBinaryStream(int columnIndex) throws SQLException;
getCharacterStream(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>String</code>. * <code>String</code>.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a <code>String</code>. * @return The column value as a <code>String</code>.
*
* @exception SQLException If an error occurs.
*/
public abstract String
getString(String column) throws SQLException;
/*************************************************************************/
/**
* This method returns the value of the specified column as a Java
* <code>Object</code>.
*
* @param column The name of the column to return.
*
* @return The column value as an <code>Object</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Object public String getString(String columnName) throws SQLException;
getObject(String column) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>boolean</code>. * <code>boolean</code>.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a <code>boolean</code>. * @return The column value as a <code>boolean</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean getBoolean(String columnName) throws SQLException;
getBoolean(String column) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>byte</code>. * <code>byte</code>.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a <code>byte</code>. * @return The column value as a <code>byte</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract byte public byte getByte(String columnName) throws SQLException;
getByte(String column) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>short</code>. * <code>short</code>.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a <code>short</code>. * @return The column value as a <code>short</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract short public short getShort(String columnName) throws SQLException;
getShort(String column) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>int</code>. * <code>int</code>.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a <code>int</code>. * @return The column value as a <code>int</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getInt(String columnName) throws SQLException;
getInt(String column) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>long</code>. * <code>long</code>.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a <code>long</code>. * @return The column value as a <code>long</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract long public long getLong(String columnName) throws SQLException;
getLong(String column) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>float</code>. * <code>float</code>.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a <code>float</code>. * @return The column value as a <code>float</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract float public float getFloat(String columnName) throws SQLException;
getFloat(String column) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>double</code>. * <code>double</code>.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a <code>double</code>. * @return The column value as a <code>double</code>.
*
* @exception SQLException If an error occurs.
*/
public abstract double
getDouble(String column) throws SQLException;
/*************************************************************************/
/**
* This method returns the value of the specified column as a Java
* <code>BigDecimal</code>.
*
* @param column The name of the column to return.
*
* @return The column value as a <code>BigDecimal</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract BigDecimal public double getDouble(String columnName) throws SQLException;
getBigDecimal(String column) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>BigDecimal</code>. * <code>BigDecimal</code>.
* *
* @param column The name of the column to return. * @param index The index of the column to return.
* @param scale The number of digits to the right of the decimal to return.
*
* @return The column value as a <code>BigDecimal</code>. * @return The column value as a <code>BigDecimal</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @deprecated
*/ */
public abstract BigDecimal public BigDecimal getBigDecimal(String columnName, int scale)
getBigDecimal(String column, int scale) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* byte array. * byte array.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a byte array * @return The column value as a byte array
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract byte[] public byte[] getBytes(String columnName) throws SQLException;
getBytes(String column) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>java.sql.Date</code>. * <code>java.sql.Date</code>.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a <code>java.sql.Date</code>. * @return The column value as a <code>java.sql.Date</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Date public Date getDate(String columnName) throws SQLException;
getDate(String column) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>java.sql.Time</code>. * <code>java.sql.Time</code>.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a <code>java.sql.Time</code>. * @return The column value as a <code>java.sql.Time</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Time public Time getTime(String columnName) throws SQLException;
getTime(String column) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>java.sql.Timestamp</code>. * <code>java.sql.Timestamp</code>.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a <code>java.sql.Timestamp</code>. * @return The column value as a <code>java.sql.Timestamp</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Timestamp public Timestamp getTimestamp(String columnName) throws SQLException;
getTimestamp(String column) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as an ASCII * This method returns the value of the specified column as an ASCII
* stream. Note that all the data from this stream must be read before * stream. Note that all the data from this stream must be read before
* fetching the value of any other column. Please also be aware that * fetching the value of any other column. Please also be aware that
...@@ -689,17 +447,12 @@ getTimestamp(String column) throws SQLException; ...@@ -689,17 +447,12 @@ getTimestamp(String column) throws SQLException;
* will close this stream as well. * will close this stream as well.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as an ASCII <code>InputStream</code>. * @return The column value as an ASCII <code>InputStream</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract InputStream public InputStream getAsciiStream(String columnName) throws SQLException;
getAsciiStream(String column) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a Unicode UTF-8 * This method returns the value of the specified column as a Unicode UTF-8
* stream. Note that all the data from this stream must be read before * stream. Note that all the data from this stream must be read before
* fetching the value of any other column. Please also be aware that * fetching the value of any other column. Please also be aware that
...@@ -707,17 +460,13 @@ getAsciiStream(String column) throws SQLException; ...@@ -707,17 +460,13 @@ getAsciiStream(String column) throws SQLException;
* will close this stream as well. * will close this stream as well.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a Unicode UTF-8 <code>InputStream</code>. * @return The column value as a Unicode UTF-8 <code>InputStream</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
* @deprecated Use getCharacterStream instead.
*/ */
public abstract InputStream public InputStream getUnicodeStream(String columnName) throws SQLException;
getUnicodeStream(String column) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the value of the specified column as a raw byte * This method returns the value of the specified column as a raw byte
* stream. Note that all the data from this stream must be read before * stream. Note that all the data from this stream must be read before
* fetching the value of any other column. Please also be aware that * fetching the value of any other column. Please also be aware that
...@@ -725,218 +474,207 @@ getUnicodeStream(String column) throws SQLException; ...@@ -725,218 +474,207 @@ getUnicodeStream(String column) throws SQLException;
* will close this stream as well. * will close this stream as well.
* *
* @param column The name of the column to return. * @param column The name of the column to return.
*
* @return The column value as a raw byte <code>InputStream</code>. * @return The column value as a raw byte <code>InputStream</code>.
*
* @exception SQLException If an error occurs.
*/
public abstract InputStream
getBinaryStream(String column) throws SQLException;
/*************************************************************************/
/**
* This method returns the value of the specified column as a character
* stream. Note that all the data from this stream must be read before
* fetching the value of any other column. Please also be aware that
* calling <code>next()</code> or <code>close()</code> on this result set
* will close this stream as well.
*
* @param column The name of the column to return.
*
* @return The column value as an character <code>Reader</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Reader public InputStream getBinaryStream(String columnName) throws SQLException;
getCharacterStream(String column) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the first SQL warning associated with this result * This method returns the first SQL warning associated with this result
* set. Any additional warnings will be chained to this one. * set. Any additional warnings will be chained to this one.
* *
* @return The first SQLWarning for this result set, or <code>null</code> if * @return The first SQLWarning for this result set, or <code>null</code> if
* there are no warnings. * there are no warnings.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract SQLWarning public SQLWarning getWarnings() throws SQLException;
getWarnings() throws SQLException;
/*************************************************************************/
/** /**
* This method clears all warnings associated with this result set. * This method clears all warnings associated with this result set.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void clearWarnings() throws SQLException;
clearWarnings() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the name of the database cursor used by this * This method returns the name of the database cursor used by this
* result set. * result set.
* *
* @return The name of the database cursor used by this result set. * @return The name of the database cursor used by this result set.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getCursorName() throws SQLException;
getCursorName() throws SQLException;
/*************************************************************************/
/** /**
* This method returns data about the columns returned as part of the * This method returns data about the columns returned as part of the
* result set as a <code>ResultSetMetaData</code> instance. * result set as a <code>ResultSetMetaData</code> instance.
* *
* @return The <code>ResultSetMetaData</code> instance for this result set. * @return The <code>ResultSetMetaData</code> instance for this result set.
* @exception SQLException If an error occurs.
*/
public ResultSetMetaData getMetaData() throws SQLException;
/**
* This method returns the value of the specified column as a Java
* <code>Object</code>.
* *
* @param index The index of the column to return.
* @return The column value as an <code>Object</code>.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSetMetaData public Object getObject(int columnIndex) throws SQLException;
getMetaData() throws SQLException;
/*************************************************************************/ /**
* This method returns the value of the specified column as a Java
* <code>Object</code>.
*
* @param column The name of the column to return.
* @return The column value as an <code>Object</code>.
* @exception SQLException If an error occurs.
*/
public Object getObject(String columnName) throws SQLException;
/** /**
* This method returns the column index of the specified named column. * This method returns the column index of the specified named column.
* *
* @param column The name of the column. * @param column The name of the column.
*
* @return The index of the column. * @return The index of the column.
* @exception SQLException If an error occurs.
*/
public int findColumn(String columnName) throws SQLException;
/**
* This method returns the value of the specified column as a character
* stream. Note that all the data from this stream must be read before
* fetching the value of any other column. Please also be aware that
* calling <code>next()</code> or <code>close()</code> on this result set
* will close this stream as well.
* *
* @param index The index of the column to return.
* @return The column value as an character <code>Reader</code>.
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public Reader getCharacterStream(int columnIndex) throws SQLException;
findColumn(String column) throws SQLException;
/*************************************************************************/ /**
* This method returns the value of the specified column as a character
* stream. Note that all the data from this stream must be read before
* fetching the value of any other column. Please also be aware that
* calling <code>next()</code> or <code>close()</code> on this result set
* will close this stream as well.
*
* @param column The name of the column to return.
* @return The column value as an character <code>Reader</code>.
* @exception SQLException If an error occurs.
*/
public Reader getCharacterStream(String columnName) throws SQLException;
/** /**
* This method returns the value of the specified column as a Java
* <code>BigDecimal</code>.
*
* @param index The index of the column to return.
* @return The column value as a <code>BigDecimal</code>.
* @exception SQLException If an error occurs.
*/
public BigDecimal getBigDecimal(int columnIndex) throws SQLException;
/**
* This method returns the value of the specified column as a Java
* <code>BigDecimal</code>.
*
* @param column The name of the column to return.
* @return The column value as a <code>BigDecimal</code>.
* @exception SQLException If an error occurs.
*/
public BigDecimal getBigDecimal(String columnName) throws SQLException;
/**
* This method tests whether or not the cursor is before the first row * This method tests whether or not the cursor is before the first row
* in the result set. * in the result set.
* *
* @return <code>true</code> if the cursor is positioned before the first * @return <code>true</code> if the cursor is positioned before the first
* row, <code>false</code> otherwise. * row, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isBeforeFirst() throws SQLException;
isBeforeFirst() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the cursor is after the last row * This method tests whether or not the cursor is after the last row
* in the result set. * in the result set.
* *
* @return <code>true</code> if the cursor is positioned after the last * @return <code>true</code> if the cursor is positioned after the last
* row, <code>false</code> otherwise. * row, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isAfterLast() throws SQLException;
isAfterLast() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the cursor is positioned on the first * This method tests whether or not the cursor is positioned on the first
* row in the result set. * row in the result set.
* *
* @return <code>true</code> if the cursor is positioned on the first * @return <code>true</code> if the cursor is positioned on the first
* row, <code>false</code> otherwise. * row, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isFirst() throws SQLException;
isFirst() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the cursor is on the last row * This method tests whether or not the cursor is on the last row
* in the result set. * in the result set.
* *
* @return <code>true</code> if the cursor is positioned on the last * @return <code>true</code> if the cursor is positioned on the last
* row, <code>false</code> otherwise. * row, <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isLast() throws SQLException;
isLast() throws SQLException;
/*************************************************************************/ /**
/**
* This method repositions the cursor to before the first row in the * This method repositions the cursor to before the first row in the
* result set. * result set.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void beforeFirst() throws SQLException;
beforeFirst() throws SQLException;
/*************************************************************************/
/** /**
* This method repositions the cursor to after the last row in the result * This method repositions the cursor to after the last row in the result
* set. * set.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void afterLast() throws SQLException;
afterLast() throws SQLException;
/*************************************************************************/
/** /**
* This method repositions the cursor on the first row in the * This method repositions the cursor on the first row in the
* result set. * result set.
* *
* @return <code>true</code> if the cursor is on a valid row; * @return <code>true</code> if the cursor is on a valid row;
* <code>false</code> if there are no rows in the result set. * <code>false</code> if there are no rows in the result set.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean first() throws SQLException;
first() throws SQLException;
/*************************************************************************/
/** /**
* This method repositions the cursor on the last row in the result * This method repositions the cursor on the last row in the result
* set. * set.
* *
* @return <code>true</code> if the cursor is on a valid row; * @return <code>true</code> if the cursor is on a valid row;
* <code>false</code> if there are no rows in the result set. * <code>false</code> if there are no rows in the result set.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean last() throws SQLException;
last() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the current row number in the cursor. Numbering * This method returns the current row number in the cursor. Numbering
* begins at index 1. * begins at index 1.
* *
* @return The current row number, or 0 if there is not current row. * @return The current row number, or 0 if there is not current row.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getRow() throws SQLException;
getRow() throws SQLException;
/*************************************************************************/
/** /**
* This method positions the result set to the specified absolute row. * This method positions the result set to the specified absolute row.
* Positive numbers are row offsets from the beginning of the result * Positive numbers are row offsets from the beginning of the result
* set (numbering starts from row 1) and negative numbers are row offsets * set (numbering starts from row 1) and negative numbers are row offsets
...@@ -946,362 +684,273 @@ getRow() throws SQLException; ...@@ -946,362 +684,273 @@ getRow() throws SQLException;
* *
* @return <code>true</code> if the current position was changed, * @return <code>true</code> if the current position was changed,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean absolute(int row) throws SQLException;
absolute(int row) throws SQLException;
/*************************************************************************/
/** /**
* This method moves the result set position relative to the current row. * This method moves the result set position relative to the current row.
* The offset can be positive or negative. * The offset can be positive or negative.
* *
* @param row The relative row position to move to. * @param row The relative row position to move to.
*
* @return <code>true</code> if the current position was changed, * @return <code>true</code> if the current position was changed,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean relative(int rows) throws SQLException;
relative(int row) throws SQLException;
/*************************************************************************/ /**
* This method moves the current position to the previous row in the
* result set.
*
* @return <code>true</code> if the previous row exists, <code>false</code>
* otherwise.
* @exception SQLException If an error occurs.
*/
public boolean previous() throws SQLException;
/** /**
* This method provides a hint to the driver about which direction the * This method provides a hint to the driver about which direction the
* result set will be processed in. * result set will be processed in.
* *
* @param direction The direction in which rows will be processed. (Values?) * @param direction The direction in which rows will be processed. (Values?)
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setFetchDirection(int direction) throws SQLException;
setFetchDirection(int direction) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the current fetch direction for this result set. * This method returns the current fetch direction for this result set.
* *
* @return The fetch direction for this result set. * @return The fetch direction for this result set.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getFetchDirection() throws SQLException;
getFetchDirection() throws SQLException;
/*************************************************************************/
/** /**
* This method provides a hint to the driver about how many rows at a * This method provides a hint to the driver about how many rows at a
* time it should fetch from the database. * time it should fetch from the database.
* *
* @param rows The number of rows the driver should fetch per call. * @param rows The number of rows the driver should fetch per call.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setFetchSize(int rows) throws SQLException;
setFetchSize(int rows) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the current number of rows that will be fetched * This method returns the current number of rows that will be fetched
* from the database at a time. * from the database at a time.
* *
* @return The current fetch size for this result set. * @return The current fetch size for this result set.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getFetchSize() throws SQLException;
getFetchSize() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the result set type of this result set. This will * This method returns the result set type of this result set. This will
* be one of the TYPE_* constants defined in this interface. * be one of the TYPE_* constants defined in this interface.
* *
* @return The result set type. * @return The result set type.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getType() throws SQLException;
getType() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the concurrency type of this result set. This will * This method returns the concurrency type of this result set. This will
* be one of the CONCUR_* constants defined in this interface. * be one of the CONCUR_* constants defined in this interface.
* *
* @return The result set concurrency type. * @return The result set concurrency type.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getConcurrency() throws SQLException;
getConcurrency() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the current row in the result set * This method tests whether or not the current row in the result set
* has been updated. Updates must be visible in order of this method to * has been updated. Updates must be visible in order of this method to
* detect the update. * detect the update.
* *
* @return <code>true</code> if the row has been updated, <code>false</code> * @return <code>true</code> if the row has been updated, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean rowUpdated() throws SQLException;
rowUpdated() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the current row in the result set * This method tests whether or not the current row in the result set
* has been inserted. Inserts must be visible in order of this method to * has been inserted. Inserts must be visible in order of this method to
* detect the insert. * detect the insert.
* *
* @return <code>true</code> if the row has been inserted, <code>false</code> * @return <code>true</code> if the row has been inserted, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean rowInserted() throws SQLException;
rowInserted() throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether or not the current row in the result set * This method tests whether or not the current row in the result set
* has been deleted. Deletes must be visible in order of this method to * has been deleted. Deletes must be visible in order of this method to
* detect the deletion. * detect the deletion.
* *
* @return <code>true</code> if the row has been deleted, <code>false</code> * @return <code>true</code> if the row has been deleted, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean rowDeleted() throws SQLException;
rowDeleted() throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a NULL value. This * This method updates the specified column to have a NULL value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @return index The index of the column to update. * @return index The index of the column to update.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateNull(int columnIndex) throws SQLException;
updateNull(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a boolean value. This * This method updates the specified column to have a boolean value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateBoolean(int columnIndex, boolean x) throws SQLException;
updateBoolean(int index, boolean value) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a byte value. This * This method updates the specified column to have a byte value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateByte(int columnIndex, byte x) throws SQLException;
updateByte(int index, byte value) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a short value. This * This method updates the specified column to have a short value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateShort(int columnIndex, short x) throws SQLException;
updateShort(int index, short value) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have an int value. This * This method updates the specified column to have an int value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateInt(int columnIndex, int x) throws SQLException;
updateInt(int index, int value) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a long value. This * This method updates the specified column to have a long value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateLong(int columnIndex, long x) throws SQLException;
updateLong(int index, long value) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a float value. This * This method updates the specified column to have a float value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateFloat(int columnIndex, float x) throws SQLException;
updateFloat(int index, float value) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a double value. This * This method updates the specified column to have a double value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateDouble(int columnIndex, double x) throws SQLException;
updateDouble(int index, double value) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a BigDecimal value. This * This method updates the specified column to have a BigDecimal value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateBigDecimal(int columnIndex, BigDecimal x)
updateBigDecimal(int index, BigDecimal value) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a String value. This * This method updates the specified column to have a String value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateString(int columnIndex, String x) throws SQLException;
updateString(int index, String value) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a byte array value. This * This method updates the specified column to have a byte array value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateBytes(int columnIndex, byte[] x) throws SQLException;
updateBytes(int index, byte[] value) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a java.sql.Date value. This * This method updates the specified column to have a java.sql.Date value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateDate(int columnIndex, Date x) throws SQLException;
updateDate(int index, java.sql.Date value) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a java.sql.Time value. This * This method updates the specified column to have a java.sql.Time value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateTime(int columnIndex, Time x) throws SQLException;
updateTime(int index, java.sql.Time value) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a java.sql.Timestamp value. * This method updates the specified column to have a java.sql.Timestamp value.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateTimestamp(int columnIndex, Timestamp x)
updateTimestamp(int index, java.sql.Timestamp value) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column from an ASCII text stream. * This method updates the specified column from an ASCII text stream.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
...@@ -1309,15 +958,12 @@ updateTimestamp(int index, java.sql.Timestamp value) throws SQLException; ...@@ -1309,15 +958,12 @@ updateTimestamp(int index, java.sql.Timestamp value) throws SQLException;
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
* @param length The length of the stream. * @param length The length of the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateAsciiStream(int columnIndex, InputStream x, int length)
updateAsciiStream(int index, InputStream value, int length) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column from a binary stream. * This method updates the specified column from a binary stream.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
...@@ -1325,16 +971,12 @@ updateAsciiStream(int index, InputStream value, int length) throws SQLException; ...@@ -1325,16 +971,12 @@ updateAsciiStream(int index, InputStream value, int length) throws SQLException;
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
* @param length The length of the stream. * @param length The length of the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateBinaryStream(int columnIndex, InputStream x, int length)
updateBinaryStream(int index, InputStream value, int length)
throws SQLException; throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column from a character stream. * This method updates the specified column from a character stream.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
...@@ -1342,15 +984,12 @@ updateBinaryStream(int index, InputStream value, int length) ...@@ -1342,15 +984,12 @@ updateBinaryStream(int index, InputStream value, int length)
* @param index The index of the column to update. * @param index The index of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
* @param length The length of the stream. * @param length The length of the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateCharacterStream(int columnIndex, Reader x, int length)
updateCharacterStream(int index, Reader value, int length) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have an Object value. * This method updates the specified column to have an Object value.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
...@@ -1360,12 +999,10 @@ updateCharacterStream(int index, Reader value, int length) throws SQLException; ...@@ -1360,12 +999,10 @@ updateCharacterStream(int index, Reader value, int length) throws SQLException;
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateObject(int columnIndex, Object x, int scale)
updateObject(int index, Object value) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have an Object value. * This method updates the specified column to have an Object value.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
...@@ -1374,224 +1011,166 @@ updateObject(int index, Object value) throws SQLException; ...@@ -1374,224 +1011,166 @@ updateObject(int index, Object value) throws SQLException;
* @param value The new value of the column. * @param value The new value of the column.
* @param scale The scale of the object in question, which is used only * @param scale The scale of the object in question, which is used only
* for numeric type objects. * for numeric type objects.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateObject(int columnIndex, Object x) throws SQLException;
updateObject(int index, Object value, int scale) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a NULL value. This * This method updates the specified column to have a NULL value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @return name The name of the column to update. * @return name The name of the column to update.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateNull(String columnName) throws SQLException;
updateNull(String name) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a boolean value. This * This method updates the specified column to have a boolean value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateBoolean(String columnName, boolean x) throws SQLException;
updateBoolean(String name, boolean value) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a byte value. This * This method updates the specified column to have a byte value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateByte(String columnName, byte x) throws SQLException;
updateByte(String name, byte value) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a short value. This * This method updates the specified column to have a short value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateShort(String columnName, short x) throws SQLException;
updateShort(String name, short value) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have an int value. This * This method updates the specified column to have an int value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateInt(String columnName, int x) throws SQLException;
updateInt(String name, int value) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a long value. This * This method updates the specified column to have a long value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateLong(String columnName, long x) throws SQLException;
updateLong(String name, long value) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a float value. This * This method updates the specified column to have a float value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateFloat(String columnName, float x) throws SQLException;
updateFloat(String name, float value) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a double value. This * This method updates the specified column to have a double value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateDouble(String columnName, double x) throws SQLException;
updateDouble(String name, double value) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a BigDecimal value. This * This method updates the specified column to have a BigDecimal value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateBigDecimal(String columnName, BigDecimal x)
updateBigDecimal(String name, BigDecimal value) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a String value. This * This method updates the specified column to have a String value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateString(String columnName, String x) throws SQLException;
updateString(String name, String value) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a byte array value. This * This method updates the specified column to have a byte array value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateBytes(String columnName, byte[] x) throws SQLException;
updateBytes(String name, byte[] value) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a java.sql.Date value. This * This method updates the specified column to have a java.sql.Date value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateDate(String columnName, Date x) throws SQLException;
updateDate(String name, java.sql.Date value) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have a java.sql.Time value. This * This method updates the specified column to have a java.sql.Time value. This
* does not update the actual database. <code>updateRow</code> must be * does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateTime(String columnName, Time x) throws SQLException;
updateTime(String name, java.sql.Time value) throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column to have a java.sql.Timestamp value. * This method updates the specified column to have a java.sql.Timestamp value.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateTimestamp(String columnName, Timestamp x)
updateTimestamp(String name, java.sql.Timestamp value) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column from an ASCII text stream. * This method updates the specified column from an ASCII text stream.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
...@@ -1599,15 +1178,12 @@ updateTimestamp(String name, java.sql.Timestamp value) throws SQLException; ...@@ -1599,15 +1178,12 @@ updateTimestamp(String name, java.sql.Timestamp value) throws SQLException;
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
* @param length The length of the stream. * @param length The length of the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateAsciiStream(String columnName, InputStream x, int length)
updateAsciiStream(String name, InputStream value, int length) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column from a binary stream. * This method updates the specified column from a binary stream.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
...@@ -1615,16 +1191,12 @@ updateAsciiStream(String name, InputStream value, int length) throws SQLExceptio ...@@ -1615,16 +1191,12 @@ updateAsciiStream(String name, InputStream value, int length) throws SQLExceptio
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
* @param length The length of the stream. * @param length The length of the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateBinaryStream(String columnName, InputStream x, int length)
updateBinaryStream(String name, InputStream value, int length)
throws SQLException; throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the specified column from a character stream. * This method updates the specified column from a character stream.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
...@@ -1635,27 +1207,22 @@ updateBinaryStream(String name, InputStream value, int length) ...@@ -1635,27 +1207,22 @@ updateBinaryStream(String name, InputStream value, int length)
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateCharacterStream(String columnName, Reader reader,
updateCharacterStream(String name, Reader value, int length) throws SQLException; int length) throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have an Object value. * This method updates the specified column to have an Object value.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
* *
* @param name The name of the column to update. * @param name The name of the column to update.
* @param value The new value of the column. * @param value The new value of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateObject(String columnName, Object x, int scale)
updateObject(String name, Object value) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method updates the specified column to have an Object value. * This method updates the specified column to have an Object value.
* This does not update the actual database. <code>updateRow</code> must be * This does not update the actual database. <code>updateRow</code> must be
* called in order to do that. * called in order to do that.
...@@ -1664,91 +1231,66 @@ updateObject(String name, Object value) throws SQLException; ...@@ -1664,91 +1231,66 @@ updateObject(String name, Object value) throws SQLException;
* @param value The new value of the column. * @param value The new value of the column.
* @param scale The scale of the object in question, which is used only * @param scale The scale of the object in question, which is used only
* for numeric type objects. * for numeric type objects.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateObject(String columnName, Object x) throws SQLException;
updateObject(String name, Object value, int scale) throws SQLException;
/*************************************************************************/ /**
/**
* This method inserts the current row into the database. The result set * This method inserts the current row into the database. The result set
* must be positioned on the insert row in order to call this method * must be positioned on the insert row in order to call this method
* successfully. * successfully.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void insertRow() throws SQLException;
insertRow() throws SQLException;
/*************************************************************************/ /**
/**
* This method updates the current row in the database. * This method updates the current row in the database.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void updateRow() throws SQLException;
updateRow() throws SQLException;
/*************************************************************************/ /**
/**
* This method deletes the current row in the database. * This method deletes the current row in the database.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void deleteRow() throws SQLException;
deleteRow() throws SQLException;
/*************************************************************************/ /**
/**
* This method refreshes the contents of the current row from the database. * This method refreshes the contents of the current row from the database.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void refreshRow() throws SQLException;
refreshRow() throws SQLException;
/*************************************************************************/ /**
/**
* This method cancels any changes that have been made to a row. If * This method cancels any changes that have been made to a row. If
* the <code>rowUpdate</code> method has been called, then the changes * the <code>rowUpdate</code> method has been called, then the changes
* cannot be undone. * cannot be undone.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void cancelRowUpdates() throws SQLException;
cancelRowUpdates() throws SQLException;
/*************************************************************************/ /**
/**
* This method positions the result set to the "insert row", which allows * This method positions the result set to the "insert row", which allows
* a new row to be inserted into the database from the result set. * a new row to be inserted into the database from the result set.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void moveToInsertRow() throws SQLException;
moveToInsertRow() throws SQLException;
/*************************************************************************/ /**
/**
* This method moves the result set position from the insert row back to * This method moves the result set position from the insert row back to
* the current row that was selected prior to moving to the insert row. * the current row that was selected prior to moving to the insert row.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void moveToCurrentRow() throws SQLException;
moveToCurrentRow() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns a the <code>Statement</code> that was used to * This method returns a the <code>Statement</code> that was used to
* produce this result set. * produce this result set.
* *
...@@ -1756,158 +1298,105 @@ moveToCurrentRow() throws SQLException; ...@@ -1756,158 +1298,105 @@ moveToCurrentRow() throws SQLException;
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Statement public Statement getStatement() throws SQLException;
getStatement() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>Object</code> using the specified SQL type to Java type map. * <code>Object</code> using the specified SQL type to Java type map.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
* @param map The SQL type to Java type map to use. * @param map The SQL type to Java type map to use.
*
* @return The value of the column as an <code>Object</code>. * @return The value of the column as an <code>Object</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Object public Object getObject(int i, Map map) throws SQLException;
getObject(int index, Map map) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns a <code>Ref</code> for the specified column which * This method returns a <code>Ref</code> for the specified column which
* represents the structured type for the column. * represents the structured type for the column.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return A <code>Ref</code> object for the column * @return A <code>Ref</code> object for the column
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public Ref public Ref getRef(int i) throws SQLException;
getRef(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the specified column value as a BLOB. * This method returns the specified column value as a BLOB.
* *
* @param index The index of the column value to return. * @param index The index of the column value to return.
*
* @return The value of the column as a BLOB. * @return The value of the column as a BLOB.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Blob public Blob getBlob(int i) throws SQLException;
getBlob(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the specified column value as a CLOB. * This method returns the specified column value as a CLOB.
* *
* @param index The index of the column value to return. * @param index The index of the column value to return.
*
* @return The value of the column as a CLOB. * @return The value of the column as a CLOB.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Clob public Clob getClob(int i) throws SQLException;
getClob(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the specified column value as an <code>Array</code>. * This method returns the specified column value as an <code>Array</code>.
* *
* @param index The index of the column value to return. * @param index The index of the column value to return.
*
* @return The value of the column as an <code>Array</code>. * @return The value of the column as an <code>Array</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Array public Array getArray(int i) throws SQLException;
getArray(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the value of the specified column as a Java * This method returns the value of the specified column as a Java
* <code>Object</code> using the specified SQL type to Java type map. * <code>Object</code> using the specified SQL type to Java type map.
* *
* @param name The name of the column to return. * @param name The name of the column to return.
* @param map The SQL type to Java type map to use. * @param map The SQL type to Java type map to use.
*
* @return The value of the column as an <code>Object</code>. * @return The value of the column as an <code>Object</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Object public Object getObject(String colName, Map map) throws SQLException;
getObject(String name, Map map) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns a <code>Ref</code> for the specified column which * This method returns a <code>Ref</code> for the specified column which
* represents the structured type for the column. * represents the structured type for the column.
* *
* @param index The index of the column to return. * @param index The index of the column to return.
*
* @return A <code>Ref</code> object for the column * @return A <code>Ref</code> object for the column
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public Ref public Ref getRef(String colName) throws SQLException;
getRef(String name) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the specified column value as a BLOB. * This method returns the specified column value as a BLOB.
* *
* @param name The name of the column value to return. * @param name The name of the column value to return.
*
* @return The value of the column as a BLOB. * @return The value of the column as a BLOB.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Blob public Blob getBlob(String colName) throws SQLException;
getBlob(String name) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the specified column value as a CLOB. * This method returns the specified column value as a CLOB.
* *
* @param name The name of the column value to return. * @param name The name of the column value to return.
*
* @return The value of the column as a CLOB. * @return The value of the column as a CLOB.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Clob public Clob getClob(String colName) throws SQLException;
getClob(String name) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the specified column value as an <code>Array</code>. * This method returns the specified column value as an <code>Array</code>.
* *
* @param name The name of the column value to return. * @param name The name of the column value to return.
*
* @return The value of the column as an <code>Array</code>. * @return The value of the column as an <code>Array</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Array public Array getArray(String colName) throws SQLException;
getArray(String name) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the specified column value as a * This method returns the specified column value as a
* <code>java.sql.Date</code>. The specified <code>Calendar</code> is used * <code>java.sql.Date</code>. The specified <code>Calendar</code> is used
* to generate a value for the date if the database does not support * to generate a value for the date if the database does not support
...@@ -1915,89 +1404,65 @@ getArray(String name) throws SQLException; ...@@ -1915,89 +1404,65 @@ getArray(String name) throws SQLException;
* *
* @param index The index of the column value to return. * @param index The index of the column value to return.
* @param cal The <code>Calendar</code> to use for calculating timezones. * @param cal The <code>Calendar</code> to use for calculating timezones.
*
* @return The value of the column as a <code>java.sql.Date</code>. * @return The value of the column as a <code>java.sql.Date</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Date public Date getDate(int columnIndex, Calendar cal) throws SQLException;
getDate(int index, Calendar cal) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the specified column value as a * This method returns the specified column value as a
* <code>java.sql.Time</code>. The specified <code>Calendar</code> is used * <code>java.sql.Date</code>. The specified <code>Calendar</code> is used
* to generate a value for the time if the database does not support * to generate a value for the date if the database does not support
* timezones. * timezones.
* *
* @param index The index of the column value to return. * @param name The name of the column value to return.
* @param cal The <code>Calendar</code> to use for calculating timezones. * @param cal The <code>Calendar</code> to use for calculating timezones.
* * @return The value of the column as a <code>java.sql.Date</code>.
* @return The value of the column as a <code>java.sql.Time</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Time public Date getDate(String columnName, Calendar cal) throws SQLException;
getTime(int index, Calendar cal) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the specified column value as a * This method returns the specified column value as a
* <code>java.sql.Timestamp</code>. The specified <code>Calendar</code> is used * <code>java.sql.Time</code>. The specified <code>Calendar</code> is used
* to generate a value for the timestamp if the database does not support * to generate a value for the time if the database does not support
* timezones. * timezones.
* *
* @param index The index of the column value to return. * @param index The index of the column value to return.
* @param cal The <code>Calendar</code> to use for calculating timezones. * @param cal The <code>Calendar</code> to use for calculating timezones.
* * @return The value of the column as a <code>java.sql.Time</code>.
* @return The value of the column as a <code>java.sql.Timestamp</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Timestamp public Time getTime(int columnIndex, Calendar cal) throws SQLException;
getTimestamp(int index, Calendar cal) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the specified column value as a * This method returns the specified column value as a
* <code>java.sql.Date</code>. The specified <code>Calendar</code> is used * <code>java.sql.Time</code>. The specified <code>Calendar</code> is used
* to generate a value for the date if the database does not support * to generate a value for the time if the database does not support
* timezones. * timezones.
* *
* @param name The name of the column value to return. * @param name The name of the column value to return.
* @param cal The <code>Calendar</code> to use for calculating timezones. * @param cal The <code>Calendar</code> to use for calculating timezones.
* * @return The value of the column as a <code>java.sql.Time</code>.
* @return The value of the column as a <code>java.sql.Date</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Date public Time getTime(String columnName, Calendar cal) throws SQLException;
getDate(String name, Calendar cal) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the specified column value as a * This method returns the specified column value as a
* <code>java.sql.Time</code>. The specified <code>Calendar</code> is used * <code>java.sql.Timestamp</code>. The specified <code>Calendar</code> is used
* to generate a value for the time if the database does not support * to generate a value for the timestamp if the database does not support
* timezones. * timezones.
* *
* @param name The name of the column value to return. * @param index The index of the column value to return.
* @param cal The <code>Calendar</code> to use for calculating timezones. * @param cal The <code>Calendar</code> to use for calculating timezones.
* * @return The value of the column as a <code>java.sql.Timestamp</code>.
* @return The value of the column as a <code>java.sql.Time</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Time public Timestamp getTimestamp(int columnIndex, Calendar cal)
getTime(String name, Calendar cal) throws SQLException; throws SQLException;
/*************************************************************************/
/** /**
* This method returns the specified column value as a * This method returns the specified column value as a
* <code>java.sql.Timestamp</code>. The specified <code>Calendar</code> is used * <code>java.sql.Timestamp</code>. The specified <code>Calendar</code> is used
* to generate a value for the timestamp if the database does not support * to generate a value for the timestamp if the database does not support
...@@ -2010,8 +1475,56 @@ getTime(String name, Calendar cal) throws SQLException; ...@@ -2010,8 +1475,56 @@ getTime(String name, Calendar cal) throws SQLException;
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Timestamp public Timestamp getTimestamp(String columnName, Calendar cal)
getTimestamp(String name, Calendar cal) throws SQLException; throws SQLException;
/**
* @since 1.4
*/
public URL getURL(int columnIndex) throws SQLException;
} // interface ResultSet /**
* @since 1.4
*/
public URL getURL(String columnName) throws SQLException;
/**
* @since 1.4
*/
public void updateRef(int columnIndex, Ref x) throws SQLException;
/**
* @since 1.4
*/
public void updateRef(String columnName, Ref x) throws SQLException;
/**
* @since 1.4
*/
public void updateBlob(int columnIndex, Blob x) throws SQLException;
/**
* @since 1.4
*/
public void updateBlob(String columnName, Blob x) throws SQLException;
/**
* @since 1.4
*/
public void updateClob(int columnIndex, Clob x) throws SQLException;
/**
* @since 1.4
*/
public void updateClob(String columnName, Clob x) throws SQLException;
/**
* @since 1.4
*/
public void updateArray(int columnIndex, Array x) throws SQLException;
/**
* @since 1.4
*/
public void updateArray(String columnName, Array x) throws SQLException;
}
/* ResultSetMetaData.java -- Returns information about the ResultSet /* ResultSetMetaData.java -- Returns information about the ResultSet
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -48,342 +48,234 @@ package java.sql; ...@@ -48,342 +48,234 @@ package java.sql;
*/ */
public interface ResultSetMetaData public interface ResultSetMetaData
{ {
/**
/**
* The column does not allow NULL's. * The column does not allow NULL's.
*/ */
public static final int columnNoNulls = 0; public static final int columnNoNulls = 0;
/** /**
* The column allows NULL's. * The column allows NULL's.
*/ */
public static final int columnNullable = 1; public static final int columnNullable = 1;
/** /**
* It is unknown whether or not the column allows NULL's. * It is unknown whether or not the column allows NULL's.
*/ */
public static final int columnNullableUnknown = 2; public static final int columnNullableUnknown = 2;
/*************************************************************************/
/** /**
* This method returns the number of columns in the result set. * This method returns the number of columns in the result set.
* *
* @return The number of columns in the result set. * @return The number of columns in the result set.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getColumnCount() throws SQLException;
getColumnCount() throws SQLException;
/*************************************************************************/
/** /**
* This method test whether or not the column is an auto-increment column. * This method test whether or not the column is an auto-increment column.
* Auto-increment columns are read-only. * Auto-increment columns are read-only.
* *
* @param index The index of the column to test. * @param index The index of the column to test.
*
* @return <code>true</code> if the column is auto-increment, <code>false</code> * @return <code>true</code> if the column is auto-increment, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isAutoIncrement(int column) throws SQLException;
isAutoIncrement(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not a column is case sensitive in its values. * This method tests whether or not a column is case sensitive in its values.
* *
* @param index The index of the column to test. * @param index The index of the column to test.
*
* @return <code>true</code> if the column value is case sensitive, * @return <code>true</code> if the column value is case sensitive,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isCaseSensitive(int column) throws SQLException;
isCaseSensitive(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method tests whether not the specified column can be used in * This method tests whether not the specified column can be used in
* a WHERE clause. * a WHERE clause.
* *
* @param index The index of the column to test. * @param index The index of the column to test.
*
* @return <code>true</code> if the column may be used in a WHERE clause, * @return <code>true</code> if the column may be used in a WHERE clause,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isSearchable(int column) throws SQLException;
isSearchable(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the column stores a monetary value. * This method tests whether or not the column stores a monetary value.
* *
* @param index The index of the column to test. * @param index The index of the column to test.
*
* @return <code>true</code> if the column contains a monetary value, * @return <code>true</code> if the column contains a monetary value,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isCurrency(int column) throws SQLException;
isCurrency(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns a value indicating whether or not the specified * This method returns a value indicating whether or not the specified
* column may contain a NULL value. * column may contain a NULL value.
* *
* @param index The index of the column to test. * @param index The index of the column to test.
*
* @return A constant indicating whether or not the column can contain NULL, * @return A constant indicating whether or not the column can contain NULL,
* which will be one of <code>columnNoNulls</code>, * which will be one of <code>columnNoNulls</code>,
* <code>columnNullable</code>, or <code>columnNullableUnknown</code>. * <code>columnNullable</code>, or <code>columnNullableUnknown</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int isNullable(int column) throws SQLException;
isNullable(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the value of the specified column * This method tests whether or not the value of the specified column
* is signed or unsigned. * is signed or unsigned.
* *
* @param index The index of the column to test. * @param index The index of the column to test.
*
* @return <code>true</code> if the column value is signed, <code>false</code> * @return <code>true</code> if the column value is signed, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isSigned(int column) throws SQLException;
isSigned(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the maximum number of characters that can be used * This method returns the maximum number of characters that can be used
* to display a value in this column. * to display a value in this column.
* *
* @param index The index of the column to check. * @param index The index of the column to check.
*
* @return The maximum number of characters that can be used to display a * @return The maximum number of characters that can be used to display a
* value for this column. * value for this column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getColumnDisplaySize(int column) throws SQLException;
getColumnDisplaySize(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns a string that should be used as a caption for this * This method returns a string that should be used as a caption for this
* column for user display purposes. * column for user display purposes.
* *
* @param index The index of the column to check. * @param index The index of the column to check.
*
* @return A display string for the column. * @return A display string for the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getColumnLabel(int column) throws SQLException;
getColumnLabel(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the name of the specified column. * This method returns the name of the specified column.
* *
* @param index The index of the column to return the name of. * @param index The index of the column to return the name of.
*
* @return The name of the column. * @return The name of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getColumnName(int column) throws SQLException;
getColumnName(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the name of the schema that contains the specified * This method returns the name of the schema that contains the specified
* column. * column.
* *
* @param index The index of the column to check the schema name for. * @param index The index of the column to check the schema name for.
*
* @return The name of the schema that contains the column. * @return The name of the schema that contains the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getSchemaName(int column) throws SQLException;
getSchemaName(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the precision of the specified column, which is the * This method returns the precision of the specified column, which is the
* number of decimal digits it contains. * number of decimal digits it contains.
* *
* @param index The index of the column to check the precision on. * @param index The index of the column to check the precision on.
*
* @return The precision of the specified column. * @return The precision of the specified column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getPrecision(int column) throws SQLException;
getPrecision(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the scale of the specified column, which is the * This method returns the scale of the specified column, which is the
* number of digits to the right of the decimal point. * number of digits to the right of the decimal point.
* *
* @param index The index column to check the scale of. * @param index The index column to check the scale of.
*
* @return The scale of the column. * @return The scale of the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getScale(int column) throws SQLException;
getScale(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the name of the table containing the specified * This method returns the name of the table containing the specified
* column. * column.
* *
* @param index The index of the column to check the table name for. * @param index The index of the column to check the table name for.
*
* @return The name of the table containing the column. * @return The name of the table containing the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getTableName(int column) throws SQLException;
getTableName(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the name of the catalog containing the specified * This method returns the name of the catalog containing the specified
* column. * column.
* *
* @param index The index of the column to check the catalog name for. * @param index The index of the column to check the catalog name for.
*
* @return The name of the catalog containing the column. * @return The name of the catalog containing the column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getCatalogName(int column) throws SQLException;
getCatalogName(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the SQL type of the specified column. This will * This method returns the SQL type of the specified column. This will
* be one of the constants from <code>Types</code>. * be one of the constants from <code>Types</code>.
* *
* @param index The index of the column to check the SQL type of. * @param index The index of the column to check the SQL type of.
*
* @return The SQL type for this column. * @return The SQL type for this column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see Types * @see Types
*/ */
public abstract int public int getColumnType(int column) throws SQLException;
getColumnType(int index) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the name of the SQL type for this column. * This method returns the name of the SQL type for this column.
* *
* @param index The index of the column to check the SQL type name for. * @param index The index of the column to check the SQL type name for.
*
* @return The name of the SQL type for this column. * @return The name of the SQL type for this column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getColumnTypeName(int column) throws SQLException;
getColumnTypeName(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the specified column is read only. * This method tests whether or not the specified column is read only.
* *
* @param index The index of the column to check. * @param index The index of the column to check.
*
* @return <code>true</code> if the column is read only, <code>false</code> * @return <code>true</code> if the column is read only, <code>false</code>
* otherwise. * otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isReadOnly(int column) throws SQLException;
isReadOnly(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the column may be writable. This * This method tests whether or not the column may be writable. This
* does not guarantee that a write will be successful. * does not guarantee that a write will be successful.
* *
* @param index The index of the column to check for writability. * @param index The index of the column to check for writability.
*
* @return <code>true</code> if the column may be writable, * @return <code>true</code> if the column may be writable,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isWritable(int column) throws SQLException;
isWritable(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the column is writable. This * This method tests whether or not the column is writable. This
* does guarantee that a write will be successful. * does guarantee that a write will be successful.
* *
* @param index The index of the column to check for writability. * @param index The index of the column to check for writability.
*
* @return <code>true</code> if the column is writable, * @return <code>true</code> if the column is writable,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean isDefinitelyWritable(int column) throws SQLException;
isDefinitelyWritable(int index) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the name of the Java class which will be used to * This method returns the name of the Java class which will be used to
* create objects representing the data in this column. * create objects representing the data in this column.
* *
* @param index The index of the column to check. * @param index The index of the column to check.
*
* @return The name of the Java class that will be used for values in * @return The name of the Java class that will be used for values in
* this column. * this column.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getColumnClassName(int column) throws SQLException;
getColumnClassName(int index) throws SQLException; }
} // interface ResultSetMetaData
...@@ -45,41 +45,28 @@ package java.sql; ...@@ -45,41 +45,28 @@ package java.sql;
*/ */
public interface SQLData public interface SQLData
{ {
/**
/**
* This method returns the user defined datatype name for this object. * This method returns the user defined datatype name for this object.
* *
* @return The user defined data type name for this object. * @return The user defined data type name for this object.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getSQLTypeName() throws SQLException;
getSQLTypeName() throws SQLException;
/*************************************************************************/ /**
/**
* This method populates the data in the object from the specified stream. * This method populates the data in the object from the specified stream.
* *
* @param stream The stream to read the data from. * @param stream The stream to read the data from.
* @param name The data type name of the data on the stream. * @param name The data type name of the data on the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void readSQL(SQLInput stream, String typeName) throws SQLException;
readSQL(SQLInput stream, String name) throws SQLException;
/*************************************************************************/ /**
/**
* This method writes the data in this object to the specified stream. * This method writes the data in this object to the specified stream.
* *
* @param stream The stream to write the data to. * @param stream The stream to write the data to.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeSQL(SQLOutput stream) throws SQLException;
writeSQL(SQLOutput stream) throws SQLException; }
} // interface SQLData
...@@ -45,77 +45,40 @@ package java.sql; ...@@ -45,77 +45,40 @@ package java.sql;
*/ */
public class SQLException extends Exception public class SQLException extends Exception
{ {
static final long serialVersionUID = 2135244094396331484L;
/*************************************************************************/ /**
/*
* Instance Variables
*/
/**
* This is the next exception in the chain * This is the next exception in the chain
* @serialized
*/ */
private SQLException next; private SQLException next;
/** /**
* This is the state of the SQL statement at the time of the error. * This is the state of the SQL statement at the time of the error.
* @serialized
*/ */
private String SQLState; private String SQLState;
/** /**
* The vendor error code for this error * The vendor error code for this error
* @serialized
*/
private int vendorCode;
/*************************************************************************/
/**
* Static Variables
*/
/**
* This is the serialization UID for this class
*/
private static final long serialVersionUID = 2135244094396331484L;
/*************************************************************************/
/*
* Constructors
*/
/**
* This method initializes a new instance of <code>SQLException</code>
* that does not have a descriptive messages and SQL state, and which
* has a vendor error code of 0.
*/ */
public private int vendorCode;
SQLException()
{
this(null, null, 0);
}
/*************************************************************************/
/** /**
* This method initializes a new instance of <code>SQLException</code> * This method initializes a nwe instance of <code>SQLException</code>
* with the specified descriptive error message. The SQL state of this * with the specified descriptive error message, SQL state string, and
* instance will be <code>null</code> and the vendor error code will be 0. * vendor code.
* *
* @param message A string describing the nature of the error. * @param message A string describing the nature of the error.
* @param SQLState A string containing the SQL state of the error.
* @param vendorCode The vendor error code associated with this error.
*/ */
public public SQLException(String message, String SQLState, int vendorCode)
SQLException(String message) {
{ super(message);
this(message, null, 0); this.SQLState = SQLState;
} this.vendorCode = vendorCode;
}
/*************************************************************************/
/** /**
* This method initializes a new instance of <code>SQLException</code> * This method initializes a new instance of <code>SQLException</code>
* with the specified descriptive error message and SQL state string. * with the specified descriptive error message and SQL state string.
* The vendor error code of this instance will be 0. * The vendor error code of this instance will be 0.
...@@ -123,90 +86,75 @@ SQLException(String message) ...@@ -123,90 +86,75 @@ SQLException(String message)
* @param message A string describing the nature of the error. * @param message A string describing the nature of the error.
* @param SQLState A string containing the SQL state of the error. * @param SQLState A string containing the SQL state of the error.
*/ */
public public SQLException(String message, String SQLState)
SQLException(String message, String SQLState) {
{
this(message, SQLState, 0); this(message, SQLState, 0);
} }
/*************************************************************************/ /**
* This method initializes a new instance of <code>SQLException</code>
/** * with the specified descriptive error message. The SQL state of this
* This method initializes a nwe instance of <code>SQLException</code> * instance will be <code>null</code> and the vendor error code will be 0.
* with the specified descriptive error message, SQL state string, and
* vendor code.
* *
* @param message A string describing the nature of the error. * @param message A string describing the nature of the error.
* @param SQLState A string containing the SQL state of the error.
* @param vendorCode The vendor error code associated with this error.
*/ */
public public SQLException(String message)
SQLException(String message, String SQLState, int vendorCode) {
{ this(message, null, 0);
super(message); }
this.SQLState = SQLState;
this.vendorCode = vendorCode;
}
/*************************************************************************/
/* /**
* Instance Methods * This method initializes a new instance of <code>SQLException</code>
* that does not have a descriptive messages and SQL state, and which
* has a vendor error code of 0.
*/ */
public SQLException()
{
this(null, null, 0);
}
/** /**
* This method returns the SQLState information associated with this * This method returns the SQLState information associated with this
* error. The value returned is a <code>String</code> which is formatted * error. The value returned is a <code>String</code> which is formatted
* using the XOPEN SQL state conventions. * using the XOPEN SQL state conventions.
* *
* @return The SQL state, which may be <code>null</code>. * @return The SQL state, which may be <code>null</code>.
*/ */
public String public String getSQLState()
getSQLState() {
{ return SQLState;
return(SQLState); }
}
/*************************************************************************/
/** /**
* This method returns the vendor specific error code associated with * This method returns the vendor specific error code associated with
* this error. * this error.
* *
* @return The vendor specific error code associated with this error. * @return The vendor specific error code associated with this error.
*/ */
public int public int getErrorCode()
getErrorCode() {
{ return vendorCode;
return(vendorCode); }
}
/*************************************************************************/
/** /**
* This method returns the exception that is chained to this object. * This method returns the exception that is chained to this object.
* *
* @return The exception chained to this object, which may be * @return The exception chained to this object, which may be
* <code>null</code>. * <code>null</code>.
*/ */
public SQLException public SQLException getNextException()
getNextException() {
{ return next;
return(next); }
}
/*************************************************************************/ /**
/**
* This method adds a new exception to the end of the chain of exceptions * This method adds a new exception to the end of the chain of exceptions
* that are chained to this object. * that are chained to this object.
* *
* @param e The exception to add to the end of the chain. * @param e The exception to add to the end of the chain.
*/ */
public void public void setNextException(SQLException e)
setNextException(SQLException e) {
{
if (e == null) if (e == null)
return; return;
...@@ -215,7 +163,5 @@ setNextException(SQLException e) ...@@ -215,7 +163,5 @@ setNextException(SQLException e)
list_entry = list_entry.getNextException(); list_entry = list_entry.getNextException();
list_entry.next = e; list_entry.next = e;
}
} }
} // class SQLException
/* SQLInput.java -- Read SQL values from a stream /* SQLInput.java -- Read SQL values from a stream
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -41,6 +41,7 @@ package java.sql; ...@@ -41,6 +41,7 @@ package java.sql;
import java.io.InputStream; import java.io.InputStream;
import java.io.Reader; import java.io.Reader;
import java.math.BigDecimal; import java.math.BigDecimal;
import java.net.URL;
/** /**
* This interface provides methods for reading values from a stream * This interface provides methods for reading values from a stream
...@@ -51,293 +52,208 @@ import java.math.BigDecimal; ...@@ -51,293 +52,208 @@ import java.math.BigDecimal;
*/ */
public interface SQLInput public interface SQLInput
{ {
/**
/*************************************************************************/
/**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>String</code>. * <code>String</code>.
* *
* @return The value read from the stream as a <code>String</code>. * @return The value read from the stream as a <code>String</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String readString() throws SQLException;
readString() throws SQLException;
/*************************************************************************/
/** /**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>boolean</code>. * <code>boolean</code>.
* *
* @return The value read from the stream as a <code>boolean</code>. * @return The value read from the stream as a <code>boolean</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean readBoolean() throws SQLException;
readBoolean() throws SQLException;
/*************************************************************************/
/** /**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>byte</code>. * <code>byte</code>.
* *
* @return The value read from the stream as a <code>byte</code>. * @return The value read from the stream as a <code>byte</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract byte public byte readByte() throws SQLException;
readByte() throws SQLException;
/*************************************************************************/ /**
/**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>short</code>. * <code>short</code>.
* *
* @return The value read from the stream as a <code>short</code>. * @return The value read from the stream as a <code>short</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract short public short readShort() throws SQLException;
readShort() throws SQLException;
/*************************************************************************/ /**
/**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>int</code>. * <code>int</code>.
* *
* @return The value read from the stream as an <code>int</code>. * @return The value read from the stream as an <code>int</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int readInt() throws SQLException;
readInt() throws SQLException;
/*************************************************************************/
/** /**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>long</code>. * <code>long</code>.
* *
* @return The value read from the stream as a <code>long</code>. * @return The value read from the stream as a <code>long</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract long public long readLong() throws SQLException;
readLong() throws SQLException;
/*************************************************************************/
/** /**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>float</code>. * <code>float</code>.
* *
* @return The value read from the stream as a <code>float</code>. * @return The value read from the stream as a <code>float</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract float public float readFloat() throws SQLException;
readFloat() throws SQLException;
/*************************************************************************/
/** /**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>double</code>. * <code>double</code>.
* *
* @return The value read from the stream as a <code>double</code>. * @return The value read from the stream as a <code>double</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract double public double readDouble() throws SQLException;
readDouble() throws SQLException;
/*************************************************************************/ /**
/**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>BigDecimal</code>. * <code>BigDecimal</code>.
* *
* @return The value read from the stream as a <code>BigDecimal</code>. * @return The value read from the stream as a <code>BigDecimal</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract BigDecimal public BigDecimal readBigDecimal() throws SQLException;
readBigDecimal() throws SQLException;
/*************************************************************************/ /**
/**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* byte array * byte array
* *
* @return The value read from the stream as a byte array. * @return The value read from the stream as a byte array.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract byte[] public byte[] readBytes() throws SQLException;
readBytes() throws SQLException;
/*************************************************************************/
/** /**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>java.sql.Date</code>. * <code>java.sql.Date</code>.
* *
* @return The value read from the stream as a <code>java.sql.Date</code>. * @return The value read from the stream as a <code>java.sql.Date</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Date public Date readDate() throws SQLException;
readDate() throws SQLException;
/*************************************************************************/
/** /**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>java.sql.Time</code>. * <code>java.sql.Time</code>.
* *
* @return The value read from the stream as a <code>java.sql.Time</code>. * @return The value read from the stream as a <code>java.sql.Time</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Time public Time readTime() throws SQLException;
readTime() throws SQLException;
/*************************************************************************/
/** /**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>java.sql.Timestamp</code>. * <code>java.sql.Timestamp</code>.
* *
* @return The value read from the stream as a <code>java.sql.Timestamp</code>. * @return The value read from the stream as a <code>java.sql.Timestamp</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract java.sql.Timestamp public Timestamp readTimestamp() throws SQLException;
readTimestamp() throws SQLException;
/*************************************************************************/ /**
* This method reads the next item from the stream a character
* <code>Reader</code>.
*
* @return The value read from the stream as a <code>Reader</code>.
* @exception SQLException If an error occurs.
*/
public Reader readCharacterStream() throws SQLException;
/** /**
* This method reads the next item from the stream a ASCII text * This method reads the next item from the stream a ASCII text
* <code>InputStream</code>. * <code>InputStream</code>.
* *
* @return The value read from the stream as an <code>InputStream</code>. * @return The value read from the stream as an <code>InputStream</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract InputStream public InputStream readAsciiStream() throws SQLException;
readAsciiStream() throws SQLException;
/*************************************************************************/ /**
/**
* This method reads the next item from the stream a binary * This method reads the next item from the stream a binary
* <code>InputStream</code>. * <code>InputStream</code>.
* *
* @return The value read from the stream as an <code>InputStream</code>. * @return The value read from the stream as an <code>InputStream</code>.
*
* @exception SQLException If an error occurs.
*/
public abstract InputStream
readBinaryStream() throws SQLException;
/*************************************************************************/
/**
* This method reads the next item from the stream a character
* <code>Reader</code>.
*
* @return The value read from the stream as a <code>Reader</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Reader public InputStream readBinaryStream() throws SQLException;
readCharacterStream() throws SQLException;
/*************************************************************************/
/** /**
* This method reads the next item from the stream a Java * This method reads the next item from the stream a Java
* <code>Object</code>. * <code>Object</code>.
* *
* @return The value read from the stream as an <code>Object</code>. * @return The value read from the stream as an <code>Object</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Object public Object readObject() throws SQLException;
readObject() throws SQLException;
/*************************************************************************/
/** /**
* This method reads the next item from the stream a Java SQL * This method reads the next item from the stream a Java SQL
* <code>Ref</code>. * <code>Ref</code>.
* *
* @return The value read from the stream as an <code>Ref</code>. * @return The value read from the stream as an <code>Ref</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Ref public Ref readRef() throws SQLException;
readRef() throws SQLException;
/*************************************************************************/
/** /**
* This method reads the next item from the stream a Java SQL * This method reads the next item from the stream a Java SQL
* <code>Blob</code>. * <code>Blob</code>.
* *
* @return The value read from the stream as a <code>Blob</code>. * @return The value read from the stream as a <code>Blob</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Blob public Blob readBlob() throws SQLException;
readBlob() throws SQLException;
/*************************************************************************/ /**
/**
* This method reads the next item from the stream a Java SQL * This method reads the next item from the stream a Java SQL
* <code>Clob</code>. * <code>Clob</code>.
* *
* @return The value read from the stream as a <code>Clob</code>. * @return The value read from the stream as a <code>Clob</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Clob public Clob readClob() throws SQLException;
readClob() throws SQLException;
/*************************************************************************/ /**
/**
* This method reads the next item from the stream a Java SQL * This method reads the next item from the stream a Java SQL
* <code>Array</code>. * <code>Array</code>.
* *
* @return The value read from the stream as an <code>Array</code>. * @return The value read from the stream as an <code>Array</code>.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Array public Array readArray() throws SQLException;
readArray() throws SQLException;
/*************************************************************************/
/** /**
* This method tests whether or not the last value read was a SQL * This method tests whether or not the last value read was a SQL
* NULL value. * NULL value.
* *
* @return <code>true</code> if the last value read was a NULL, * @return <code>true</code> if the last value read was a NULL,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean wasNull() throws SQLException;
wasNull() throws SQLException;
} // interface SQLInput /**
* @since 1.4
*/
public URL readURL() throws SQLException;
}
/* SQLOutput.java -- Write SQL values to a stream /* SQLOutput.java -- Write SQL values to a stream
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -41,6 +41,7 @@ package java.sql; ...@@ -41,6 +41,7 @@ package java.sql;
import java.io.InputStream; import java.io.InputStream;
import java.io.Reader; import java.io.Reader;
import java.math.BigDecimal; import java.math.BigDecimal;
import java.net.URL;
/** /**
* This interface provides methods for writing Java types to a SQL stream. * This interface provides methods for writing Java types to a SQL stream.
...@@ -51,292 +52,206 @@ import java.math.BigDecimal; ...@@ -51,292 +52,206 @@ import java.math.BigDecimal;
*/ */
public interface SQLOutput public interface SQLOutput
{ {
/**
/*************************************************************************/
/**
* This method writes the specified Java <code>String</code> * This method writes the specified Java <code>String</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeString(String x) throws SQLException;
writeString(String value) throws SQLException;
/*************************************************************************/
/** /**
* This method writes the specified Java <code>boolean</code> * This method writes the specified Java <code>boolean</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeBoolean(boolean x) throws SQLException;
writeBoolean(boolean value) throws SQLException;
/*************************************************************************/
/** /**
* This method writes the specified Java <code>byte</code> * This method writes the specified Java <code>byte</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeByte(byte x) throws SQLException;
writeByte(byte value) throws SQLException;
/*************************************************************************/ /**
/**
* This method writes the specified Java <code>short</code> * This method writes the specified Java <code>short</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeShort(short x) throws SQLException;
writeShort(short value) throws SQLException;
/*************************************************************************/ /**
/**
* This method writes the specified Java <code>int</code> * This method writes the specified Java <code>int</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeInt(int x) throws SQLException;
writeInt(int value) throws SQLException;
/*************************************************************************/
/** /**
* This method writes the specified Java <code>long</code> * This method writes the specified Java <code>long</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeLong(long x) throws SQLException;
writeLong(long value) throws SQLException;
/*************************************************************************/ /**
/**
* This method writes the specified Java <code>float</code> * This method writes the specified Java <code>float</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeFloat(float x) throws SQLException;
writeFloat(float value) throws SQLException;
/*************************************************************************/ /**
/**
* This method writes the specified Java <code>double</code> * This method writes the specified Java <code>double</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeDouble(double x) throws SQLException;
writeDouble(double value) throws SQLException;
/*************************************************************************/
/** /**
* This method writes the specified Java <code>BigDecimal</code> * This method writes the specified Java <code>BigDecimal</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeBigDecimal(BigDecimal x) throws SQLException;
writeBigDecimal(BigDecimal value) throws SQLException;
/*************************************************************************/ /**
/**
* This method writes the specified Java <code>byte</code> array * This method writes the specified Java <code>byte</code> array
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeBytes(byte[] x) throws SQLException;
writeBytes(byte[] value) throws SQLException;
/*************************************************************************/ /**
/**
* This method writes the specified Java <code>java.sql.Date</code> * This method writes the specified Java <code>java.sql.Date</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeDate(Date x) throws SQLException;
writeDate(java.sql.Date value) throws SQLException;
/*************************************************************************/
/** /**
* This method writes the specified Java <code>java.sql.Time</code> * This method writes the specified Java <code>java.sql.Time</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeTime(Time x) throws SQLException;
writeTime(java.sql.Time value) throws SQLException;
/*************************************************************************/ /**
/**
* This method writes the specified Java <code>java.sql.Timestamp</code> * This method writes the specified Java <code>java.sql.Timestamp</code>
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeTimestamp(Timestamp x) throws SQLException;
writeTimestamp(java.sql.Timestamp value) throws SQLException;
/*************************************************************************/ /**
/**
* This method writes the specified Java character stream * This method writes the specified Java character stream
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeCharacterStream(Reader x) throws SQLException;
writeCharacterStream(Reader value) throws SQLException;
/*************************************************************************/
/** /**
* This method writes the specified uninterpreted binary byte stream * This method writes the specified ASCII text stream
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeAsciiStream(InputStream x) throws SQLException;
writeBinaryStream(InputStream value) throws SQLException;
/*************************************************************************/
/** /**
* This method writes the specified ASCII text stream * This method writes the specified uninterpreted binary byte stream
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeBinaryStream(InputStream x) throws SQLException;
writeAsciiStream(InputStream value) throws SQLException;
/*************************************************************************/ /**
/**
* This method writes the specified Java <code>SQLData</code> object * This method writes the specified Java <code>SQLData</code> object
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeObject(SQLData x) throws SQLException;
writeObject(SQLData value) throws SQLException;
/*************************************************************************/
/** /**
* This method writes the specified Java SQL <code>Ref</code> object * This method writes the specified Java SQL <code>Ref</code> object
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeRef(Ref x) throws SQLException;
writeRef(Ref value) throws SQLException;
/*************************************************************************/
/** /**
* This method writes the specified Java SQL <code>Blob</code> object * This method writes the specified Java SQL <code>Blob</code> object
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeBlob(Blob x) throws SQLException;
writeBlob(Blob value) throws SQLException;
/*************************************************************************/ /**
/**
* This method writes the specified Java SQL <code>Clob</code> object * This method writes the specified Java SQL <code>Clob</code> object
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeClob(Clob x) throws SQLException;
writeClob(Clob value) throws SQLException;
/*************************************************************************/
/** /**
* This method writes the specified Java SQL <code>Struct</code> object * This method writes the specified Java SQL <code>Struct</code> object
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeStruct(Struct x) throws SQLException;
writeStruct(Struct value) throws SQLException;
/*************************************************************************/
/** /**
* This method writes the specified Java SQL <code>Array</code> object * This method writes the specified Java SQL <code>Array</code> object
* to the SQL stream. * to the SQL stream.
* *
* @param value The value to write to the stream. * @param value The value to write to the stream.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void writeArray(Array x) throws SQLException;
writeArray(Array value) throws SQLException;
} // interface SQLOutput
/**
* @since 1.4
*/
public void writeURL(URL x) throws SQLException;
}
/* SQLPermission.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package java.sql;
import java.security.BasicPermission;
/**
* @since 1.3
*/
public final class SQLPermission extends BasicPermission
{
public SQLPermission(String name)
{
super(name);
}
public SQLPermission(String name, String actions)
{
super(name, actions);
}
}
/* SQLWarning.java -- Database access warnings. /* SQLWarning.java -- Database access warnings.
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -45,53 +45,23 @@ package java.sql; ...@@ -45,53 +45,23 @@ package java.sql;
*/ */
public class SQLWarning extends SQLException public class SQLWarning extends SQLException
{ {
static final long serialVersionUID = 3917336774604784856L;
/*************************************************************************/ /**
* This method initializes a nwe instance of <code>SQLWarning</code>
/** * with the specified descriptive error message, SQL state string, and
* Static Variables * vendor code.
*/
/**
* This is the serialization UID for this class
*/
private static final long serialVersionUID = 3917336774604784856L;
/*************************************************************************/
/*
* Constructors
*/
/**
* This method initializes a new instance of <code>SQLWarning</code>
* that does not have a descriptive messages and SQL state, and which
* has a vendor error code of 0.
*/
public
SQLWarning()
{
this(null, null, 0);
}
/*************************************************************************/
/**
* This method initializes a new instance of <code>SQLWarning</code>
* with the specified descriptive error message. The SQL state of this
* instance will be <code>null</code> and the vendor error code will be 0.
* *
* @param message A string describing the nature of the error. * @param message A string describing the nature of the error.
* @param SQLState A string containing the SQL state of the error.
* @param vendorCode The vendor error code associated with this error.
*/ */
public public SQLWarning(String reason, String SQLState, int vendorCode)
SQLWarning(String message) {
{ super(reason, SQLState, vendorCode);
this(message, null, 0); }
}
/*************************************************************************/
/** /**
* This method initializes a new instance of <code>SQLWarning</code> * This method initializes a new instance of <code>SQLWarning</code>
* with the specified descriptive error message and SQL state string. * with the specified descriptive error message and SQL state string.
* The vendor error code of this instance will be 0. * The vendor error code of this instance will be 0.
...@@ -99,60 +69,52 @@ SQLWarning(String message) ...@@ -99,60 +69,52 @@ SQLWarning(String message)
* @param message A string describing the nature of the error. * @param message A string describing the nature of the error.
* @param SQLState A string containing the SQL state of the error. * @param SQLState A string containing the SQL state of the error.
*/ */
public public SQLWarning(String message, String SQLState)
SQLWarning(String message, String SQLState) {
{ super(message, SQLState);
this(message, SQLState, 0); }
}
/*************************************************************************/
/** /**
* This method initializes a nwe instance of <code>SQLWarning</code> * This method initializes a new instance of <code>SQLWarning</code>
* with the specified descriptive error message, SQL state string, and * with the specified descriptive error message. The SQL state of this
* vendor code. * instance will be <code>null</code> and the vendor error code will be 0.
* *
* @param message A string describing the nature of the error. * @param message A string describing the nature of the error.
* @param SQLState A string containing the SQL state of the error.
* @param vendorCode The vendor error code associated with this error.
*/ */
public public SQLWarning(String message)
SQLWarning(String message, String SQLState, int vendorCode) {
{ super(message);
super(message, SQLState, vendorCode); }
}
/*************************************************************************/ /**
* This method initializes a new instance of <code>SQLWarning</code>
/* * that does not have a descriptive messages and SQL state, and which
* Instance Methods * has a vendor error code of 0.
*/ */
public SQLWarning()
{
super();
}
/** /**
* This method returns the exception that is chained to this object. * This method returns the exception that is chained to this object.
* *
* @return The exception chained to this object, which may be * @return The exception chained to this object, which may be
* <code>null</code>. * <code>null</code>.
*/ */
public SQLWarning public SQLWarning getNextWarning()
getNextWarning() {
{ return (SQLWarning) super.getNextException();
return((SQLWarning)super.getNextException()); }
}
/*************************************************************************/ /**
/**
* This method adds a new exception to the end of the chain of exceptions * This method adds a new exception to the end of the chain of exceptions
* that are chained to this object. * that are chained to this object.
* *
* @param e The exception to add to the end of the chain. * @param w The exception to add to the end of the chain.
*/ */
public void public void setNextWarning(SQLWarning w)
setNextWarning(SQLWarning e) {
{ super.setNextException(w);
super.setNextException(e); }
} }
} // class SQLWarning
/* SavePoint.java -- Returns information about the ResultSet
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package java.sql;
/**
* @since 1.4
*/
public interface Savepoint
{
/**
* @since 1.4
*/
public int getSavepointId() throws SQLException;
/**
* @since 1.4
*/
public String getSavepointName() throws SQLException;
}
/* Statement.java -- Interface for executing SQL statements. /* Statement.java -- Interface for executing SQL statements.
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -45,380 +45,322 @@ package java.sql; ...@@ -45,380 +45,322 @@ package java.sql;
*/ */
public interface Statement public interface Statement
{ {
public static final int CLOSE_CURRENT_RESULT = 1;
/** public static final int KEEP_CURRENT_RESULT = 2;
public static final int CLOSE_ALL_RESULTS = 3;
public static final int SUCCESS_NO_INFO = -2;
public static final int EXECUTE_FAILED = -3;
public static final int RETURN_GENERATED_KEYS = 1;
public static final int NO_GENERATED_KEYS = 2;
/**
* This method executes the specified SQL SELECT statement and returns a * This method executes the specified SQL SELECT statement and returns a
* (possibly empty) <code>ResultSet</code> with the results of the query. * (possibly empty) <code>ResultSet</code> with the results of the query.
* *
* @param sql The SQL statement to execute. * @param sql The SQL statement to execute.
*
* @return The result set of the SQL statement. * @return The result set of the SQL statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract ResultSet public ResultSet executeQuery(String sql) throws SQLException;
executeQuery(String sql) throws SQLException;
/*************************************************************************/ /**
/**
* This method executes the specified SQL INSERT, UPDATE, or DELETE statement * This method executes the specified SQL INSERT, UPDATE, or DELETE statement
* and returns the number of rows affected, which may be 0. * and returns the number of rows affected, which may be 0.
* *
* @param sql The SQL statement to execute. * @param sql The SQL statement to execute.
*
* @return The number of rows affected by the SQL statement. * @return The number of rows affected by the SQL statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int executeUpdate(String sql) throws SQLException;
executeUpdate(String sql) throws SQLException;
/*************************************************************************/ /**
/**
* This method closes the statement and frees any associated resources. * This method closes the statement and frees any associated resources.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void close() throws SQLException;
close() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the maximum length of any column value in bytes. * This method returns the maximum length of any column value in bytes.
* *
* @return The maximum length of any column value in bytes. * @return The maximum length of any column value in bytes.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxFieldSize() throws SQLException;
getMaxFieldSize() throws SQLException;
/*************************************************************************/
/** /**
* This method sets the limit for the maximum length of any column in bytes. * This method sets the limit for the maximum length of any column in bytes.
* *
* @param maxsize The new maximum length of any column in bytes. * @param maxsize The new maximum length of any column in bytes.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setMaxFieldSize(int max) throws SQLException;
setMaxFieldSize(int maxsize) throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the maximum possible number of rows in a result set. * This method returns the maximum possible number of rows in a result set.
* *
* @return The maximum possible number of rows in a result set. * @return The maximum possible number of rows in a result set.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getMaxRows() throws SQLException;
getMaxRows() throws SQLException;
/*************************************************************************/
/** /**
* This method sets the maximum number of rows that can be present in a * This method sets the maximum number of rows that can be present in a
* result set. * result set.
* *
* @param maxrows The maximum possible number of rows in a result set. * @param maxrows The maximum possible number of rows in a result set.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setMaxRows(int max) throws SQLException;
setMaxRows(int maxrows) throws SQLException;
/*************************************************************************/ /**
/**
* This method sets the local escape processing mode on or off. The * This method sets the local escape processing mode on or off. The
* default value is on. * default value is on.
* *
* @param escape <code>true</code> to enable local escape processing, * @param escape <code>true</code> to enable local escape processing,
* <code>false</code> to disable it. * <code>false</code> to disable it.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setEscapeProcessing(boolean enable) throws SQLException;
setEscapeProcessing(boolean esacpe) throws SQLException;
/*************************************************************************/
/** /**
* The method returns the number of seconds a statement may be in process * The method returns the number of seconds a statement may be in process
* before timing out. A value of 0 means there is no timeout. * before timing out. A value of 0 means there is no timeout.
* *
* @return The SQL statement timeout in seconds. * @return The SQL statement timeout in seconds.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getQueryTimeout() throws SQLException;
getQueryTimeout() throws SQLException;
/*************************************************************************/ /**
/**
* This method sets the number of seconds a statement may be in process * This method sets the number of seconds a statement may be in process
* before timing out. A value of 0 means there is no timeout. * before timing out. A value of 0 means there is no timeout.
* *
* @param timeout The new SQL statement timeout value. * @param timeout The new SQL statement timeout value.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setQueryTimeout(int seconds) throws SQLException;
setQueryTimeout(int timeout) throws SQLException;
/*************************************************************************/ /**
/**
* This method cancels an outstanding statement, if the database supports * This method cancels an outstanding statement, if the database supports
* that operation. * that operation.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void cancel() throws SQLException;
cancel() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the first SQL warning attached to this statement. * This method returns the first SQL warning attached to this statement.
* Subsequent warnings will be chained to this one. * Subsequent warnings will be chained to this one.
* *
* @return The first SQL warning for this statement. * @return The first SQL warning for this statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract SQLWarning public SQLWarning getWarnings() throws SQLException;
getWarnings() throws SQLException;
/*************************************************************************/
/** /**
* This method clears any SQL warnings that have been attached to this * This method clears any SQL warnings that have been attached to this
* statement. * statement.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void clearWarnings() throws SQLException;
clearWarnings() throws SQLException;
/*************************************************************************/
/** /**
* This method sets the cursor name that will be used by the result set. * This method sets the cursor name that will be used by the result set.
* *
* @param name The cursor name to use for this statement. * @param name The cursor name to use for this statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setCursorName(String name) throws SQLException;
setCursorName(String name) throws SQLException;
/*************************************************************************/ /**
/**
* This method executes an arbitrary SQL statement of any time. The * This method executes an arbitrary SQL statement of any time. The
* methods <code>getResultSet</code>, <code>getMoreResults</code> and * methods <code>getResultSet</code>, <code>getMoreResults</code> and
* <code>getUpdateCount</code> retrieve the results. * <code>getUpdateCount</code> retrieve the results.
* *
* @return <code>true</code> if a result set was returned, <code>false</code> * @return <code>true</code> if a result set was returned, <code>false</code>
* if an update count was returned. * if an update count was returned.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract boolean public boolean execute(String sql) throws SQLException;
execute(String sql) throws SQLException;
/*************************************************************************/
/** /**
* This method returns the result set of the SQL statement that was * This method returns the result set of the SQL statement that was
* executed. This should be called only once per result set returned. * executed. This should be called only once per result set returned.
* *
* @return The result set of the query, or <code>null</code> if there was * @return The result set of the query, or <code>null</code> if there was
* no result set (for example, if the statement was an UPDATE). * no result set (for example, if the statement was an UPDATE).
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see execute * @see execute
*/ */
public abstract ResultSet public ResultSet getResultSet() throws SQLException;
getResultSet() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the update count of the SQL statement that was * This method returns the update count of the SQL statement that was
* executed. This should be called only once per executed SQL statement. * executed. This should be called only once per executed SQL statement.
* *
* @return The update count of the query, or -1 if there was no update * @return The update count of the query, or -1 if there was no update
* count (for example, if the statement was a SELECT). * count (for example, if the statement was a SELECT).
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see execute * @see execute
*/ */
public abstract int public int getUpdateCount() throws SQLException;
getUpdateCount() throws SQLException;
/*************************************************************************/ /**
/**
* This method advances the result set pointer to the next result set, * This method advances the result set pointer to the next result set,
* which can then be retrieved using <code>getResultSet</code> * which can then be retrieved using <code>getResultSet</code>
* *
* @return <code>true</code> if there is another result set, * @return <code>true</code> if there is another result set,
* <code>false</code> otherwise (for example, the next result is an * <code>false</code> otherwise (for example, the next result is an
* update count). * update count).
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see execute * @see execute
*/ */
public abstract boolean public boolean getMoreResults() throws SQLException;
getMoreResults() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the current direction that the driver thinks the
* result set will be accessed int.
*
* @return The direction the result set will be accessed in (????)
*
* @exception SQLException If an error occurs.
*/
public abstract int
getFetchDirection() throws SQLException;
/*************************************************************************/
/**
* This method informs the driver which direction the result set will * This method informs the driver which direction the result set will
* be accessed in. * be accessed in.
* *
* @param direction The direction the result set will be accessed in (?????) * @param direction The direction the result set will be accessed in (?????)
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setFetchDirection(int direction) throws SQLException;
setFetchDirection(int direction) throws SQLException;
/*************************************************************************/ /**
* This method returns the current direction that the driver thinks the
/** * result set will be accessed int.
* This method returns the number of rows the driver believes should be
* fetched from the database at a time.
*
* @return The number of rows that will be fetched from the database at a time.
* *
* @return The direction the result set will be accessed in (????)
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int public int getFetchDirection() throws SQLException;
getFetchSize() throws SQLException;
/*************************************************************************/ /**
/**
* This method informs the driver how many rows it should fetch from the * This method informs the driver how many rows it should fetch from the
* database at a time. * database at a time.
* *
* @param numrows The number of rows the driver should fetch at a time * @param numrows The number of rows the driver should fetch at a time
* to populate the result set. * to populate the result set.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void setFetchSize(int rows) throws SQLException;
setFetchSize(int numrows) throws SQLException;
/*************************************************************************/ /**
* This method returns the number of rows the driver believes should be
* fetched from the database at a time.
*
* @return The number of rows that will be fetched from the database at a time.
* @exception SQLException If an error occurs.
*/
public int getFetchSize() throws SQLException;
/** /**
* This method returns the concurrency type of the result set for this * This method returns the concurrency type of the result set for this
* statement. This will be one of the concurrency types defined in * statement. This will be one of the concurrency types defined in
* <code>ResultSet</code>. * <code>ResultSet</code>.
* *
* @return The concurrency type of the result set for this statement. * @return The concurrency type of the result set for this statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract int public int getResultSetConcurrency() throws SQLException;
getResultSetConcurrency() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the result set type for this statement. This will * This method returns the result set type for this statement. This will
* be one of the result set types defined in <code>ResultSet</code>. * be one of the result set types defined in <code>ResultSet</code>.
* *
* @return The result set type for this statement. * @return The result set type for this statement.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*
* @see ResultSet * @see ResultSet
*/ */
public abstract int public int getResultSetType() throws SQLException;
getResultSetType() throws SQLException;
/*************************************************************************/
/** /**
* This method adds a SQL statement to a SQL batch. A driver is not * This method adds a SQL statement to a SQL batch. A driver is not
* required to implement this method. * required to implement this method.
* *
* @param sql The sql statement to add to the batch. * @param sql The sql statement to add to the batch.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void addBatch(String sql) throws SQLException;
addBatch(String sql) throws SQLException;
/*************************************************************************/ /**
/**
* This method clears out any SQL statements that have been populated in * This method clears out any SQL statements that have been populated in
* the current batch. A driver is not required to implement this method. * the current batch. A driver is not required to implement this method.
* *
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract void public void clearBatch() throws SQLException;
clearBatch() throws SQLException;
/*************************************************************************/ /**
/**
* This method executes the SQL batch and returns an array of update * This method executes the SQL batch and returns an array of update
* counts - one for each SQL statement in the batch - ordered in the same * counts - one for each SQL statement in the batch - ordered in the same
* order the statements were added to the batch. A driver is not required * order the statements were added to the batch. A driver is not required
* to implement this method. * to implement this method.
* *
* @return An array of update counts for this batch. * @return An array of update counts for this batch.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract int[] public int[] executeBatch() throws SQLException;
executeBatch() throws SQLException;
/*************************************************************************/
/** /**
* This method returns the <code>Connection</code> instance that was * This method returns the <code>Connection</code> instance that was
* used to create this object. * used to create this object.
* *
* @return The connection used to create this object. * @return The connection used to create this object.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Connection public Connection getConnection() throws SQLException;
getConnection() throws SQLException;
/**
* @since 1.4
*/
public boolean getMoreResults(int current) throws SQLException;
/**
* @since 1.4
*/
public ResultSet getGeneratedKeys() throws SQLException;
/**
* @since 1.4
*/
public int executeUpdate(String sql, int autoGeneratedKeys)
throws SQLException;
/**
* @since 1.4
*/
public int executeUpdate(String sql, int[] columnIndexes)
throws SQLException;
} // interface Statement /**
* @since 1.4
*/
public int executeUpdate(String sql, String[] columnNames)
throws SQLException;
/**
* @since 1.4
*/
public boolean execute(String sql, int autoGeneratedKeys)
throws SQLException;
/**
* @since 1.4
*/
public boolean execute(String sql, int[] columnIndexes) throws SQLException;
/**
* @since 1.4
*/
public boolean execute(String sql, String[] columnNames)
throws SQLException;
/**
* @since 1.4
*/
public int getResultSetHoldability() throws SQLException;
}
/* Struct.java -- Mapping for a SQL structured type. /* Struct.java -- Mapping for a SQL structured type.
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -48,44 +48,30 @@ import java.util.Map; ...@@ -48,44 +48,30 @@ import java.util.Map;
*/ */
public interface Struct public interface Struct
{ {
/**
/**
* This method returns the name of the SQL structured type for this * This method returns the name of the SQL structured type for this
* object. * object.
* *
* @return The SQL structured type name. * @return The SQL structured type name.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract String public String getSQLTypeName() throws SQLException;
getSQLTypeName() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the attributes of this SQL structured type. * This method returns the attributes of this SQL structured type.
* *
* @return The attributes of this structure type. * @return The attributes of this structure type.
*
* @exception SQLException If an error occurs. * @exception SQLException If an error occurs.
*/ */
public abstract Object[] public Object[] getAttributes() throws SQLException;
getAttributes() throws SQLException;
/*************************************************************************/ /**
/**
* This method returns the attributes of this SQL structured type. * This method returns the attributes of this SQL structured type.
* The specified map of type mappings overrides the default mappings. * The specified map of type mappings overrides the default mappings.
* *
* @param map The map of SQL type mappings. * @param map The map of SQL type mappings.
*
* @return The attributes of this structure type. * @return The attributes of this structure type.
*
* @exception SQLException If a error occurs. * @exception SQLException If a error occurs.
*/ */
public abstract Object[] public Object[] getAttributes(Map map) throws SQLException;
getAttributes(Map map) throws SQLException; }
} // interface Struct
/* Time.java -- Wrapper around java.util.Date /* Time.java -- Wrapper around java.util.Date
Copyright (C) 1999, 2000 Free Software Foundation, Inc. Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
...@@ -48,106 +48,74 @@ import java.text.SimpleDateFormat; ...@@ -48,106 +48,74 @@ import java.text.SimpleDateFormat;
*/ */
public class Time extends java.util.Date public class Time extends java.util.Date
{ {
static final long serialVersionUID = 8397324403548013681L;
/* /**
* Class Variables
*/
/**
* Used for parsing and formatting this date. * Used for parsing and formatting this date.
*/ */
private static SimpleDateFormat sdf = new SimpleDateFormat("HH:mm:ss"); private static SimpleDateFormat sdf = new SimpleDateFormat("HH:mm:ss");
/**
* This is the serialization UID for this class.
*/
private static final long serialVersionUID = 8397324403548013681L;
/*************************************************************************/
/*
* Class Methods
*/
/** /**
* This method returns a new instance of this class by parsing a * This method returns a new instance of this class by parsing a
* date in JDBC format into a Java date. * date in JDBC format into a Java date.
* *
* @param str The string to parse. * @param str The string to parse.
*
* @return The resulting <code>java.sql.Time</code> value. * @return The resulting <code>java.sql.Time</code> value.
*/ */
public static Time public static Time valueOf(String str)
valueOf(String str) {
{
try try
{ {
java.util.Date d = (java.util.Date)sdf.parseObject(str); java.util.Date d = (java.util.Date) sdf.parseObject(str);
return(new Time(d.getTime())); return new Time(d.getTime());
} }
catch(Exception e) catch (Exception e)
{ {
return(null); return null;
}
} }
}
/*************************************************************************/
/*
* Constructors
*/
/** /**
* This method initializes a new instance of this class with the * This method initializes a new instance of this class with the
* specified year, month, and day. * specified year, month, and day.
* *
* @param hour The hour for this Time (0-23) * @param hour The hour for this Time (0-23)
* @param minute The minute for this time (0-59) * @param minute The minute for this time (0-59)
* @param second The second for this time (0-59) * @param second The second for this time (0-59)
*
* @deprecated * @deprecated
*/ */
public public Time(int hour, int minute, int second)
Time(int hour, int minute, int second) {
{
super(System.currentTimeMillis()); super(System.currentTimeMillis());
setHours(hour); setHours(hour);
setMinutes(minute); setMinutes(minute);
setSeconds(second); setSeconds(second);
} }
/*************************************************************************/
/** /**
* This method initializes a new instance of this class with the * This method initializes a new instance of this class with the
* specified time value representing the number of seconds since * specified time value representing the number of seconds since
* Jan 1, 1970 at 12:00 midnight GMT. * Jan 1, 1970 at 12:00 midnight GMT.
* *
* @param time The time value to intialize this <code>Time</code> to. * @param time The time value to intialize this <code>Time</code> to.
*/ */
public public Time(long date)
Time(long date) {
{
super(date); super(date);
} }
/*************************************************************************/
/*
* Instance Methods
*/
/** /**
* This method returns this date in JDBC format. * This method returns this date in JDBC format.
* *
* @return This date as a string. * @return This date as a string.
*/ */
public String public String
toString() toString()
{ {
return(sdf.format(this)); return sdf.format(this);
} }
} // class Time }
...@@ -52,72 +52,44 @@ import java.text.SimpleDateFormat; ...@@ -52,72 +52,44 @@ import java.text.SimpleDateFormat;
*/ */
public class Timestamp extends java.util.Date public class Timestamp extends java.util.Date
{ {
static final long serialVersionUID = 3581463369166924961L;
/* /**
* Class Variables
*/
/**
* Used for parsing and formatting this date. * Used for parsing and formatting this date.
*/ */
// Millisecond will have to be close enough for now. // Millisecond will have to be close enough for now.
private static SimpleDateFormat parse_sdf = private static SimpleDateFormat parse_sdf =
new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSSS"); new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSSS");
private static SimpleDateFormat format_sdf = private static SimpleDateFormat format_sdf =
new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
/** /**
* This is the serialization UID for this class. * The nanosecond value for this object
*/
private static final long serialVersionUID = 3581463369166924961L;
/*************************************************************************/
/*
* Instance Variables
*/
/**
* @serial The nanosecond value for this object
*/
private int nanos;
/*************************************************************************/
/*
* Class Methods
*/ */
private int nanos;
/** /**
* This method returns a new instance of this class by parsing a * This method returns a new instance of this class by parsing a
* date in JDBC format into a Java date. * date in JDBC format into a Java date.
* *
* @param str The string to parse. * @param str The string to parse.
*
* @return The resulting <code>java.sql.Timestamp</code> value. * @return The resulting <code>java.sql.Timestamp</code> value.
*/ */
public static Timestamp public static Timestamp valueOf(String str)
valueOf(String str) {
{
try try
{ {
Date d = (Date)parse_sdf.parseObject(str); Date d = (Date) parse_sdf.parseObject(str);
return(new Timestamp(d.getTime())); return new Timestamp(d.getTime());
} }
catch(Exception e) catch (Exception e)
{ {
return(null); return null;
}
} }
}
/*************************************************************************/
/*
* Constructors
*/
/** /**
* This method initializes a new instance of this class with the * This method initializes a new instance of this class with the
* specified year, month, and day. * specified year, month, and day.
* *
...@@ -128,102 +100,76 @@ valueOf(String str) ...@@ -128,102 +100,76 @@ valueOf(String str)
* @param minute The minute for this Timestamp (0-59) * @param minute The minute for this Timestamp (0-59)
* @param second The second for this Timestamp (0-59) * @param second The second for this Timestamp (0-59)
* @param nanos The nanosecond value for this Timestamp (0 to 999,999,9999) * @param nanos The nanosecond value for this Timestamp (0 to 999,999,9999)
*
* @deprecated * @deprecated
*/ */
public public Timestamp(int year, int month, int day, int hour, int minute,
Timestamp(int year, int month, int day, int hour, int minute, int second, int second, int nanos)
int nanos) {
{
super(year, month, day, hour, minute, second); super(year, month, day, hour, minute, second);
this.nanos = nanos; this.nanos = nanos;
} }
/*************************************************************************/
/** /**
* This method initializes a new instance of this class with the * This method initializes a new instance of this class with the
* specified time value representing the number of seconds since * specified time value representing the number of seconds since
* Jan 1, 1970 at 12:00 midnight GMT. * Jan 1, 1970 at 12:00 midnight GMT.
* *
* @param time The time value to intialize this <code>Time</code> to. * @param time The time value to intialize this <code>Time</code> to.
*/ */
public public Timestamp(long date)
Timestamp(long date) {
{
super(date); super(date);
} }
/*************************************************************************/
/*
* Instance Methods
*/
/** /**
* This method returns this date in JDBC format. * This method returns this date in JDBC format.
* *
* @return This date as a string. * @return This date as a string.
*/ */
public String public String toString()
toString() {
{ return format_sdf.format(this) + "." + getNanos();
return(format_sdf.format(this) + "." + getNanos()); }
}
/*************************************************************************/
/** /**
* This method returns the nanosecond value for this object. * This method returns the nanosecond value for this object.
*
* @return The nanosecond value for this object. * @return The nanosecond value for this object.
*/ */
public int public int getNanos()
getNanos() {
{ return nanos;
return(nanos); }
}
/*************************************************************************/
/** /**
* This method sets the nanosecond value for this object. * This method sets the nanosecond value for this object.
* *
* @param nanos The nanosecond value for this object. * @param nanos The nanosecond value for this object.
*/ */
public void public void setNanos(int nanos)
setNanos(int nanos) {
{
this.nanos = nanos; this.nanos = nanos;
} }
/*************************************************************************/
/** /**
* This methods tests whether this object is earlier than the specified * This methods tests whether this object is earlier than the specified
* object. * object.
* *
* @param ts The other <code>Timestamp</code> to test against. * @param ts The other <code>Timestamp</code> to test against.
*
* @return <code>true</code> if this object is earlier than the other object, * @return <code>true</code> if this object is earlier than the other object,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*/ */
public boolean public boolean before(Timestamp ts)
before(Timestamp ts) {
{
if (ts.getTime() > getTime()) if (ts.getTime() > getTime())
return(true); return true;
if (ts.getNanos() > getNanos()) if (ts.getNanos() > getNanos())
return(true); return true;
return(false);
}
/*************************************************************************/ return false;
}
/** /**
* This methods tests whether this object is later than the specified * This methods tests whether this object is later than the specified
* object. * object.
* *
...@@ -232,21 +178,18 @@ before(Timestamp ts) ...@@ -232,21 +178,18 @@ before(Timestamp ts)
* @return <code>true</code> if this object is later than the other object, * @return <code>true</code> if this object is later than the other object,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*/ */
public boolean public boolean after(Timestamp ts)
after(Timestamp ts) {
{
if (ts.getTime() < getTime()) if (ts.getTime() < getTime())
return(true); return true;
if (ts.getNanos() < getNanos()) if (ts.getNanos() < getNanos())
return(true); return true;
return(false);
}
/*************************************************************************/ return false;
}
/** /**
* This method these the specified <code>Object</code> for equality * This method these the specified <code>Object</code> for equality
* against this object. This will be true if an only if the specified * against this object. This will be true if an only if the specified
* object is an instance of <code>Timestamp</code> and has the same * object is an instance of <code>Timestamp</code> and has the same
...@@ -257,21 +200,18 @@ after(Timestamp ts) ...@@ -257,21 +200,18 @@ after(Timestamp ts)
* @return <code>true</code> if the specified object is equal to this * @return <code>true</code> if the specified object is equal to this
* object, <code>false</code> otherwise. * object, <code>false</code> otherwise.
*/ */
public boolean public boolean equals(Object obj)
equals(Object obj) {
{
if (obj == null) if (obj == null)
return(false); return false;
if (!(obj instanceof Timestamp)) if (!(obj instanceof Timestamp))
return(false); return false;
return(equals((Timestamp)obj)); return equals((Timestamp) obj);
} }
/*************************************************************************/
/** /**
* This method tests the specified timestamp for equality against this * This method tests the specified timestamp for equality against this
* object. This will be true if and only if the specified object is * object. This will be true if and only if the specified object is
* not <code>null</code> and contains all the same time value fields * not <code>null</code> and contains all the same time value fields
...@@ -282,20 +222,34 @@ equals(Object obj) ...@@ -282,20 +222,34 @@ equals(Object obj)
* @return <code>true</code> if the specified object is equal to this * @return <code>true</code> if the specified object is equal to this
* object, <code>false</code> otherwise. * object, <code>false</code> otherwise.
*/ */
public boolean public boolean equals(Timestamp ts)
equals(Timestamp ts) {
{
if (ts == null) if (ts == null)
return(false); return false;
if (ts.getTime() != getTime()) if (ts.getTime() != getTime())
return(false); return false;
if (ts.getNanos() != getNanos()) if (ts.getNanos() != getNanos())
return(false); return false;
return(true); return true;
} }
} // class Timestamp /**
* @since 1.2
*/
/*
public int compareTo(Timestamp ts)
{
}*/
/**
* @since 1.2
*//*
public int compareTo(Object obj)
{
return compareTo((Timestamp) obj);
}*/
}
...@@ -45,43 +45,41 @@ package java.sql; ...@@ -45,43 +45,41 @@ package java.sql;
*/ */
public class Types public class Types
{ {
// These should be self explanatory. People need a SQL book, not
// These should be self explanatory. People need a SQL book, not // Javadoc comments for these.
// Javadoc comments for these. public static final int BIT = -7;
public static final int TINYINT = -6;
public static final int BIT = -7; public static final int SMALLINT = 5;
public static final int TINYINT = -6; public static final int INTEGER = 4;
public static final int SMALLINT = 5; public static final int BIGINT = -5;
public static final int INTEGER = 4; public static final int FLOAT = 6;
public static final int BIGINT = -5; public static final int REAL = 7;
public static final int FLOAT = 6; public static final int DOUBLE = 8;
public static final int REAL = 7; public static final int NUMERIC = 2;
public static final int DOUBLE = 8; public static final int DECIMAL = 3;
public static final int NUMERIC = 2; public static final int CHAR = 1;
public static final int DECIMAL = 3; public static final int VARCHAR = 12;
public static final int CHAR = 1; public static final int LONGVARCHAR = -1;
public static final int VARCHAR = 12; public static final int DATE = 91;
public static final int LONGVARCHAR = -1; public static final int TIME = 92;
public static final int DATE = 91; public static final int TIMESTAMP = 93;
public static final int TIME = 92; public static final int BINARY = -2;
public static final int TIMESTAMP = 93; public static final int VARBINARY = -3;
public static final int BINARY = -2; public static final int LONGVARBINARY = -4;
public static final int VARBINARY = -3; public static final int NULL = 0;
public static final int LONGVARBINARY = -4; public static final int OTHER = 1111;
public static final int NULL = 0; public static final int JAVA_OBJECT = 2000;
public static final int OTHER = 1111; public static final int DISTINCT = 2001;
public static final int JAVA_OBJECT = 2000; public static final int STRUCT = 2002;
public static final int DISTINCT = 2001; public static final int ARRAY = 2003;
public static final int STRUCT = 2002; public static final int BLOB = 2004;
public static final int ARRAY = 2003; public static final int CLOB = 2005;
public static final int BLOB = 2004; public static final int REF = 2006;
public static final int CLOB = 2005; public static final int DATALINK = 70;
public static final int REF = 2006; public static final int BOOLEAN = 16;
// This class can't be instantiated. // This class can't be instantiated.
private Types () private Types()
{ {
} }
}
} // class Types
/* ConnectionEvent.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.sql.SQLException;
import java.util.EventObject;
/**
* @since 1.4
*/
public class ConnectionEvent extends EventObject
{
private SQLException sqlException;
/**
* @since 1.4
*/
public ConnectionEvent(PooledConnection con)
{
super(con);
}
/**
* @since 1.4
*/
public ConnectionEvent(PooledConnection con, SQLException ex)
{
super(con);
this.sqlException = ex;
}
/**
* @since 1.4
*/
public SQLException getSQLException()
{
return sqlException;
}
}
/* ConnectionEventListener.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.util.EventListener;
/**
* @since 1.4
*/
public interface ConnectionEventListener extends EventListener
{
/**
* @since 1.4
*/
public void connectionClosed(ConnectionEvent event);
/**
* @since 1.4
*/
public void connectionErrorOccurred(ConnectionEvent event);
}
/* ConnectionPoolDataSource.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.io.PrintWriter;
import java.sql.SQLException;
/**
* @since 1.4
*/
public interface ConnectionPoolDataSource
{
/**
* @since 1.4
*/
public PooledConnection getPooledConnection() throws SQLException;
/**
* @since 1.4
*/
public PooledConnection getPooledConnection(String user, String password)
throws SQLException;
/**
* @since 1.4
*/
public PrintWriter getLogWriter() throws SQLException;
/**
* @since 1.4
*/
public void setLogWriter(PrintWriter out) throws SQLException;
/**
* @since 1.4
*/
public void setLoginTimeout(int seconds) throws SQLException;
/**
* @since 1.4
*/
public int getLoginTimeout() throws SQLException;
}
/* DataSource.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.io.PrintWriter;
import java.sql.Connection;
import java.sql.SQLException;
/**
* @since 1.4
*/
public interface DataSource
{
/**
* @since 1.4
*/
public Connection getConnection() throws SQLException;
/**
* @since 1.4
*/
public Connection getConnection(String username, String password)
throws SQLException;
/**
* @since 1.4
*/
public PrintWriter getLogWriter() throws SQLException;
/**
* @since 1.4
*/
public void setLogWriter(PrintWriter out) throws SQLException;
/**
* @since 1.4
*/
public void setLoginTimeout(int seconds) throws SQLException;
/**
* @since 1.4
*/
public int getLoginTimeout() throws SQLException;
}
/* PooledConnection.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.sql.Connection;
import java.sql.SQLException;
/**
* @since 1.4
*/
public interface PooledConnection
{
/**
* @since 1.4
*/
public Connection getConnection() throws SQLException;
/**
* @since 1.4
*/
public void close() throws SQLException;
/**
* @since 1.4
*/
public void addConnectionEventListener(ConnectionEventListener listener);
/**
* @since 1.4
*/
public void removeConnectionEventListener(ConnectionEventListener listener);
}
/* RowSet.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.io.InputStream;
import java.io.Reader;
import java.math.BigDecimal;
import java.sql.Array;
import java.sql.Blob;
import java.sql.Clob;
import java.sql.Date;
import java.sql.Ref;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Time;
import java.sql.Timestamp;
import java.util.Calendar;
import java.util.Map;
/**
* @since 1.4
*/
public interface RowSet extends ResultSet
{
/**
* @since 1.4
*/
public String getUrl() throws SQLException;
/**
* @since 1.4
*/
public void setUrl(String url) throws SQLException;
/**
* @since 1.4
*/
public String getDataSourceName();
/**
* @since 1.4
*/
public void setDataSourceName(String name) throws SQLException;
/**
* @since 1.4
*/
public String getUsername();
/**
* @since 1.4
*/
public void setUsername(String name) throws SQLException;
/**
* @since 1.4
*/
public String getPassword();
/**
* @since 1.4
*/
public void setPassword(String password) throws SQLException;
/**
* @since 1.4
*/
public int getTransactionIsolation();
/**
* @since 1.4
*/
public void setTransactionIsolation(int level) throws SQLException;
/**
* @since 1.4
*/
public Map getTypeMap() throws SQLException;
/**
* @since 1.4
*/
public void setTypeMap(Map map) throws SQLException;
/**
* @since 1.4
*/
public String getCommand();
/**
* @since 1.4
*/
public void setCommand(String cmd) throws SQLException;
/**
* @since 1.4
*/
public boolean isReadOnly();
/**
* @since 1.4
*/
public void setReadOnly(boolean value) throws SQLException;
/**
* @since 1.4
*/
public int getMaxFieldSize() throws SQLException;
/**
* @since 1.4
*/
public void setMaxFieldSize(int max) throws SQLException;
/**
* @since 1.4
*/
public int getMaxRows() throws SQLException;
/**
* @since 1.4
*/
public void setMaxRows(int max) throws SQLException;
/**
* @since 1.4
*/
public boolean getEscapeProcessing() throws SQLException;
/**
* @since 1.4
*/
public void setEscapeProcessing(boolean enable) throws SQLException;
/**
* @since 1.4
*/
public int getQueryTimeout() throws SQLException;
/**
* @since 1.4
*/
public void setQueryTimeout(int seconds) throws SQLException;
/**
* @since 1.4
*/
public void setType(int type) throws SQLException;
/**
* @since 1.4
*/
public void setConcurrency(int concurrency) throws SQLException;
/**
* @since 1.4
*/
public void setNull(int parameterIndex, int sqlType) throws SQLException;
/**
* @since 1.4
*/
public void setNull(int paramIndex, int sqlType, String typeName) throws
SQLException;
/**
* @since 1.4
*/
public void setBoolean(int parameterIndex, boolean x) throws SQLException;
/**
* @since 1.4
*/
public void setByte(int parameterIndex, byte x) throws SQLException;
/**
* @since 1.4
*/
public void setShort(int parameterIndex, short x) throws SQLException;
/**
* @since 1.4
*/
public void setInt(int parameterIndex, int x) throws SQLException;
/**
* @since 1.4
*/
public void setLong(int parameterIndex, long x) throws SQLException;
/**
* @since 1.4
*/
public void setFloat(int parameterIndex, float x) throws SQLException;
/**
* @since 1.4
*/
public void setDouble(int parameterIndex, double x) throws SQLException;
/**
* @since 1.4
*/
public void setBigDecimal(int parameterIndex, BigDecimal x) throws
SQLException;
/**
* @since 1.4
*/
public void setString(int parameterIndex, String x) throws SQLException;
/**
* @since 1.4
*/
public void setBytes(int parameterIndex, byte[] x) throws SQLException;
/**
* @since 1.4
*/
public void setDate(int parameterIndex, Date x) throws SQLException;
/**
* @since 1.4
*/
public void setTime(int parameterIndex, Time x) throws SQLException;
/**
* @since 1.4
*/
public void setTimestamp(int parameterIndex, Timestamp x) throws
SQLException;
/**
* @since 1.4
*/
public void setAsciiStream(int parameterIndex, InputStream x, int length)
throws SQLException;
/**
* @since 1.4
*/
public void setBinaryStream(int parameterIndex, InputStream x, int length)
throws SQLException;
/**
* @since 1.4
*/
public void setCharacterStream(int parameterIndex, Reader reader, int
length) throws SQLException;
/**
* @since 1.4
*/
public void setObject(int parameterIndex, Object x, int targetSqlType, int
scale) throws SQLException;
/**
* @since 1.4
*/
public void setObject(int parameterIndex, Object x, int targetSqlType)
throws SQLException;
/**
* @since 1.4
*/
public void setObject(int parameterIndex, Object x) throws SQLException;
/**
* @since 1.4
*/
public void setRef(int i, Ref x) throws SQLException;
/**
* @since 1.4
*/
public void setBlob(int i, Blob x) throws SQLException;
/**
* @since 1.4
*/
public void setClob(int i, Clob x) throws SQLException;
/**
* @since 1.4
*/
public void setArray(int i, Array x) throws SQLException;
/**
* @since 1.4
*/
public void setDate(int parameterIndex, Date x, Calendar cal) throws
SQLException;
/**
* @since 1.4
*/
public void setTime(int parameterIndex, Time x, Calendar cal) throws
SQLException;
/**
* @since 1.4
*/
public void setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
throws SQLException;
/**
* @since 1.4
*/
public void clearParameters() throws SQLException;
/**
* @since 1.4
*/
public void execute() throws SQLException;
/**
* @since 1.4
*/
public void addRowSetListener(RowSetListener listener);
/**
* @since 1.4
*/
public void removeRowSetListener(RowSetListener listener);
}
/* RowSetEvent.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.util.EventObject;
/**
* @since 1.4
*/
public class RowSetEvent extends EventObject
{
public RowSetEvent(RowSet source)
{
super(source);
}
}
/* RowSetInternal.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.SQLException;
/**
* @since 1.4
*/
public interface RowSetInternal
{
/**
* @since 1.4
*/
public Object[] getParams() throws SQLException;
/**
* @since 1.4
*/
public Connection getConnection() throws SQLException;
/**
* @since 1.4
*/
public void setMetaData(RowSetMetaData md) throws SQLException;
/**
* @since 1.4
*/
public ResultSet getOriginal() throws SQLException;
/**
* @since 1.4
*/
public ResultSet getOriginalRow() throws SQLException;
}
/* RowSetListener.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.util.EventListener;
/**
* @since 1.4
*/
public interface RowSetListener extends EventListener
{
/**
* @since 1.4
*/
public void rowSetChanged(RowSetEvent event);
/**
* @since 1.4
*/
public void rowChanged(RowSetEvent event);
/**
* @since 1.4
*/
public void cursorMoved(RowSetEvent event);
}
/* RowSetMetaData.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.sql.ResultSetMetaData;
import java.sql.SQLException;
/**
* @since 1.4
*/
public interface RowSetMetaData extends ResultSetMetaData
{
/**
* @since 1.4
*/
public void setColumnCount(int columnCount) throws SQLException;
/**
* @since 1.4
*/
public void setAutoIncrement(int columnIndex, boolean property)
throws SQLException;
/**
* @since 1.4
*/
public void setCaseSensitive(int columnIndex, boolean property)
throws SQLException;
/**
* @since 1.4
*/
public void setSearchable(int columnIndex, boolean property)
throws SQLException;
/**
* @since 1.4
*/
public void setCurrency(int columnIndex, boolean property)
throws SQLException;
/**
* @since 1.4
*/
public void setNullable(int columnIndex, int property) throws SQLException;
/**
* @since 1.4
*/
public void setSigned(int columnIndex, boolean property)
throws SQLException;
/**
* @since 1.4
*/
public void setColumnDisplaySize(int columnIndex, int size)
throws SQLException;
/**
* @since 1.4
*/
public void setColumnLabel(int columnIndex, String label)
throws SQLException;
/**
* @since 1.4
*/
public void setColumnName(int columnIndex, String columnName)
throws SQLException;
/**
* @since 1.4
*/
public void setSchemaName(int columnIndex, String schemaName)
throws SQLException;
/**
* @since 1.4
*/
public void setPrecision(int columnIndex, int precision)
throws SQLException;
/**
* @since 1.4
*/
public void setScale(int columnIndex, int scale) throws SQLException;
/**
* @since 1.4
*/
public void setTableName(int columnIndex, String tableName)
throws SQLException;
/**
* @since 1.4
*/
public void setCatalogName(int columnIndex, String catalogName)
throws SQLException;
/**
* @since 1.4
*/
public void setColumnType(int columnIndex, int SQLType) throws SQLException;
/**
* @since 1.4
*/
public void setColumnTypeName(int columnIndex, String typeName)
throws SQLException;
}
/* RowSetReader.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.sql.SQLException;
/**
* @since 1.4
*/
public interface RowSetReader
{
/**
* @since 1.4
*/
public void readData(RowSetInternal caller) throws SQLException;
}
/* RowSetWriter.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.sql.SQLException;
/**
* @since 1.4
*/
public interface RowSetWriter
{
/**
* @since 1.4
*/
public boolean writeData(RowSetInternal caller) throws SQLException;
}
/* XAConnection.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.sql.SQLException;
import javax.transaction.xa.XAResource;
/**
* @since 1.4
*/
public interface XAConnection extends PooledConnection
{
/**
* @since 1.4
*/
public XAResource getXAResource() throws SQLException;
}
/* XADataSource.java
Copyright (C) 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */
package javax.sql;
import java.io.PrintWriter;
import java.sql.SQLException;
/**
* @since 1.4
*/
public interface XADataSource
{
/**
* @since 1.4
*/
public XAConnection getXAConnection() throws SQLException;
/**
* @since 1.4
*/
public XAConnection getXAConnection(String user, String password) throws
SQLException;
/**
* @since 1.4
*/
public PrintWriter getLogWriter() throws SQLException;
/**
* @since 1.4
*/
public void setLogWriter(PrintWriter out) throws SQLException;
/**
* @since 1.4
*/
public void setLoginTimeout(int seconds) throws SQLException;
/**
* @since 1.4
*/
public int getLoginTimeout() throws SQLException;
}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment