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
This commit is contained in:
Bryce McKinlay
Bryce McKinlay
parent
00b94a4440
commit
f2390faddf
46 changed files with 8948 additions and 9156 deletions
|
|
@ -1,5 +1,5 @@
|
|||
/* 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.
|
||||
|
||||
|
|
@ -35,203 +35,151 @@ 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.util.Map;
|
||||
|
||||
/**
|
||||
* This interface provides methods for accessing SQL array types
|
||||
*
|
||||
* @author Aaron M. Renn (arenn@urbanophile.com)
|
||||
*/
|
||||
public interface Array
|
||||
* This interface provides methods for accessing SQL array types.
|
||||
*
|
||||
* @author Aaron M. Renn (arenn@urbanophile.com)
|
||||
*/
|
||||
public interface Array
|
||||
{
|
||||
/**
|
||||
* Returns the name of the SQL type of the elements in this
|
||||
* array. This name is database specific.
|
||||
*
|
||||
* @param The name of the SQL type of the elements in this array.
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public String getBaseTypeName() throws SQLException;
|
||||
|
||||
/**
|
||||
* This method returns the name of the SQL type of the elements in this
|
||||
* array. This name is database specific.
|
||||
*
|
||||
* @param The name of the SQL type of the elements in this array.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public abstract String
|
||||
getBaseTypeName() throws SQLException;
|
||||
/**
|
||||
* Returns the JDBC type identifier of the elements in this
|
||||
* array. This will be one of the values defined in the
|
||||
* <code>Types</code> class.
|
||||
*
|
||||
* @return The JDBC type of the elements in this array.
|
||||
* @exception SQLException If an error occurs.
|
||||
* @see Types
|
||||
*/
|
||||
public int getBaseType() throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
/**
|
||||
* Returns the contents of this array. This object returned
|
||||
* will be an array of Java objects of the appropriate types.
|
||||
*
|
||||
* @return The contents of the array as an array of Java objects.
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public Object getArray() throws SQLException;
|
||||
|
||||
/**
|
||||
* This method returns the JDBC type identifier of the elements in this
|
||||
* array. This will be one of the values defined in the <code>Types</code>
|
||||
* class.
|
||||
*
|
||||
* @return The JDBC type of the elements in this array.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*
|
||||
* @see Types
|
||||
*/
|
||||
public abstract int
|
||||
getBaseType() throws SQLException;
|
||||
/**
|
||||
* Returns the contents of this array. The specified
|
||||
* <code>Map</code> will be used to override selected mappings
|
||||
* between SQL types and Java classes.
|
||||
*
|
||||
* @param map A mapping of SQL types to Java classes.
|
||||
* @return The contents of the array as an array of Java objects.
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public Object 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>
|
||||
* elements. Fewer than the requested number of elements will be
|
||||
* returned if the array does not contain the requested number of elements.
|
||||
* The object returned will be an array of Java objects of
|
||||
* the appropriate types.
|
||||
*
|
||||
* @param offset The offset into this array to start returning elements from.
|
||||
* @param count The requested number of elements to return.
|
||||
* @return The requested portion of the array.
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public Object getArray(long index, int count) throws SQLException;
|
||||
|
||||
/**
|
||||
* This method returns the contents of this array. This object returned
|
||||
* will be an array of Java objects of the appropriate types.
|
||||
*
|
||||
* @return The contents of the array as an array of Java objects.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public abstract Object
|
||||
getArray() throws SQLException;
|
||||
/**
|
||||
* This method returns a portion of this array starting at <code>index</code>
|
||||
* into the array and continuing for <code>count</code>
|
||||
* elements. Fewer than the requested number of elements will be
|
||||
* returned if the array does not contain the requested number of elements.
|
||||
* The object returned will be an array of Java objects. The specified
|
||||
* <code>Map</code> will be used for overriding selected SQL type to
|
||||
* Java class mappings.
|
||||
*
|
||||
* @param offset The offset into this array to start returning elements from.
|
||||
* @param count The requested number of elements to return.
|
||||
* @param map A mapping of SQL types to Java classes.
|
||||
* @return The requested portion of the array.
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public Object getArray(long index, int count, Map map) throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
/**
|
||||
* 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
|
||||
* the index into the array of that row's contents. The second will be
|
||||
* the actual value of that array element.
|
||||
*
|
||||
* @return The elements of this array as a <code>ResultSet</code>.
|
||||
* @exception SQLException If an error occurs.
|
||||
* @see ResultSet
|
||||
*/
|
||||
public ResultSet getResultSet() throws SQLException;
|
||||
|
||||
/**
|
||||
* This method returns the contents of this array. The specified
|
||||
* <code>Map</code> will be used to override selected mappings between
|
||||
* SQL types and Java classes.
|
||||
*
|
||||
* @param map A mapping of SQL types to Java classes.
|
||||
*
|
||||
* @return The contents of the array as an array of Java objects.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public abstract Object
|
||||
getArray(Map map) throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
|
||||
/**
|
||||
* 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
|
||||
* returned if the array does not contain the requested number of elements.
|
||||
* The object returned will be an array of Java objects of
|
||||
* the appropriate types.
|
||||
*
|
||||
* @param offset The offset into this array to start returning elements from.
|
||||
* @param count The requested number of elements to return.
|
||||
*
|
||||
* @return The requested portion of the array.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public abstract Object
|
||||
getArray(long offset, int count) throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
|
||||
/**
|
||||
* 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
|
||||
* returned if the array does not contain the requested number of elements.
|
||||
* The object returned will be an array of Java objects. The specified
|
||||
* <code>Map</code> will be used for overriding selected SQL type to
|
||||
* Java class mappings.
|
||||
*
|
||||
* @param offset The offset into this array to start returning elements from.
|
||||
* @param count The requested number of elements to return.
|
||||
* @param map A mapping of SQL types to Java classes.
|
||||
*
|
||||
* @return The requested portion of the array.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public abstract Object
|
||||
getArray(long index, int count, Map map) throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
|
||||
/**
|
||||
* 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
|
||||
* the index into the array of that row's contents. The second will be
|
||||
* the actual value of that array element.
|
||||
*
|
||||
* @return The elements of this array as a <code>ResultSet</code>.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*
|
||||
* @see ResultSet
|
||||
*/
|
||||
public abstract ResultSet
|
||||
getResultSet() throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
|
||||
/**
|
||||
* 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
|
||||
* the index into the array of that row's contents. The second will be
|
||||
* the actual value of that array element. The specified <code>Map</code>
|
||||
* will be used to override selected default mappings 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>.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*
|
||||
* @see ResultSet
|
||||
*/
|
||||
public abstract ResultSet
|
||||
getResultSet(Map map) throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
|
||||
/**
|
||||
* 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
|
||||
* array and up to <code>length</code> elements will be returned.
|
||||
* <p>
|
||||
* 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 actual value of that array element.
|
||||
*
|
||||
* @param offset The index into the array to start returning elements from.
|
||||
* @param length The requested number of elements to return.
|
||||
*
|
||||
* @return The requested elements of this array as a <code>ResultSet</code>.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*
|
||||
* @see ResultSet
|
||||
*/
|
||||
public abstract ResultSet
|
||||
getResultSet(long index, int count) throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
|
||||
/**
|
||||
* 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
|
||||
* array and up to <code>length</code> elements will be returned.
|
||||
* <p>
|
||||
* 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 actual value of that array element. The specified <code>Map</code>
|
||||
* will be used to override selected default mappings of SQL types to
|
||||
* Java classes.
|
||||
*
|
||||
* @param offset The index into the array to start returning elements from.
|
||||
* @param length The requested number of elements to return.
|
||||
* @param map A mapping of SQL types to Java classes.
|
||||
*
|
||||
* @return The requested elements of this array as a <code>ResultSet</code>.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*
|
||||
* @see ResultSet
|
||||
*/
|
||||
public abstract ResultSet
|
||||
getResultSet(long index, int count, Map map) throws SQLException;
|
||||
|
||||
} // interface Array
|
||||
/**
|
||||
* 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
|
||||
* the index into the array of that row's contents. The second will be
|
||||
* the actual value of that array element. The specified <code>Map</code>
|
||||
* will be used to override selected default mappings 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>.
|
||||
* @exception SQLException If an error occurs.
|
||||
* @see ResultSet
|
||||
*/
|
||||
public ResultSet getResultSet(Map map) throws SQLException;
|
||||
|
||||
/**
|
||||
* This method returns a portion of the array as a <code>ResultSet</code>.
|
||||
* The returned portion will start at <code>index</code> into the
|
||||
* array and up to <code>count</code> elements will be returned.
|
||||
* <p>
|
||||
* 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 actual value of that array element.
|
||||
*
|
||||
* @param offset The index into the array to start returning elements from.
|
||||
* @param length The requested number of elements to return.
|
||||
* @return The requested elements of this array as a <code>ResultSet</code>.
|
||||
* @exception SQLException If an error occurs.
|
||||
* @see ResultSet
|
||||
*/
|
||||
public ResultSet getResultSet(long index, int count) throws SQLException;
|
||||
|
||||
/**
|
||||
* This method returns a portion of the array as a <code>ResultSet</code>.
|
||||
* The returned portion will start at <code>index</code> into the
|
||||
* array and up to <cod>count</code> elements will be returned.
|
||||
* <p>
|
||||
* 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 actual value of that array element. The specified <code>Map</code>
|
||||
* will be used to override selected default mappings of SQL types to
|
||||
* Java classes.
|
||||
*
|
||||
* @param offset The index into the array to start returning elements from.
|
||||
* @param length The requested number of elements to return.
|
||||
* @param map A mapping of SQL types to Java classes.
|
||||
* @return The requested elements of this array as a <code>ResultSet</code>.
|
||||
* @exception SQLException If an error occurs.
|
||||
* @see ResultSet
|
||||
*/
|
||||
public ResultSet getResultSet(long index, int count, Map map)
|
||||
throws SQLException;
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue