diff options
Diffstat (limited to 'libjava/classpath/java/sql/ResultSet.java')
| -rw-r--r-- | libjava/classpath/java/sql/ResultSet.java | 422 |
1 files changed, 251 insertions, 171 deletions
diff --git a/libjava/classpath/java/sql/ResultSet.java b/libjava/classpath/java/sql/ResultSet.java index 97f2897d423..79cba63d419 100644 --- a/libjava/classpath/java/sql/ResultSet.java +++ b/libjava/classpath/java/sql/ResultSet.java @@ -1,5 +1,5 @@ /* ResultSet.java -- A SQL statement result set. - 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. @@ -138,7 +138,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>String</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>String</code>. * @exception SQLException If an error occurs. */ @@ -148,7 +148,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>boolean</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>boolean</code>. * @exception SQLException If an error occurs. */ @@ -158,7 +158,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>byte</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>byte</code>. * @exception SQLException If an error occurs. */ @@ -168,7 +168,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>short</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>short</code>. * @exception SQLException If an error occurs. */ @@ -178,7 +178,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>int</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>int</code>. * @exception SQLException If an error occurs. */ @@ -188,7 +188,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>long</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>long</code>. * @exception SQLException If an error occurs. */ @@ -198,7 +198,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>float</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>float</code>. * @exception SQLException If an error occurs. */ @@ -208,7 +208,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>double</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>double</code>. * @exception SQLException If an error occurs. */ @@ -218,7 +218,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>BigDecimal</code>. * - * @param index The index of the column to return. + * @param columnIndex 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>. * @exception SQLException If an error occurs. @@ -231,7 +231,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * byte array. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a byte array * @exception SQLException If an error occurs. */ @@ -241,7 +241,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>java.sql.Date</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>java.sql.Date</code>. * @exception SQLException If an error occurs. */ @@ -251,7 +251,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>java.sql.Time</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>java.sql.Time</code>. * @exception SQLException If an error occurs. */ @@ -261,7 +261,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>java.sql.Timestamp</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>java.sql.Timestamp</code>. * @exception SQLException If an error occurs. */ @@ -274,7 +274,7 @@ public interface ResultSet * 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. + * @param columnIndex The index of the column to return. * @return The column value as an ASCII <code>InputStream</code>. * @exception SQLException If an error occurs. */ @@ -287,7 +287,7 @@ public interface ResultSet * 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. + * @param columnIndex The index of the column to return. * @return The column value as a Unicode UTF-8 <code>InputStream</code>. * @exception SQLException If an error occurs. * @deprecated Use getCharacterStream instead. @@ -301,7 +301,7 @@ public interface ResultSet * 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. + * @param columnIndex The index of the column to return. * @return The column value as a raw byte <code>InputStream</code>. * @exception SQLException If an error occurs. */ @@ -311,7 +311,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>String</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>String</code>. * @exception SQLException If an error occurs. */ @@ -321,7 +321,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>boolean</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>boolean</code>. * @exception SQLException If an error occurs. */ @@ -331,7 +331,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>byte</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>byte</code>. * @exception SQLException If an error occurs. */ @@ -341,7 +341,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>short</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>short</code>. * @exception SQLException If an error occurs. */ @@ -351,7 +351,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>int</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>int</code>. * @exception SQLException If an error occurs. */ @@ -361,7 +361,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>long</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>long</code>. * @exception SQLException If an error occurs. */ @@ -371,7 +371,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>float</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>float</code>. * @exception SQLException If an error occurs. */ @@ -381,7 +381,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>double</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>double</code>. * @exception SQLException If an error occurs. */ @@ -391,7 +391,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>BigDecimal</code>. * - * @param index The index of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>BigDecimal</code>. * @exception SQLException If an error occurs. * @deprecated @@ -403,7 +403,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * byte array. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a byte array * @exception SQLException If an error occurs. */ @@ -413,7 +413,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>java.sql.Date</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>java.sql.Date</code>. * @exception SQLException If an error occurs. */ @@ -423,7 +423,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>java.sql.Time</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>java.sql.Time</code>. * @exception SQLException If an error occurs. */ @@ -433,7 +433,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>java.sql.Timestamp</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>java.sql.Timestamp</code>. * @exception SQLException If an error occurs. */ @@ -446,7 +446,7 @@ public interface ResultSet * 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. + * @param columnName The name of the column to return. * @return The column value as an ASCII <code>InputStream</code>. * @exception SQLException If an error occurs. */ @@ -459,7 +459,7 @@ public interface ResultSet * 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. + * @param columnName The name of the column to return. * @return The column value as a Unicode UTF-8 <code>InputStream</code>. * @exception SQLException If an error occurs. * @deprecated Use getCharacterStream instead. @@ -473,7 +473,7 @@ public interface ResultSet * 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. + * @param columnName The name of the column to return. * @return The column value as a raw byte <code>InputStream</code>. * @exception SQLException If an error occurs. */ @@ -518,7 +518,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>Object</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as an <code>Object</code>. * @exception SQLException If an error occurs. */ @@ -528,7 +528,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>Object</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as an <code>Object</code>. * @exception SQLException If an error occurs. */ @@ -537,7 +537,7 @@ public interface ResultSet /** * This method returns the column index of the specified named column. * - * @param column The name of the column. + * @param columnName The name of the column. * @return The index of the column. * @exception SQLException If an error occurs. */ @@ -550,7 +550,7 @@ public interface ResultSet * 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. + * @param columnIndex The index of the column to return. * @return The column value as an character <code>Reader</code>. * @exception SQLException If an error occurs. */ @@ -563,7 +563,7 @@ public interface ResultSet * 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. + * @param columnName The name of the column to return. * @return The column value as an character <code>Reader</code>. * @exception SQLException If an error occurs. */ @@ -573,7 +573,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>BigDecimal</code>. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return The column value as a <code>BigDecimal</code>. * @exception SQLException If an error occurs. */ @@ -583,7 +583,7 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>BigDecimal</code>. * - * @param column The name of the column to return. + * @param columnName The name of the column to return. * @return The column value as a <code>BigDecimal</code>. * @exception SQLException If an error occurs. */ @@ -692,7 +692,7 @@ public interface ResultSet * This method moves the result set position relative to the current row. * The offset can be positive or negative. * - * @param row The relative row position to move to. + * @param rows The number of row positions to move. * @return <code>true</code> if the current position was changed, * <code>false</code> otherwise. * @exception SQLException If an error occurs. @@ -713,7 +713,9 @@ public interface ResultSet * This method provides a hint to the driver about which direction the * 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. The + * allowed values are the <code>FETCH_*</code> constants + * defined in this interface. * @exception SQLException If an error occurs. */ void setFetchDirection(int direction) throws SQLException; @@ -746,7 +748,7 @@ public interface ResultSet /** * 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 <code>TYPE_*</code> constants defined in this interface. * * @return The result set type. * @exception SQLException If an error occurs. @@ -755,7 +757,7 @@ public interface ResultSet /** * 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 <code>CONCUR_*</code> constants defined in this interface. * * @return The result set concurrency type. * @exception SQLException If an error occurs. @@ -800,7 +802,7 @@ public interface ResultSet * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @return index The index of the column to update. + * @param columnIndex The index of the column to update. * @exception SQLException If an error occurs. */ void updateNull(int columnIndex) throws SQLException; @@ -810,88 +812,88 @@ public interface ResultSet * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateBoolean(int columnIndex, boolean x) throws SQLException; + void updateBoolean(int columnIndex, boolean value) throws SQLException; /** * This method updates the specified column to have a byte value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateByte(int columnIndex, byte x) throws SQLException; + void updateByte(int columnIndex, byte value) throws SQLException; /** * This method updates the specified column to have a short value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateShort(int columnIndex, short x) throws SQLException; + void updateShort(int columnIndex, short value) throws SQLException; /** * This method updates the specified column to have an int value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateInt(int columnIndex, int x) throws SQLException; + void updateInt(int columnIndex, int value) throws SQLException; /** * This method updates the specified column to have a long value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateLong(int columnIndex, long x) throws SQLException; + void updateLong(int columnIndex, long value) throws SQLException; /** * This method updates the specified column to have a float value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateFloat(int columnIndex, float x) throws SQLException; + void updateFloat(int columnIndex, float value) throws SQLException; /** * This method updates the specified column to have a double value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateDouble(int columnIndex, double x) throws SQLException; + void updateDouble(int columnIndex, double value) throws SQLException; /** * This method updates the specified column to have a BigDecimal value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateBigDecimal(int columnIndex, BigDecimal x) + void updateBigDecimal(int columnIndex, BigDecimal value) throws SQLException; /** @@ -899,55 +901,55 @@ public interface ResultSet * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateString(int columnIndex, String x) throws SQLException; + void updateString(int columnIndex, String value) throws SQLException; /** * This method updates the specified column to have a byte array value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateBytes(int columnIndex, byte[] x) throws SQLException; + void updateBytes(int columnIndex, byte[] value) throws SQLException; /** * 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 * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateDate(int columnIndex, Date x) throws SQLException; + void updateDate(int columnIndex, Date value) throws SQLException; /** * 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 * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateTime(int columnIndex, Time x) throws SQLException; + void updateTime(int columnIndex, Time value) throws SQLException; /** * 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 * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateTimestamp(int columnIndex, Timestamp x) + void updateTimestamp(int columnIndex, Timestamp value) throws SQLException; /** @@ -955,12 +957,12 @@ public interface ResultSet * This does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. - * @param value The new value of the column. - * @param length The length of the stream. + * @param columnIndex The index of the column to update. + * @param stream The stream from which the column value is updated. + * @param count The length of the stream. * @exception SQLException If an error occurs. */ - void updateAsciiStream(int columnIndex, InputStream x, int length) + void updateAsciiStream(int columnIndex, InputStream stream, int count) throws SQLException; /** @@ -968,12 +970,12 @@ public interface ResultSet * This does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. - * @param value The new value of the column. - * @param length The length of the stream. + * @param columnIndex The index of the column to update. + * @param stream The stream from which the column value is updated. + * @param count The length of the stream. * @exception SQLException If an error occurs. */ - void updateBinaryStream(int columnIndex, InputStream x, int length) + void updateBinaryStream(int columnIndex, InputStream stream, int count) throws SQLException; /** @@ -981,12 +983,12 @@ public interface ResultSet * This does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. - * @param value The new value of the column. - * @param length The length of the stream. + * @param columnIndex The index of the column to update. + * @param reader The reader from which the column value is updated. + * @param count The length of the stream. * @exception SQLException If an error occurs. */ - void updateCharacterStream(int columnIndex, Reader x, int length) + void updateCharacterStream(int columnIndex, Reader reader, int count) throws SQLException; /** @@ -994,12 +996,13 @@ public interface ResultSet * This does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. - * + * @param scale The scale of the object in question, which is used only + * for numeric type objects. * @exception SQLException If an error occurs. */ - void updateObject(int columnIndex, Object x, int scale) + void updateObject(int columnIndex, Object value, int scale) throws SQLException; /** @@ -1007,20 +1010,18 @@ public interface ResultSet * This does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param index The index of the column to update. + * @param columnIndex The index of the column to update. * @param value The new value of the column. - * @param scale The scale of the object in question, which is used only - * for numeric type objects. * @exception SQLException If an error occurs. */ - void updateObject(int columnIndex, Object x) throws SQLException; + void updateObject(int columnIndex, Object value) throws SQLException; /** * This method updates the specified column to have a NULL value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @return name The name of the column to update. + * @param columnName The name of the column to update. * @exception SQLException If an error occurs. */ void updateNull(String columnName) throws SQLException; @@ -1030,88 +1031,88 @@ public interface ResultSet * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateBoolean(String columnName, boolean x) throws SQLException; + void updateBoolean(String columnName, boolean value) throws SQLException; /** * This method updates the specified column to have a byte value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateByte(String columnName, byte x) throws SQLException; + void updateByte(String columnName, byte value) throws SQLException; /** * This method updates the specified column to have a short value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateShort(String columnName, short x) throws SQLException; + void updateShort(String columnName, short value) throws SQLException; /** * This method updates the specified column to have an int value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateInt(String columnName, int x) throws SQLException; + void updateInt(String columnName, int value) throws SQLException; /** * This method updates the specified column to have a long value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateLong(String columnName, long x) throws SQLException; + void updateLong(String columnName, long value) throws SQLException; /** * This method updates the specified column to have a float value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateFloat(String columnName, float x) throws SQLException; + void updateFloat(String columnName, float value) throws SQLException; /** * This method updates the specified column to have a double value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateDouble(String columnName, double x) throws SQLException; + void updateDouble(String columnName, double value) throws SQLException; /** * This method updates the specified column to have a BigDecimal value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateBigDecimal(String columnName, BigDecimal x) + void updateBigDecimal(String columnName, BigDecimal value) throws SQLException; /** @@ -1119,55 +1120,55 @@ public interface ResultSet * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateString(String columnName, String x) throws SQLException; + void updateString(String columnName, String value) throws SQLException; /** * This method updates the specified column to have a byte array value. This * does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateBytes(String columnName, byte[] x) throws SQLException; + void updateBytes(String columnName, byte[] value) throws SQLException; /** * 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 * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateDate(String columnName, Date x) throws SQLException; + void updateDate(String columnName, Date value) throws SQLException; /** * 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 * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateTime(String columnName, Time x) throws SQLException; + void updateTime(String columnName, Time value) throws SQLException; /** * 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 * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. * @exception SQLException If an error occurs. */ - void updateTimestamp(String columnName, Timestamp x) + void updateTimestamp(String columnName, Timestamp value) throws SQLException; /** @@ -1175,12 +1176,12 @@ public interface ResultSet * This does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. - * @param value The new value of the column. - * @param length The length of the stream. + * @param columnName The name of the column to update. + * @param stream The stream from which the column value is updated. + * @param count The length of the stream. * @exception SQLException If an error occurs. */ - void updateAsciiStream(String columnName, InputStream x, int length) + void updateAsciiStream(String columnName, InputStream stream, int count) throws SQLException; /** @@ -1188,12 +1189,12 @@ public interface ResultSet * This does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. - * @param value The new value of the column. - * @param length The length of the stream. + * @param columnName The name of the column to update. + * @param stream The stream from which the column value is updated. + * @param count The length of the stream. * @exception SQLException If an error occurs. */ - void updateBinaryStream(String columnName, InputStream x, int length) + void updateBinaryStream(String columnName, InputStream stream, int count) throws SQLException; /** @@ -1201,25 +1202,26 @@ public interface ResultSet * This does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. - * @param value The new value of the column. - * @param length The length of the stream. - * + * @param columnName The name of the column to update. + * @param reader The reader from which the column value is updated. + * @param count The length of the stream. * @exception SQLException If an error occurs. */ - void updateCharacterStream(String columnName, Reader reader, - int length) throws SQLException; + void updateCharacterStream(String columnName, Reader reader, int count) + throws SQLException; /** * This method updates the specified column to have an Object value. * This does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. + * @param scale The scale of the object in question, which is used only + * for numeric type objects. * @exception SQLException If an error occurs. */ - void updateObject(String columnName, Object x, int scale) + void updateObject(String columnName, Object value, int scale) throws SQLException; /** @@ -1227,13 +1229,11 @@ public interface ResultSet * This does not update the actual database. <code>updateRow</code> must be * called in order to do that. * - * @param name The name of the column to update. + * @param columnName The name of the column to update. * @param value The new value of the column. - * @param scale The scale of the object in question, which is used only - * for numeric type objects. * @exception SQLException If an error occurs. */ - void updateObject(String columnName, Object x) throws SQLException; + void updateObject(String columnName, Object value) throws SQLException; /** * This method inserts the current row into the database. The result set @@ -1304,97 +1304,97 @@ public interface ResultSet * This method returns the value of the specified column as a Java * <code>Object</code> using the specified SQL type to Java type map. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @param map The SQL type to Java type map to use. * @return The value of the column as an <code>Object</code>. * @exception SQLException If an error occurs. */ - Object getObject(int i, Map map) throws SQLException; + Object getObject(int columnIndex, Map map) throws SQLException; /** * This method returns a <code>Ref</code> for the specified column which * represents the structured type for the column. * - * @param index The index of the column to return. + * @param columnIndex The index of the column to return. * @return A <code>Ref</code> object for the column * @exception SQLException If an error occurs. */ - Ref getRef(int i) throws SQLException; + Ref getRef(int columnIndex) throws SQLException; /** * This method returns the specified column value as a BLOB. * - * @param index The index of the column value to return. + * @param columnIndex The index of the column value to return. * @return The value of the column as a BLOB. * @exception SQLException If an error occurs. */ - Blob getBlob(int i) throws SQLException; + Blob getBlob(int columnIndex) throws SQLException; /** * This method returns the specified column value as a CLOB. * - * @param index The index of the column value to return. + * @param columnIndex The index of the column value to return. * @return The value of the column as a CLOB. * @exception SQLException If an error occurs. */ - Clob getClob(int i) throws SQLException; + Clob getClob(int columnIndex) throws SQLException; /** * This method returns the specified column value as an <code>Array</code>. * - * @param index The index of the column value to return. + * @param columnIndex The index of the column value to return. * @return The value of the column as an <code>Array</code>. * @exception SQLException If an error occurs. */ - Array getArray(int i) throws SQLException; + Array getArray(int columnIndex) throws SQLException; /** * This method returns the value of the specified column as a Java * <code>Object</code> using the specified SQL type to Java type map. * - * @param name The name of the column to return. + * @param columnName The name of the column to return. * @param map The SQL type to Java type map to use. * @return The value of the column as an <code>Object</code>. * @exception SQLException If an error occurs. */ - Object getObject(String colName, Map map) throws SQLException; + Object getObject(String columnName, Map map) throws SQLException; /** * This method returns a <code>Ref</code> for the specified column which * represents the structured type for the column. * - * @param index The index of the column to return. + * @param columnName The name of the column to return. * @return A <code>Ref</code> object for the column * @exception SQLException If an error occurs. */ - Ref getRef(String colName) throws SQLException; + Ref getRef(String columnName) throws SQLException; /** * This method returns the specified column value as a BLOB. * - * @param name The name of the column value to return. + * @param columnName The name of the column value to return. * @return The value of the column as a BLOB. * @exception SQLException If an error occurs. */ - Blob getBlob(String colName) throws SQLException; + Blob getBlob(String columnName) throws SQLException; /** * This method returns the specified column value as a CLOB. * - * @param name The name of the column value to return. + * @param columnName The name of the column value to return. * @return The value of the column as a CLOB. * @exception SQLException If an error occurs. */ - Clob getClob(String colName) throws SQLException; + Clob getClob(String columnName) throws SQLException; /** * This method returns the specified column value as an <code>Array</code>. * - * @param name The name of the column value to return. + * @param columnName The name of the column value to return. * @return The value of the column as an <code>Array</code>. * @exception SQLException If an error occurs. */ - Array getArray(String colName) throws SQLException; + Array getArray(String columnName) throws SQLException; /** * This method returns the specified column value as a @@ -1402,7 +1402,7 @@ public interface ResultSet * to generate a value for the date if the database does not support * timezones. * - * @param index The index of the column value to return. + * @param columnIndex The index of the column value to return. * @param cal The <code>Calendar</code> to use for calculating timezones. * @return The value of the column as a <code>java.sql.Date</code>. * @exception SQLException If an error occurs. @@ -1415,7 +1415,7 @@ public interface ResultSet * to generate a value for the date if the database does not support * timezones. * - * @param name The name of the column value to return. + * @param columnName The name of the column value to return. * @param cal The <code>Calendar</code> to use for calculating timezones. * @return The value of the column as a <code>java.sql.Date</code>. * @exception SQLException If an error occurs. @@ -1428,7 +1428,7 @@ public interface ResultSet * to generate a value for the time if the database does not support * timezones. * - * @param index The index of the column value to return. + * @param columnIndex The index of the column value to return. * @param cal The <code>Calendar</code> to use for calculating timezones. * @return The value of the column as a <code>java.sql.Time</code>. * @exception SQLException If an error occurs. @@ -1441,7 +1441,7 @@ public interface ResultSet * to generate a value for the time if the database does not support * timezones. * - * @param name The name of the column value to return. + * @param columnName The name of the column value to return. * @param cal The <code>Calendar</code> to use for calculating timezones. * @return The value of the column as a <code>java.sql.Time</code>. * @exception SQLException If an error occurs. @@ -1454,7 +1454,7 @@ public interface ResultSet * to generate a value for the timestamp if the database does not support * timezones. * - * @param index The index of the column value to return. + * @param columnIndex The index of the column value to return. * @param cal The <code>Calendar</code> to use for calculating timezones. * @return The value of the column as a <code>java.sql.Timestamp</code>. * @exception SQLException If an error occurs. @@ -1468,7 +1468,7 @@ public interface ResultSet * to generate a value for the timestamp if the database does not support * timezones. * - * @param name The name of the column value to return. + * @param columnName The name of the column value to return. * @param cal The <code>Calendar</code> to use for calculating timezones. * * @return The value of the column as a <code>java.sql.Timestamp</code>. @@ -1479,52 +1479,132 @@ public interface ResultSet throws SQLException; /** + * This method returns the specified column value as a + * <code>java.net.URL</code>. + * + * @param columnIndex The index of the column value to return. + * @exception SQLException If an error occurs. * @since 1.4 */ URL getURL(int columnIndex) throws SQLException; /** + * This method returns the specified column value as a + * <code>java.net.URL</code>. + * + * @param columnName The name of the column value to return. + * @exception SQLException If an error occurs. * @since 1.4 */ URL getURL(String columnName) throws SQLException; /** + * This method updates the specified column to have a + * <code>java.sql.Ref</code> value. + * This does not update the actual database. <code>updateRow</code> must be + * called in order to do that. + * + * @parm columnIndex The index of the column value to update. + * @parm value The <code>java.sql.Ref</code> used to set the new value + * of the column. + * @exception SQLException If an error occurs. * @since 1.4 */ - void updateRef(int columnIndex, Ref x) throws SQLException; + void updateRef(int columnIndex, Ref value) throws SQLException; /** + * This method updates the specified column to have a + * <code>java.sql.Ref</code> value. + * This does not update the actual database. <code>updateRow</code> must be + * called in order to do that. + * + * @parm columnName The name of the column value to update. + * @parm value The <code>java.sql.Ref</code> used to set the new value + * of the column. + * @exception SQLException If an error occurs. * @since 1.4 */ - void updateRef(String columnName, Ref x) throws SQLException; + void updateRef(String columnName, Ref value) throws SQLException; /** + * This method updates the specified column to have a + * <code>java.sql.Blob</code> value. + * This does not update the actual database. <code>updateRow</code> must be + * called in order to do that. + * + * @parm columnIndex The index of the column value to update. + * @parm value The <code>java.sql.Blob</code> used to set the new value + * of the column. + * @exception SQLException If an error occurs. * @since 1.4 */ - void updateBlob(int columnIndex, Blob x) throws SQLException; + void updateBlob(int columnIndex, Blob value) throws SQLException; /** + * This method updates the specified column to have a + * <code>java.sql.Blob</code> value. + * This does not update the actual database. <code>updateRow</code> must be + * called in order to do that. + * + * @parm columnName The name of the column value to update. + * @parm value The <code>java.sql.Blob</code> used to set the new value + * of the column. + * @exception SQLException If an error occurs. * @since 1.4 */ - void updateBlob(String columnName, Blob x) throws SQLException; + void updateBlob(String columnName, Blob value) throws SQLException; /** + * This method updates the specified column to have a + * <code>java.sql.Clob</code> value. + * This does not update the actual database. <code>updateRow</code> must be + * called in order to do that. + * + * @parm columnIndex The index of the column value to update. + * @parm value The <code>java.sql.Clob</code> used to set the new value + * of the column. + * @exception SQLException If an error occurs. * @since 1.4 */ - void updateClob(int columnIndex, Clob x) throws SQLException; + void updateClob(int columnIndex, Clob value) throws SQLException; /** + * This method updates the specified column to have a + * <code>java.sql.Clob</code> value. + * This does not update the actual database. <code>updateRow</code> must be + * called in order to do that. + * + * @parm columnName The name of the column value to update. + * @parm value The <code>java.sql.Clob</code> used to set the new value + * of the column. + * @exception SQLException If an error occurs. * @since 1.4 */ - void updateClob(String columnName, Clob x) throws SQLException; + void updateClob(String columnName, Clob value) throws SQLException; /** + * This method updates the specified column to have a + * <code>java.sqlArray</code> value. + * This does not update the actual database. <code>updateRow</code> must be + * called in order to do that. + * + * @parm columnIndex The index of the column value to update. + * @parm value The new value of the column. + * @exception SQLException If an error occurs. * @since 1.4 */ - void updateArray(int columnIndex, Array x) throws SQLException; + void updateArray(int columnIndex, Array value) throws SQLException; /** + * This method updates the specified column to have a + * <code>java.sqlArray</code> value. + * This does not update the actual database. <code>updateRow</code> must be + * called in order to do that. + * + * @parm columnName The name of the column value to update. + * @parm value The new value of the column. + * @exception SQLException If an error occurs. * @since 1.4 */ - void updateArray(String columnName, Array x) throws SQLException; + void updateArray(String columnName, Array value) throws SQLException; } |