src/java.sql/share/classes/java/sql/ResultSet.java
author alanb
Tue, 15 May 2018 09:33:02 +0100
changeset 50109 ea54197f4fe4
parent 47216 71c04702a3d5
permissions -rw-r--r--
8203059: (so) Closing a socket channel registered with Selector and with SO_LINGER set to 0 does not reset connection Reviewed-by: chegar
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     1
/*
41889
54d1ff9312ce 8169020: Add since element to JDBC deprecated methods
lancea
parents: 25859
diff changeset
     2
 * Copyright (c) 1996, 2016, Oracle and/or its affiliates. All rights reserved.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
90ce3da70b43 Initial load
duke
parents:
diff changeset
     4
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
90ce3da70b43 Initial load
duke
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    10
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
90ce3da70b43 Initial load
duke
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
90ce3da70b43 Initial load
duke
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
90ce3da70b43 Initial load
duke
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
90ce3da70b43 Initial load
duke
parents:
diff changeset
    15
 * accompanied this code).
90ce3da70b43 Initial load
duke
parents:
diff changeset
    16
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
90ce3da70b43 Initial load
duke
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
90ce3da70b43 Initial load
duke
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    20
 *
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
    23
 * questions.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    24
 */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    25
90ce3da70b43 Initial load
duke
parents:
diff changeset
    26
package java.sql;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    27
90ce3da70b43 Initial load
duke
parents:
diff changeset
    28
import java.math.BigDecimal;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    29
import java.util.Calendar;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    30
import java.io.Reader;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    31
import java.io.InputStream;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    32
90ce3da70b43 Initial load
duke
parents:
diff changeset
    33
/**
90ce3da70b43 Initial load
duke
parents:
diff changeset
    34
 * A table of data representing a database result set, which
90ce3da70b43 Initial load
duke
parents:
diff changeset
    35
 * is usually generated by executing a statement that queries the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    36
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
    37
 * <P>A <code>ResultSet</code> object  maintains a cursor pointing
90ce3da70b43 Initial load
duke
parents:
diff changeset
    38
 * to its current row of data.  Initially the cursor is positioned
90ce3da70b43 Initial load
duke
parents:
diff changeset
    39
 * before the first row. The <code>next</code> method moves the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    40
 * cursor to the next row, and because it returns <code>false</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    41
 * when there are no more rows in the <code>ResultSet</code> object,
90ce3da70b43 Initial load
duke
parents:
diff changeset
    42
 * it can be used in a <code>while</code> loop to iterate through
90ce3da70b43 Initial load
duke
parents:
diff changeset
    43
 * the result set.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    44
 * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    45
 * A default <code>ResultSet</code> object is not updatable and
90ce3da70b43 Initial load
duke
parents:
diff changeset
    46
 * has a cursor that moves forward only.  Thus, you can
90ce3da70b43 Initial load
duke
parents:
diff changeset
    47
 * iterate through it only once and only from the first row to the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    48
 * last row. It is possible to
90ce3da70b43 Initial load
duke
parents:
diff changeset
    49
 * produce <code>ResultSet</code> objects that are scrollable and/or
90ce3da70b43 Initial load
duke
parents:
diff changeset
    50
 * updatable.  The following code fragment, in which <code>con</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    51
 * is a valid <code>Connection</code> object, illustrates how to make
90ce3da70b43 Initial load
duke
parents:
diff changeset
    52
 * a result set that is scrollable and insensitive to updates by others, and
90ce3da70b43 Initial load
duke
parents:
diff changeset
    53
 * that is updatable. See <code>ResultSet</code> fields for other
90ce3da70b43 Initial load
duke
parents:
diff changeset
    54
 * options.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    55
 * <PRE>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    56
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
    57
 *       Statement stmt = con.createStatement(
90ce3da70b43 Initial load
duke
parents:
diff changeset
    58
 *                                      ResultSet.TYPE_SCROLL_INSENSITIVE,
90ce3da70b43 Initial load
duke
parents:
diff changeset
    59
 *                                      ResultSet.CONCUR_UPDATABLE);
90ce3da70b43 Initial load
duke
parents:
diff changeset
    60
 *       ResultSet rs = stmt.executeQuery("SELECT a, b FROM TABLE2");
90ce3da70b43 Initial load
duke
parents:
diff changeset
    61
 *       // rs will be scrollable, will not show changes made by others,
90ce3da70b43 Initial load
duke
parents:
diff changeset
    62
 *       // and will be updatable
90ce3da70b43 Initial load
duke
parents:
diff changeset
    63
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
    64
 * </PRE>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    65
 * The <code>ResultSet</code> interface provides
90ce3da70b43 Initial load
duke
parents:
diff changeset
    66
 * <i>getter</i> methods (<code>getBoolean</code>, <code>getLong</code>, and so on)
90ce3da70b43 Initial load
duke
parents:
diff changeset
    67
 * for retrieving column values from the current row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    68
 * Values can be retrieved using either the index number of the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    69
 * column or the name of the column.  In general, using the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    70
 * column index will be more efficient.  Columns are numbered from 1.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    71
 * For maximum portability, result set columns within each row should be
90ce3da70b43 Initial load
duke
parents:
diff changeset
    72
 * read in left-to-right order, and each column should be read only once.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    73
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
    74
 * <P>For the getter methods, a JDBC driver attempts
90ce3da70b43 Initial load
duke
parents:
diff changeset
    75
 * to convert the underlying data to the Java type specified in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    76
 * getter method and returns a suitable Java value.  The JDBC specification
90ce3da70b43 Initial load
duke
parents:
diff changeset
    77
 * has a table showing the allowable mappings from SQL types to Java types
90ce3da70b43 Initial load
duke
parents:
diff changeset
    78
 * that can be used by the <code>ResultSet</code> getter methods.
20880
1b610151b316 8026812: doclint clean up for java.sql and javax.sql
lancea
parents: 18583
diff changeset
    79
 *
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    80
 * <P>Column names used as input to getter methods are case
90ce3da70b43 Initial load
duke
parents:
diff changeset
    81
 * insensitive.  When a getter method is called  with
90ce3da70b43 Initial load
duke
parents:
diff changeset
    82
 * a column name and several columns have the same name,
90ce3da70b43 Initial load
duke
parents:
diff changeset
    83
 * the value of the first matching column will be returned.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    84
 * The column name option is
90ce3da70b43 Initial load
duke
parents:
diff changeset
    85
 * designed to be used when column names are used in the SQL
90ce3da70b43 Initial load
duke
parents:
diff changeset
    86
 * query that generated the result set.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    87
 * For columns that are NOT explicitly named in the query, it
90ce3da70b43 Initial load
duke
parents:
diff changeset
    88
 * is best to use column numbers. If column names are used, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    89
 * programmer should take care to guarantee that they uniquely refer to
90ce3da70b43 Initial load
duke
parents:
diff changeset
    90
 * the intended columns, which can be assured with the SQL <i>AS</i> clause.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    91
 * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    92
 * A set of updater methods were added to this interface
18564
f9db68ff2cbb 8017471: Fix JDBC -Xdoclint public errors
lancea
parents: 18156
diff changeset
    93
 * in the JDBC 2.0 API (Java&trade; 2 SDK,
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    94
 * Standard Edition, version 1.2). The comments regarding parameters
90ce3da70b43 Initial load
duke
parents:
diff changeset
    95
 * to the getter methods also apply to parameters to the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    96
 * updater methods.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    97
 *<P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    98
 * The updater methods may be used in two ways:
90ce3da70b43 Initial load
duke
parents:
diff changeset
    99
 * <ol>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   100
 * <LI>to update a column value in the current row.  In a scrollable
90ce3da70b43 Initial load
duke
parents:
diff changeset
   101
 *     <code>ResultSet</code> object, the cursor can be moved backwards
90ce3da70b43 Initial load
duke
parents:
diff changeset
   102
 *     and forwards, to an absolute position, or to a position
90ce3da70b43 Initial load
duke
parents:
diff changeset
   103
 *     relative to the current row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   104
 *     The following code fragment updates the <code>NAME</code> column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   105
 *     in the fifth row of the <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
   106
 *     <code>rs</code> and then uses the method <code>updateRow</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   107
 *     to update the data source table from which <code>rs</code> was derived.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   108
 * <PRE>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   109
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   110
 *       rs.absolute(5); // moves the cursor to the fifth row of rs
90ce3da70b43 Initial load
duke
parents:
diff changeset
   111
 *       rs.updateString("NAME", "AINSWORTH"); // updates the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   112
 *          // <code>NAME</code> column of row 5 to be <code>AINSWORTH</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   113
 *       rs.updateRow(); // updates the row in the data source
90ce3da70b43 Initial load
duke
parents:
diff changeset
   114
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   115
 * </PRE>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   116
 * <LI>to insert column values into the insert row.  An updatable
90ce3da70b43 Initial load
duke
parents:
diff changeset
   117
 *     <code>ResultSet</code> object has a special row associated with
90ce3da70b43 Initial load
duke
parents:
diff changeset
   118
 *     it that serves as a staging area for building a row to be inserted.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   119
 *     The following code fragment moves the cursor to the insert row, builds
90ce3da70b43 Initial load
duke
parents:
diff changeset
   120
 *     a three-column row, and inserts it into <code>rs</code> and into
90ce3da70b43 Initial load
duke
parents:
diff changeset
   121
 *     the data source table using the method <code>insertRow</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   122
 * <PRE>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   123
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   124
 *       rs.moveToInsertRow(); // moves cursor to the insert row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   125
 *       rs.updateString(1, "AINSWORTH"); // updates the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   126
 *          // first column of the insert row to be <code>AINSWORTH</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   127
 *       rs.updateInt(2,35); // updates the second column to be <code>35</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   128
 *       rs.updateBoolean(3, true); // updates the third column to <code>true</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   129
 *       rs.insertRow();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   130
 *       rs.moveToCurrentRow();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   131
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   132
 * </PRE>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   133
 * </ol>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   134
 * <P>A <code>ResultSet</code> object is automatically closed when the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   135
 * <code>Statement</code> object that
90ce3da70b43 Initial load
duke
parents:
diff changeset
   136
 * generated it is closed, re-executed, or used
90ce3da70b43 Initial load
duke
parents:
diff changeset
   137
 * to retrieve the next result from a sequence of multiple results.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   138
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   139
 * <P>The number, types and properties of a <code>ResultSet</code>
9258
b5a28d36265b 7007772: Address typos in javadoc for ResultSet
lancea
parents: 6540
diff changeset
   140
 * object's columns are provided by the <code>ResultSetMetaData</code>
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   141
 * object returned by the <code>ResultSet.getMetaData</code> method.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   142
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   143
 * @see Statement#executeQuery
90ce3da70b43 Initial load
duke
parents:
diff changeset
   144
 * @see Statement#getResultSet
90ce3da70b43 Initial load
duke
parents:
diff changeset
   145
 * @see ResultSetMetaData
44256
12050b22e372 8176721: @since value errors java.sql module
mli
parents: 41889
diff changeset
   146
 * @since 1.1
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   147
 */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   148
6540
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
   149
public interface ResultSet extends Wrapper, AutoCloseable {
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   150
90ce3da70b43 Initial load
duke
parents:
diff changeset
   151
    /**
18583
d678ac758734 8019286: Fix javadoc typo in ResultSet.next
lancea
parents: 18564
diff changeset
   152
     * Moves the cursor forward one row from its current position.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   153
     * A <code>ResultSet</code> cursor is initially positioned
90ce3da70b43 Initial load
duke
parents:
diff changeset
   154
     * before the first row; the first call to the method
90ce3da70b43 Initial load
duke
parents:
diff changeset
   155
     * <code>next</code> makes the first row the current row; the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   156
     * second call makes the second row the current row, and so on.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   157
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   158
     * When a call to the <code>next</code> method returns <code>false</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   159
     * the cursor is positioned after the last row. Any
90ce3da70b43 Initial load
duke
parents:
diff changeset
   160
     * invocation of a <code>ResultSet</code> method which requires a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   161
     * current row will result in a <code>SQLException</code> being thrown.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   162
     *  If the result set type is <code>TYPE_FORWARD_ONLY</code>, it is vendor specified
90ce3da70b43 Initial load
duke
parents:
diff changeset
   163
     * whether their JDBC driver implementation will return <code>false</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
   164
     *  throw an <code>SQLException</code> on a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   165
     * subsequent call to <code>next</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   166
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   167
     * <P>If an input stream is open for the current row, a call
90ce3da70b43 Initial load
duke
parents:
diff changeset
   168
     * to the method <code>next</code> will
90ce3da70b43 Initial load
duke
parents:
diff changeset
   169
     * implicitly close it. A <code>ResultSet</code> object's
90ce3da70b43 Initial load
duke
parents:
diff changeset
   170
     * warning chain is cleared when a new row is read.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   171
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   172
     * @return <code>true</code> if the new current row is valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   173
     * <code>false</code> if there are no more rows
90ce3da70b43 Initial load
duke
parents:
diff changeset
   174
     * @exception SQLException if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   175
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   176
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   177
    boolean next() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   178
90ce3da70b43 Initial load
duke
parents:
diff changeset
   179
90ce3da70b43 Initial load
duke
parents:
diff changeset
   180
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   181
     * Releases this <code>ResultSet</code> object's database and
90ce3da70b43 Initial load
duke
parents:
diff changeset
   182
     * JDBC resources immediately instead of waiting for
90ce3da70b43 Initial load
duke
parents:
diff changeset
   183
     * this to happen when it is automatically closed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   184
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   185
     * <P>The closing of a <code>ResultSet</code> object does <strong>not</strong> close the <code>Blob</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   186
     * <code>Clob</code> or <code>NClob</code> objects created by the <code>ResultSet</code>. <code>Blob</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   187
     * <code>Clob</code> or <code>NClob</code> objects remain valid for at least the duration of the
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 20880
diff changeset
   188
     * transaction in which they are created, unless their <code>free</code> method is invoked.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   189
     *<p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   190
     * When a <code>ResultSet</code> is closed, any <code>ResultSetMetaData</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   191
     * instances that were created by calling the  <code>getMetaData</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   192
     * method remain accessible.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   193
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   194
     * <P><B>Note:</B> A <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
   195
     * is automatically closed by the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   196
     * <code>Statement</code> object that generated it when
90ce3da70b43 Initial load
duke
parents:
diff changeset
   197
     * that <code>Statement</code> object is closed,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   198
     * re-executed, or is used to retrieve the next result from a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   199
     * sequence of multiple results.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   200
     *<p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   201
     * Calling the method <code>close</code> on a <code>ResultSet</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   202
     * object that is already closed is a no-op.
20880
1b610151b316 8026812: doclint clean up for java.sql and javax.sql
lancea
parents: 18583
diff changeset
   203
     *
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   204
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   205
     * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
   206
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   207
    void close() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   208
90ce3da70b43 Initial load
duke
parents:
diff changeset
   209
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   210
     * Reports whether
90ce3da70b43 Initial load
duke
parents:
diff changeset
   211
     * the last column read had a value of SQL <code>NULL</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   212
     * Note that you must first call one of the getter methods
90ce3da70b43 Initial load
duke
parents:
diff changeset
   213
     * on a column to try to read its value and then call
90ce3da70b43 Initial load
duke
parents:
diff changeset
   214
     * the method <code>wasNull</code> to see if the value read was
90ce3da70b43 Initial load
duke
parents:
diff changeset
   215
     * SQL <code>NULL</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   216
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   217
     * @return <code>true</code> if the last column value read was SQL
90ce3da70b43 Initial load
duke
parents:
diff changeset
   218
     *         <code>NULL</code> and <code>false</code> otherwise
90ce3da70b43 Initial load
duke
parents:
diff changeset
   219
     * @exception SQLException if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   220
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   221
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   222
    boolean wasNull() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   223
90ce3da70b43 Initial load
duke
parents:
diff changeset
   224
    // Methods for accessing results by column index
90ce3da70b43 Initial load
duke
parents:
diff changeset
   225
90ce3da70b43 Initial load
duke
parents:
diff changeset
   226
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   227
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   228
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   229
     * a <code>String</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   230
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   231
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   232
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   233
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   234
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   235
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   236
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   237
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   238
    String getString(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   239
90ce3da70b43 Initial load
duke
parents:
diff changeset
   240
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   241
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   242
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   243
     * a <code>boolean</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   244
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   245
     * <P>If the designated column has a datatype of CHAR or VARCHAR
90ce3da70b43 Initial load
duke
parents:
diff changeset
   246
     * and contains a "0" or has a datatype of BIT, TINYINT, SMALLINT, INTEGER or BIGINT
90ce3da70b43 Initial load
duke
parents:
diff changeset
   247
     * and contains  a 0, a value of <code>false</code> is returned.  If the designated column has a datatype
90ce3da70b43 Initial load
duke
parents:
diff changeset
   248
     * of CHAR or VARCHAR
90ce3da70b43 Initial load
duke
parents:
diff changeset
   249
     * and contains a "1" or has a datatype of BIT, TINYINT, SMALLINT, INTEGER or BIGINT
90ce3da70b43 Initial load
duke
parents:
diff changeset
   250
     * and contains  a 1, a value of <code>true</code> is returned.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   251
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   252
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   253
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   254
     * value returned is <code>false</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   255
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   256
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   257
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   258
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   259
    boolean getBoolean(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   260
90ce3da70b43 Initial load
duke
parents:
diff changeset
   261
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   262
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   263
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   264
     * a <code>byte</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   265
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   266
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   267
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   268
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   269
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   270
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   271
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   272
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   273
    byte getByte(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   274
90ce3da70b43 Initial load
duke
parents:
diff changeset
   275
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   276
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   277
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   278
     * a <code>short</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   279
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   280
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   281
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   282
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   283
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   284
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   285
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   286
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   287
    short getShort(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   288
90ce3da70b43 Initial load
duke
parents:
diff changeset
   289
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   290
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   291
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   292
     * an <code>int</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   293
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   294
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   295
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   296
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   297
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   298
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   299
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   300
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   301
    int getInt(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   302
90ce3da70b43 Initial load
duke
parents:
diff changeset
   303
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   304
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   305
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   306
     * a <code>long</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   307
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   308
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   309
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   310
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   311
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   312
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   313
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   314
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   315
    long getLong(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   316
90ce3da70b43 Initial load
duke
parents:
diff changeset
   317
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   318
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   319
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   320
     * a <code>float</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   321
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   322
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   323
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   324
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   325
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   326
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   327
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   328
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   329
    float getFloat(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   330
90ce3da70b43 Initial load
duke
parents:
diff changeset
   331
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   332
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   333
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   334
     * a <code>double</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   335
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   336
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   337
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   338
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   339
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   340
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   341
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   342
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   343
    double getDouble(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   344
90ce3da70b43 Initial load
duke
parents:
diff changeset
   345
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   346
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   347
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   348
     * a <code>java.sql.BigDecimal</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   349
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   350
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   351
     * @param scale the number of digits to the right of the decimal point
90ce3da70b43 Initial load
duke
parents:
diff changeset
   352
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   353
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   354
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   355
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   356
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   357
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
   358
     * this method
14171
94eb36844bd7 7197395: Add @Deprecated to all deprecated methods to eliminate compiler warnings in JDBC
lancea
parents: 9258
diff changeset
   359
     * @deprecated Use {@code getBigDecimal(int columnIndex)}
94eb36844bd7 7197395: Add @Deprecated to all deprecated methods to eliminate compiler warnings in JDBC
lancea
parents: 9258
diff changeset
   360
     *             or {@code getBigDecimal(String columnLabel)}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   361
     */
41889
54d1ff9312ce 8169020: Add since element to JDBC deprecated methods
lancea
parents: 25859
diff changeset
   362
    @Deprecated(since="1.2")
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   363
    BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   364
90ce3da70b43 Initial load
duke
parents:
diff changeset
   365
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   366
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   367
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   368
     * a <code>byte</code> array in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   369
     * The bytes represent the raw values returned by the driver.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   370
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   371
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   372
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   373
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   374
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   375
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   376
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   377
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   378
    byte[] getBytes(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   379
90ce3da70b43 Initial load
duke
parents:
diff changeset
   380
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   381
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   382
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   383
     * a <code>java.sql.Date</code> object in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   384
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   385
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   386
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   387
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   388
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   389
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   390
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   391
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   392
    java.sql.Date getDate(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   393
90ce3da70b43 Initial load
duke
parents:
diff changeset
   394
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   395
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   396
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   397
     * a <code>java.sql.Time</code> object in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   398
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   399
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   400
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   401
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   402
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   403
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   404
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   405
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   406
    java.sql.Time getTime(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   407
90ce3da70b43 Initial load
duke
parents:
diff changeset
   408
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   409
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   410
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   411
     * a <code>java.sql.Timestamp</code> object in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   412
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   413
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   414
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   415
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   416
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   417
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   418
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   419
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   420
    java.sql.Timestamp getTimestamp(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   421
90ce3da70b43 Initial load
duke
parents:
diff changeset
   422
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   423
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   424
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   425
     * a stream of ASCII characters. The value can then be read in chunks from the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   426
     * stream. This method is particularly
9258
b5a28d36265b 7007772: Address typos in javadoc for ResultSet
lancea
parents: 6540
diff changeset
   427
     * suitable for retrieving large <code>LONGVARCHAR</code> values.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   428
     * The JDBC driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
   429
     * do any necessary conversion from the database format into ASCII.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   430
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   431
     * <P><B>Note:</B> All the data in the returned stream must be
90ce3da70b43 Initial load
duke
parents:
diff changeset
   432
     * read prior to getting the value of any other column. The next
90ce3da70b43 Initial load
duke
parents:
diff changeset
   433
     * call to a getter method implicitly closes the stream.  Also, a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   434
     * stream may return <code>0</code> when the method
90ce3da70b43 Initial load
duke
parents:
diff changeset
   435
     * <code>InputStream.available</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   436
     * is called whether there is data available or not.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   437
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   438
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   439
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
   440
     * as a stream of one-byte ASCII characters;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   441
     * if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   442
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   443
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   444
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   445
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   446
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   447
    java.io.InputStream getAsciiStream(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   448
90ce3da70b43 Initial load
duke
parents:
diff changeset
   449
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   450
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   451
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   452
     * as a stream of two-byte 3 characters. The first byte is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   453
     * the high byte; the second byte is the low byte.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   454
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   455
     * The value can then be read in chunks from the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   456
     * stream. This method is particularly
90ce3da70b43 Initial load
duke
parents:
diff changeset
   457
     * suitable for retrieving large <code>LONGVARCHAR</code>values.  The
90ce3da70b43 Initial load
duke
parents:
diff changeset
   458
     * JDBC driver will do any necessary conversion from the database
90ce3da70b43 Initial load
duke
parents:
diff changeset
   459
     * format into Unicode.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   460
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   461
     * <P><B>Note:</B> All the data in the returned stream must be
90ce3da70b43 Initial load
duke
parents:
diff changeset
   462
     * read prior to getting the value of any other column. The next
90ce3da70b43 Initial load
duke
parents:
diff changeset
   463
     * call to a getter method implicitly closes the stream.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   464
     * Also, a stream may return <code>0</code> when the method
90ce3da70b43 Initial load
duke
parents:
diff changeset
   465
     * <code>InputStream.available</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   466
     * is called, whether there is data available or not.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   467
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   468
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   469
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
   470
     *         as a stream of two-byte Unicode characters;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   471
     *         if the value is SQL <code>NULL</code>, the value returned is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   472
     *         <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   473
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   474
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   475
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   476
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   477
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
   478
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
   479
     * @deprecated use <code>getCharacterStream</code> in place of
90ce3da70b43 Initial load
duke
parents:
diff changeset
   480
     *              <code>getUnicodeStream</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   481
     */
41889
54d1ff9312ce 8169020: Add since element to JDBC deprecated methods
lancea
parents: 25859
diff changeset
   482
    @Deprecated(since="1.2")
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   483
    java.io.InputStream getUnicodeStream(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   484
90ce3da70b43 Initial load
duke
parents:
diff changeset
   485
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   486
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   487
     * of this <code>ResultSet</code> object as a  stream of
90ce3da70b43 Initial load
duke
parents:
diff changeset
   488
     * uninterpreted bytes. The value can then be read in chunks from the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   489
     * stream. This method is particularly
90ce3da70b43 Initial load
duke
parents:
diff changeset
   490
     * suitable for retrieving large <code>LONGVARBINARY</code> values.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   491
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   492
     * <P><B>Note:</B> All the data in the returned stream must be
90ce3da70b43 Initial load
duke
parents:
diff changeset
   493
     * read prior to getting the value of any other column. The next
90ce3da70b43 Initial load
duke
parents:
diff changeset
   494
     * call to a getter method implicitly closes the stream.  Also, a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   495
     * stream may return <code>0</code> when the method
90ce3da70b43 Initial load
duke
parents:
diff changeset
   496
     * <code>InputStream.available</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   497
     * is called whether there is data available or not.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   498
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   499
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   500
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
   501
     *         as a stream of uninterpreted bytes;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   502
     *         if the value is SQL <code>NULL</code>, the value returned is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   503
     *         <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   504
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   505
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   506
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   507
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   508
    java.io.InputStream getBinaryStream(int columnIndex)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   509
        throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   510
90ce3da70b43 Initial load
duke
parents:
diff changeset
   511
90ce3da70b43 Initial load
duke
parents:
diff changeset
   512
    // Methods for accessing results by column label
90ce3da70b43 Initial load
duke
parents:
diff changeset
   513
90ce3da70b43 Initial load
duke
parents:
diff changeset
   514
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   515
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   516
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   517
     * a <code>String</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   518
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   519
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   520
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   521
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   522
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   523
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   524
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   525
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   526
    String getString(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   527
90ce3da70b43 Initial load
duke
parents:
diff changeset
   528
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   529
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   530
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   531
     * a <code>boolean</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   532
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   533
     * <P>If the designated column has a datatype of CHAR or VARCHAR
90ce3da70b43 Initial load
duke
parents:
diff changeset
   534
     * and contains a "0" or has a datatype of BIT, TINYINT, SMALLINT, INTEGER or BIGINT
90ce3da70b43 Initial load
duke
parents:
diff changeset
   535
     * and contains  a 0, a value of <code>false</code> is returned.  If the designated column has a datatype
90ce3da70b43 Initial load
duke
parents:
diff changeset
   536
     * of CHAR or VARCHAR
90ce3da70b43 Initial load
duke
parents:
diff changeset
   537
     * and contains a "1" or has a datatype of BIT, TINYINT, SMALLINT, INTEGER or BIGINT
90ce3da70b43 Initial load
duke
parents:
diff changeset
   538
     * and contains  a 1, a value of <code>true</code> is returned.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   539
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   540
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   541
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   542
     * value returned is <code>false</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   543
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   544
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   545
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   546
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   547
    boolean getBoolean(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   548
90ce3da70b43 Initial load
duke
parents:
diff changeset
   549
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   550
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   551
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   552
     * a <code>byte</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   553
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   554
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   555
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   556
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   557
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   558
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   559
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   560
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   561
    byte getByte(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   562
90ce3da70b43 Initial load
duke
parents:
diff changeset
   563
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   564
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   565
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   566
     * a <code>short</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   567
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   568
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   569
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   570
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   571
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   572
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   573
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   574
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   575
    short getShort(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   576
90ce3da70b43 Initial load
duke
parents:
diff changeset
   577
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   578
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   579
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   580
     * an <code>int</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   581
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   582
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   583
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   584
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   585
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   586
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   587
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   588
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   589
    int getInt(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   590
90ce3da70b43 Initial load
duke
parents:
diff changeset
   591
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   592
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   593
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   594
     * a <code>long</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   595
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   596
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   597
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   598
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   599
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   600
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   601
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   602
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   603
    long getLong(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   604
90ce3da70b43 Initial load
duke
parents:
diff changeset
   605
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   606
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   607
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   608
     * a <code>float</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   609
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   610
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   611
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   612
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   613
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   614
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   615
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   616
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   617
    float getFloat(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   618
90ce3da70b43 Initial load
duke
parents:
diff changeset
   619
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   620
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   621
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   622
     * a <code>double</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   623
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   624
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   625
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   626
     * value returned is <code>0</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   627
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   628
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   629
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   630
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   631
    double getDouble(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   632
90ce3da70b43 Initial load
duke
parents:
diff changeset
   633
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   634
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   635
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   636
     * a <code>java.math.BigDecimal</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   637
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   638
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   639
     * @param scale the number of digits to the right of the decimal point
90ce3da70b43 Initial load
duke
parents:
diff changeset
   640
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   641
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   642
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   643
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   644
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   645
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
   646
     * this method
14171
94eb36844bd7 7197395: Add @Deprecated to all deprecated methods to eliminate compiler warnings in JDBC
lancea
parents: 9258
diff changeset
   647
     * @deprecated Use {@code getBigDecimal(int columnIndex)}
94eb36844bd7 7197395: Add @Deprecated to all deprecated methods to eliminate compiler warnings in JDBC
lancea
parents: 9258
diff changeset
   648
     *             or {@code getBigDecimal(String columnLabel)}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   649
     */
41889
54d1ff9312ce 8169020: Add since element to JDBC deprecated methods
lancea
parents: 25859
diff changeset
   650
    @Deprecated(since="1.2")
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   651
    BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   652
90ce3da70b43 Initial load
duke
parents:
diff changeset
   653
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   654
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   655
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   656
     * a <code>byte</code> array in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   657
     * The bytes represent the raw values returned by the driver.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   658
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   659
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   660
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   661
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   662
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   663
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   664
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   665
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   666
    byte[] getBytes(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   667
90ce3da70b43 Initial load
duke
parents:
diff changeset
   668
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   669
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   670
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   671
     * a <code>java.sql.Date</code> object in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   672
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   673
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   674
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   675
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   676
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   677
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   678
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   679
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   680
    java.sql.Date getDate(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   681
90ce3da70b43 Initial load
duke
parents:
diff changeset
   682
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   683
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   684
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   685
     * a <code>java.sql.Time</code> object in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   686
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   687
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   688
     * @return the column value;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   689
     * if the value is SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   690
     * the value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   691
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   692
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   693
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   694
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   695
    java.sql.Time getTime(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   696
90ce3da70b43 Initial load
duke
parents:
diff changeset
   697
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   698
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   699
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   700
     * a <code>java.sql.Timestamp</code> object in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   701
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   702
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   703
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   704
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   705
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   706
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   707
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   708
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   709
    java.sql.Timestamp getTimestamp(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   710
90ce3da70b43 Initial load
duke
parents:
diff changeset
   711
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   712
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   713
     * of this <code>ResultSet</code> object as a stream of
90ce3da70b43 Initial load
duke
parents:
diff changeset
   714
     * ASCII characters. The value can then be read in chunks from the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   715
     * stream. This method is particularly
90ce3da70b43 Initial load
duke
parents:
diff changeset
   716
     * suitable for retrieving large <code>LONGVARCHAR</code> values.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   717
     * The JDBC driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
   718
     * do any necessary conversion from the database format into ASCII.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   719
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   720
     * <P><B>Note:</B> All the data in the returned stream must be
90ce3da70b43 Initial load
duke
parents:
diff changeset
   721
     * read prior to getting the value of any other column. The next
90ce3da70b43 Initial load
duke
parents:
diff changeset
   722
     * call to a getter method implicitly closes the stream. Also, a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   723
     * stream may return <code>0</code> when the method <code>available</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   724
     * is called whether there is data available or not.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   725
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   726
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   727
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
   728
     * as a stream of one-byte ASCII characters.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   729
     * If the value is SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   730
     * the value returned is <code>null</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   731
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   732
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   733
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   734
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   735
    java.io.InputStream getAsciiStream(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   736
90ce3da70b43 Initial load
duke
parents:
diff changeset
   737
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   738
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   739
     * of this <code>ResultSet</code> object as a stream of two-byte
90ce3da70b43 Initial load
duke
parents:
diff changeset
   740
     * Unicode characters. The first byte is the high byte; the second
90ce3da70b43 Initial load
duke
parents:
diff changeset
   741
     * byte is the low byte.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   742
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   743
     * The value can then be read in chunks from the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   744
     * stream. This method is particularly
90ce3da70b43 Initial load
duke
parents:
diff changeset
   745
     * suitable for retrieving large <code>LONGVARCHAR</code> values.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   746
     * The JDBC technology-enabled driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
   747
     * do any necessary conversion from the database format into Unicode.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   748
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   749
     * <P><B>Note:</B> All the data in the returned stream must be
90ce3da70b43 Initial load
duke
parents:
diff changeset
   750
     * read prior to getting the value of any other column. The next
90ce3da70b43 Initial load
duke
parents:
diff changeset
   751
     * call to a getter method implicitly closes the stream.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   752
     * Also, a stream may return <code>0</code> when the method
90ce3da70b43 Initial load
duke
parents:
diff changeset
   753
     * <code>InputStream.available</code> is called, whether there
90ce3da70b43 Initial load
duke
parents:
diff changeset
   754
     * is data available or not.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   755
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   756
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   757
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
   758
     *         as a stream of two-byte Unicode characters.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   759
     *         If the value is SQL <code>NULL</code>, the value returned
90ce3da70b43 Initial load
duke
parents:
diff changeset
   760
     *         is <code>null</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   761
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   762
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   763
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   764
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
   765
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
   766
     * @deprecated use <code>getCharacterStream</code> instead
90ce3da70b43 Initial load
duke
parents:
diff changeset
   767
     */
41889
54d1ff9312ce 8169020: Add since element to JDBC deprecated methods
lancea
parents: 25859
diff changeset
   768
    @Deprecated(since="1.2")
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   769
    java.io.InputStream getUnicodeStream(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   770
90ce3da70b43 Initial load
duke
parents:
diff changeset
   771
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   772
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   773
     * of this <code>ResultSet</code> object as a stream of uninterpreted
90ce3da70b43 Initial load
duke
parents:
diff changeset
   774
     * <code>byte</code>s.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   775
     * The value can then be read in chunks from the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   776
     * stream. This method is particularly
90ce3da70b43 Initial load
duke
parents:
diff changeset
   777
     * suitable for retrieving large <code>LONGVARBINARY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   778
     * values.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   779
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   780
     * <P><B>Note:</B> All the data in the returned stream must be
90ce3da70b43 Initial load
duke
parents:
diff changeset
   781
     * read prior to getting the value of any other column. The next
90ce3da70b43 Initial load
duke
parents:
diff changeset
   782
     * call to a getter method implicitly closes the stream. Also, a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   783
     * stream may return <code>0</code> when the method <code>available</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   784
     * is called whether there is data available or not.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   785
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   786
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   787
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
   788
     * as a stream of uninterpreted bytes;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   789
     * if the value is SQL <code>NULL</code>, the result is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   790
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   791
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   792
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   793
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   794
    java.io.InputStream getBinaryStream(String columnLabel)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   795
        throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   796
90ce3da70b43 Initial load
duke
parents:
diff changeset
   797
90ce3da70b43 Initial load
duke
parents:
diff changeset
   798
    // Advanced features:
90ce3da70b43 Initial load
duke
parents:
diff changeset
   799
90ce3da70b43 Initial load
duke
parents:
diff changeset
   800
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   801
     * Retrieves the first warning reported by calls on this
90ce3da70b43 Initial load
duke
parents:
diff changeset
   802
     * <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   803
     * Subsequent warnings on this <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
   804
     * will be chained to the <code>SQLWarning</code> object that
90ce3da70b43 Initial load
duke
parents:
diff changeset
   805
     * this method returns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   806
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   807
     * <P>The warning chain is automatically cleared each time a new
90ce3da70b43 Initial load
duke
parents:
diff changeset
   808
     * row is read.  This method may not be called on a <code>ResultSet</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   809
     * object that has been closed; doing so will cause an
90ce3da70b43 Initial load
duke
parents:
diff changeset
   810
     * <code>SQLException</code> to be thrown.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   811
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   812
     * <B>Note:</B> This warning chain only covers warnings caused
90ce3da70b43 Initial load
duke
parents:
diff changeset
   813
     * by <code>ResultSet</code> methods.  Any warning caused by
90ce3da70b43 Initial load
duke
parents:
diff changeset
   814
     * <code>Statement</code> methods
90ce3da70b43 Initial load
duke
parents:
diff changeset
   815
     * (such as reading OUT parameters) will be chained on the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   816
     * <code>Statement</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   817
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   818
     * @return the first <code>SQLWarning</code> object reported or
90ce3da70b43 Initial load
duke
parents:
diff changeset
   819
     *         <code>null</code> if there are none
90ce3da70b43 Initial load
duke
parents:
diff changeset
   820
     * @exception SQLException if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   821
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   822
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   823
    SQLWarning getWarnings() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   824
90ce3da70b43 Initial load
duke
parents:
diff changeset
   825
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   826
     * Clears all warnings reported on this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   827
     * After this method is called, the method <code>getWarnings</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   828
     * returns <code>null</code> until a new warning is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   829
     * reported for this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   830
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   831
     * @exception SQLException if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   832
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   833
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   834
    void clearWarnings() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   835
90ce3da70b43 Initial load
duke
parents:
diff changeset
   836
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   837
     * Retrieves the name of the SQL cursor used by this <code>ResultSet</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   838
     * object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   839
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   840
     * <P>In SQL, a result table is retrieved through a cursor that is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   841
     * named. The current row of a result set can be updated or deleted
90ce3da70b43 Initial load
duke
parents:
diff changeset
   842
     * using a positioned update/delete statement that references the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   843
     * cursor name. To insure that the cursor has the proper isolation
90ce3da70b43 Initial load
duke
parents:
diff changeset
   844
     * level to support update, the cursor's <code>SELECT</code> statement
90ce3da70b43 Initial load
duke
parents:
diff changeset
   845
     * should be of the form <code>SELECT FOR UPDATE</code>. If
90ce3da70b43 Initial load
duke
parents:
diff changeset
   846
     * <code>FOR UPDATE</code> is omitted, the positioned updates may fail.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   847
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   848
     * <P>The JDBC API supports this SQL feature by providing the name of the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   849
     * SQL cursor used by a <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   850
     * The current row of a <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
   851
     * is also the current row of this SQL cursor.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   852
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   853
     * @return the SQL name for this <code>ResultSet</code> object's cursor
90ce3da70b43 Initial load
duke
parents:
diff changeset
   854
     * @exception SQLException if a database access error occurs or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   855
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
   856
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
   857
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   858
    String getCursorName() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   859
90ce3da70b43 Initial load
duke
parents:
diff changeset
   860
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   861
     * Retrieves the  number, types and properties of
90ce3da70b43 Initial load
duke
parents:
diff changeset
   862
     * this <code>ResultSet</code> object's columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   863
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   864
     * @return the description of this <code>ResultSet</code> object's columns
90ce3da70b43 Initial load
duke
parents:
diff changeset
   865
     * @exception SQLException if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   866
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   867
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   868
    ResultSetMetaData getMetaData() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   869
90ce3da70b43 Initial load
duke
parents:
diff changeset
   870
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   871
     * <p>Gets the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   872
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   873
     * an <code>Object</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   874
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   875
     * <p>This method will return the value of the given column as a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   876
     * Java object.  The type of the Java object will be the default
90ce3da70b43 Initial load
duke
parents:
diff changeset
   877
     * Java object type corresponding to the column's SQL type,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   878
     * following the mapping for built-in types specified in the JDBC
90ce3da70b43 Initial load
duke
parents:
diff changeset
   879
     * specification. If the value is an SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   880
     * the driver returns a Java <code>null</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   881
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   882
     * <p>This method may also be used to read database-specific
90ce3da70b43 Initial load
duke
parents:
diff changeset
   883
     * abstract data types.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   884
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   885
     * In the JDBC 2.0 API, the behavior of method
90ce3da70b43 Initial load
duke
parents:
diff changeset
   886
     * <code>getObject</code> is extended to materialize
90ce3da70b43 Initial load
duke
parents:
diff changeset
   887
     * data of SQL user-defined types.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   888
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   889
     * If <code>Connection.getTypeMap</code> does not throw a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   890
     * <code>SQLFeatureNotSupportedException</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   891
     * then when a column contains a structured or distinct value,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   892
     * the behavior of this method is as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   893
     * if it were a call to: <code>getObject(columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   894
     * this.getStatement().getConnection().getTypeMap())</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   895
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   896
     * If <code>Connection.getTypeMap</code> does throw a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   897
     * <code>SQLFeatureNotSupportedException</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   898
     * then structured values are not supported, and distinct values
90ce3da70b43 Initial load
duke
parents:
diff changeset
   899
     * are mapped to the default Java class as determined by the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   900
     * underlying SQL type of the DISTINCT type.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   901
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   902
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   903
     * @return a <code>java.lang.Object</code> holding the column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
   904
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   905
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   906
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   907
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   908
    Object getObject(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   909
90ce3da70b43 Initial load
duke
parents:
diff changeset
   910
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   911
     * <p>Gets the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   912
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   913
     * an <code>Object</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   914
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   915
     * <p>This method will return the value of the given column as a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   916
     * Java object.  The type of the Java object will be the default
90ce3da70b43 Initial load
duke
parents:
diff changeset
   917
     * Java object type corresponding to the column's SQL type,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   918
     * following the mapping for built-in types specified in the JDBC
90ce3da70b43 Initial load
duke
parents:
diff changeset
   919
     * specification. If the value is an SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   920
     * the driver returns a Java <code>null</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   921
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   922
     * This method may also be used to read database-specific
90ce3da70b43 Initial load
duke
parents:
diff changeset
   923
     * abstract data types.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   924
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   925
     * In the JDBC 2.0 API, the behavior of the method
90ce3da70b43 Initial load
duke
parents:
diff changeset
   926
     * <code>getObject</code> is extended to materialize
90ce3da70b43 Initial load
duke
parents:
diff changeset
   927
     * data of SQL user-defined types.  When a column contains
90ce3da70b43 Initial load
duke
parents:
diff changeset
   928
     * a structured or distinct value, the behavior of this method is as
90ce3da70b43 Initial load
duke
parents:
diff changeset
   929
     * if it were a call to: <code>getObject(columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   930
     * this.getStatement().getConnection().getTypeMap())</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   931
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   932
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   933
     * @return a <code>java.lang.Object</code> holding the column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
   934
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   935
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   936
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   937
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   938
    Object getObject(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   939
90ce3da70b43 Initial load
duke
parents:
diff changeset
   940
    //----------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   941
90ce3da70b43 Initial load
duke
parents:
diff changeset
   942
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   943
     * Maps the given <code>ResultSet</code> column label to its
90ce3da70b43 Initial load
duke
parents:
diff changeset
   944
     * <code>ResultSet</code> column index.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   945
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   946
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   947
     * @return the column index of the given column name
90ce3da70b43 Initial load
duke
parents:
diff changeset
   948
     * @exception SQLException if the <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
   949
     * does not contain a column labeled <code>columnLabel</code>, a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
   950
     *  or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   951
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   952
    int findColumn(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   953
90ce3da70b43 Initial load
duke
parents:
diff changeset
   954
90ce3da70b43 Initial load
duke
parents:
diff changeset
   955
    //--------------------------JDBC 2.0-----------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   956
90ce3da70b43 Initial load
duke
parents:
diff changeset
   957
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   958
    // Getters and Setters
90ce3da70b43 Initial load
duke
parents:
diff changeset
   959
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   960
90ce3da70b43 Initial load
duke
parents:
diff changeset
   961
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   962
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   963
     * of this <code>ResultSet</code> object as a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   964
     * <code>java.io.Reader</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   965
     * @return a <code>java.io.Reader</code> object that contains the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   966
     * value; if the value is SQL <code>NULL</code>, the value returned is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   967
     * <code>null</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   968
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   969
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   970
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   971
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   972
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   973
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   974
    java.io.Reader getCharacterStream(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   975
90ce3da70b43 Initial load
duke
parents:
diff changeset
   976
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   977
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   978
     * of this <code>ResultSet</code> object as a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   979
     * <code>java.io.Reader</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   980
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   981
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   982
     * @return a <code>java.io.Reader</code> object that contains the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
   983
     * value; if the value is SQL <code>NULL</code>, the value returned is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   984
     * <code>null</code> in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
   985
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   986
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   987
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   988
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   989
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   990
    java.io.Reader getCharacterStream(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   991
90ce3da70b43 Initial load
duke
parents:
diff changeset
   992
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   993
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   994
     * of this <code>ResultSet</code> object as a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   995
     * <code>java.math.BigDecimal</code> with full precision.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   996
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   997
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
   998
     * @return the column value (full precision);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   999
     * if the value is SQL <code>NULL</code>, the value returned is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1000
     * <code>null</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1001
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1002
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1003
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1004
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1005
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1006
    BigDecimal getBigDecimal(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1007
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1008
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1009
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1010
     * of this <code>ResultSet</code> object as a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1011
     * <code>java.math.BigDecimal</code> with full precision.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1012
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1013
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1014
     * @return the column value (full precision);
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1015
     * if the value is SQL <code>NULL</code>, the value returned is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1016
     * <code>null</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1017
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1018
     * if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1019
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1020
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1021
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1022
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1023
    BigDecimal getBigDecimal(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1024
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1025
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1026
    // Traversal/Positioning
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1027
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1028
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1029
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1030
     * Retrieves whether the cursor is before the first row in
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1031
     * this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1032
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1033
     * <strong>Note:</strong>Support for the <code>isBeforeFirst</code> method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1034
     * is optional for <code>ResultSet</code>s with a result
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1035
     * set type of <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1036
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1037
     * @return <code>true</code> if the cursor is before the first row;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1038
     * <code>false</code> if the cursor is at any other position or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1039
     * result set contains no rows
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1040
     * @exception SQLException if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1041
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1042
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1043
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1044
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1045
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1046
    boolean isBeforeFirst() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1047
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1048
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1049
     * Retrieves whether the cursor is after the last row in
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1050
     * this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1051
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1052
     * <strong>Note:</strong>Support for the <code>isAfterLast</code> method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1053
     * is optional for <code>ResultSet</code>s with a result
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1054
     * set type of <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1055
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1056
     * @return <code>true</code> if the cursor is after the last row;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1057
     * <code>false</code> if the cursor is at any other position or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1058
     * result set contains no rows
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1059
     * @exception SQLException if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1060
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1061
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1062
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1063
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1064
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1065
    boolean isAfterLast() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1066
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1067
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1068
     * Retrieves whether the cursor is on the first row of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1069
     * this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1070
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1071
     * <strong>Note:</strong>Support for the <code>isFirst</code> method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1072
     * is optional for <code>ResultSet</code>s with a result
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1073
     * set type of <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1074
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1075
     * @return <code>true</code> if the cursor is on the first row;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1076
     * <code>false</code> otherwise
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1077
     * @exception SQLException if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1078
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1079
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1080
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1081
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1082
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1083
    boolean isFirst() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1084
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1085
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1086
     * Retrieves whether the cursor is on the last row of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1087
     * this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1088
     *  <strong>Note:</strong> Calling the method <code>isLast</code> may be expensive
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1089
     * because the JDBC driver
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1090
     * might need to fetch ahead one row in order to determine
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1091
     * whether the current row is the last row in the result set.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1092
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1093
     * <strong>Note:</strong> Support for the <code>isLast</code> method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1094
     * is optional for <code>ResultSet</code>s with a result
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1095
     * set type of <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1096
     * @return <code>true</code> if the cursor is on the last row;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1097
     * <code>false</code> otherwise
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1098
     * @exception SQLException if a database access error occurs or this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1099
     *            called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1100
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1101
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1102
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1103
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1104
    boolean isLast() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1105
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1106
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1107
     * Moves the cursor to the front of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1108
     * this <code>ResultSet</code> object, just before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1109
     * first row. This method has no effect if the result set contains no rows.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1110
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1111
     * @exception SQLException if a database access error
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1112
     * occurs; this method is called on a closed result set or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1113
     * result set type is <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1114
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1115
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1116
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1117
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1118
    void beforeFirst() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1119
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1120
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1121
     * Moves the cursor to the end of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1122
     * this <code>ResultSet</code> object, just after the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1123
     * last row. This method has no effect if the result set contains no rows.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1124
     * @exception SQLException if a database access error
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1125
     * occurs; this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1126
     * or the result set type is <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1127
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1128
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1129
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1130
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1131
    void afterLast() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1132
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1133
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1134
     * Moves the cursor to the first row in
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1135
     * this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1136
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1137
     * @return <code>true</code> if the cursor is on a valid row;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1138
     * <code>false</code> if there are no rows in the result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1139
     * @exception SQLException if a database access error
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1140
     * occurs; this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1141
     * or the result set type is <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1142
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1143
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1144
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1145
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1146
    boolean first() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1147
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1148
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1149
     * Moves the cursor to the last row in
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1150
     * this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1151
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1152
     * @return <code>true</code> if the cursor is on a valid row;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1153
     * <code>false</code> if there are no rows in the result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1154
     * @exception SQLException if a database access error
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1155
     * occurs; this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1156
     * or the result set type is <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1157
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1158
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1159
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1160
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1161
    boolean last() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1162
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1163
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1164
     * Retrieves the current row number.  The first row is number 1, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1165
     * second number 2, and so on.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1166
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1167
     * <strong>Note:</strong>Support for the <code>getRow</code> method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1168
     * is optional for <code>ResultSet</code>s with a result
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1169
     * set type of <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1170
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1171
     * @return the current row number; <code>0</code> if there is no current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1172
     * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1173
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1174
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1175
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1176
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1177
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1178
    int getRow() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1179
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1180
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1181
     * Moves the cursor to the given row number in
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1182
     * this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1183
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1184
     * <p>If the row number is positive, the cursor moves to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1185
     * the given row number with respect to the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1186
     * beginning of the result set.  The first row is row 1, the second
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1187
     * is row 2, and so on.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1188
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1189
     * <p>If the given row number is negative, the cursor moves to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1190
     * an absolute row position with respect to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1191
     * the end of the result set.  For example, calling the method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1192
     * <code>absolute(-1)</code> positions the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1193
     * cursor on the last row; calling the method <code>absolute(-2)</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1194
     * moves the cursor to the next-to-last row, and so on.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1195
     *
6540
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  1196
     * <p>If the row number specified is zero, the cursor is moved to
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  1197
     * before the first row.
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  1198
     *
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1199
     * <p>An attempt to position the cursor beyond the first/last row in
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1200
     * the result set leaves the cursor before the first row or after
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1201
     * the last row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1202
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1203
     * <p><B>Note:</B> Calling <code>absolute(1)</code> is the same
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1204
     * as calling <code>first()</code>. Calling <code>absolute(-1)</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1205
     * is the same as calling <code>last()</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1206
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1207
     * @param row the number of the row to which the cursor should move.
6540
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  1208
     *        A value of zero indicates that the cursor will be positioned
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  1209
     *        before the first row; a positive number indicates the row number
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  1210
     *        counting from the beginning of the result set; a negative number
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  1211
     *        indicates the row number counting from the end of the result set
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1212
     * @return <code>true</code> if the cursor is moved to a position in this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1213
     * <code>ResultSet</code> object;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1214
     * <code>false</code> if the cursor is before the first row or after the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1215
     * last row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1216
     * @exception SQLException if a database access error
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1217
     * occurs; this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1218
     * or the result set type is <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1219
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1220
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1221
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1222
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1223
    boolean absolute( int row ) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1224
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1225
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1226
     * Moves the cursor a relative number of rows, either positive or negative.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1227
     * Attempting to move beyond the first/last row in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1228
     * result set positions the cursor before/after the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1229
     * the first/last row. Calling <code>relative(0)</code> is valid, but does
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1230
     * not change the cursor position.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1231
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1232
     * <p>Note: Calling the method <code>relative(1)</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1233
     * is identical to calling the method <code>next()</code> and
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1234
     * calling the method <code>relative(-1)</code> is identical
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1235
     * to calling the method <code>previous()</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1236
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1237
     * @param rows an <code>int</code> specifying the number of rows to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1238
     *        move from the current row; a positive number moves the cursor
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1239
     *        forward; a negative number moves the cursor backward
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1240
     * @return <code>true</code> if the cursor is on a row;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1241
     *         <code>false</code> otherwise
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1242
     * @exception SQLException if a database access error occurs;  this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1243
     * is called on a closed result set or the result set type is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1244
     *            <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1245
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1246
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1247
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1248
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1249
    boolean relative( int rows ) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1250
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1251
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1252
     * Moves the cursor to the previous row in this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1253
     * <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1254
     *<p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1255
     * When a call to the <code>previous</code> method returns <code>false</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1256
     * the cursor is positioned before the first row.  Any invocation of a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1257
     * <code>ResultSet</code> method which requires a current row will result in a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1258
     * <code>SQLException</code> being thrown.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1259
     *<p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1260
     * If an input stream is open for the current row, a call to the method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1261
     * <code>previous</code> will implicitly close it.  A <code>ResultSet</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1262
     *  object's warning change is cleared when a new row is read.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1263
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1264
     * @return <code>true</code> if the cursor is now positioned on a valid row;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1265
     * <code>false</code> if the cursor is positioned before the first row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1266
     * @exception SQLException if a database access error
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1267
     * occurs; this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1268
     * or the result set type is <code>TYPE_FORWARD_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1269
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1270
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1271
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1272
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1273
    boolean previous() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1274
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1275
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1276
    // Properties
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1277
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1278
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1279
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1280
     * The constant indicating that the rows in a result set will be
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1281
     * processed in a forward direction; first-to-last.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1282
     * This constant is used by the method <code>setFetchDirection</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1283
     * as a hint to the driver, which the driver may ignore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1284
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1285
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1286
    int FETCH_FORWARD = 1000;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1287
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1288
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1289
     * The constant indicating that the rows in a result set will be
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1290
     * processed in a reverse direction; last-to-first.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1291
     * This constant is used by the method <code>setFetchDirection</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1292
     * as a hint to the driver, which the driver may ignore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1293
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1294
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1295
    int FETCH_REVERSE = 1001;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1296
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1297
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1298
     * The constant indicating that the order in which rows in a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1299
     * result set will be processed is unknown.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1300
     * This constant is used by the method <code>setFetchDirection</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1301
     * as a hint to the driver, which the driver may ignore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1302
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1303
    int FETCH_UNKNOWN = 1002;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1304
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1305
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1306
     * Gives a hint as to the direction in which the rows in this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1307
     * <code>ResultSet</code> object will be processed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1308
     * The initial value is determined by the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1309
     * <code>Statement</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1310
     * that produced this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1311
     * The fetch direction may be changed at any time.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1312
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1313
     * @param direction an <code>int</code> specifying the suggested
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1314
     *        fetch direction; one of <code>ResultSet.FETCH_FORWARD</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1315
     *        <code>ResultSet.FETCH_REVERSE</code>, or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1316
     *        <code>ResultSet.FETCH_UNKNOWN</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1317
     * @exception SQLException if a database access error occurs; this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1318
     * method is called on a closed result set or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1319
     * the result set type is <code>TYPE_FORWARD_ONLY</code> and the fetch
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1320
     * direction is not <code>FETCH_FORWARD</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1321
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1322
     * @see Statement#setFetchDirection
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1323
     * @see #getFetchDirection
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1324
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1325
    void setFetchDirection(int direction) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1326
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1327
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1328
     * Retrieves the fetch direction for this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1329
     * <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1330
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1331
     * @return the current fetch direction for this <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1332
     * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1333
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1334
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1335
     * @see #setFetchDirection
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1336
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1337
    int getFetchDirection() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1338
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1339
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1340
     * Gives the JDBC driver a hint as to the number of rows that should
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1341
     * be fetched from the database when more rows are needed for this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1342
     * <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1343
     * If the fetch size specified is zero, the JDBC driver
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1344
     * ignores the value and is free to make its own best guess as to what
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1345
     * the fetch size should be.  The default value is set by the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1346
     * <code>Statement</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1347
     * that created the result set.  The fetch size may be changed at any time.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1348
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1349
     * @param rows the number of rows to fetch
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1350
     * @exception SQLException if a database access error occurs; this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1351
     * is called on a closed result set or the
18156
edb590d448c5 8016217: More javadoc warnings
alanb
parents: 15278
diff changeset
  1352
     * condition {@code rows >= 0} is not satisfied
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1353
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1354
     * @see #getFetchSize
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1355
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1356
    void setFetchSize(int rows) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1357
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1358
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1359
     * Retrieves the fetch size for this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1360
     * <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1361
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1362
     * @return the current fetch size for this <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1363
     * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1364
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1365
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1366
     * @see #setFetchSize
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1367
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1368
    int getFetchSize() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1369
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1370
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1371
     * The constant indicating the type for a <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1372
     * whose cursor may move only forward.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1373
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1374
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1375
    int TYPE_FORWARD_ONLY = 1003;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1376
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1377
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1378
     * The constant indicating the type for a <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1379
     * that is scrollable but generally not sensitive to changes to the data
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1380
     * that underlies the <code>ResultSet</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1381
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1382
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1383
    int TYPE_SCROLL_INSENSITIVE = 1004;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1384
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1385
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1386
     * The constant indicating the type for a <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1387
     * that is scrollable and generally sensitive to changes to the data
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1388
     * that underlies the <code>ResultSet</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1389
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1390
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1391
    int TYPE_SCROLL_SENSITIVE = 1005;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1392
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1393
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1394
     * Retrieves the type of this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1395
     * The type is determined by the <code>Statement</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1396
     * that created the result set.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1397
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1398
     * @return <code>ResultSet.TYPE_FORWARD_ONLY</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1399
     *         <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1400
     *         or <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1401
     * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1402
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1403
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1404
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1405
    int getType() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1406
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1407
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1408
     * The constant indicating the concurrency mode for a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1409
     * <code>ResultSet</code> object that may NOT be updated.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1410
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1411
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1412
    int CONCUR_READ_ONLY = 1007;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1413
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1414
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1415
     * The constant indicating the concurrency mode for a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1416
     * <code>ResultSet</code> object that may be updated.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1417
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1418
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1419
    int CONCUR_UPDATABLE = 1008;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1420
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1421
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1422
     * Retrieves the concurrency mode of this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1423
     * The concurrency used is determined by the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1424
     * <code>Statement</code> object that created the result set.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1425
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1426
     * @return the concurrency type, either
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1427
     *         <code>ResultSet.CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1428
     *         or <code>ResultSet.CONCUR_UPDATABLE</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1429
     * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1430
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1431
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1432
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1433
    int getConcurrency() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1434
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1435
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1436
    // Updates
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1437
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1438
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1439
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1440
     * Retrieves whether the current row has been updated.  The value returned
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1441
     * depends on whether or not the result set can detect updates.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1442
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1443
     * <strong>Note:</strong> Support for the <code>rowUpdated</code> method is optional with a result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1444
     * concurrency of <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1445
     * @return <code>true</code> if the current row is detected to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1446
     * have been visibly updated by the owner or another; <code>false</code> otherwise
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1447
     * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1448
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1449
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1450
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1451
     * @see DatabaseMetaData#updatesAreDetected
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1452
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1453
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1454
    boolean rowUpdated() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1455
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1456
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1457
     * Retrieves whether the current row has had an insertion.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1458
     * The value returned depends on whether or not this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1459
     * <code>ResultSet</code> object can detect visible inserts.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1460
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1461
     * <strong>Note:</strong> Support for the <code>rowInserted</code> method is optional with a result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1462
     * concurrency of <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1463
     * @return <code>true</code> if the current row is detected to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1464
     * have been inserted; <code>false</code> otherwise
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1465
     * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1466
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1467
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1468
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1469
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1470
     * @see DatabaseMetaData#insertsAreDetected
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1471
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1472
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1473
    boolean rowInserted() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1474
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1475
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1476
     * Retrieves whether a row has been deleted.  A deleted row may leave
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1477
     * a visible "hole" in a result set.  This method can be used to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1478
     * detect holes in a result set.  The value returned depends on whether
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1479
     * or not this <code>ResultSet</code> object can detect deletions.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1480
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1481
     * <strong>Note:</strong> Support for the <code>rowDeleted</code> method is optional with a result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1482
     * concurrency of <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1483
     * @return <code>true</code> if the current row is detected to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1484
     * have been deleted by the owner or another; <code>false</code> otherwise
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1485
     * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1486
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1487
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1488
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1489
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1490
     * @see DatabaseMetaData#deletesAreDetected
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1491
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1492
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1493
    boolean rowDeleted() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1494
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1495
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1496
     * Updates the designated column with a <code>null</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1497
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1498
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1499
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1500
     * update the underlying database; instead the <code>updateRow</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1501
     * or <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1502
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1503
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1504
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1505
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1506
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1507
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1508
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1509
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1510
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1511
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1512
    void updateNull(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1513
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1514
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1515
     * Updates the designated column with a <code>boolean</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1516
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1517
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1518
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1519
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1520
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1521
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1522
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1523
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1524
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1525
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1526
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1527
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1528
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1529
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1530
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1531
    void updateBoolean(int columnIndex, boolean x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1532
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1533
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1534
     * Updates the designated column with a <code>byte</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1535
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1536
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1537
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1538
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1539
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1540
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1541
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1542
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1543
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1544
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1545
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1546
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1547
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1548
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1549
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1550
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1551
    void updateByte(int columnIndex, byte x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1552
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1553
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1554
     * Updates the designated column with a <code>short</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1555
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1556
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1557
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1558
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1559
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1560
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1561
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1562
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1563
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1564
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1565
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1566
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1567
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1568
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1569
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1570
    void updateShort(int columnIndex, short x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1571
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1572
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1573
     * Updates the designated column with an <code>int</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1574
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1575
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1576
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1577
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1578
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1579
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1580
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1581
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1582
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1583
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1584
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1585
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1586
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1587
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1588
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1589
    void updateInt(int columnIndex, int x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1590
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1591
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1592
     * Updates the designated column with a <code>long</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1593
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1594
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1595
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1596
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1597
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1598
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1599
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1600
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1601
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1602
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1603
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1604
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1605
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1606
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1607
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1608
    void updateLong(int columnIndex, long x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1609
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1610
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1611
     * Updates the designated column with a <code>float</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1612
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1613
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1614
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1615
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1616
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1617
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1618
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1619
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1620
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1621
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1622
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1623
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1624
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1625
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1626
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1627
    void updateFloat(int columnIndex, float x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1628
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1629
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1630
     * Updates the designated column with a <code>double</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1631
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1632
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1633
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1634
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1635
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1636
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1637
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1638
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1639
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1640
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1641
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1642
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1643
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1644
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1645
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1646
    void updateDouble(int columnIndex, double x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1647
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1648
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1649
     * Updates the designated column with a <code>java.math.BigDecimal</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1650
     * value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1651
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1652
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1653
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1654
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1655
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1656
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1657
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1658
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1659
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1660
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1661
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1662
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1663
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1664
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1665
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1666
    void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1667
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1668
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1669
     * Updates the designated column with a <code>String</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1670
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1671
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1672
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1673
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1674
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1675
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1676
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1677
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1678
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1679
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1680
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1681
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1682
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1683
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1684
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1685
    void updateString(int columnIndex, String x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1686
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1687
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1688
     * Updates the designated column with a <code>byte</code> array value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1689
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1690
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1691
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1692
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1693
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1694
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1695
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1696
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1697
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1698
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1699
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1700
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1701
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1702
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1703
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1704
    void updateBytes(int columnIndex, byte x[]) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1705
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1706
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1707
     * Updates the designated column with a <code>java.sql.Date</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1708
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1709
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1710
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1711
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1712
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1713
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1714
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1715
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1716
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1717
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1718
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1719
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1720
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1721
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1722
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1723
    void updateDate(int columnIndex, java.sql.Date x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1724
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1725
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1726
     * Updates the designated column with a <code>java.sql.Time</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1727
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1728
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1729
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1730
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1731
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1732
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1733
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1734
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1735
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1736
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1737
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1738
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1739
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1740
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1741
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1742
    void updateTime(int columnIndex, java.sql.Time x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1743
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1744
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1745
     * Updates the designated column with a <code>java.sql.Timestamp</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1746
     * value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1747
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1748
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1749
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1750
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1751
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1752
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1753
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1754
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1755
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1756
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1757
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1758
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1759
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1760
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1761
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1762
    void updateTimestamp(int columnIndex, java.sql.Timestamp x)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1763
      throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1764
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1765
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1766
     * Updates the designated column with an ascii stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1767
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1768
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1769
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1770
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1771
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1772
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1773
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1774
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1775
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1776
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1777
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1778
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1779
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1780
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1781
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1782
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1783
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1784
    void updateAsciiStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1785
                           java.io.InputStream x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1786
                           int length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1787
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1788
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1789
     * Updates the designated column with a binary stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1790
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1791
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1792
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1793
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1794
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1795
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1796
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1797
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1798
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1799
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1800
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1801
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1802
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1803
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1804
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1805
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1806
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1807
    void updateBinaryStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1808
                            java.io.InputStream x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1809
                            int length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1810
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1811
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1812
     * Updates the designated column with a character stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1813
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1814
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1815
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1816
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1817
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1818
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1819
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1820
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1821
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1822
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1823
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1824
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1825
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1826
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1827
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1828
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1829
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1830
    void updateCharacterStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1831
                             java.io.Reader x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1832
                             int length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1833
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1834
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1835
     * Updates the designated column with an <code>Object</code> value.
15278
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  1836
     *
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1837
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1838
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1839
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1840
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1841
     *<p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1842
     * If the second argument is an <code>InputStream</code> then the stream must contain
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1843
     * the number of bytes specified by scaleOrLength.  If the second argument is a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1844
     * <code>Reader</code> then the reader must contain the number of characters specified
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1845
     * by scaleOrLength. If these conditions are not true the driver will generate a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1846
     * <code>SQLException</code> when the statement is executed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1847
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1848
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1849
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1850
     * @param scaleOrLength for an object of <code>java.math.BigDecimal</code> ,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1851
     *          this is the number of digits after the decimal point. For
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1852
     *          Java Object types <code>InputStream</code> and <code>Reader</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1853
     *          this is the length
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1854
     *          of the data in the stream or reader.  For all other types,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1855
     *          this value will be ignored.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1856
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1857
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1858
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1859
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1860
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1861
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1862
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1863
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1864
    void updateObject(int columnIndex, Object x, int scaleOrLength)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1865
      throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1866
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1867
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1868
     * Updates the designated column with an <code>Object</code> value.
15278
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  1869
     *
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1870
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1871
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1872
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1873
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1874
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1875
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1876
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1877
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1878
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1879
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1880
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1881
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1882
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1883
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1884
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1885
    void updateObject(int columnIndex, Object x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1886
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1887
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1888
     * Updates the designated column with a <code>null</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1889
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1890
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1891
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1892
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1893
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1894
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1895
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1896
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1897
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1898
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1899
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1900
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1901
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1902
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1903
    void updateNull(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1904
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1905
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1906
     * Updates the designated column with a <code>boolean</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1907
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1908
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1909
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1910
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1911
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1912
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1913
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1914
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1915
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1916
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1917
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1918
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1919
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1920
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1921
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1922
    void updateBoolean(String columnLabel, boolean x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1923
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1924
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1925
     * Updates the designated column with a <code>byte</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1926
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1927
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1928
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1929
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1930
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1931
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1932
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1933
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1934
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1935
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1936
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1937
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1938
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1939
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1940
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1941
    void updateByte(String columnLabel, byte x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1942
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1943
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1944
     * Updates the designated column with a <code>short</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1945
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1946
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1947
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1948
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1949
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1950
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1951
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1952
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1953
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1954
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1955
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1956
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1957
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1958
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1959
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1960
    void updateShort(String columnLabel, short x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1961
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1962
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1963
     * Updates the designated column with an <code>int</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1964
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1965
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1966
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1967
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1968
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1969
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1970
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1971
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1972
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1973
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1974
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1975
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1976
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1977
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1978
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1979
    void updateInt(String columnLabel, int x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1980
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1981
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1982
     * Updates the designated column with a <code>long</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1983
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1984
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1985
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1986
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1987
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1988
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1989
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1990
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1991
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1992
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1993
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1994
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1995
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1996
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1997
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1998
    void updateLong(String columnLabel, long x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1999
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2000
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2001
     * Updates the designated column with a <code>float </code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2002
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2003
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2004
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2005
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2006
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2007
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2008
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2009
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2010
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2011
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2012
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2013
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2014
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2015
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2016
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2017
    void updateFloat(String columnLabel, float x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2018
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2019
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2020
     * Updates the designated column with a <code>double</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2021
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2022
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2023
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2024
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2025
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2026
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2027
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2028
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2029
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2030
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2031
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2032
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2033
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2034
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2035
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2036
    void updateDouble(String columnLabel, double x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2037
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2038
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2039
     * Updates the designated column with a <code>java.sql.BigDecimal</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2040
     * value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2041
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2042
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2043
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2044
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2045
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2046
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2047
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2048
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2049
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2050
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2051
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2052
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2053
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2054
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2055
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2056
    void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2057
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2058
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2059
     * Updates the designated column with a <code>String</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2060
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2061
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2062
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2063
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2064
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2065
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2066
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2067
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2068
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2069
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2070
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2071
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2072
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2073
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2074
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2075
    void updateString(String columnLabel, String x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2076
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2077
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2078
     * Updates the designated column with a byte array value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2079
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2080
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2081
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2082
     * update the underlying database; instead the <code>updateRow</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2083
     * or <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2084
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2085
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2086
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2087
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2088
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2089
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2090
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2091
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2092
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2093
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2094
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2095
    void updateBytes(String columnLabel, byte x[]) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2096
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2097
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2098
     * Updates the designated column with a <code>java.sql.Date</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2099
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2100
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2101
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2102
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2103
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2104
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2105
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2106
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2107
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2108
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2109
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2110
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2111
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2112
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2113
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2114
    void updateDate(String columnLabel, java.sql.Date x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2115
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2116
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2117
     * Updates the designated column with a <code>java.sql.Time</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2118
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2119
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2120
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2121
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2122
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2123
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2124
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2125
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2126
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2127
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2128
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2129
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2130
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2131
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2132
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2133
    void updateTime(String columnLabel, java.sql.Time x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2134
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2135
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2136
     * Updates the designated column with a <code>java.sql.Timestamp</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2137
     * value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2138
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2139
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2140
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2141
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2142
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2143
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2144
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2145
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2146
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2147
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2148
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2149
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2150
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2151
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2152
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2153
    void updateTimestamp(String columnLabel, java.sql.Timestamp x)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2154
      throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2155
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2156
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2157
     * Updates the designated column with an ascii stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2158
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2159
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2160
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2161
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2162
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2163
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2164
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2165
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2166
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2167
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2168
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2169
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2170
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2171
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2172
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2173
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2174
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2175
    void updateAsciiStream(String columnLabel,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2176
                           java.io.InputStream x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2177
                           int length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2178
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2179
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2180
     * Updates the designated column with a binary stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2181
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2182
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2183
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2184
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2185
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2186
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2187
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2188
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2189
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2190
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2191
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2192
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2193
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2194
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2195
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2196
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2197
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2198
    void updateBinaryStream(String columnLabel,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2199
                            java.io.InputStream x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2200
                            int length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2201
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2202
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2203
     * Updates the designated column with a character stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2204
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2205
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2206
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2207
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2208
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2209
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2210
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2211
     * @param reader the <code>java.io.Reader</code> object containing
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2212
     *        the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2213
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2214
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2215
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2216
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2217
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2218
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2219
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2220
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2221
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2222
    void updateCharacterStream(String columnLabel,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2223
                             java.io.Reader reader,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2224
                             int length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2225
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2226
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2227
     * Updates the designated column with an <code>Object</code> value.
15278
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  2228
     *
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2229
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2230
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2231
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2232
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2233
     *<p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2234
     * If the second argument is an <code>InputStream</code> then the stream must contain
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2235
     * the number of bytes specified by scaleOrLength.  If the second argument is a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2236
     * <code>Reader</code> then the reader must contain the number of characters specified
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2237
     * by scaleOrLength. If these conditions are not true the driver will generate a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2238
     * <code>SQLException</code> when the statement is executed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2239
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2240
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2241
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2242
     * @param scaleOrLength for an object of <code>java.math.BigDecimal</code> ,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2243
     *          this is the number of digits after the decimal point. For
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2244
     *          Java Object types <code>InputStream</code> and <code>Reader</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2245
     *          this is the length
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2246
     *          of the data in the stream or reader.  For all other types,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2247
     *          this value will be ignored.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2248
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2249
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2250
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2251
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2252
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2253
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2254
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2255
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2256
    void updateObject(String columnLabel, Object x, int scaleOrLength)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2257
      throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2258
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2259
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2260
     * Updates the designated column with an <code>Object</code> value.
15278
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  2261
     *
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2262
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2263
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2264
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2265
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2266
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2267
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2268
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2269
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2270
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2271
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2272
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2273
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2274
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2275
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2276
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2277
    void updateObject(String columnLabel, Object x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2278
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2279
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2280
     * Inserts the contents of the insert row into this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2281
     * <code>ResultSet</code> object and into the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2282
     * The cursor must be on the insert row when this method is called.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2283
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2284
     * @exception SQLException if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2285
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2286
     * this method is called on a closed result set,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2287
     * if this method is called when the cursor is not on the insert row,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2288
     * or if not all of non-nullable columns in
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2289
     * the insert row have been given a non-null value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2290
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2291
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2292
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2293
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2294
    void insertRow() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2295
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2296
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2297
     * Updates the underlying database with the new contents of the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2298
     * current row of this <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2299
     * This method cannot be called when the cursor is on the insert row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2300
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2301
     * @exception SQLException if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2302
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2303
     *  this method is called on a closed result set or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2304
     * if this method is called when the cursor is on the insert row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2305
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2306
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2307
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2308
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2309
    void updateRow() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2310
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2311
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2312
     * Deletes the current row from this <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2313
     * and from the underlying database.  This method cannot be called when
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2314
     * the cursor is on the insert row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2315
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2316
     * @exception SQLException if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2317
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2318
     * this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2319
     * or if this method is called when the cursor is on the insert row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2320
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2321
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2322
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2323
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2324
    void deleteRow() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2325
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2326
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2327
     * Refreshes the current row with its most recent value in
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2328
     * the database.  This method cannot be called when
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2329
     * the cursor is on the insert row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2330
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2331
     * <P>The <code>refreshRow</code> method provides a way for an
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2332
     * application to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2333
     * explicitly tell the JDBC driver to refetch a row(s) from the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2334
     * database.  An application may want to call <code>refreshRow</code> when
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2335
     * caching or prefetching is being done by the JDBC driver to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2336
     * fetch the latest value of a row from the database.  The JDBC driver
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2337
     * may actually refresh multiple rows at once if the fetch size is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2338
     * greater than one.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2339
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2340
     * <P> All values are refetched subject to the transaction isolation
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2341
     * level and cursor sensitivity.  If <code>refreshRow</code> is called after
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2342
     * calling an updater method, but before calling
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2343
     * the method <code>updateRow</code>, then the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2344
     * updates made to the row are lost.  Calling the method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2345
     * <code>refreshRow</code> frequently will likely slow performance.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2346
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2347
     * @exception SQLException if a database access error
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2348
     * occurs; this method is called on a closed result set;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2349
     * the result set type is <code>TYPE_FORWARD_ONLY</code> or if this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2350
     * method is called when the cursor is on the insert row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2351
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2352
     * this method or this method is not supported for the specified result
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2353
     * set type and result set concurrency.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2354
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2355
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2356
    void refreshRow() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2357
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2358
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2359
     * Cancels the updates made to the current row in this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2360
     * <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2361
     * This method may be called after calling an
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2362
     * updater method(s) and before calling
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2363
     * the method <code>updateRow</code> to roll back
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2364
     * the updates made to a row.  If no updates have been made or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2365
     * <code>updateRow</code> has already been called, this method has no
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2366
     * effect.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2367
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2368
     * @exception SQLException if a database access error
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2369
     *            occurs; this method is called on a closed result set;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2370
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2371
     * or if this method is called when the cursor is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2372
     *            on the insert row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2373
      * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2374
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2375
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2376
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2377
    void cancelRowUpdates() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2378
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2379
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2380
     * Moves the cursor to the insert row.  The current cursor position is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2381
     * remembered while the cursor is positioned on the insert row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2382
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2383
     * The insert row is a special row associated with an updatable
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2384
     * result set.  It is essentially a buffer where a new row may
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2385
     * be constructed by calling the updater methods prior to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2386
     * inserting the row into the result set.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2387
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2388
     * Only the updater, getter,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2389
     * and <code>insertRow</code> methods may be
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2390
     * called when the cursor is on the insert row.  All of the columns in
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2391
     * a result set must be given a value each time this method is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2392
     * called before calling <code>insertRow</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2393
     * An updater method must be called before a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2394
     * getter method can be called on a column value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2395
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2396
     * @exception SQLException if a database access error occurs; this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2397
     * method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2398
     * or the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2399
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2400
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2401
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2402
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2403
    void moveToInsertRow() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2404
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2405
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2406
     * Moves the cursor to the remembered cursor position, usually the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2407
     * current row.  This method has no effect if the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2408
     * the insert row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2409
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2410
     * @exception SQLException if a database access error occurs; this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2411
     * method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2412
     *  or the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2413
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2414
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2415
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2416
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2417
    void moveToCurrentRow() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2418
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2419
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2420
     * Retrieves the <code>Statement</code> object that produced this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2421
     * <code>ResultSet</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2422
     * If the result set was generated some other way, such as by a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2423
     * <code>DatabaseMetaData</code> method, this method  may return
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2424
     * <code>null</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2425
     *
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 20880
diff changeset
  2426
     * @return the <code>Statement</code> object that produced
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2427
     * this <code>ResultSet</code> object or <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2428
     * if the result set was produced some other way
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2429
     * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2430
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2431
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2432
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2433
    Statement getStatement() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2434
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2435
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2436
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2437
     * of this <code>ResultSet</code> object as an <code>Object</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2438
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2439
     * If the value is an SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2440
     * the driver returns a Java <code>null</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2441
     * This method uses the given <code>Map</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2442
     * for the custom mapping of the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2443
     * SQL structured or distinct type that is being retrieved.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2444
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2445
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2446
     * @param map a <code>java.util.Map</code> object that contains the mapping
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2447
     * from SQL type names to classes in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2448
     * @return an <code>Object</code> in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2449
     * representing the SQL value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2450
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2451
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2452
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2453
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2454
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2455
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2456
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2457
    Object getObject(int columnIndex, java.util.Map<String,Class<?>> map)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2458
        throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2459
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2460
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2461
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2462
     * of this <code>ResultSet</code> object as a <code>Ref</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2463
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2464
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2465
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2466
     * @return a <code>Ref</code> object representing an SQL <code>REF</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2467
     *         value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2468
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2469
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2470
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2471
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2472
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2473
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2474
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2475
    Ref getRef(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2476
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2477
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2478
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2479
     * of this <code>ResultSet</code> object as a <code>Blob</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2480
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2481
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2482
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2483
     * @return a <code>Blob</code> object representing the SQL
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2484
     *         <code>BLOB</code> value in the specified column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2485
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2486
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2487
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2488
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2489
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2490
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2491
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2492
    Blob getBlob(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2493
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2494
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2495
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2496
     * of this <code>ResultSet</code> object as a <code>Clob</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2497
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2498
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2499
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2500
     * @return a <code>Clob</code> object representing the SQL
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2501
     *         <code>CLOB</code> value in the specified column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2502
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2503
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2504
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2505
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2506
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2507
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2508
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2509
    Clob getClob(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2510
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2511
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2512
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2513
     * of this <code>ResultSet</code> object as an <code>Array</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2514
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2515
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2516
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2517
     * @return an <code>Array</code> object representing the SQL
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2518
     *         <code>ARRAY</code> value in the specified column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2519
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2520
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2521
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2522
      * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2523
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2524
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2525
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2526
    Array getArray(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2527
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2528
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2529
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2530
     * of this <code>ResultSet</code> object as an <code>Object</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2531
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2532
     * If the value is an SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2533
     * the driver returns a Java <code>null</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2534
     * This method uses the specified <code>Map</code> object for
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2535
     * custom mapping if appropriate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2536
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2537
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2538
     * @param map a <code>java.util.Map</code> object that contains the mapping
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2539
     * from SQL type names to classes in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2540
     * @return an <code>Object</code> representing the SQL value in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2541
     *         specified column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2542
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2543
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2544
     * or this method is called on a closed result set
6540
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  2545
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2546
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2547
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2548
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2549
    Object getObject(String columnLabel, java.util.Map<String,Class<?>> map)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2550
      throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2551
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2552
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2553
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2554
     * of this <code>ResultSet</code> object as a <code>Ref</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2555
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2556
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2557
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2558
     * @return a <code>Ref</code> object representing the SQL <code>REF</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2559
     *         value in the specified column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2560
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2561
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2562
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2563
      * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2564
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2565
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2566
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2567
    Ref getRef(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2568
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2569
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2570
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2571
     * of this <code>ResultSet</code> object as a <code>Blob</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2572
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2573
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2574
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2575
     * @return a <code>Blob</code> object representing the SQL <code>BLOB</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2576
     *         value in the specified column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2577
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2578
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2579
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2580
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2581
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2582
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2583
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2584
    Blob getBlob(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2585
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2586
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2587
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2588
     * of this <code>ResultSet</code> object as a <code>Clob</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2589
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2590
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2591
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2592
     * @return a <code>Clob</code> object representing the SQL <code>CLOB</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2593
     * value in the specified column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2594
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2595
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2596
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2597
      * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2598
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2599
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2600
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2601
    Clob getClob(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2602
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2603
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2604
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2605
     * of this <code>ResultSet</code> object as an <code>Array</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2606
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2607
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2608
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2609
     * @return an <code>Array</code> object representing the SQL <code>ARRAY</code> value in
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2610
     *         the specified column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2611
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2612
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2613
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2614
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2615
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2616
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2617
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2618
    Array getArray(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2619
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2620
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2621
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2622
     * of this <code>ResultSet</code> object as a <code>java.sql.Date</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2623
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2624
     * This method uses the given calendar to construct an appropriate millisecond
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2625
     * value for the date if the underlying database does not store
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2626
     * timezone information.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2627
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2628
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2629
     * @param cal the <code>java.util.Calendar</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2630
     * to use in constructing the date
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2631
     * @return the column value as a <code>java.sql.Date</code> object;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2632
     * if the value is SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2633
     * the value returned is <code>null</code> in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2634
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2635
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2636
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2637
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2638
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2639
    java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2640
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2641
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2642
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2643
     * of this <code>ResultSet</code> object as a <code>java.sql.Date</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2644
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2645
     * This method uses the given calendar to construct an appropriate millisecond
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2646
     * value for the date if the underlying database does not store
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2647
     * timezone information.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2648
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2649
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2650
     * @param cal the <code>java.util.Calendar</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2651
     * to use in constructing the date
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2652
     * @return the column value as a <code>java.sql.Date</code> object;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2653
     * if the value is SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2654
     * the value returned is <code>null</code> in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2655
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2656
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2657
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2658
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2659
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2660
    java.sql.Date getDate(String columnLabel, Calendar cal) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2661
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2662
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2663
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2664
     * of this <code>ResultSet</code> object as a <code>java.sql.Time</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2665
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2666
     * This method uses the given calendar to construct an appropriate millisecond
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2667
     * value for the time if the underlying database does not store
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2668
     * timezone information.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2669
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2670
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2671
     * @param cal the <code>java.util.Calendar</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2672
     * to use in constructing the time
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2673
     * @return the column value as a <code>java.sql.Time</code> object;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2674
     * if the value is SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2675
     * the value returned is <code>null</code> in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2676
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2677
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2678
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2679
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2680
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2681
    java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2682
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2683
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2684
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2685
     * of this <code>ResultSet</code> object as a <code>java.sql.Time</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2686
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2687
     * This method uses the given calendar to construct an appropriate millisecond
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2688
     * value for the time if the underlying database does not store
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2689
     * timezone information.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2690
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2691
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2692
     * @param cal the <code>java.util.Calendar</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2693
     * to use in constructing the time
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2694
     * @return the column value as a <code>java.sql.Time</code> object;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2695
     * if the value is SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2696
     * the value returned is <code>null</code> in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2697
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2698
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2699
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2700
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2701
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2702
    java.sql.Time getTime(String columnLabel, Calendar cal) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2703
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2704
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2705
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2706
     * of this <code>ResultSet</code> object as a <code>java.sql.Timestamp</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2707
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2708
     * This method uses the given calendar to construct an appropriate millisecond
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2709
     * value for the timestamp if the underlying database does not store
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2710
     * timezone information.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2711
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2712
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2713
     * @param cal the <code>java.util.Calendar</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2714
     * to use in constructing the timestamp
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2715
     * @return the column value as a <code>java.sql.Timestamp</code> object;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2716
     * if the value is SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2717
     * the value returned is <code>null</code> in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2718
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2719
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2720
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2721
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2722
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2723
    java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2724
      throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2725
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2726
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2727
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2728
     * of this <code>ResultSet</code> object as a <code>java.sql.Timestamp</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2729
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2730
     * This method uses the given calendar to construct an appropriate millisecond
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2731
     * value for the timestamp if the underlying database does not store
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2732
     * timezone information.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2733
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2734
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2735
     * @param cal the <code>java.util.Calendar</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2736
     * to use in constructing the date
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2737
     * @return the column value as a <code>java.sql.Timestamp</code> object;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2738
     * if the value is SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2739
     * the value returned is <code>null</code> in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2740
     * @exception SQLException if the columnLabel is not valid or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2741
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2742
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2743
     * @since 1.2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2744
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2745
    java.sql.Timestamp getTimestamp(String columnLabel, Calendar cal)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2746
      throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2747
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2748
    //-------------------------- JDBC 3.0 ----------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2749
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2750
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2751
     * The constant indicating that open <code>ResultSet</code> objects with this
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 20880
diff changeset
  2752
     * holdability will remain open when the current transaction is committed.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2753
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2754
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2755
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2756
    int HOLD_CURSORS_OVER_COMMIT = 1;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2757
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2758
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2759
     * The constant indicating that open <code>ResultSet</code> objects with this
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 20880
diff changeset
  2760
     * holdability will be closed when the current transaction is committed.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2761
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2762
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2763
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2764
    int CLOSE_CURSORS_AT_COMMIT = 2;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2765
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2766
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2767
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2768
     * of this <code>ResultSet</code> object as a <code>java.net.URL</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2769
     * object in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2770
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2771
     * @param columnIndex the index of the column 1 is the first, 2 is the second,...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2772
     * @return the column value as a <code>java.net.URL</code> object;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2773
     * if the value is SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2774
     * the value returned is <code>null</code> in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2775
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2776
     * if a database access error occurs; this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2777
     * is called on a closed result set or if a URL is malformed
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2778
      * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2779
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2780
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2781
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2782
    java.net.URL getURL(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2783
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2784
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2785
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2786
     * of this <code>ResultSet</code> object as a <code>java.net.URL</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2787
     * object in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2788
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2789
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2790
     * @return the column value as a <code>java.net.URL</code> object;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2791
     * if the value is SQL <code>NULL</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2792
     * the value returned is <code>null</code> in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2793
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2794
     * if a database access error occurs; this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2795
     * is called on a closed result set or if a URL is malformed
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2796
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2797
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2798
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2799
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2800
    java.net.URL getURL(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2801
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2802
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2803
     * Updates the designated column with a <code>java.sql.Ref</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2804
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2805
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2806
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2807
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2808
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2809
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2810
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2811
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2812
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2813
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2814
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2815
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2816
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2817
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2818
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2819
    void updateRef(int columnIndex, java.sql.Ref x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2820
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2821
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2822
     * Updates the designated column with a <code>java.sql.Ref</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2823
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2824
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2825
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2826
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2827
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2828
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2829
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2830
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2831
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2832
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2833
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2834
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2835
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2836
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2837
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2838
    void updateRef(String columnLabel, java.sql.Ref x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2839
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2840
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2841
     * Updates the designated column with a <code>java.sql.Blob</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2842
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2843
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2844
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2845
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2846
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2847
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2848
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2849
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2850
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2851
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2852
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2853
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2854
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2855
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2856
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2857
    void updateBlob(int columnIndex, java.sql.Blob x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2858
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2859
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2860
     * Updates the designated column with a <code>java.sql.Blob</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2861
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2862
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2863
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2864
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2865
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2866
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2867
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2868
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2869
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2870
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2871
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2872
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2873
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2874
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2875
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2876
    void updateBlob(String columnLabel, java.sql.Blob x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2877
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2878
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2879
     * Updates the designated column with a <code>java.sql.Clob</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2880
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2881
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2882
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2883
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2884
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2885
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2886
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2887
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2888
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2889
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2890
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2891
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2892
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2893
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2894
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2895
    void updateClob(int columnIndex, java.sql.Clob x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2896
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2897
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2898
     * Updates the designated column with a <code>java.sql.Clob</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2899
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2900
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2901
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2902
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2903
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2904
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2905
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2906
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2907
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2908
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2909
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2910
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2911
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2912
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2913
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2914
    void updateClob(String columnLabel, java.sql.Clob x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2915
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2916
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2917
     * Updates the designated column with a <code>java.sql.Array</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2918
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2919
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2920
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2921
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2922
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2923
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2924
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2925
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2926
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2927
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2928
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2929
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2930
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2931
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2932
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2933
    void updateArray(int columnIndex, java.sql.Array x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2934
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2935
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2936
     * Updates the designated column with a <code>java.sql.Array</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2937
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2938
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2939
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2940
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2941
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2942
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2943
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2944
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2945
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2946
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2947
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2948
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2949
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2950
     * @since 1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2951
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2952
    void updateArray(String columnLabel, java.sql.Array x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2953
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2954
    //------------------------- JDBC 4.0 -----------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2955
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2956
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2957
     * Retrieves the value of the designated column in the current row of this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2958
     * <code>ResultSet</code> object as a <code>java.sql.RowId</code> object in the Java
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2959
     * programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2960
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2961
     * @param columnIndex the first column is 1, the second 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2962
     * @return the column value; if the value is a SQL <code>NULL</code> the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2963
     *     value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2964
     * @throws SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2965
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2966
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2967
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2968
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2969
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2970
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2971
    RowId getRowId(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2972
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2973
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2974
     * Retrieves the value of the designated column in the current row of this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2975
     * <code>ResultSet</code> object as a <code>java.sql.RowId</code> object in the Java
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2976
     * programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2977
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2978
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2979
     * @return the column value ; if the value is a SQL <code>NULL</code> the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2980
     *     value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2981
     * @throws SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2982
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2983
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2984
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2985
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2986
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2987
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2988
    RowId getRowId(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2989
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2990
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2991
     * Updates the designated column with a <code>RowId</code> value. The updater
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2992
     * methods are used to update column values in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2993
     * row. The updater methods do not update the underlying database; instead
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2994
     * the <code>updateRow</code> or <code>insertRow</code> methods are called
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2995
     * to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2996
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2997
     * @param columnIndex the first column is 1, the second 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2998
     * @param x the column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2999
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3000
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3001
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3002
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3003
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3004
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3005
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3006
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3007
    void updateRowId(int columnIndex, RowId x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3008
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3009
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3010
     * Updates the designated column with a <code>RowId</code> value. The updater
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3011
     * methods are used to update column values in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3012
     * row. The updater methods do not update the underlying database; instead
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3013
     * the <code>updateRow</code> or <code>insertRow</code> methods are called
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3014
     * to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3015
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3016
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3017
     * @param x the column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3018
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3019
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3020
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3021
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3022
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3023
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3024
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3025
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3026
    void updateRowId(String columnLabel, RowId x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3027
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3028
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3029
     * Retrieves the holdability of this <code>ResultSet</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3030
     * @return  either <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code> or <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3031
     * @throws SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3032
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3033
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3034
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3035
    int getHoldability() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3036
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3037
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3038
     * Retrieves whether this <code>ResultSet</code> object has been closed. A <code>ResultSet</code> is closed if the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3039
     * method close has been called on it, or if it is automatically closed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3040
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3041
     * @return true if this <code>ResultSet</code> object is closed; false if it is still open
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3042
     * @throws SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3043
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3044
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3045
    boolean isClosed() throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3046
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3047
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3048
     * Updates the designated column with a <code>String</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3049
     * It is intended for use when updating <code>NCHAR</code>,<code>NVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3050
     * and <code>LONGNVARCHAR</code> columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3051
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3052
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3053
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3054
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3055
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3056
     * @param columnIndex the first column is 1, the second 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3057
     * @param nString the value for the column to be updated
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3058
     * @throws SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3059
     * if the driver does not support national
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3060
     *         character sets;  if the driver can detect that a data conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3061
     *  error could occur; this method is called on a closed result set;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3062
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3063
     * or if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3064
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3065
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3066
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3067
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3068
    void updateNString(int columnIndex, String nString) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3069
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3070
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3071
     * Updates the designated column with a <code>String</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3072
     * It is intended for use when updating <code>NCHAR</code>,<code>NVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3073
     * and <code>LONGNVARCHAR</code> columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3074
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3075
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3076
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3077
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3078
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3079
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3080
     * @param nString the value for the column to be updated
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3081
     * @throws SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3082
     * if the driver does not support national
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3083
     *         character sets;  if the driver can detect that a data conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3084
     *  error could occur; this method is called on a closed result set;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3085
     * the result set concurrency is <CODE>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3086
     *  or if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3087
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3088
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3089
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3090
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3091
    void updateNString(String columnLabel, String nString) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3092
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3093
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3094
     * Updates the designated column with a <code>java.sql.NClob</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3095
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3096
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3097
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3098
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3099
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3100
     * @param columnIndex the first column is 1, the second 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3101
     * @param nClob the value for the column to be updated
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3102
     * @throws SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3103
     * if the driver does not support national
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3104
     *         character sets;  if the driver can detect that a data conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3105
     *  error could occur; this method is called on a closed result set;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3106
     * if a database access error occurs or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3107
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3108
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3109
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3110
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3111
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3112
    void updateNClob(int columnIndex, NClob nClob) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3113
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3114
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3115
     * Updates the designated column with a <code>java.sql.NClob</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3116
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3117
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3118
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3119
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3120
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3121
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3122
     * @param nClob the value for the column to be updated
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3123
     * @throws SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3124
     * if the driver does not support national
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3125
     *         character sets;  if the driver can detect that a data conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3126
     *  error could occur; this method is called on a closed result set;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3127
     *  if a database access error occurs or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3128
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3129
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3130
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3131
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3132
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3133
    void updateNClob(String columnLabel, NClob nClob) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3134
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3135
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3136
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3137
     * of this <code>ResultSet</code> object as a <code>NClob</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3138
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3139
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3140
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3141
     * @return a <code>NClob</code> object representing the SQL
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3142
     *         <code>NCLOB</code> value in the specified column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3143
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3144
     * if the driver does not support national
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3145
     *         character sets;  if the driver can detect that a data conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3146
     *  error could occur; this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3147
     * or if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3148
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3149
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3150
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3151
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3152
    NClob getNClob(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3153
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3154
  /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3155
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3156
     * of this <code>ResultSet</code> object as a <code>NClob</code> object
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3157
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3158
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3159
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3160
     * @return a <code>NClob</code> object representing the SQL <code>NCLOB</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3161
     * value in the specified column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3162
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3163
   * if the driver does not support national
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3164
     *         character sets;  if the driver can detect that a data conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3165
     *  error could occur; this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3166
     * or if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3167
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3168
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3169
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3170
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3171
    NClob getNClob(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3172
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3173
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3174
     * Retrieves the value of the designated column in  the current row of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3175
     *  this <code>ResultSet</code> as a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3176
     * <code>java.sql.SQLXML</code> object in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3177
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3178
     * @return a <code>SQLXML</code> object that maps an <code>SQL XML</code> value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3179
     * @throws SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3180
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3181
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3182
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3183
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3184
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3185
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3186
    SQLXML getSQLXML(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3187
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3188
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3189
     * Retrieves the value of the designated column in  the current row of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3190
     *  this <code>ResultSet</code> as a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3191
     * <code>java.sql.SQLXML</code> object in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3192
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3193
     * @return a <code>SQLXML</code> object that maps an <code>SQL XML</code> value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3194
     * @throws SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3195
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3196
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3197
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3198
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3199
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3200
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3201
    SQLXML getSQLXML(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3202
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3203
     * Updates the designated column with a <code>java.sql.SQLXML</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3204
     * The updater
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3205
     * methods are used to update column values in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3206
     * row. The updater methods do not update the underlying database; instead
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3207
     * the <code>updateRow</code> or <code>insertRow</code> methods are called
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3208
     * to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3209
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3210
     * @param columnIndex the first column is 1, the second 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3211
     * @param xmlObject the value for the column to be updated
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3212
     * @throws SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3213
     * if a database access error occurs; this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3214
     *  is called on a closed result set;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3215
     * the <code>java.xml.transform.Result</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3216
     *  <code>Writer</code> or <code>OutputStream</code> has not been closed
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3217
     * for the <code>SQLXML</code> object;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3218
     *  if there is an error processing the XML value or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3219
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>.  The <code>getCause</code> method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3220
     *  of the exception may provide a more detailed exception, for example, if the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3221
     *  stream does not contain valid XML.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3222
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3223
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3224
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3225
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3226
    void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3227
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3228
     * Updates the designated column with a <code>java.sql.SQLXML</code> value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3229
     * The updater
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3230
     * methods are used to update column values in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3231
     * row. The updater methods do not update the underlying database; instead
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3232
     * the <code>updateRow</code> or <code>insertRow</code> methods are called
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3233
     * to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3234
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3235
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3236
     * @param xmlObject the column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3237
     * @throws SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3238
     * if a database access error occurs; this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3239
     *  is called on a closed result set;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3240
     * the <code>java.xml.transform.Result</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3241
     *  <code>Writer</code> or <code>OutputStream</code> has not been closed
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3242
     * for the <code>SQLXML</code> object;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3243
     *  if there is an error processing the XML value or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3244
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>.  The <code>getCause</code> method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3245
     *  of the exception may provide a more detailed exception, for example, if the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3246
     *  stream does not contain valid XML.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3247
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3248
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3249
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3250
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3251
    void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3252
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3253
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3254
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3255
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3256
     * a <code>String</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3257
     * It is intended for use when
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3258
     * accessing  <code>NCHAR</code>,<code>NVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3259
     * and <code>LONGNVARCHAR</code> columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3260
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3261
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3262
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3263
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3264
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3265
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3266
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3267
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3268
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3269
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3270
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3271
    String getNString(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3272
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3273
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3274
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3275
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3276
     * of this <code>ResultSet</code> object as
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3277
     * a <code>String</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3278
     * It is intended for use when
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3279
     * accessing  <code>NCHAR</code>,<code>NVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3280
     * and <code>LONGNVARCHAR</code> columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3281
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3282
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3283
     * @return the column value; if the value is SQL <code>NULL</code>, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3284
     * value returned is <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3285
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3286
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3287
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3288
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3289
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3290
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3291
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3292
    String getNString(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3293
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3294
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3295
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3296
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3297
     * of this <code>ResultSet</code> object as a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3298
     * <code>java.io.Reader</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3299
     * It is intended for use when
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3300
     * accessing  <code>NCHAR</code>,<code>NVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3301
     * and <code>LONGNVARCHAR</code> columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3302
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3303
     * @return a <code>java.io.Reader</code> object that contains the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3304
     * value; if the value is SQL <code>NULL</code>, the value returned is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3305
     * <code>null</code> in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3306
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3307
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3308
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3309
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3310
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3311
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3312
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3313
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3314
    java.io.Reader getNCharacterStream(int columnIndex) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3315
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3316
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3317
     * Retrieves the value of the designated column in the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3318
     * of this <code>ResultSet</code> object as a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3319
     * <code>java.io.Reader</code> object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3320
     * It is intended for use when
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3321
     * accessing  <code>NCHAR</code>,<code>NVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3322
     * and <code>LONGNVARCHAR</code> columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3323
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3324
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3325
     * @return a <code>java.io.Reader</code> object that contains the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3326
     * value; if the value is SQL <code>NULL</code>, the value returned is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3327
     * <code>null</code> in the Java programming language
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3328
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3329
     * if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3330
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3331
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3332
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3333
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3334
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3335
    java.io.Reader getNCharacterStream(String columnLabel) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3336
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3337
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3338
     * Updates the designated column with a character stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3339
     * the specified number of bytes.   The
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3340
     * driver does the necessary conversion from Java character format to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3341
     * the national character set in the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3342
     * It is intended for use when
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3343
     * updating  <code>NCHAR</code>,<code>NVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3344
     * and <code>LONGNVARCHAR</code> columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3345
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3346
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3347
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3348
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3349
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3350
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3351
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3352
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3353
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3354
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3355
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3356
     * the result set concurrency is <code>CONCUR_READ_ONLY</code> or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3357
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3358
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3359
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3360
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3361
    void updateNCharacterStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3362
                             java.io.Reader x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3363
                             long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3364
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3365
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3366
     * Updates the designated column with a character stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3367
     * the specified number of bytes.  The
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3368
     * driver does the necessary conversion from Java character format to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3369
     * the national character set in the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3370
     * It is intended for use when
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3371
     * updating  <code>NCHAR</code>,<code>NVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3372
     * and <code>LONGNVARCHAR</code> columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3373
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3374
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3375
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3376
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3377
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3378
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3379
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3380
     * @param reader the <code>java.io.Reader</code> object containing
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3381
     *        the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3382
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3383
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3384
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3385
     * the result set concurrency is <code>CONCUR_READ_ONLY</code> or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3386
      * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3387
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3388
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3389
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3390
    void updateNCharacterStream(String columnLabel,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3391
                             java.io.Reader reader,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3392
                             long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3393
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3394
     * Updates the designated column with an ascii stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3395
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3396
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3397
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3398
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3399
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3400
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3401
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3402
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3403
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3404
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3405
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3406
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3407
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3408
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3409
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3410
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3411
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3412
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3413
    void updateAsciiStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3414
                           java.io.InputStream x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3415
                           long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3416
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3417
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3418
     * Updates the designated column with a binary stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3419
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3420
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3421
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3422
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3423
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3424
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3425
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3426
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3427
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3428
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3429
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3430
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3431
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3432
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3433
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3434
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3435
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3436
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3437
    void updateBinaryStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3438
                            java.io.InputStream x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3439
                            long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3440
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3441
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3442
     * Updates the designated column with a character stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3443
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3444
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3445
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3446
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3447
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3448
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3449
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3450
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3451
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3452
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3453
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3454
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3455
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3456
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3457
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3458
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3459
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3460
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3461
    void updateCharacterStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3462
                             java.io.Reader x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3463
                             long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3464
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3465
     * Updates the designated column with an ascii stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3466
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3467
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3468
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3469
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3470
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3471
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3472
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3473
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3474
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3475
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3476
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3477
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3478
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3479
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3480
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3481
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3482
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3483
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3484
    void updateAsciiStream(String columnLabel,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3485
                           java.io.InputStream x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3486
                           long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3487
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3488
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3489
     * Updates the designated column with a binary stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3490
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3491
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3492
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3493
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3494
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3495
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3496
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3497
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3498
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3499
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3500
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3501
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3502
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3503
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3504
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3505
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3506
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3507
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3508
    void updateBinaryStream(String columnLabel,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3509
                            java.io.InputStream x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3510
                            long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3511
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3512
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3513
     * Updates the designated column with a character stream value, which will have
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3514
     * the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3515
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3516
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3517
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3518
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3519
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3520
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3521
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3522
     * @param reader the <code>java.io.Reader</code> object containing
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3523
     *        the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3524
     * @param length the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3525
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3526
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3527
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3528
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3529
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3530
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3531
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3532
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3533
    void updateCharacterStream(String columnLabel,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3534
                             java.io.Reader reader,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3535
                             long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3536
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3537
     * Updates the designated column using the given input stream, which
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3538
     * will have the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3539
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3540
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3541
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3542
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3543
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3544
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3545
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3546
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3547
     * @param inputStream An object that contains the data to set the parameter
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3548
     * value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3549
     * @param length the number of bytes in the parameter data.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3550
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3551
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3552
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3553
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3554
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3555
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3556
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3557
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3558
    void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3559
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3560
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3561
     * Updates the designated column using the given input stream, which
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3562
     * will have the specified number of bytes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3563
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3564
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3565
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3566
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3567
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3568
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3569
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3570
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3571
     * @param inputStream An object that contains the data to set the parameter
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3572
     * value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3573
     * @param length the number of bytes in the parameter data.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3574
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3575
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3576
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3577
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3578
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3579
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3580
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3581
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3582
    void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3583
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3584
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3585
     * Updates the designated column using the given <code>Reader</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3586
     * object, which is the given number of characters long.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3587
     * When a very large UNICODE value is input to a <code>LONGVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3588
     * parameter, it may be more practical to send it via a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3589
     * <code>java.io.Reader</code> object. The JDBC driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3590
     * do any necessary conversion from UNICODE to the database char format.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3591
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3592
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3593
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3594
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3595
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3596
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3597
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3598
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3599
     * @param reader An object that contains the data to set the parameter value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3600
     * @param length the number of characters in the parameter data.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3601
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3602
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3603
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3604
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3605
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3606
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3607
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3608
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3609
    void updateClob(int columnIndex,  Reader reader, long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3610
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3611
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3612
     * Updates the designated column using the given <code>Reader</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3613
     * object, which is the given number of characters long.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3614
     * When a very large UNICODE value is input to a <code>LONGVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3615
     * parameter, it may be more practical to send it via a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3616
     * <code>java.io.Reader</code> object.  The JDBC driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3617
     * do any necessary conversion from UNICODE to the database char format.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3618
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3619
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3620
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3621
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3622
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3623
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3624
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3625
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3626
     * @param reader An object that contains the data to set the parameter value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3627
     * @param length the number of characters in the parameter data.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3628
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3629
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3630
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3631
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3632
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3633
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3634
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3635
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3636
    void updateClob(String columnLabel,  Reader reader, long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3637
   /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3638
     * Updates the designated column using the given <code>Reader</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3639
     * object, which is the given number of characters long.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3640
     * When a very large UNICODE value is input to a <code>LONGVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3641
     * parameter, it may be more practical to send it via a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3642
     * <code>java.io.Reader</code> object. The JDBC driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3643
     * do any necessary conversion from UNICODE to the database char format.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3644
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3645
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3646
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3647
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3648
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3649
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3650
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3651
     * @param columnIndex the first column is 1, the second 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3652
     * @param reader An object that contains the data to set the parameter value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3653
     * @param length the number of characters in the parameter data.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3654
     * @throws SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3655
    * if the driver does not support national
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3656
     *         character sets;  if the driver can detect that a data conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3657
     *  error could occur; this method is called on a closed result set,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3658
     * if a database access error occurs or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3659
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3660
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3661
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3662
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3663
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3664
    void updateNClob(int columnIndex,  Reader reader, long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3665
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3666
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3667
     * Updates the designated column using the given <code>Reader</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3668
     * object, which is the given number of characters long.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3669
     * When a very large UNICODE value is input to a <code>LONGVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3670
     * parameter, it may be more practical to send it via a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3671
     * <code>java.io.Reader</code> object. The JDBC driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3672
     * do any necessary conversion from UNICODE to the database char format.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3673
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3674
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3675
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3676
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3677
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3678
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3679
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3680
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3681
     * @param reader An object that contains the data to set the parameter value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3682
     * @param length the number of characters in the parameter data.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3683
     * @throws SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3684
     * if the driver does not support national
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3685
     *         character sets;  if the driver can detect that a data conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3686
     *  error could occur; this method is called on a closed result set;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3687
     *  if a database access error occurs or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3688
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3689
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3690
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3691
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3692
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3693
    void updateNClob(String columnLabel,  Reader reader, long length) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3694
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3695
    //---
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3696
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3697
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3698
     * Updates the designated column with a character stream value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3699
     * The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3700
     * as needed until end-of-stream is reached.  The
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3701
     * driver does the necessary conversion from Java character format to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3702
     * the national character set in the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3703
     * It is intended for use when
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3704
     * updating  <code>NCHAR</code>,<code>NVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3705
     * and <code>LONGNVARCHAR</code> columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3706
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3707
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3708
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3709
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3710
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3711
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3712
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3713
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3714
     * <code>updateNCharacterStream</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3715
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3716
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3717
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3718
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3719
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3720
     * the result set concurrency is <code>CONCUR_READ_ONLY</code> or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3721
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3722
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3723
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3724
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3725
    void updateNCharacterStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3726
                             java.io.Reader x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3727
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3728
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3729
     * Updates the designated column with a character stream value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3730
     * The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3731
     * as needed until end-of-stream is reached.  The
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3732
     * driver does the necessary conversion from Java character format to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3733
     * the national character set in the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3734
     * It is intended for use when
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3735
     * updating  <code>NCHAR</code>,<code>NVARCHAR</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3736
     * and <code>LONGNVARCHAR</code> columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3737
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3738
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3739
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3740
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3741
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3742
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3743
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3744
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3745
     * <code>updateNCharacterStream</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3746
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3747
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3748
     * @param reader the <code>java.io.Reader</code> object containing
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3749
     *        the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3750
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3751
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3752
     * the result set concurrency is <code>CONCUR_READ_ONLY</code> or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3753
      * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3754
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3755
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3756
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3757
    void updateNCharacterStream(String columnLabel,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3758
                             java.io.Reader reader) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3759
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3760
     * Updates the designated column with an ascii stream value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3761
     * The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3762
     * as needed until end-of-stream is reached.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3763
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3764
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3765
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3766
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3767
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3768
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3769
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3770
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3771
     * <code>updateAsciiStream</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3772
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3773
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3774
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3775
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3776
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3777
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3778
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3779
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3780
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3781
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3782
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3783
    void updateAsciiStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3784
                           java.io.InputStream x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3785
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3786
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3787
     * Updates the designated column with a binary stream value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3788
     * The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3789
     * as needed until end-of-stream is reached.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3790
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3791
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3792
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3793
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3794
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3795
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3796
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3797
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3798
     * <code>updateBinaryStream</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3799
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3800
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3801
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3802
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3803
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3804
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3805
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3806
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3807
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3808
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3809
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3810
    void updateBinaryStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3811
                            java.io.InputStream x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3812
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3813
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3814
     * Updates the designated column with a character stream value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3815
     * The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3816
     * as needed until end-of-stream is reached.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3817
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3818
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3819
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3820
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3821
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3822
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3823
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3824
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3825
     * <code>updateCharacterStream</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3826
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3827
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3828
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3829
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3830
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3831
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3832
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3833
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3834
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3835
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3836
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3837
    void updateCharacterStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3838
                             java.io.Reader x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3839
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3840
     * Updates the designated column with an ascii stream value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3841
     * The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3842
     * as needed until end-of-stream is reached.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3843
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3844
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3845
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3846
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3847
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3848
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3849
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3850
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3851
     * <code>updateAsciiStream</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3852
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3853
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3854
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3855
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3856
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3857
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3858
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3859
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3860
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3861
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3862
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3863
    void updateAsciiStream(String columnLabel,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3864
                           java.io.InputStream x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3865
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3866
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3867
     * Updates the designated column with a binary stream value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3868
     * The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3869
     * as needed until end-of-stream is reached.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3870
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3871
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3872
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3873
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3874
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3875
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3876
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3877
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3878
     * <code>updateBinaryStream</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3879
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3880
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3881
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3882
     * @exception SQLException if the columnLabel is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3883
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3884
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3885
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3886
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3887
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3888
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3889
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3890
    void updateBinaryStream(String columnLabel,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3891
                            java.io.InputStream x) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3892
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3893
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3894
     * Updates the designated column with a character stream value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3895
     * The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3896
     * as needed until end-of-stream is reached.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3897
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3898
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3899
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3900
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3901
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3902
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3903
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3904
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3905
     * <code>updateCharacterStream</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3906
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3907
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3908
     * @param reader the <code>java.io.Reader</code> object containing
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3909
     *        the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3910
     * @exception SQLException if the columnLabel is not valid; if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3911
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3912
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3913
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3914
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3915
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3916
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3917
    void updateCharacterStream(String columnLabel,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3918
                             java.io.Reader reader) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3919
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3920
     * Updates the designated column using the given input stream. The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3921
     * as needed until end-of-stream is reached.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3922
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3923
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3924
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3925
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3926
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3927
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3928
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3929
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3930
     * <code>updateBlob</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3931
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3932
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3933
     * @param inputStream An object that contains the data to set the parameter
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3934
     * value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3935
     * @exception SQLException if the columnIndex is not valid; if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3936
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3937
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3938
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3939
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3940
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3941
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3942
    void updateBlob(int columnIndex, InputStream inputStream) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3943
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3944
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3945
     * Updates the designated column using the given input stream. The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3946
     * as needed until end-of-stream is reached.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3947
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3948
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3949
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3950
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3951
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3952
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3953
     *   <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3954
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3955
     * <code>updateBlob</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3956
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3957
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3958
     * @param inputStream An object that contains the data to set the parameter
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3959
     * value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3960
     * @exception SQLException if the columnLabel is not valid; if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3961
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3962
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3963
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3964
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3965
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3966
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3967
    void updateBlob(String columnLabel, InputStream inputStream) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3968
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3969
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3970
     * Updates the designated column using the given <code>Reader</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3971
     * object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3972
     *  The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3973
     * as needed until end-of-stream is reached.  The JDBC driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3974
     * do any necessary conversion from UNICODE to the database char format.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3975
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3976
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3977
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3978
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3979
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3980
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3981
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3982
     *   <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3983
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3984
     * <code>updateClob</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3985
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3986
     * @param columnIndex the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3987
     * @param reader An object that contains the data to set the parameter value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3988
     * @exception SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3989
     * if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3990
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3991
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3992
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3993
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3994
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3995
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3996
    void updateClob(int columnIndex,  Reader reader) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3997
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3998
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3999
     * Updates the designated column using the given <code>Reader</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4000
     * object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4001
     *  The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4002
     * as needed until end-of-stream is reached.  The JDBC driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4003
     * do any necessary conversion from UNICODE to the database char format.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4004
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4005
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4006
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4007
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4008
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4009
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4010
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4011
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4012
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4013
     * <code>updateClob</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4014
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4015
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4016
     * @param reader An object that contains the data to set the parameter value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4017
     * @exception SQLException if the columnLabel is not valid; if a database access error occurs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4018
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4019
     * or this method is called on a closed result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4020
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4021
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4022
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4023
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4024
    void updateClob(String columnLabel,  Reader reader) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4025
   /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4026
     * Updates the designated column using the given <code>Reader</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4027
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4028
     * The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4029
     * as needed until end-of-stream is reached.  The JDBC driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4030
     * do any necessary conversion from UNICODE to the database char format.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4031
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4032
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4033
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4034
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4035
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4036
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4037
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4038
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4039
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4040
     * <code>updateNClob</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4041
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4042
     * @param columnIndex the first column is 1, the second 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4043
     * @param reader An object that contains the data to set the parameter value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4044
     * @throws SQLException if the columnIndex is not valid;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4045
    * if the driver does not support national
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4046
     *         character sets;  if the driver can detect that a data conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4047
     *  error could occur; this method is called on a closed result set,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4048
     * if a database access error occurs or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4049
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4050
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4051
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4052
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4053
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4054
    void updateNClob(int columnIndex,  Reader reader) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4055
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4056
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4057
     * Updates the designated column using the given <code>Reader</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4058
     * object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4059
     * The data will be read from the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4060
     * as needed until end-of-stream is reached.  The JDBC driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4061
     * do any necessary conversion from UNICODE to the database char format.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4062
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4063
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4064
     * The updater methods are used to update column values in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4065
     * current row or the insert row.  The updater methods do not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4066
     * update the underlying database; instead the <code>updateRow</code> or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4067
     * <code>insertRow</code> methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4068
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4069
     * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4070
     * it might be more efficient to use a version of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4071
     * <code>updateNClob</code> which takes a length parameter.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4072
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4073
     * @param columnLabel the label for the column specified with the SQL AS clause.  If the SQL AS clause was not specified, then the label is the name of the column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4074
     * @param reader An object that contains the data to set the parameter value to.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4075
     * @throws SQLException if the columnLabel is not valid; if the driver does not support national
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4076
     *         character sets;  if the driver can detect that a data conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4077
     *  error could occur; this method is called on a closed result set;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4078
     *  if a database access error occurs or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4079
     * the result set concurrency is <code>CONCUR_READ_ONLY</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4080
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4081
     * this method
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4082
     * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4083
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4084
    void updateNClob(String columnLabel,  Reader reader) throws SQLException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4085
6540
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4086
    //------------------------- JDBC 4.1 -----------------------------------
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4087
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4088
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4089
    /**
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4090
     *<p>Retrieves the value of the designated column in the current row
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4091
     * of this <code>ResultSet</code> object and will convert from the
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4092
     * SQL type of the column to the requested Java data type, if the
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4093
     * conversion is supported. If the conversion is not
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4094
     * supported  or null is specified for the type, a
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4095
     * <code>SQLException</code> is thrown.
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4096
     *<p>
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4097
     * At a minimum, an implementation must support the conversions defined in
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4098
     * Appendix B, Table B-3 and conversion of appropriate user defined SQL
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4099
     * types to a Java type which implements {@code SQLData}, or {@code Struct}.
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4100
     * Additional conversions may be supported and are vendor defined.
18564
f9db68ff2cbb 8017471: Fix JDBC -Xdoclint public errors
lancea
parents: 18156
diff changeset
  4101
     * @param <T> the type of the class modeled by this Class object
6540
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4102
     * @param columnIndex the first column is 1, the second is 2, ...
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4103
     * @param type Class representing the Java data type to convert the designated
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4104
     * column to.
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4105
     * @return an instance of {@code type} holding the column value
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4106
     * @throws SQLException if conversion is not supported, type is null or
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4107
     *         another error occurs. The getCause() method of the
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4108
     * exception may provide a more detailed exception, for example, if
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4109
     * a conversion error occurs
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4110
     * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4111
     * this method
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4112
     * @since 1.7
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4113
     */
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4114
     public <T> T getObject(int columnIndex, Class<T> type) throws SQLException;
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4115
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4116
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4117
    /**
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4118
     *<p>Retrieves the value of the designated column in the current row
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4119
     * of this <code>ResultSet</code> object and will convert from the
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4120
     * SQL type of the column to the requested Java data type, if the
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4121
     * conversion is supported. If the conversion is not
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4122
     * supported  or null is specified for the type, a
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4123
     * <code>SQLException</code> is thrown.
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4124
     *<p>
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4125
     * At a minimum, an implementation must support the conversions defined in
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4126
     * Appendix B, Table B-3 and conversion of appropriate user defined SQL
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4127
     * types to a Java type which implements {@code SQLData}, or {@code Struct}.
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4128
     * Additional conversions may be supported and are vendor defined.
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4129
     *
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4130
     * @param columnLabel the label for the column specified with the SQL AS clause.
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4131
     * If the SQL AS clause was not specified, then the label is the name
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4132
     * of the column
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4133
     * @param type Class representing the Java data type to convert the designated
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4134
     * column to.
18564
f9db68ff2cbb 8017471: Fix JDBC -Xdoclint public errors
lancea
parents: 18156
diff changeset
  4135
     * @param <T> the type of the class modeled by this Class object
6540
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4136
     * @return an instance of {@code type} holding the column value
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4137
     * @throws SQLException if conversion is not supported, type is null or
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4138
     *         another error occurs. The getCause() method of the
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4139
     * exception may provide a more detailed exception, for example, if
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4140
     * a conversion error occurs
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4141
     * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4142
     * this method
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4143
     * @since 1.7
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4144
     */
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4145
     public <T> T getObject(String columnLabel, Class<T> type) throws SQLException;
a4ae668f6125 6589685: JDBC 4.1 updates
lancea
parents: 5506
diff changeset
  4146
15278
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4147
    //------------------------- JDBC 4.2 -----------------------------------
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4148
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4149
    /**
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4150
     * Updates the designated column with an {@code Object} value.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4151
     *
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4152
     * The updater methods are used to update column values in the
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4153
     * current row or the insert row.  The updater methods do not
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4154
     * update the underlying database; instead the {@code updateRow} or
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4155
     * {@code insertRow} methods are called to update the database.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4156
     *<p>
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4157
     * If the second argument is an {@code InputStream} then the stream must contain
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4158
     * the number of bytes specified by scaleOrLength.  If the second argument is a
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4159
     * {@code Reader} then the reader must contain the number of characters specified
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4160
     * by scaleOrLength. If these conditions are not true the driver will generate a
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4161
     * {@code SQLException} when the statement is executed.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4162
     *<p>
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4163
     * The default implementation will throw {@code SQLFeatureNotSupportedException}
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4164
     *
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4165
     * @param columnIndex the first column is 1, the second is 2, ...
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4166
     * @param x the new column value
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4167
     * @param targetSqlType the SQL type to be sent to the database
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4168
     * @param scaleOrLength for an object of {@code java.math.BigDecimal} ,
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4169
     *          this is the number of digits after the decimal point. For
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4170
     *          Java Object types {@code InputStream} and {@code Reader},
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4171
     *          this is the length
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4172
     *          of the data in the stream or reader.  For all other types,
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4173
     *          this value will be ignored.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4174
     * @exception SQLException if the columnIndex is not valid;
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4175
     * if a database access error occurs;
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4176
     * the result set concurrency is {@code CONCUR_READ_ONLY}
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4177
     * or this method is called on a closed result set
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4178
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not
21950
db3c826749f7 8029417: JDBC 4.2 javadoc updates
lancea
parents: 21278
diff changeset
  4179
     * support this method; if the JDBC driver does not support the specified targetSqlType
15278
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4180
     * @see JDBCType
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4181
     * @see SQLType
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4182
     * @since 1.8
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4183
     */
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4184
     default void updateObject(int columnIndex, Object x,
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4185
             SQLType targetSqlType, int scaleOrLength)  throws SQLException {
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4186
        throw new SQLFeatureNotSupportedException("updateObject not implemented");
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4187
    }
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4188
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4189
    /**
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4190
     * Updates the designated column with an {@code Object} value.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4191
     *
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4192
     * The updater methods are used to update column values in the
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4193
     * current row or the insert row.  The updater methods do not
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4194
     * update the underlying database; instead the {@code updateRow} or
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4195
     * {@code insertRow} methods are called to update the database.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4196
     *<p>
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4197
     * If the second argument is an {@code InputStream} then the stream must
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4198
     * contain number of bytes specified by scaleOrLength.  If the second
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4199
     * argument is a {@code Reader} then the reader must contain the number
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4200
     * of characters specified by scaleOrLength. If these conditions are not
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4201
     * true the driver will generate a
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4202
     * {@code SQLException} when the statement is executed.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4203
     *<p>
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4204
     * The default implementation will throw {@code SQLFeatureNotSupportedException}
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4205
     *
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4206
     * @param columnLabel the label for the column specified with the SQL AS
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4207
     * clause.  If the SQL AS clause was not specified, then the label is
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4208
     * the name of the column
18564
f9db68ff2cbb 8017471: Fix JDBC -Xdoclint public errors
lancea
parents: 18156
diff changeset
  4209
     * @param x the new column value
15278
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4210
     * @param targetSqlType the SQL type to be sent to the database
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4211
     * @param scaleOrLength for an object of {@code java.math.BigDecimal} ,
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4212
     *          this is the number of digits after the decimal point. For
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4213
     *          Java Object types {@code InputStream} and {@code Reader},
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4214
     *          this is the length
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4215
     *          of the data in the stream or reader.  For all other types,
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4216
     *          this value will be ignored.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4217
     * @exception SQLException if the columnLabel is not valid;
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4218
     * if a database access error occurs;
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4219
     * the result set concurrency is {@code CONCUR_READ_ONLY}
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4220
     * or this method is called on a closed result set
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4221
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not
21950
db3c826749f7 8029417: JDBC 4.2 javadoc updates
lancea
parents: 21278
diff changeset
  4222
     * support this method; if the JDBC driver does not support the specified targetSqlType
15278
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4223
     * @see JDBCType
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4224
     * @see SQLType
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4225
     * @since 1.8
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4226
     */
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4227
    default void updateObject(String columnLabel, Object x,
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4228
            SQLType targetSqlType, int scaleOrLength) throws SQLException {
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4229
        throw new SQLFeatureNotSupportedException("updateObject not implemented");
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4230
    }
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4231
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4232
    /**
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4233
     * Updates the designated column with an {@code Object} value.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4234
     *
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4235
     * The updater methods are used to update column values in the
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4236
     * current row or the insert row.  The updater methods do not
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4237
     * update the underlying database; instead the {@code updateRow} or
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4238
     * {@code insertRow} methods are called to update the database.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4239
     *<p>
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4240
     * The default implementation will throw {@code SQLFeatureNotSupportedException}
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4241
     *
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4242
     * @param columnIndex the first column is 1, the second is 2, ...
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4243
     * @param x the new column value
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4244
     * @param targetSqlType the SQL type to be sent to the database
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4245
     * @exception SQLException if the columnIndex is not valid;
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4246
     * if a database access error occurs;
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4247
     * the result set concurrency is {@code CONCUR_READ_ONLY}
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4248
     * or this method is called on a closed result set
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4249
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not
21950
db3c826749f7 8029417: JDBC 4.2 javadoc updates
lancea
parents: 21278
diff changeset
  4250
     * support this method; if the JDBC driver does not support the specified targetSqlType
15278
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4251
     * @see JDBCType
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4252
     * @see SQLType
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4253
     * @since 1.8
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4254
     */
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4255
    default void updateObject(int columnIndex, Object x, SQLType targetSqlType)
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4256
            throws SQLException {
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4257
        throw new SQLFeatureNotSupportedException("updateObject not implemented");
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4258
    }
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4259
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4260
    /**
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4261
     * Updates the designated column with an {@code Object} value.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4262
     *
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4263
     * The updater methods are used to update column values in the
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4264
     * current row or the insert row.  The updater methods do not
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4265
     * update the underlying database; instead the {@code updateRow} or
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4266
     * {@code insertRow} methods are called to update the database.
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4267
     *<p>
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4268
     * The default implementation will throw {@code SQLFeatureNotSupportedException}
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4269
     *
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4270
     * @param columnLabel the label for the column specified with the SQL AS
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4271
     * clause.  If the SQL AS clause was not specified, then the label is
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4272
     * the name of the column
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4273
     * @param x the new column value
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4274
     * @param targetSqlType the SQL type to be sent to the database
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4275
     * @exception SQLException if the columnLabel is not valid;
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4276
     * if a database access error occurs;
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4277
     * the result set concurrency is {@code CONCUR_READ_ONLY}
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4278
     * or this method is called on a closed result set
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4279
     * @exception SQLFeatureNotSupportedException if the JDBC driver does not
21950
db3c826749f7 8029417: JDBC 4.2 javadoc updates
lancea
parents: 21278
diff changeset
  4280
     * support this method; if the JDBC driver does not support the specified targetSqlType
15278
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4281
     * @see JDBCType
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4282
     * @see SQLType
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4283
     * @since 1.8
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4284
     */
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4285
    default void updateObject(String columnLabel, Object x,
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4286
            SQLType targetSqlType) throws SQLException {
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4287
        throw new SQLFeatureNotSupportedException("updateObject not implemented");
e081d3f73b75 8005080: JDBC 4.2 Core changes
lancea
parents: 14342
diff changeset
  4288
    }
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4289
}