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 @@
|
|||
/* 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.
|
||||
|
||||
|
|
@ -35,113 +35,118 @@ 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.io.InputStream;
|
||||
import java.io.OutputStream;
|
||||
import java.io.Reader;
|
||||
import java.io.Writer;
|
||||
|
||||
/**
|
||||
* This interface contains methods for accessing a SQL CLOB (Character
|
||||
* Large OBject) type.
|
||||
*
|
||||
* @author Aaron M. Renn (arenn@urbanophile.com)
|
||||
*/
|
||||
public interface Clob
|
||||
* This interface contains methods for accessing a SQL CLOB (Character
|
||||
* Large OBject) type.
|
||||
*
|
||||
* @author Aaron M. Renn (arenn@urbanophile.com)
|
||||
*/
|
||||
public interface Clob
|
||||
{
|
||||
|
||||
/**
|
||||
/**
|
||||
* This method returns the number of characters in the CLOB.
|
||||
*
|
||||
* @return The number of characters in the CLOB.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
* @since 1.2
|
||||
*/
|
||||
public abstract long
|
||||
length() throws SQLException;
|
||||
public long length() throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
/**
|
||||
* This method returns the specified portion of the CLOB as a
|
||||
* <code>String</code>.
|
||||
*
|
||||
* @param offset The index into the CLOB (index values start at 1) to
|
||||
* start returning characters from.
|
||||
* @param length The requested number of characters to return.
|
||||
* @return The requested CLOB section, as a <code>String</code>.
|
||||
* @exception SQLException If an error occurs.
|
||||
* @since 1.2
|
||||
*/
|
||||
public String getSubString(long pos, int length) throws SQLException;
|
||||
|
||||
/**
|
||||
* This method returns the specified portion of the CLOB as a
|
||||
* <code>String</code>.
|
||||
*
|
||||
* @param offset The index into the CLOB (index values start at 1) to
|
||||
* start returning characters from.
|
||||
* @param length The requested number of characters to return.
|
||||
*
|
||||
* @return The requested CLOB section, as a <code>String</code>.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public abstract String
|
||||
getSubString(long offset, int length) throws SQLException;
|
||||
/**
|
||||
* This method returns a character stream that reads the contents of the
|
||||
* CLOB.
|
||||
*
|
||||
* @return A character stream to read the CLOB's contents.
|
||||
* @exception SQLException If an error occurs.
|
||||
* @since 1.2
|
||||
*/
|
||||
public Reader 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 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 the index into the CLOB of the first occurrence of
|
||||
* the specified character pattern (supplied by the caller as a
|
||||
* <code>String</code>). The search begins at the specified index.
|
||||
*
|
||||
* @param searchstr The character pattern to search for, passed as a
|
||||
* <code>String</code>.
|
||||
* @param start. The index into the CLOB to start search (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.
|
||||
* @exception SQLException If an error occurs.
|
||||
* @since 1.2
|
||||
*/
|
||||
public long position(String searchstr, long start) throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
/**
|
||||
* This method returns the index into the CLOB of the first occurrence of
|
||||
* the specified character pattern (supplied by the caller as a
|
||||
* <code>Clob</code>). The search begins at the specified index.
|
||||
*
|
||||
* @param searchstr The character pattern to search for, passed as a
|
||||
* <code>Clob</code>.
|
||||
* @param start. The index into the CLOB to start search (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.
|
||||
* @exception SQLException If an error occurs.
|
||||
* @since 1.2
|
||||
*/
|
||||
public long position(Clob searchstr, long start) throws SQLException;
|
||||
|
||||
/**
|
||||
* This method returns a character stream that reads the contents of the
|
||||
* CLOB.
|
||||
*
|
||||
* @return A character stream to read the CLOB's contents.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public abstract Reader
|
||||
getCharacterStream() throws SQLException;
|
||||
/**
|
||||
* @since 1.4
|
||||
*/
|
||||
public int setString(long pos, String str) throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
/**
|
||||
* @since 1.4
|
||||
*/
|
||||
public int setString(long pos, String str, int offset, int len)
|
||||
throws SQLException;
|
||||
|
||||
/**
|
||||
* This method returns the index into the CLOB of the first occurrence of
|
||||
* the specified character pattern (supplied by the caller as a
|
||||
* <code>String</code>). The search begins at the specified index.
|
||||
*
|
||||
* @param pattern The character pattern to search for, passed as a
|
||||
* <code>String</code>.
|
||||
* @param offset. The index into the CLOB to start search (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.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public abstract long
|
||||
position(String pattern, long offset) throws SQLException;
|
||||
/**
|
||||
* @since 1.4
|
||||
*/
|
||||
public OutputStream setAsciiStream(long pos) throws SQLException;
|
||||
|
||||
/*************************************************************************/
|
||||
|
||||
/**
|
||||
* This method returns the index into the CLOB of the first occurrence of
|
||||
* the specified character pattern (supplied by the caller as a
|
||||
* <code>Clob</code>). The search begins at the specified index.
|
||||
*
|
||||
* @param pattern The character pattern to search for, passed as a
|
||||
* <code>Clob</code>.
|
||||
* @param offset. The index into the CLOB to start search (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.
|
||||
*
|
||||
* @exception SQLException If an error occurs.
|
||||
*/
|
||||
public abstract long
|
||||
position(Clob pattern, long offset) throws SQLException;
|
||||
|
||||
} // interface Clob
|
||||
/**
|
||||
* @since 1.4
|
||||
*/
|
||||
public Writer setCharacterStream(long pos) throws SQLException;
|
||||
|
||||
/**
|
||||
* @since 1.4
|
||||
*/
|
||||
public void truncate(long len) throws SQLException;
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue