From 64089cc9f030d8ef7972adb5d117e0b23f47d62b Mon Sep 17 00:00:00 2001 From: mark Date: Thu, 18 May 2006 17:29:21 +0000 Subject: Imported GNU Classpath 0.90 * scripts/makemake.tcl: LocaleData.java moved to gnu/java/locale. * sources.am: Regenerated. * gcj/javaprims.h: Regenerated. * Makefile.in: Regenerated. * gcj/Makefile.in: Regenerated. * include/Makefile.in: Regenerated. * testsuite/Makefile.in: Regenerated. * gnu/java/lang/VMInstrumentationImpl.java: New override. * gnu/java/net/local/LocalSocketImpl.java: Likewise. * gnu/classpath/jdwp/VMMethod.java: Likewise. * gnu/classpath/jdwp/VMVirtualMachine.java: Update to latest interface. * java/lang/Thread.java: Add UncaughtExceptionHandler. * java/lang/reflect/Method.java: Implements GenericDeclaration and isSynthetic(), * java/lang/reflect/Field.java: Likewise. * java/lang/reflect/Constructor.java * java/lang/Class.java: Implements Type, GenericDeclaration, getSimpleName() and getEnclosing*() methods. * java/lang/Class.h: Add new public methods. * java/lang/Math.java: Add signum(), ulp() and log10(). * java/lang/natMath.cc (log10): New function. * java/security/VMSecureRandom.java: New override. * java/util/logging/Logger.java: Updated to latest classpath version. * java/util/logging/LogManager.java: New override. git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@113887 138bc75d-0d04-0410-961f-82ee72b054a4 --- libjava/classpath/java/sql/Blob.java | 96 +++++++++++++++++++++++------------- 1 file changed, 61 insertions(+), 35 deletions(-) (limited to 'libjava/classpath/java/sql/Blob.java') diff --git a/libjava/classpath/java/sql/Blob.java b/libjava/classpath/java/sql/Blob.java index 616839d01be..c662aad5f2f 100644 --- a/libjava/classpath/java/sql/Blob.java +++ b/libjava/classpath/java/sql/Blob.java @@ -1,5 +1,5 @@ /* Blob.java -- Access a SQL Binary Large OBject. - Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc. + Copyright (C) 1999, 2000, 2002, 2006 Free Software Foundation, Inc. This file is part of GNU Classpath. @@ -41,48 +41,51 @@ import java.io.InputStream; import java.io.OutputStream; /** - * This interface specified methods for accessing a SQL BLOB (Binary - * Large OBject) type. - * + * This interface specified methods for accessing a SQL BLOB (Binary Large + * OBject) type. + * * @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. - * - * @return The number of bytes in the BLOB. + * This method returns the number of bytes in this Blob. + * + * @return The number of bytes in this Blob. * @exception SQLException If an error occurs. */ long length() throws SQLException; /** - * This method returns up to the requested bytes of this BLOB as a - * byte array. - * - * @param pos The index into the BLOB to start returning bytes from. - * @param length The requested number of bytes to return. - * @return The requested bytes from the BLOB. + * This method returns up to the requested bytes of this Blob + * as a byte array. + * + * @param start The index into this Blob to start returning + * bytes from. + * @param count The requested number of bytes to return. + * @return The requested bytes from this Blob. * @exception SQLException If an error occurs. */ - byte[] getBytes(long pos, int length) throws SQLException; + byte[] getBytes(long start, int count) throws SQLException; /** - * This method returns a stream that will read the bytes of the BLOB. - * - * @return A stream that will read the bytes of the BLOB. + * This method returns a stream that will read the bytes of this + * Blob. + * + * @return A stream that will read the bytes of this Blob. * @exception SQLException If an error occurs. */ InputStream getBinaryStream() throws SQLException; /** - * This method returns the index into the BLOB at which the first instance - * of the specified bytes occur. The searching starts at the specified - * index into the BLOB. - * + * This method returns the index into this Blob at which the + * first instance of the specified bytes occur. The searching starts at the + * specified index into this Blob. + * * @param pattern The byte pattern to search for. - * @param offset The index into the BLOB to starting searching for the pattern. + * @param start The index into this Blob to start searching for + * the pattern. * @return The offset at which the pattern is first found, or -1 if the * pattern is not found. * @exception SQLException If an error occurs. @@ -90,14 +93,15 @@ public interface Blob long position(byte[] pattern, long start) throws SQLException; /** - * This method returns the index into the BLOB at which the first instance - * of the specified pattern occurs. The searching starts at the specified - * index into this BLOB. The bytes in the specified Blob are - * used as the search pattern. - * + * This method returns the index into this Blob at which the + * first instance of the specified pattern occurs. The searching starts at the + * specified index into this Blob. The bytes in the specified + * Blob are used as the search pattern. + * * @param pattern The Blob containing the byte pattern to - * search for. - * @param offset The index into the BLOB to starting searching for the pattern. + * search for. + * @param start The index into this Blob to start searching for + * the pattern. * @return The offset at which the pattern is first found, or -1 if the * pattern is not found. * @exception SQLException If an error occurs. @@ -105,27 +109,49 @@ public interface Blob long position(Blob pattern, long start) throws SQLException; /** + * Writes the specified data into this Blob, starting at the + * specified index. + * + * @param start The index at which the writing starts. + * @param bytes The data to write. * @exception SQLException If an error occurs. * @since 1.4 */ - int setBytes(long pos, byte[] bytes) throws SQLException; + int setBytes(long start, byte[] bytes) throws SQLException; /** + * Writes a portion of the specified data into this Blob, + * starting at the specified index. + * + * @param startWrite The index into this Blob at which writing + * starts. + * @param bytes The data to write a portion of. + * @param startRead The offset into the data where the portion to copy starts. + * @param count The number of bytes to write. * @exception SQLException If an error occurs. * @since 1.4 */ - int setBytes(long pos, byte[] bytes, int offset, int len) - throws SQLException; + int setBytes(long startWrite, byte[] bytes, int startRead, int count) + throws SQLException; /** + * Returns a binary stream that writes into this Blob, + * starting at the specified index. + * + * @param start The index at which the writing starts. + * @return A binary stream to write into this Blob. * @exception SQLException If an error occurs. * @since 1.4 */ - OutputStream setBinaryStream(long pos) throws SQLException; + OutputStream setBinaryStream(long start) throws SQLException; /** + * Truncates this Blob to be at most the specified number of + * bytes long. + * + * @param count The length this Blob is truncated to. * @exception SQLException If an error occurs. * @since 1.4 */ - void truncate(long len) throws SQLException; + void truncate(long count) throws SQLException; } -- cgit v1.2.1