jdk/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java
author avstepan
Mon, 08 Jun 2015 16:37:53 +0400
changeset 31061 fead7d86d75f
parent 28059 e576535359cc
child 37880 60ec48925dc6
permissions -rw-r--r--
8081517: minor cleanup for docs Summary: fix some tidy and javadoc warnings/errors Reviewed-by: lancea, rriggs
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     1
/*
23010
6dadb192ad81 8029235: Update copyright year to match last edit in jdk8 jdk repository for 2013
lana
parents: 21278
diff changeset
     2
 * Copyright (c) 2004, 2013, 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 com.sun.rowset.internal;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    27
90ce3da70b43 Initial load
duke
parents:
diff changeset
    28
import java.sql.*;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    29
import javax.sql.*;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    30
import java.util.*;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    31
import java.math.BigDecimal;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    32
90ce3da70b43 Initial load
duke
parents:
diff changeset
    33
import javax.sql.rowset.*;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    34
import javax.sql.rowset.spi.*;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    35
90ce3da70b43 Initial load
duke
parents:
diff changeset
    36
import com.sun.rowset.*;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    37
import java.io.IOException;
6530
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
    38
import java.io.ObjectInputStream;
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    39
90ce3da70b43 Initial load
duke
parents:
diff changeset
    40
/**
90ce3da70b43 Initial load
duke
parents:
diff changeset
    41
 * There will be two sets of data which will be maintained by the rowset at the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
    42
 * time of synchronization. The {@code SyncProvider} will utilize the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
    43
 * {@code SyncResolver} to synchronize the changes back to database.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    44
 */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    45
public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver {
90ce3da70b43 Initial load
duke
parents:
diff changeset
    46
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
    47
     * This CachedRowSet object will encapsulate a rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
    48
     * which will be sync'ed with the datasource but will
90ce3da70b43 Initial load
duke
parents:
diff changeset
    49
     * contain values in rows where there is conflict.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    50
     * For rows other than conflict, it will *not* contain
90ce3da70b43 Initial load
duke
parents:
diff changeset
    51
     * any data. For rows containing conflict it will
90ce3da70b43 Initial load
duke
parents:
diff changeset
    52
     * return either of the three values set by SyncResolver.*_CONFLICT
90ce3da70b43 Initial load
duke
parents:
diff changeset
    53
     * from getStatus()
90ce3da70b43 Initial load
duke
parents:
diff changeset
    54
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    55
    private CachedRowSetImpl crsRes;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    56
90ce3da70b43 Initial load
duke
parents:
diff changeset
    57
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
    58
     * This is the actual CachedRowSet object
90ce3da70b43 Initial load
duke
parents:
diff changeset
    59
     * which is being synchronized back to
90ce3da70b43 Initial load
duke
parents:
diff changeset
    60
     * datasource.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    61
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    62
    private CachedRowSetImpl crsSync;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    63
90ce3da70b43 Initial load
duke
parents:
diff changeset
    64
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
    65
     *  This ArrayList will contain the status of a row
90ce3da70b43 Initial load
duke
parents:
diff changeset
    66
     *  from the SyncResolver.* values else it will be null.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    67
     */
11129
f9ad1aadf3fa 7116445: Miscellaneous warnings in the JDBC/RowSet classes
lancea
parents: 6530
diff changeset
    68
    private ArrayList<?> stats;
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    69
90ce3da70b43 Initial load
duke
parents:
diff changeset
    70
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
    71
     * The RowSetWriter associated with the original
90ce3da70b43 Initial load
duke
parents:
diff changeset
    72
     * CachedRowSet object which is being synchronized.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    73
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    74
    private CachedRowSetWriter crw;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    75
90ce3da70b43 Initial load
duke
parents:
diff changeset
    76
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
    77
     * Row number identifier
90ce3da70b43 Initial load
duke
parents:
diff changeset
    78
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    79
    private int rowStatus;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    80
90ce3da70b43 Initial load
duke
parents:
diff changeset
    81
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
    82
     * This will contain the size of the {@code CachedRowSet} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    83
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    84
    private int sz;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    85
90ce3da70b43 Initial load
duke
parents:
diff changeset
    86
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
    87
     * The {@code Connection} handle used to synchronize the changes
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    88
     * back to datasource. This is the same connection handle as was passed
90ce3da70b43 Initial load
duke
parents:
diff changeset
    89
     * to the CachedRowSet while fetching the data.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    90
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    91
    private transient Connection con;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    92
90ce3da70b43 Initial load
duke
parents:
diff changeset
    93
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
    94
     * The {@code CachedRowSet} object which will encapsulate
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    95
     * a row at any time. This will be built from CachedRowSet and
90ce3da70b43 Initial load
duke
parents:
diff changeset
    96
     * SyncResolver values. Synchronization takes place on a row by
90ce3da70b43 Initial load
duke
parents:
diff changeset
    97
     * row basis encapsulated as a CahedRowSet.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    98
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    99
    private CachedRowSet row;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   100
90ce3da70b43 Initial load
duke
parents:
diff changeset
   101
    private JdbcRowSetResourceBundle resBundle;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   102
90ce3da70b43 Initial load
duke
parents:
diff changeset
   103
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   104
     * Public constructor
90ce3da70b43 Initial load
duke
parents:
diff changeset
   105
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   106
    public SyncResolverImpl() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   107
        try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   108
            crsSync = new CachedRowSetImpl();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   109
            crsRes = new CachedRowSetImpl();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   110
            crw = new CachedRowSetWriter();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   111
            row = new CachedRowSetImpl();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   112
            rowStatus = 1;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   113
            try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   114
                resBundle = JdbcRowSetResourceBundle.getJdbcRowSetResourceBundle();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   115
            } catch(IOException ioe) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   116
                throw new RuntimeException(ioe);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   117
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   118
90ce3da70b43 Initial load
duke
parents:
diff changeset
   119
        } catch(SQLException sqle) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   120
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   121
     }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   122
90ce3da70b43 Initial load
duke
parents:
diff changeset
   123
90ce3da70b43 Initial load
duke
parents:
diff changeset
   124
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   125
     * Retrieves the conflict status of the current row of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   126
     * {@code SyncResolver}, which indicates the operationthe {@code RowSet}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   127
     * object was attempting when the conflict occurred.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   128
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   129
     * @return one of the following constants:
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   130
     *         {@code SyncResolver.UPDATE_ROW_CONFLICT},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   131
     *         {@code SyncResolver.DELETE_ROW_CONFLICT}, or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   132
     *         {@code SyncResolver.INSERT_ROW_CONFLICT}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   133
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   134
    public int getStatus() {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   135
        return ((Integer)stats.get(rowStatus-1)).intValue();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   136
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   137
90ce3da70b43 Initial load
duke
parents:
diff changeset
   138
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   139
     * Retrieves the value in the designated column in the current row of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   140
     * {@code SyncResolver} object, which is the value that caused a conflict.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   141
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   142
     * @param index {@code int} designating the column in this row of this
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   143
     *        {@code SyncResolver} object from which to retrieve the value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   144
     *        causing a conflict
90ce3da70b43 Initial load
duke
parents:
diff changeset
   145
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   146
    public Object getConflictValue(int index) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   147
        try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   148
             return crsRes.getObject(index);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   149
        } catch(SQLException sqle) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   150
            throw new SQLException(sqle.getMessage());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   151
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   152
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   153
90ce3da70b43 Initial load
duke
parents:
diff changeset
   154
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   155
     * Retrieves the value in the designated column in the current row of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   156
     * {@code SyncResolver} object, which is the value that caused a conflict.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   157
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   158
     * @param columnName a {@code String} object designating the column in this row of this
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   159
     *        {@code SyncResolver} object from which to retrieve the value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   160
     *        causing a conflict
90ce3da70b43 Initial load
duke
parents:
diff changeset
   161
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   162
    public Object getConflictValue(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   163
        try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   164
             return crsRes.getObject(columnName);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   165
        } catch(SQLException sqle) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   166
             throw new SQLException(sqle.getMessage());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   167
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   168
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   169
90ce3da70b43 Initial load
duke
parents:
diff changeset
   170
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   171
     * Sets <i>obj</i> as the value in column <i>index</i> in the current row of the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   172
     * {@code RowSet} object. This value is the resolved value that is to be
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   173
     * persisted in the data source.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   174
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   175
     * @param index an {@code int} giving the number of the column into which to
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   176
     *        set the value to be persisted
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   177
     * @param obj an {@code Object} that is the value to be set in the data source
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   178
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   179
    public void setResolvedValue(int index, Object obj) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   180
        // modify method to throw SQLException in spec
90ce3da70b43 Initial load
duke
parents:
diff changeset
   181
90ce3da70b43 Initial load
duke
parents:
diff changeset
   182
        /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   183
         * When a value is resolved properly make it to null
90ce3da70b43 Initial load
duke
parents:
diff changeset
   184
         * inside crsRes for that column.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   185
         *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   186
         * For more than one conflicts in the row,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   187
         * check for the last resolved value of the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   188
         * (Note: it can be resolved randomly for same row)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   189
         * then sync back immediately.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   190
         **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   191
        try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   192
            // check whether the index is in range
90ce3da70b43 Initial load
duke
parents:
diff changeset
   193
            if(index<=0 || index > crsSync.getMetaData().getColumnCount() ) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   194
                throw new SQLException(resBundle.handleGetObject("syncrsimpl.indexval").toString()+ index);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   195
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   196
             // check whether index col is in conflict
90ce3da70b43 Initial load
duke
parents:
diff changeset
   197
            if(crsRes.getObject(index) == null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   198
                throw new SQLException(resBundle.handleGetObject("syncrsimpl.noconflict").toString());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   199
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   200
        } catch (SQLException sqle) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   201
            // modify method to throw for SQLException
90ce3da70b43 Initial load
duke
parents:
diff changeset
   202
            throw new SQLException(sqle.getMessage());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   203
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   204
        try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   205
             boolean bool = true;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   206
             /** Check resolved value to be either of conflict
90ce3da70b43 Initial load
duke
parents:
diff changeset
   207
               * or in rowset else throw sql exception.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   208
               * If we allow a value other than that in CachedRowSet or
90ce3da70b43 Initial load
duke
parents:
diff changeset
   209
               * datasource we will end up in looping the loop of exceptions.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   210
              **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   211
90ce3da70b43 Initial load
duke
parents:
diff changeset
   212
             if( ((crsSync.getObject(index)).toString()).equals(obj.toString()) ||
90ce3da70b43 Initial load
duke
parents:
diff changeset
   213
                     ((crsRes.getObject(index)).toString()).equals(obj.toString()) ) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   214
90ce3da70b43 Initial load
duke
parents:
diff changeset
   215
                /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   216
                 * Check whether this is the only conflict in the row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   217
                 * If yes, synchronize this row back
90ce3da70b43 Initial load
duke
parents:
diff changeset
   218
                 * which has been resolved, else wait
90ce3da70b43 Initial load
duke
parents:
diff changeset
   219
                 * for all conflicts of current row to be resolved
90ce3da70b43 Initial load
duke
parents:
diff changeset
   220
                 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   221
                 * Step 1: Update crsRes and make the index col as null
90ce3da70b43 Initial load
duke
parents:
diff changeset
   222
                 * i.e. resolved
90ce3da70b43 Initial load
duke
parents:
diff changeset
   223
                 * crsRes.updateObject(index, obj);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   224
                 **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   225
                  crsRes.updateNull(index);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   226
                  crsRes.updateRow();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   227
90ce3da70b43 Initial load
duke
parents:
diff changeset
   228
                 /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   229
                  * Step 2: Change the value in the CachedRowSetImpl object
90ce3da70b43 Initial load
duke
parents:
diff changeset
   230
                  * crsSync.updateObject(index, obj);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   231
                  * crsSync.updateRow();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   232
                  **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   233
                 if(row.size() != 1) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   234
                    row = buildCachedRow();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   235
                 }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   236
90ce3da70b43 Initial load
duke
parents:
diff changeset
   237
                 row.updateObject(index, obj);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   238
                 row.updateRow();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   239
90ce3da70b43 Initial load
duke
parents:
diff changeset
   240
                 for(int j=1; j < crsRes.getMetaData().getColumnCount(); j++) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   241
                     if(crsRes.getObject(j) != null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   242
                        bool = false;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   243
                        break;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   244
                         // break out of loop and wait for other cols
90ce3da70b43 Initial load
duke
parents:
diff changeset
   245
                         // in same row to get resolved
90ce3da70b43 Initial load
duke
parents:
diff changeset
   246
                     } //end if
90ce3da70b43 Initial load
duke
parents:
diff changeset
   247
90ce3da70b43 Initial load
duke
parents:
diff changeset
   248
                  } //end for
90ce3da70b43 Initial load
duke
parents:
diff changeset
   249
90ce3da70b43 Initial load
duke
parents:
diff changeset
   250
                  if(bool) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   251
                     /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   252
                      * sync data back using CachedRowSetWriter
90ce3da70b43 Initial load
duke
parents:
diff changeset
   253
                      * construct the present row and pass it to the writer
90ce3da70b43 Initial load
duke
parents:
diff changeset
   254
                      * to write back to db.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   255
                      **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   256
                     try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   257
                           /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   258
                            * Note : The use of CachedRowSetWriter to get *same* Connection handle.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   259
                            * The CachedRowSetWriter uses the connection handle
90ce3da70b43 Initial load
duke
parents:
diff changeset
   260
                            * from the reader, Hence will use the same connection handle
90ce3da70b43 Initial load
duke
parents:
diff changeset
   261
                            * as of original CachedRowSetImpl
90ce3da70b43 Initial load
duke
parents:
diff changeset
   262
                            **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   263
90ce3da70b43 Initial load
duke
parents:
diff changeset
   264
                          writeData(row);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   265
90ce3da70b43 Initial load
duke
parents:
diff changeset
   266
                          //crw.writeData( (RowSetInternal)crsRow);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   267
                          //System.out.printlnt.println("12");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   268
90ce3da70b43 Initial load
duke
parents:
diff changeset
   269
                     } catch(SyncProviderException spe) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   270
                         /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   271
                          * This will occur if db is not allowing
90ce3da70b43 Initial load
duke
parents:
diff changeset
   272
                          * even after resolving the conflicts
90ce3da70b43 Initial load
duke
parents:
diff changeset
   273
                          * due to some reasons.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   274
                          * Also will prevent from going into a loop of SPE's
90ce3da70b43 Initial load
duke
parents:
diff changeset
   275
                          **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   276
                         throw new SQLException(resBundle.handleGetObject("syncrsimpl.syncnotpos").toString());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   277
                     }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   278
                  } //end if(bool)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   279
90ce3da70b43 Initial load
duke
parents:
diff changeset
   280
             } else {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   281
                 throw new SQLException(resBundle.handleGetObject("syncrsimpl.valtores").toString());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   282
             } //end if (crs.getObject ...) block
90ce3da70b43 Initial load
duke
parents:
diff changeset
   283
90ce3da70b43 Initial load
duke
parents:
diff changeset
   284
90ce3da70b43 Initial load
duke
parents:
diff changeset
   285
        } catch(SQLException sqle) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   286
           throw new SQLException(sqle.getMessage());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   287
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   288
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   289
90ce3da70b43 Initial load
duke
parents:
diff changeset
   290
    /**
28059
e576535359cc 8067377: My hobby: caning, then then canning, the the can-can
martin
parents: 25859
diff changeset
   291
     * This passes a CachedRowSet as a row to the CachedRowSetWriter
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   292
     * after the values have been resolved, back to the datasource.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   293
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   294
     * @param row a {@code CachedRowSet} object which will hold the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   295
     *        values of a particular row after they have been resolved by
90ce3da70b43 Initial load
duke
parents:
diff changeset
   296
     *        the user to synchronize back to datasource.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   297
     * @throws SQLException if synchronization does not happen properly
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   298
     *         maybe beacuse {@code Connection} has timed out.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   299
     **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   300
     private void writeData(CachedRowSet row) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   301
        crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync));
90ce3da70b43 Initial load
duke
parents:
diff changeset
   302
     }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   303
90ce3da70b43 Initial load
duke
parents:
diff changeset
   304
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   305
     * This function builds a row  as a {@code CachedRowSet} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   306
     * which has been resolved and is ready to be synchrinized to the datasource
90ce3da70b43 Initial load
duke
parents:
diff changeset
   307
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   308
     * @throws SQLException if there is problem in building
90ce3da70b43 Initial load
duke
parents:
diff changeset
   309
     *         the metadata of the row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   310
     **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   311
     private CachedRowSet buildCachedRow() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   312
       int iColCount;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   313
       CachedRowSetImpl crsRow = new CachedRowSetImpl();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   314
90ce3da70b43 Initial load
duke
parents:
diff changeset
   315
       RowSetMetaDataImpl rsmd = new RowSetMetaDataImpl();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   316
       RowSetMetaDataImpl rsmdWrite = (RowSetMetaDataImpl)crsSync.getMetaData();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   317
       RowSetMetaDataImpl rsmdRow = new RowSetMetaDataImpl();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   318
90ce3da70b43 Initial load
duke
parents:
diff changeset
   319
       iColCount = rsmdWrite.getColumnCount();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   320
       rsmdRow.setColumnCount(iColCount);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   321
90ce3da70b43 Initial load
duke
parents:
diff changeset
   322
       for(int i =1;i<=iColCount;i++) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   323
          rsmdRow.setColumnType(i,rsmdWrite.getColumnType(i));
90ce3da70b43 Initial load
duke
parents:
diff changeset
   324
          rsmdRow.setColumnName(i,rsmdWrite.getColumnName(i));
90ce3da70b43 Initial load
duke
parents:
diff changeset
   325
          rsmdRow.setNullable(i,ResultSetMetaData.columnNullableUnknown);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   326
90ce3da70b43 Initial load
duke
parents:
diff changeset
   327
          try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   328
             rsmdRow.setCatalogName(i, rsmdWrite.getCatalogName(i));
90ce3da70b43 Initial load
duke
parents:
diff changeset
   329
             rsmdRow.setSchemaName(i, rsmdWrite.getSchemaName(i));
90ce3da70b43 Initial load
duke
parents:
diff changeset
   330
          } catch(SQLException e) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   331
               e.printStackTrace();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   332
          }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   333
        } //end for
90ce3da70b43 Initial load
duke
parents:
diff changeset
   334
90ce3da70b43 Initial load
duke
parents:
diff changeset
   335
       crsRow.setMetaData(rsmdRow);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   336
90ce3da70b43 Initial load
duke
parents:
diff changeset
   337
       crsRow.moveToInsertRow();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   338
90ce3da70b43 Initial load
duke
parents:
diff changeset
   339
       for(int col=1;col<=crsSync.getMetaData().getColumnCount();col++) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   340
           crsRow.updateObject(col, crsSync.getObject(col));
90ce3da70b43 Initial load
duke
parents:
diff changeset
   341
       }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   342
90ce3da70b43 Initial load
duke
parents:
diff changeset
   343
       crsRow.insertRow();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   344
       crsRow.moveToCurrentRow();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   345
90ce3da70b43 Initial load
duke
parents:
diff changeset
   346
       crsRow.absolute(1);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   347
       crsRow.setOriginalRow();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   348
90ce3da70b43 Initial load
duke
parents:
diff changeset
   349
      try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   350
          crsRow.setUrl(crsSync.getUrl());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   351
      } catch(SQLException sqle) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   352
90ce3da70b43 Initial load
duke
parents:
diff changeset
   353
      }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   354
90ce3da70b43 Initial load
duke
parents:
diff changeset
   355
      try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   356
          crsRow.setDataSourceName(crsSync.getCommand());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   357
       } catch(SQLException sqle) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   358
90ce3da70b43 Initial load
duke
parents:
diff changeset
   359
       }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   360
90ce3da70b43 Initial load
duke
parents:
diff changeset
   361
       try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   362
           if(crsSync.getTableName()!= null){
90ce3da70b43 Initial load
duke
parents:
diff changeset
   363
              crsRow.setTableName(crsSync.getTableName());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   364
           }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   365
        } catch(SQLException sqle) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   366
90ce3da70b43 Initial load
duke
parents:
diff changeset
   367
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   368
90ce3da70b43 Initial load
duke
parents:
diff changeset
   369
       try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   370
            if(crsSync.getCommand() != null)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   371
                crsRow.setCommand(crsSync.getCommand());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   372
       } catch(SQLException sqle) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   373
90ce3da70b43 Initial load
duke
parents:
diff changeset
   374
       }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   375
90ce3da70b43 Initial load
duke
parents:
diff changeset
   376
       try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   377
            crsRow.setKeyColumns(crsSync.getKeyColumns());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   378
       } catch(SQLException sqle) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   379
90ce3da70b43 Initial load
duke
parents:
diff changeset
   380
       }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   381
       return crsRow;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   382
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   383
90ce3da70b43 Initial load
duke
parents:
diff changeset
   384
90ce3da70b43 Initial load
duke
parents:
diff changeset
   385
90ce3da70b43 Initial load
duke
parents:
diff changeset
   386
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   387
     * Sets <i>obj</i> as the value in column <i>columnName</i> in the current row of the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   388
     * {@code RowSet} object. This value is the resolved value that is to be
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   389
     * persisted in the data source.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   390
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   391
     * @param columnName a {@code String} object giving the name of the column
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   392
     *        into which to set the value to be persisted
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   393
     * @param obj an {@code Object} that is the value to be set in the data source
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   394
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   395
    public void setResolvedValue(String columnName, Object obj) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   396
       // modify method to throw SQLException in spec
90ce3da70b43 Initial load
duke
parents:
diff changeset
   397
       // %%% Missing implementation!
90ce3da70b43 Initial load
duke
parents:
diff changeset
   398
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   399
90ce3da70b43 Initial load
duke
parents:
diff changeset
   400
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   401
     * This function is package private,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   402
     * i.e. cannot be accesses outside this package.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   403
     * This is used to set the actual CachedRowSet
90ce3da70b43 Initial load
duke
parents:
diff changeset
   404
     * which is being synchronized to the database
90ce3da70b43 Initial load
duke
parents:
diff changeset
   405
     **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   406
   void setCachedRowSet(CachedRowSet crs) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   407
           crsSync = (CachedRowSetImpl)crs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   408
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   409
90ce3da70b43 Initial load
duke
parents:
diff changeset
   410
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   411
     * This function is package private,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   412
     * i.e. cannot be accesses outside this package.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   413
     * This is used to set the CachedRowSet formed
90ce3da70b43 Initial load
duke
parents:
diff changeset
   414
     * with conflict values.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   415
     **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   416
    void setCachedRowSetResolver(CachedRowSet crs){
90ce3da70b43 Initial load
duke
parents:
diff changeset
   417
         try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   418
              crsRes = (CachedRowSetImpl)crs;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   419
              crsRes.afterLast();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   420
              sz = crsRes.size();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   421
         } catch (SQLException sqle) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   422
            // do nothing
90ce3da70b43 Initial load
duke
parents:
diff changeset
   423
         }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   424
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   425
90ce3da70b43 Initial load
duke
parents:
diff changeset
   426
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   427
     * This function is package private,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   428
     * i.e. cannot be accesses outside this package.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   429
     * This is used to set the status of each row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   430
     * to either of the values SyncResolver.*_CONFLICT
90ce3da70b43 Initial load
duke
parents:
diff changeset
   431
     **/
11129
f9ad1aadf3fa 7116445: Miscellaneous warnings in the JDBC/RowSet classes
lancea
parents: 6530
diff changeset
   432
    @SuppressWarnings("rawtypes")
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   433
    void setStatus(ArrayList status){
90ce3da70b43 Initial load
duke
parents:
diff changeset
   434
             stats = status;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   435
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   436
90ce3da70b43 Initial load
duke
parents:
diff changeset
   437
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   438
     * This function is package private,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   439
     * i.e. cannot be accesses outside this package.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   440
     * This is used to set the handle to the writer object
90ce3da70b43 Initial load
duke
parents:
diff changeset
   441
     * which will write the resolved values back to datasource
90ce3da70b43 Initial load
duke
parents:
diff changeset
   442
     **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   443
    void setCachedRowSetWriter(CachedRowSetWriter CRWriter) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   444
         crw = CRWriter;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   445
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   446
90ce3da70b43 Initial load
duke
parents:
diff changeset
   447
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   448
     * Moves the cursor down one row from its current position. A {@code SyncResolver}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   449
     * cursor is initially positioned before the first conflict row; the first call to the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   450
     * method {@code nextConflict()} makes the first conflict row the current row;
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   451
     * the second call makes the second conflict row the current row, and so on.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   452
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   453
     * If an input stream is open for the current row, a call to the method next will
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   454
     * implicitly close it. A {@code SyncResolver} object's warning chain is cleared
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   455
     * when a new row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   456
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   457
     * @return true if the new current row is valid; false if there are no more rows
90ce3da70b43 Initial load
duke
parents:
diff changeset
   458
     * @throws SQLException if a database access occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
   459
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   460
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   461
    public boolean nextConflict() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   462
        /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   463
          * The next() method will hop from
90ce3da70b43 Initial load
duke
parents:
diff changeset
   464
          * one conflict to another
90ce3da70b43 Initial load
duke
parents:
diff changeset
   465
          *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   466
          * Internally do a crs.next() until
90ce3da70b43 Initial load
duke
parents:
diff changeset
   467
          * next conflict.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   468
          **/
90ce3da70b43 Initial load
duke
parents:
diff changeset
   469
      boolean bool = false;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   470
90ce3da70b43 Initial load
duke
parents:
diff changeset
   471
      crsSync.setShowDeleted(true);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   472
      while(crsSync.next()) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   473
           crsRes.previous();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   474
           rowStatus++;  //sz--;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   475
90ce3da70b43 Initial load
duke
parents:
diff changeset
   476
          if((rowStatus-1) >= stats.size()) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   477
             bool = false;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   478
             break;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   479
          }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   480
90ce3da70b43 Initial load
duke
parents:
diff changeset
   481
          if(((Integer)stats.get(rowStatus-1)).intValue() == SyncResolver.NO_ROW_CONFLICT) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   482
              // do nothing
90ce3da70b43 Initial load
duke
parents:
diff changeset
   483
              // bool remains as false
90ce3da70b43 Initial load
duke
parents:
diff changeset
   484
             ;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   485
           } else {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   486
             bool = true;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   487
             break;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   488
           } //end if
90ce3da70b43 Initial load
duke
parents:
diff changeset
   489
90ce3da70b43 Initial load
duke
parents:
diff changeset
   490
      } //end while
90ce3da70b43 Initial load
duke
parents:
diff changeset
   491
90ce3da70b43 Initial load
duke
parents:
diff changeset
   492
        crsSync.setShowDeleted(false);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   493
        return bool;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   494
   } // end next() method
90ce3da70b43 Initial load
duke
parents:
diff changeset
   495
90ce3da70b43 Initial load
duke
parents:
diff changeset
   496
90ce3da70b43 Initial load
duke
parents:
diff changeset
   497
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   498
     * Moves the cursor to the previous conflict row in this {@code SyncResolver} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   499
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   500
     * @return {@code true} if the cursor is on a valid row; {@code false}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   501
     *     if it is off the result set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   502
     * @throws SQLException if a database access error occurs or the result set type
90ce3da70b43 Initial load
duke
parents:
diff changeset
   503
     *     is TYPE_FORWARD_ONLY
90ce3da70b43 Initial load
duke
parents:
diff changeset
   504
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   505
   public boolean previousConflict() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   506
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   507
   }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   508
90ce3da70b43 Initial load
duke
parents:
diff changeset
   509
    //-----------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   510
    // Properties
90ce3da70b43 Initial load
duke
parents:
diff changeset
   511
    //-----------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   512
90ce3da70b43 Initial load
duke
parents:
diff changeset
   513
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   514
     * Sets this {@code CachedRowSetImpl} object's command property
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   515
     * to the given {@code String} object and clears the parameters,
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   516
     * if any, that were set for the previous command.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   517
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   518
     * The command property may not be needed
90ce3da70b43 Initial load
duke
parents:
diff changeset
   519
     * if the rowset is produced by a data source, such as a spreadsheet,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   520
     * that does not support commands. Thus, this property is optional
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   521
     * and may be {@code null}.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   522
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   523
     * @param cmd a {@code String} object containing an SQL query
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   524
     *            that will be set as the command; may be {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   525
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
   526
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   527
    public void setCommand(String cmd) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   528
         throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   529
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   530
90ce3da70b43 Initial load
duke
parents:
diff changeset
   531
90ce3da70b43 Initial load
duke
parents:
diff changeset
   532
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   533
    // Reading and writing data
90ce3da70b43 Initial load
duke
parents:
diff changeset
   534
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   535
90ce3da70b43 Initial load
duke
parents:
diff changeset
   536
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   537
     * Populates this {@code CachedRowSetImpl} object with data from
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   538
     * the given {@code ResultSet} object.  This
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   539
     * method is an alternative to the method {@code execute}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   540
     * for filling the rowset with data.  The method {@code populate}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   541
     * does not require that the properties needed by the method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   542
     * {@code execute}, such as the {@code command} property,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   543
     * be set. This is true because the method {@code populate}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   544
     * is given the {@code ResultSet} object from
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   545
     * which to get data and thus does not need to use the properties
90ce3da70b43 Initial load
duke
parents:
diff changeset
   546
     * required for setting up a connection and executing this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   547
     * {@code CachedRowSetImpl} object's command.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   548
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   549
     * After populating this rowset with data, the method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   550
     * {@code populate} sets the rowset's metadata and
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   551
     * then sends a {@code RowSetChangedEvent} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   552
     * to all registered listeners prior to returning.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   553
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   554
     * @param data the {@code ResultSet} object containing the data
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   555
     *             to be read into this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   556
     * @throws SQLException if an error occurs; or the max row setting is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   557
     *          violated while populating the RowSet
90ce3da70b43 Initial load
duke
parents:
diff changeset
   558
     * @see #execute
90ce3da70b43 Initial load
duke
parents:
diff changeset
   559
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   560
    public void populate(ResultSet data) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   561
         throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   562
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   563
90ce3da70b43 Initial load
duke
parents:
diff changeset
   564
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   565
     * Populates this {@code CachedRowSetImpl} object with data,
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   566
     * using the given connection to produce the result set from
90ce3da70b43 Initial load
duke
parents:
diff changeset
   567
     * which data will be read.  A second form of this method,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   568
     * which takes no arguments, uses the values from this rowset's
90ce3da70b43 Initial load
duke
parents:
diff changeset
   569
     * user, password, and either url or data source properties to
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   570
     * create a new database connection. The form of {@code execute}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   571
     * that is given a connection ignores these properties.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   572
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   573
     * @param conn A standard JDBC {@code Connection} object that this
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   574
     * {@code CachedRowSet} object can pass to a synchronization provider
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   575
     * to establish a connection to the data source
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   576
     * @throws SQLException if an invalid {@code Connection} is supplied
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   577
     *           or an error occurs in establishing the connection to the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   578
     *           data source
90ce3da70b43 Initial load
duke
parents:
diff changeset
   579
     * @see #populate
90ce3da70b43 Initial load
duke
parents:
diff changeset
   580
     * @see java.sql.Connection
90ce3da70b43 Initial load
duke
parents:
diff changeset
   581
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   582
    public void execute(Connection conn) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   583
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   584
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   585
90ce3da70b43 Initial load
duke
parents:
diff changeset
   586
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   587
     * Propagates all row update, insert, and delete changes to the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   588
     * underlying data source backing this {@code CachedRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   589
     * object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   590
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   591
     * <b>Note</b>In the reference implementation an optimistic concurrency implementation
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   592
     * is provided as a sample implementation of a the {@code SyncProvider}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   593
     * abstract class.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   594
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   595
     * This method fails if any of the updates cannot be propagated back
90ce3da70b43 Initial load
duke
parents:
diff changeset
   596
     * to the data source.  When it fails, the caller can assume that
90ce3da70b43 Initial load
duke
parents:
diff changeset
   597
     * none of the updates are reflected in the data source.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   598
     * When an exception is thrown, the current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   599
     * is set to the first "updated" row that resulted in an exception
90ce3da70b43 Initial load
duke
parents:
diff changeset
   600
     * unless the row that caused the exception is a "deleted" row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   601
     * In that case, when deleted rows are not shown, which is usually true,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   602
     * the current row is not affected.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   603
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   604
     * If no {@code SyncProvider} is configured, the reference implementation
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   605
     * leverages the {@code RIOptimisticProvider} available which provides the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   606
     * default and reference synchronization capabilities for disconnected
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   607
     * {@code RowSets}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   608
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   609
     * @throws SQLException if the cursor is on the insert row or the underlying
90ce3da70b43 Initial load
duke
parents:
diff changeset
   610
     *          reference synchronization provider fails to commit the updates
90ce3da70b43 Initial load
duke
parents:
diff changeset
   611
     *          to the datasource
90ce3da70b43 Initial load
duke
parents:
diff changeset
   612
     * @throws SyncProviderException if an internal error occurs within the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   613
     *          {@code SyncProvider} instance during either during the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   614
     *          process or at any time when the {@code SyncProvider}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   615
     *          instance touches the data source.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   616
     * @see #acceptChanges(java.sql.Connection)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   617
     * @see javax.sql.RowSetWriter
90ce3da70b43 Initial load
duke
parents:
diff changeset
   618
     * @see javax.sql.rowset.spi.SyncProvider
90ce3da70b43 Initial load
duke
parents:
diff changeset
   619
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   620
    public void acceptChanges() throws SyncProviderException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   621
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   622
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   623
90ce3da70b43 Initial load
duke
parents:
diff changeset
   624
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   625
     * Propagates all row update, insert, and delete changes to the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   626
     * data source backing this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   627
     * using the given {@code Connection} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   628
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   629
     * The reference implementation {@code RIOptimisticProvider}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   630
     * modifies its synchronization to a write back function given
90ce3da70b43 Initial load
duke
parents:
diff changeset
   631
     * the updated connection
90ce3da70b43 Initial load
duke
parents:
diff changeset
   632
     * The reference implementation modifies its synchronization behaviour
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   633
     * via the {@code SyncProvider} to ensure the synchronization
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   634
     * occurs according to the updated JDBC {@code Connection}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   635
     * properties.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   636
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   637
     * @param con a standard JDBC {@code Connection} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   638
     * @throws SQLException if the cursor is on the insert row or the underlying
90ce3da70b43 Initial load
duke
parents:
diff changeset
   639
     *                   synchronization provider fails to commit the updates
90ce3da70b43 Initial load
duke
parents:
diff changeset
   640
     *                   back to the data source
90ce3da70b43 Initial load
duke
parents:
diff changeset
   641
     * @see #acceptChanges
90ce3da70b43 Initial load
duke
parents:
diff changeset
   642
     * @see javax.sql.RowSetWriter
90ce3da70b43 Initial load
duke
parents:
diff changeset
   643
     * @see javax.sql.rowset.spi.SyncFactory
90ce3da70b43 Initial load
duke
parents:
diff changeset
   644
     * @see javax.sql.rowset.spi.SyncProvider
90ce3da70b43 Initial load
duke
parents:
diff changeset
   645
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   646
    public void acceptChanges(Connection con) throws SyncProviderException{
90ce3da70b43 Initial load
duke
parents:
diff changeset
   647
     throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   648
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   649
90ce3da70b43 Initial load
duke
parents:
diff changeset
   650
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   651
     * Restores this {@code CachedRowSetImpl} object to its original state,
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   652
     * that is, its state before the last set of changes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   653
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   654
     * Before returning, this method moves the cursor before the first row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   655
     * and sends a {@code rowSetChanged} event to all registered
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   656
     * listeners.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   657
     * @throws SQLException if an error is occurs rolling back the RowSet
90ce3da70b43 Initial load
duke
parents:
diff changeset
   658
     *           state to the definied original value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   659
     * @see javax.sql.RowSetListener#rowSetChanged
90ce3da70b43 Initial load
duke
parents:
diff changeset
   660
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   661
    public void restoreOriginal() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   662
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   663
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   664
90ce3da70b43 Initial load
duke
parents:
diff changeset
   665
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   666
     * Releases the current contents of this {@code CachedRowSetImpl}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   667
     * object and sends a {@code rowSetChanged} event object to all
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   668
     * registered listeners.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   669
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   670
     * @throws SQLException if an error occurs flushing the contents of
90ce3da70b43 Initial load
duke
parents:
diff changeset
   671
     *           RowSet.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   672
     * @see javax.sql.RowSetListener#rowSetChanged
90ce3da70b43 Initial load
duke
parents:
diff changeset
   673
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   674
    public void release() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   675
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   676
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   677
90ce3da70b43 Initial load
duke
parents:
diff changeset
   678
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   679
     * Cancels deletion of the current row and notifies listeners that
90ce3da70b43 Initial load
duke
parents:
diff changeset
   680
     * a row has changed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   681
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   682
     * Note:  This method can be ignored if deleted rows are not being shown,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   683
     * which is the normal case.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   684
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   685
     * @throws SQLException if the cursor is not on a valid row
90ce3da70b43 Initial load
duke
parents:
diff changeset
   686
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   687
    public void undoDelete() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   688
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   689
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   690
90ce3da70b43 Initial load
duke
parents:
diff changeset
   691
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   692
     * Immediately removes the current row from this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   693
     * {@code CachedRowSetImpl} object if the row has been inserted, and
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   694
     * also notifies listeners the a row has changed.  An exception is thrown
90ce3da70b43 Initial load
duke
parents:
diff changeset
   695
     * if the row is not a row that has been inserted or the cursor is before
90ce3da70b43 Initial load
duke
parents:
diff changeset
   696
     * the first row, after the last row, or on the insert row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   697
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   698
     * This operation cannot be undone.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   699
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   700
     * @throws SQLException if an error occurs,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   701
     *                         the cursor is not on a valid row,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   702
     *                         or the row has not been inserted
90ce3da70b43 Initial load
duke
parents:
diff changeset
   703
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   704
    public void undoInsert() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   705
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   706
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   707
90ce3da70b43 Initial load
duke
parents:
diff changeset
   708
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   709
     * Immediately reverses the last update operation if the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   710
     * row has been modified. This method can be
90ce3da70b43 Initial load
duke
parents:
diff changeset
   711
     * called to reverse updates on a all columns until all updates in a row have
90ce3da70b43 Initial load
duke
parents:
diff changeset
   712
     * been rolled back to their originating state since the last synchronization
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   713
     * ({@code acceptChanges}) or population. This method may also be called
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   714
     * while performing updates to the insert row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   715
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   716
     * {@code undoUpdate} may be called at any time during the life-time of a
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   717
     * rowset, however after a synchronization has occurs this method has no
90ce3da70b43 Initial load
duke
parents:
diff changeset
   718
     * affect until further modification to the RowSet data occurs.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   719
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   720
     * @throws SQLException if cursor is before the first row, after the last
90ce3da70b43 Initial load
duke
parents:
diff changeset
   721
     *     row in rowset.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   722
     * @see #undoDelete
90ce3da70b43 Initial load
duke
parents:
diff changeset
   723
     * @see #undoInsert
90ce3da70b43 Initial load
duke
parents:
diff changeset
   724
     * @see java.sql.ResultSet#cancelRowUpdates
90ce3da70b43 Initial load
duke
parents:
diff changeset
   725
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   726
    public void undoUpdate() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   727
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   728
90ce3da70b43 Initial load
duke
parents:
diff changeset
   729
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   730
90ce3da70b43 Initial load
duke
parents:
diff changeset
   731
    //--------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   732
    // Views
90ce3da70b43 Initial load
duke
parents:
diff changeset
   733
    //--------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   734
90ce3da70b43 Initial load
duke
parents:
diff changeset
   735
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   736
     * Returns a new {@code RowSet} object backed by the same data as
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   737
     * that of this {@code CachedRowSetImpl} object and sharing a set of cursors
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   738
     * with it. This allows cursors to interate over a shared set of rows, providing
90ce3da70b43 Initial load
duke
parents:
diff changeset
   739
     * multiple views of the underlying data.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   740
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   741
     * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   742
     * object and shares a set of cursors with it
90ce3da70b43 Initial load
duke
parents:
diff changeset
   743
     * @throws SQLException if an error occurs or cloning is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   744
     *                         not supported
90ce3da70b43 Initial load
duke
parents:
diff changeset
   745
     * @see javax.sql.RowSetEvent
90ce3da70b43 Initial load
duke
parents:
diff changeset
   746
     * @see javax.sql.RowSetListener
90ce3da70b43 Initial load
duke
parents:
diff changeset
   747
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   748
    public RowSet createShared() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   749
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   750
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   751
90ce3da70b43 Initial load
duke
parents:
diff changeset
   752
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   753
     * Returns a new {@code RowSet} object containing by the same data
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   754
     * as this {@code CachedRowSetImpl} object.  This method
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   755
     * differs from the method {@code createCopy} in that it throws a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   756
     * {@code CloneNotSupportedException} object instead of an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   757
     * {@code SQLException} object, as the method {@code createShared}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   758
     * does.  This {@code clone}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   759
     * method is called internally by the method {@code createShared},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   760
     * which catches the {@code CloneNotSupportedException} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   761
     * and in turn throws a new {@code SQLException} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   762
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   763
     * @return a copy of this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   764
     * @throws CloneNotSupportedException if an error occurs when
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   765
     * attempting to clone this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   766
     * @see #createShared
90ce3da70b43 Initial load
duke
parents:
diff changeset
   767
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   768
    protected Object clone() throws CloneNotSupportedException  {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   769
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   770
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   771
90ce3da70b43 Initial load
duke
parents:
diff changeset
   772
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   773
     * Creates a {@code RowSet} object that is a deep copy of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   774
     * this {@code CachedRowSetImpl} object's data, including
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   775
     * constraints.  Updates made
90ce3da70b43 Initial load
duke
parents:
diff changeset
   776
     * on a copy are not visible to the original rowset;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   777
     * a copy of a rowset is completely independent from the original.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   778
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   779
     * Making a copy saves the cost of creating an identical rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
   780
     * from first principles, which can be quite expensive.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   781
     * For example, it can eliminate the need to query a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   782
     * remote database server.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   783
     * @return a new {@code CachedRowSet} object that is a deep copy
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   784
     *           of this {@code CachedRowSet} object and is
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   785
     *           completely independent from this {@code CachedRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   786
     *           object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   787
     * @throws SQLException if an error occurs in generating the copy of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   788
     *           of the {@code CachedRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   789
     * @see #createShared
90ce3da70b43 Initial load
duke
parents:
diff changeset
   790
     * @see javax.sql.RowSetEvent
90ce3da70b43 Initial load
duke
parents:
diff changeset
   791
     * @see javax.sql.RowSetListener
90ce3da70b43 Initial load
duke
parents:
diff changeset
   792
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   793
    public CachedRowSet createCopy() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   794
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   795
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   796
90ce3da70b43 Initial load
duke
parents:
diff changeset
   797
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   798
     * Creates a {@code RowSet} object that is a copy of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   799
     * this {@code CachedRowSetImpl} object's table structure
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   800
     * and the constraints only.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   801
     * There will be no data in the object being returned.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   802
     * Updates made on a copy are not visible to the original rowset.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   803
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   804
     * This helps in getting the underlying XML schema which can
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   805
     * be used as the basis for populating a {@code WebRowSet}.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   806
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   807
     * @return a new {@code CachedRowSet} object that is a copy
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   808
     * of this {@code CachedRowSetImpl} object's schema and
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   809
     * retains all the constraints on the original rowset but contains
90ce3da70b43 Initial load
duke
parents:
diff changeset
   810
     * no data
90ce3da70b43 Initial load
duke
parents:
diff changeset
   811
     * @throws SQLException if an error occurs in generating the copy
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   812
     * of the {@code CachedRowSet} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   813
     * @see #createShared
90ce3da70b43 Initial load
duke
parents:
diff changeset
   814
     * @see #createCopy
90ce3da70b43 Initial load
duke
parents:
diff changeset
   815
     * @see #createCopyNoConstraints
90ce3da70b43 Initial load
duke
parents:
diff changeset
   816
     * @see javax.sql.RowSetEvent
90ce3da70b43 Initial load
duke
parents:
diff changeset
   817
     * @see javax.sql.RowSetListener
90ce3da70b43 Initial load
duke
parents:
diff changeset
   818
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   819
    public CachedRowSet createCopySchema() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   820
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   821
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   822
90ce3da70b43 Initial load
duke
parents:
diff changeset
   823
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   824
     * Creates a {@code CachedRowSet} object that is a copy of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   825
     * this {@code CachedRowSetImpl} object's data only.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   826
     * All constraints set in this object will not be there
90ce3da70b43 Initial load
duke
parents:
diff changeset
   827
     * in the returning object.  Updates made
90ce3da70b43 Initial load
duke
parents:
diff changeset
   828
     * on a copy are not visible to the original rowset.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   829
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   830
     * @return a new {@code CachedRowSet} object that is a deep copy
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   831
     * of this {@code CachedRowSetImpl} object and is
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   832
     * completely independent from this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   833
     * @throws SQLException if an error occurs in generating the copy of the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   834
     * of the {@code CachedRowSet}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   835
     * @see #createShared
90ce3da70b43 Initial load
duke
parents:
diff changeset
   836
     * @see #createCopy
90ce3da70b43 Initial load
duke
parents:
diff changeset
   837
     * @see #createCopySchema
90ce3da70b43 Initial load
duke
parents:
diff changeset
   838
     * @see javax.sql.RowSetEvent
90ce3da70b43 Initial load
duke
parents:
diff changeset
   839
     * @see javax.sql.RowSetListener
90ce3da70b43 Initial load
duke
parents:
diff changeset
   840
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   841
    public CachedRowSet createCopyNoConstraints() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   842
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   843
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   844
90ce3da70b43 Initial load
duke
parents:
diff changeset
   845
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   846
     * Converts this {@code CachedRowSetImpl} object to a collection
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   847
     * of tables. The sample implementation utilitizes the {@code TreeMap}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   848
     * collection type.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   849
     * This class guarantees that the map will be in ascending key order,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   850
     * sorted according to the natural order for the key's class.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   851
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   852
     * @return a {@code Collection} object consisting of tables,
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   853
     *         each of which is a copy of a row in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   854
     *         {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   855
     * @throws SQLException if an error occurs in generating the collection
90ce3da70b43 Initial load
duke
parents:
diff changeset
   856
     * @see #toCollection(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   857
     * @see #toCollection(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   858
     * @see java.util.TreeMap
90ce3da70b43 Initial load
duke
parents:
diff changeset
   859
     */
11129
f9ad1aadf3fa 7116445: Miscellaneous warnings in the JDBC/RowSet classes
lancea
parents: 6530
diff changeset
   860
    @SuppressWarnings("rawtypes")
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   861
    public Collection toCollection() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   862
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   863
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   864
90ce3da70b43 Initial load
duke
parents:
diff changeset
   865
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   866
     * Returns the specified column of this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   867
     * as a {@code Collection} object.  This method makes a copy of the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   868
     * column's data and utilitizes the {@code Vector} to establish the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   869
     * collection. The {@code Vector} class implements a growable array
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   870
     * objects allowing the individual components to be accessed using an
90ce3da70b43 Initial load
duke
parents:
diff changeset
   871
     * an integer index similar to that of an array.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   872
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   873
     * @return a {@code Collection} object that contains the value(s)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   874
     *         stored in the specified column of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   875
     *         {@code CachedRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   876
     *         object
90ce3da70b43 Initial load
duke
parents:
diff changeset
   877
     * @throws SQLException if an error occurs generated the collection; or
90ce3da70b43 Initial load
duke
parents:
diff changeset
   878
     *          an invalid column is provided.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   879
     * @see #toCollection()
90ce3da70b43 Initial load
duke
parents:
diff changeset
   880
     * @see #toCollection(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   881
     * @see java.util.Vector
90ce3da70b43 Initial load
duke
parents:
diff changeset
   882
     */
11129
f9ad1aadf3fa 7116445: Miscellaneous warnings in the JDBC/RowSet classes
lancea
parents: 6530
diff changeset
   883
    @SuppressWarnings("rawtypes")
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   884
    public Collection toCollection(int column) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   885
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   886
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   887
90ce3da70b43 Initial load
duke
parents:
diff changeset
   888
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   889
     * Returns the specified column of this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   890
     * as a {@code Collection} object.  This method makes a copy of the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   891
     * column's data and utilitizes the {@code Vector} to establish the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   892
     * collection. The {@code Vector} class implements a growable array
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   893
     * objects allowing the individual components to be accessed using an
90ce3da70b43 Initial load
duke
parents:
diff changeset
   894
     * an integer index similar to that of an array.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   895
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   896
     * @return a {@code Collection} object that contains the value(s)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   897
     *         stored in the specified column of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   898
     *         {@code CachedRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   899
     *         object
90ce3da70b43 Initial load
duke
parents:
diff changeset
   900
     * @throws SQLException if an error occurs generated the collection; or
90ce3da70b43 Initial load
duke
parents:
diff changeset
   901
     *          an invalid column is provided.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   902
     * @see #toCollection()
90ce3da70b43 Initial load
duke
parents:
diff changeset
   903
     * @see #toCollection(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   904
     * @see java.util.Vector
90ce3da70b43 Initial load
duke
parents:
diff changeset
   905
     */
11129
f9ad1aadf3fa 7116445: Miscellaneous warnings in the JDBC/RowSet classes
lancea
parents: 6530
diff changeset
   906
    @SuppressWarnings("rawtypes")
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   907
    public Collection toCollection(String column) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   908
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   909
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   910
90ce3da70b43 Initial load
duke
parents:
diff changeset
   911
    //--------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   912
    // Advanced features
90ce3da70b43 Initial load
duke
parents:
diff changeset
   913
    //--------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   914
90ce3da70b43 Initial load
duke
parents:
diff changeset
   915
90ce3da70b43 Initial load
duke
parents:
diff changeset
   916
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   917
     * Returns the {@code SyncProvider} implementation being used
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   918
     * with this {@code CachedRowSetImpl} implementation rowset.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   919
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   920
     * @return the SyncProvider used by the rowset. If not provider was
90ce3da70b43 Initial load
duke
parents:
diff changeset
   921
     *          set when the rowset was instantiated, the reference
90ce3da70b43 Initial load
duke
parents:
diff changeset
   922
     *          implementation (default) provider is returned.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   923
     * @throws SQLException if error occurs while return the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   924
     *          {@code SyncProvider} instance.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   925
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   926
    public SyncProvider getSyncProvider() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   927
      throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   928
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   929
90ce3da70b43 Initial load
duke
parents:
diff changeset
   930
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   931
     * Sets the active {@code SyncProvider} and attempts to load
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   932
     * load the new provider using the {@code SyncFactory} SPI.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   933
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   934
     * @throws SQLException if an error occurs while resetting the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   935
     *          {@code SyncProvider}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   936
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   937
    public void setSyncProvider(String providerStr) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   938
        throw new UnsupportedOperationException();
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
    // methods inherited from RowSet
90ce3da70b43 Initial load
duke
parents:
diff changeset
   944
    //-----------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   945
90ce3da70b43 Initial load
duke
parents:
diff changeset
   946
90ce3da70b43 Initial load
duke
parents:
diff changeset
   947
90ce3da70b43 Initial load
duke
parents:
diff changeset
   948
90ce3da70b43 Initial load
duke
parents:
diff changeset
   949
90ce3da70b43 Initial load
duke
parents:
diff changeset
   950
90ce3da70b43 Initial load
duke
parents:
diff changeset
   951
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   952
    // Reading and writing data
90ce3da70b43 Initial load
duke
parents:
diff changeset
   953
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   954
90ce3da70b43 Initial load
duke
parents:
diff changeset
   955
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   956
     * Populates this {@code CachedRowSetImpl} object with data.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   957
     * This form of the method uses the rowset's user, password, and url or
90ce3da70b43 Initial load
duke
parents:
diff changeset
   958
     * data source name properties to create a database
90ce3da70b43 Initial load
duke
parents:
diff changeset
   959
     * connection.  If properties that are needed
90ce3da70b43 Initial load
duke
parents:
diff changeset
   960
     * have not been set, this method will throw an exception.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   961
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   962
     * Another form of this method uses an existing JDBC {@code Connection}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   963
     * object instead of creating a new one; therefore, it ignores the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   964
     * properties used for establishing a new connection.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   965
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   966
     * The query specified by the command property is executed to create a
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   967
     * {@code ResultSet} object from which to retrieve data.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   968
     * The current contents of the rowset are discarded, and the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   969
     * rowset's metadata is also (re)set.  If there are outstanding updates,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   970
     * they are also ignored.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   971
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   972
     * The method {@code execute} closes any database connections that it
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   973
     * creates.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   974
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   975
     * @throws SQLException if an error occurs or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   976
     *                         necessary properties have not been set
90ce3da70b43 Initial load
duke
parents:
diff changeset
   977
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   978
    public void execute() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   979
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   980
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   981
90ce3da70b43 Initial load
duke
parents:
diff changeset
   982
90ce3da70b43 Initial load
duke
parents:
diff changeset
   983
90ce3da70b43 Initial load
duke
parents:
diff changeset
   984
    //-----------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   985
    // Methods inherited from ResultSet
90ce3da70b43 Initial load
duke
parents:
diff changeset
   986
    //-----------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
   987
90ce3da70b43 Initial load
duke
parents:
diff changeset
   988
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   989
     * Moves the cursor down one row from its current position and
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   990
     * returns {@code true} if the new cursor position is a
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   991
     * valid row.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   992
     * The cursor for a new {@code ResultSet} object is initially
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   993
     * positioned before the first row. The first call to the method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   994
     * {@code next} moves the cursor to the first row, making it
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   995
     * the current row; the second call makes the second row the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   996
     * current row, and so on.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   997
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   998
     * <P>If an input stream from the previous row is open, it is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
   999
     * implicitly closed. The {@code ResultSet} object's warning
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1000
     * chain is cleared when a new row is read.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1001
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1002
     * @return {@code true} if the new current row is valid;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1003
     *         {@code false} if there are no more rows
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1004
     * @throws SQLException if an error occurs or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1005
     *            the cursor is not positioned in the rowset, before
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1006
     *            the first row, or after the last row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1007
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1008
    public boolean next() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1009
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1010
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1011
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1012
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1013
     * Moves this {@code CachedRowSetImpl} object's cursor to the next
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1014
     * row and returns {@code true} if the cursor is still in the rowset;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1015
     * returns {@code false} if the cursor has moved to the position after
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1016
     * the last row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1017
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1018
     * This method handles the cases where the cursor moves to a row that
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1019
     * has been deleted.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1020
     * If this rowset shows deleted rows and the cursor moves to a row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1021
     * that has been deleted, this method moves the cursor to the next
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1022
     * row until the cursor is on a row that has not been deleted.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1023
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1024
     * The method {@code internalNext} is called by methods such as
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1025
     * {@code next}, {@code absolute}, and {@code relative},
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1026
     * and, as its name implies, is only called internally.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1027
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1028
     * This is a implementation only method and is not required as a standard
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1029
     * implementation of the {@code CachedRowSet} interface.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1030
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1031
     * @return {@code true} if the cursor is on a valid row in this
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1032
     *         rowset; {@code false} if it is after the last row
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1033
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1034
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1035
    protected boolean internalNext() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1036
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1037
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1038
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1039
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1040
     * Closes this {@code CachedRowSetImpl} objecy and releases any resources
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1041
     * it was using.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1042
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1043
     * @throws SQLException if an error occurs when releasing any resources in use
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1044
     * by this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1045
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1046
    public void close() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1047
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1048
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1049
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1050
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1051
     * Reports whether the last column read was SQL {@code NULL}.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1052
     * Note that you must first call the method {@code getXXX}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1053
     * on a column to try to read its value and then call the method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1054
     * {@code wasNull} to determine whether the value was
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1055
     * SQL {@code NULL}.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1056
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1057
     * @return {@code true} if the value in the last column read
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1058
     *         was SQL {@code NULL}; {@code false} otherwise
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1059
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1060
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1061
    public boolean wasNull() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1062
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1063
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1064
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1065
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1066
     * Returns the insert row or the current row of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1067
     * {@code CachedRowSetImpl}object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1068
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1069
     * @return the {@code Row} object on which this {@code CachedRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1070
     * objects's cursor is positioned
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1071
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1072
    protected BaseRow getCurrentRow() {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1073
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1074
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1075
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1076
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1077
     * Removes the row on which the cursor is positioned.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1078
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1079
     * This is a implementation only method and is not required as a standard
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1080
     * implementation of the {@code CachedRowSet} interface.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1081
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1082
     * @throws SQLException if the cursor is positioned on the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1083
     *            row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1084
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1085
    protected void removeCurrentRow() {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1086
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1087
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1088
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1089
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1090
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1091
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1092
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1093
     * {@code String} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1094
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1095
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1096
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1097
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1098
     * @return the column value; if the value is SQL {@code NULL}, the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1099
     *         result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1100
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1101
     * (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1102
     * insert row, or (3) the designated column does not store an
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1103
     * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1104
     * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} <b>{@code CHAR, VARCHAR}</b>
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1105
     * or {@code LONGVARCHAR} value. The bold SQL type designates the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1106
     * recommended return type.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1107
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1108
    public String getString(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1109
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1110
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1111
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1112
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1113
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1114
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1115
     * {@code boolean} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1116
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1117
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1118
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1119
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1120
     * @return the column value as a {@code boolean} in the Java progamming language;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1121
     *        if the value is SQL {@code NULL}, the result is {@code false}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1122
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1123
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1124
     *            insert row, or (3) the designated column does not store an
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1125
     *            SQL {@code BOOLEAN} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1126
     * @see #getBoolean(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1127
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1128
    public boolean getBoolean(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1129
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1130
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1131
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1132
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1133
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1134
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1135
     * {@code byte} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1136
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1137
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1138
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1139
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1140
     * @return the column value as a {@code byte} in the Java programming
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1141
     * language; if the value is SQL {@code NULL}, the result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1142
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1143
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1144
     *            insert row, or (3) the designated column does not store an
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1145
     *            SQL <b>{@code TINYINT}</b>, {@code SMALLINT, INTEGER,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1146
     *            BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1147
     *            VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1148
     *            designates the recommended return type.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1149
     * @see #getByte(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1150
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1151
    public byte getByte(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1152
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1153
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1154
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1155
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1156
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1157
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1158
     * {@code short} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1159
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1160
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1161
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1162
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1163
     * @return the column value; if the value is SQL {@code NULL}, the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1164
     *         result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1165
     * @throws SQLException if (1) the given column index is out of bounds,
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1166
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1167
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1168
     *         SQL {@code TINYINT}, <b>{@code SMALLINT}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1169
     *         {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1170
     *         DECIMAL, NUMERIC, BIT, CHAR, VARCHAR}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1171
     *         or {@code LONGVARCHAR} value. The bold SQL type
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1172
     *         designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1173
     * @see #getShort(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1174
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1175
    public short getShort(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1176
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1177
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1178
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1179
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1180
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1181
     * of this {@code CachedRowSetImpl} object as an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1182
     * {@code int} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1183
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1184
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1185
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1186
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1187
     * @return the column value; if the value is SQL {@code NULL}, the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1188
     *         result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1189
     * @throws SQLException if (1) the given column index is out of bounds,
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1190
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1191
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1192
     *         SQL {@code TINYINT, SMALLINT,} <b>{@code INTEGER}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1193
     *         {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1194
     *         NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1195
     *         The bold SQL type designates the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1196
     *         recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1197
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1198
    public int getInt(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1199
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1200
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1201
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1202
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1203
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1204
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1205
     * {@code long} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1206
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1207
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1208
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1209
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1210
     * @return the column value; if the value is SQL {@code NULL}, the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1211
     *         result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1212
     * @throws SQLException if (1) the given column index is out of bounds,
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1213
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1214
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1215
     *         SQL {@code TINYINT, SMALLINT, INTEGER,}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1216
     *         <b>{@code BIGINT}</b>, {@code REAL, FLOAT, DOUBLE,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1217
     *         DECIMAL, NUMERIC, BIT, CHAR, VARCHAR}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1218
     *         or {@code LONGVARCHAR} value. The bold SQL type
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1219
     * designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1220
     * @see #getLong(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1221
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1222
    public long getLong(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1223
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1224
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1225
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1226
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1227
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1228
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1229
     * {@code float} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1230
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1231
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1232
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1233
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1234
     * @return the column value; if the value is SQL {@code NULL}, the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1235
     *         result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1236
     * @throws SQLException if (1) the given column index is out of bounds,
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1237
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1238
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1239
     *         SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1240
     *         <b>{@code REAL}</b>, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1241
     *         BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1242
     *         The bold SQL type designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1243
     * @see #getFloat(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1244
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1245
    public float getFloat(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1246
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1247
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1248
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1249
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1250
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1251
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1252
     * {@code double} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1253
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1254
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1255
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1256
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1257
     * @return the column value; if the value is SQL {@code NULL}, the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1258
     *         result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1259
     * @throws SQLException if (1) the given column index is out of bounds,
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1260
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1261
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1262
     *         SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1263
     *         <b>{@code FLOAT, DOUBLE}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1264
     *         {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1265
     *         or {@code LONGVARCHAR} value. The bold SQL type
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1266
     *         designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1267
     * @see #getDouble(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1268
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1269
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1270
    public double getDouble(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1271
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1272
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1273
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1274
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1275
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1276
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1277
     * {@code java.math.BigDecimal} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1278
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1279
     * This method is deprecated; use the version of {@code getBigDecimal}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1280
     * that does not take a scale parameter and returns a value with full
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1281
     * precision.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1282
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1283
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1284
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1285
     *        and equal to or less than the number of columns in the rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1286
     * @param scale the number of digits to the right of the decimal point in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1287
     *        value returned
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1288
     * @return the column value with the specified number of digits to the right
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1289
     *         of the decimal point; if the value is SQL {@code NULL}, the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1290
     *         result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1291
     * @throws SQLException if the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1292
     *            the cursor is not on a valid row, or this method fails
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1293
     * @deprecated
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1294
     */
14171
94eb36844bd7 7197395: Add @Deprecated to all deprecated methods to eliminate compiler warnings in JDBC
lancea
parents: 11129
diff changeset
  1295
    @Deprecated
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1296
    public BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1297
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1298
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1299
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1300
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1301
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1302
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1303
     * {@code byte} array value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1304
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1305
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1306
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1307
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1308
     * @return the column value as a {@code byte} array in the Java programming
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1309
     * language; if the value is SQL {@code NULL}, the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1310
     * result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1311
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1312
     * @throws SQLException if (1) the given column index is out of bounds,
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1313
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1314
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1315
     *         SQL <b>{@code BINARY, VARBINARY}</b> or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1316
     *         {@code LONGVARBINARY} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1317
     *         The bold SQL type designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1318
     * @see #getBytes(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1319
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1320
    public byte[] getBytes(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1321
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1322
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1323
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1324
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1325
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1326
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1327
     * {@code java.sql.Date} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1328
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1329
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1330
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1331
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1332
     * @return the column value as a {@code java.sql.Data} object; if
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1333
     *        the value is SQL {@code NULL}, the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1334
     *        result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1335
     * @throws SQLException if the given column index is out of bounds,
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1336
     *         the cursor is not on a valid row, or this method fails
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1337
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1338
    public java.sql.Date getDate(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1339
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1340
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1341
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1342
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1343
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1344
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1345
     * {@code java.sql.Time} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1346
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1347
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1348
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1349
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1350
     * @return the column value; if the value is SQL {@code NULL}, the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1351
     *         result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1352
     * @throws SQLException if the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1353
     *         the cursor is not on a valid row, or this method fails
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1354
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1355
    public java.sql.Time getTime(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1356
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1357
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1358
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1359
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1360
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1361
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1362
     * {@code java.sql.Timestamp} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1363
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1364
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1365
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1366
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1367
     * @return the column value; if the value is SQL {@code NULL}, the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1368
     *         result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1369
     * @throws SQLException if the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1370
     *            the cursor is not on a valid row, or this method fails
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1371
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1372
    public java.sql.Timestamp getTimestamp(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1373
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1374
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1375
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1376
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1377
     * Retrieves the value of the designated column in the current row of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1378
     * {@code CachedRowSetImpl} object as a {@code java.io.InputStream}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1379
     * object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1380
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1381
     * A column value can be retrieved as a stream of ASCII characters
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1382
     * and then read in chunks from the stream.  This method is particularly
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1383
     * suitable for retrieving large {@code LONGVARCHAR} values.  The JDBC
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1384
     * driver will do any necessary conversion from the database format into ASCII.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1385
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1386
     * <P><B>Note:</B> All the data in the returned stream must be
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1387
     * read prior to getting the value of any other column. The next
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1388
     * call to a get method implicitly closes the stream. . Also, a
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1389
     * stream may return {@code 0} for {@code CachedRowSetImpl.available()}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1390
     * whether there is data available or not.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1391
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1392
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1393
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1394
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1395
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1396
     *         as a stream of one-byte ASCII characters.  If the value is SQL
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1397
     *         {@code NULL}, the result is {@code null}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1398
     * @throws SQLException if (1) the given column index is out of bounds,
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1399
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1400
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1401
     *         SQL {@code CHAR, VARCHAR}, <b>{@code LONGVARCHAR}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1402
     *         {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1403
     *         bold SQL type designates the recommended return types
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1404
     *         that this method is used to retrieve.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1405
     * @see #getAsciiStream(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1406
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1407
    public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1408
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1409
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1410
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1411
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1412
     * A column value can be retrieved as a stream of Unicode characters
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1413
     * and then read in chunks from the stream.  This method is particularly
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1414
     * suitable for retrieving large LONGVARCHAR values.  The JDBC driver will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1415
     * do any necessary conversion from the database format into Unicode.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1416
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1417
     * <P><B>Note:</B> All the data in the returned stream must be
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1418
     * read prior to getting the value of any other column. The next
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1419
     * call to a get method implicitly closes the stream. . Also, a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1420
     * stream may return 0 for available() whether there is data
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1421
     * available or not.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1422
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1423
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1424
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1425
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1426
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1427
     * as a stream of two byte Unicode characters.  If the value is SQL NULL
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1428
     * then the result is null.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1429
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1430
     * @deprecated
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1431
     */
14171
94eb36844bd7 7197395: Add @Deprecated to all deprecated methods to eliminate compiler warnings in JDBC
lancea
parents: 11129
diff changeset
  1432
    @Deprecated
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1433
    public java.io.InputStream getUnicodeStream(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1434
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1435
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1436
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1437
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1438
     * Retrieves the value of the designated column in the current row of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1439
     * {@code CachedRowSetImpl} object as a {@code java.io.InputStream}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1440
     * object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1441
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1442
     * A column value can be retrieved as a stream of uninterpreted bytes
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1443
     * and then read in chunks from the stream.  This method is particularly
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1444
     * suitable for retrieving large {@code LONGVARBINARY} values.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1445
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1446
     * <P><B>Note:</B> All the data in the returned stream must be
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1447
     * read prior to getting the value of any other column. The next
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1448
     * call to a get method implicitly closes the stream. Also, a
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1449
     * stream may return {@code 0} for
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1450
     * {@code CachedRowSetImpl.available()} whether there is data
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1451
     * available or not.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1452
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1453
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1454
     * is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1455
     * and equal to or less than the number of columns in the rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1456
     * @return a Java input stream that delivers the database column value
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1457
     * as a stream of uninterpreted bytes.  If the value is SQL {@code NULL}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1458
     * then the result is {@code null}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1459
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1460
     * (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1461
     * insert row, or (3) the designated column does not store an
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1462
     * SQL {@code BINARY, VARBINARY} or <b>{@code LONGVARBINARY}</b>.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1463
     * The bold type indicates the SQL type that this method is recommened
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1464
     * to retrieve.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1465
     * @see #getBinaryStream(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1466
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1467
    public java.io.InputStream getBinaryStream(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1468
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1469
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1470
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1471
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1472
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1473
    //======================================================================
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1474
    // Methods for accessing results by column name
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1475
    //======================================================================
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1476
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1477
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1478
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1479
     * of the current row as a {@code String} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1480
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1481
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1482
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1483
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1484
     *         the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1485
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1486
     *         a column in this rowset, (2) the cursor is not on one of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1487
     *         this rowset's rows or its insert row, or (3) the designated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1488
     *         column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1489
     *         BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1490
     *         <b>{@code CHAR, VARCHAR}</b> or {@code LONGVARCHAR} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1491
     *         The bold SQL type designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1492
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1493
    public String getString(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1494
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1495
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1496
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1497
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1498
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1499
     * of the current row as a {@code boolean} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1500
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1501
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1502
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1503
     * @return the column value as a {@code boolean} in the Java programming
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1504
     *        language; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1505
     *        the result is {@code false}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1506
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1507
     *         a column in this rowset, (2) the cursor is not on one of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1508
     *         this rowset's rows or its insert row, or (3) the designated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1509
     *         column does not store an SQL {@code BOOLEAN} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1510
     * @see #getBoolean(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1511
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1512
    public boolean getBoolean(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1513
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1514
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1515
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1516
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1517
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1518
     * of the current row as a {@code byte} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1519
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1520
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1521
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1522
     * @return the column value as a {@code byte} in the Java programming
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1523
     * language; if the value is SQL {@code NULL}, the result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1524
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1525
     *         a column in this rowset, (2) the cursor is not on one of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1526
     *         this rowset's rows or its insert row, or (3) the designated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1527
     *         column does not store an SQL <b>{@code TINYINT}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1528
     *         {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1529
     *         DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1530
     *         value. The bold type designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1531
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1532
    public byte getByte(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1533
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1534
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1535
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1536
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1537
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1538
     * of the current row as a {@code short} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1539
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1540
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1541
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1542
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1543
     *         the result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1544
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1545
     *         a column in this rowset, (2) the cursor is not on one of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1546
     *         this rowset's rows or its insert row, or (3) the designated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1547
     *         column does not store an SQL {@code TINYINT,}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1548
     *         <b>{@code SMALLINT}</b>, {@code INTEGER,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1549
     *         BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1550
     *         VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1551
     *         designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1552
     * @see #getShort(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1553
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1554
    public short getShort(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1555
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1556
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1557
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1558
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1559
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1560
     * of the current row as an {@code int} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1561
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1562
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1563
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1564
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1565
     *         the result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1566
     * @throws SQLException if (1) the given column name is not the name
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1567
     *         of a column in this rowset,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1568
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1569
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1570
     *         SQL {@code TINYINT, SMALLINT,} <b>{@code INTEGER}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1571
     *         {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1572
     *         NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1573
     *         The bold SQL type designates the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1574
     *         recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1575
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1576
    public int getInt(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1577
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1578
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1579
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1580
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1581
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1582
     * of the current row as a {@code long} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1583
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1584
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1585
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1586
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1587
     *         the result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1588
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1589
     *         a column in this rowset, (2) the cursor is not on one of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1590
     *         this rowset's rows or its insert row, or (3) the designated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1591
     *         column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1592
     *         <b>{@code BIGINT}</b>, {@code REAL, FLOAT, DOUBLE, DECIMAL,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1593
     *         NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1594
     *         The bold SQL type designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1595
     * @see #getLong(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1596
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1597
    public long getLong(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1598
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1599
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1600
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1601
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1602
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1603
     * of the current row as a {@code float} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1604
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1605
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1606
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1607
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1608
     *         the result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1609
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1610
     *         a column in this rowset, (2) the cursor is not on one of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1611
     *         this rowset's rows or its insert row, or (3) the designated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1612
     *         column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1613
     *         BIGINT,} <b>{@code REAL}</b>, {@code FLOAT, DOUBLE, DECIMAL,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1614
     *         NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1615
     *         The bold SQL type designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1616
     * @see #getFloat(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1617
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1618
    public float getFloat(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1619
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1620
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1621
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1622
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1623
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1624
     * of the current row of this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1625
     * as a {@code double} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1626
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1627
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1628
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1629
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1630
     *         the result is {@code 0}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1631
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1632
     *         a column in this rowset, (2) the cursor is not on one of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1633
     *         this rowset's rows or its insert row, or (3) the designated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1634
     *         column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1635
     *         BIGINT, REAL,} <b>{@code FLOAT, DOUBLE}</b>, {@code DECIMAL,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1636
     *         NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1637
     *         The bold SQL type designates the recommended return types.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1638
     * @see #getDouble(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1639
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1640
    public double getDouble(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1641
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1642
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1643
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1644
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1645
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1646
     * of the current row as a {@code java.math.BigDecimal} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1647
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1648
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1649
     *        a column in this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1650
     * @param scale the number of digits to the right of the decimal point
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1651
     * @return a java.math.BugDecimal object with <i>{@code scale}</i>
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1652
     *         number of digits to the right of the decimal point.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1653
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1654
     *         a column in this rowset, (2) the cursor is not on one of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1655
     *         this rowset's rows or its insert row, or (3) the designated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1656
     *         column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1657
     *         BIGINT, REAL, FLOAT, DOUBLE,} <b>{@code DECIMAL, NUMERIC}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1658
     *         {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1659
     *         The bold SQL type designates the recommended return type
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1660
     *         that this method is used to retrieve.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1661
     * @deprecated Use the {@code getBigDecimal(String columnName)}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1662
     *             method instead
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1663
     */
14171
94eb36844bd7 7197395: Add @Deprecated to all deprecated methods to eliminate compiler warnings in JDBC
lancea
parents: 11129
diff changeset
  1664
    @Deprecated
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1665
    public BigDecimal getBigDecimal(String columnName, int scale) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1666
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1667
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1668
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1669
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1670
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1671
     * of the current row as a {@code byte} array.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1672
     * The bytes represent the raw values returned by the driver.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1673
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1674
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1675
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1676
     * @return the column value as a {@code byte} array in the Java programming
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1677
     *         language; if the value is SQL {@code NULL}, the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1678
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1679
     *         a column in this rowset, (2) the cursor is not on one of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1680
     *         this rowset's rows or its insert row, or (3) the designated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1681
     *         column does not store an SQL <b>{@code BINARY, VARBINARY}</b>
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1682
     *         or {@code LONGVARBINARY} values.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1683
     *         The bold SQL type designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1684
     * @see #getBytes(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1685
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1686
    public byte[] getBytes(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1687
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1688
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1689
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1690
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1691
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1692
     * of the current row as a {@code java.sql.Date} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1693
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1694
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1695
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1696
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1697
     *         the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1698
     * @throws SQLException if (1) the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1699
     *            a column in this rowset, (2) the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1700
     *            this rowset's rows or its insert row, or (3) the designated
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1701
     *            column does not store an SQL {@code DATE} or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1702
     *            {@code TIMESTAMP} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1703
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1704
    public java.sql.Date getDate(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1705
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1706
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1707
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1708
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1709
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1710
     * of the current row as a {@code java.sql.Time} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1711
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1712
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1713
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1714
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1715
     *         the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1716
     * @throws SQLException if the given column name does not match one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1717
     *            this rowset's column names or the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1718
     *            this rowset's rows or its insert row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1719
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1720
    public java.sql.Time getTime(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1721
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1722
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1723
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1724
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1725
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1726
     * of the current row as a {@code java.sql.Timestamp} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1727
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1728
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1729
     *        a column in this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1730
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1731
     *         the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1732
     * @throws SQLException if the given column name does not match one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1733
     *            this rowset's column names or the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1734
     *            this rowset's rows or its insert row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1735
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1736
    public java.sql.Timestamp getTimestamp(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1737
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1738
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1739
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1740
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1741
     * Retrieves the value of the designated column in the current row of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1742
     * {@code CachedRowSetImpl} object as a {@code java.io.InputStream}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1743
     * object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1744
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1745
     * A column value can be retrieved as a stream of ASCII characters
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1746
     * and then read in chunks from the stream. This method is particularly
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1747
     * suitable for retrieving large {@code LONGVARCHAR} values. The
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1748
     * {@code SyncProvider} will rely on the JDBC driver to do any necessary
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1749
     * conversion from the database format into ASCII format.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1750
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1751
     * <P><B>Note:</B> All the data in the returned stream must
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1752
     * be read prior to getting the value of any other column. The
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1753
     * next call to a {@code getXXX} method implicitly closes the stream.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1754
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1755
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1756
     *        a column in this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1757
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1758
     *         as a stream of one-byte ASCII characters.  If the value is SQL
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1759
     *         {@code NULL}, the result is {@code null}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1760
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1761
     *         a column in this rowset
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1762
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1763
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1764
     *         SQL {@code CHAR, VARCHAR}, <b>{@code LONGVARCHAR}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1765
     *         {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1766
     *         bold SQL type designates the recommended return types
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1767
     *         that this method is used to retrieve.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1768
     * @see #getAsciiStream(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1769
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1770
    public java.io.InputStream getAsciiStream(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1771
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1772
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1773
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1774
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1775
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1776
     * A column value can be retrieved as a stream of Unicode characters
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1777
     * and then read in chunks from the stream.  This method is particularly
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1778
     * suitable for retrieving large {@code LONGVARCHAR} values.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1779
     * The JDBC driver will do any necessary conversion from the database
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1780
     * format into Unicode.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1781
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1782
     * <P><B>Note:</B> All the data in the returned stream must
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1783
     * be read prior to getting the value of any other column. The
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1784
     * next call to a {@code getXXX} method implicitly closes the stream.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1785
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1786
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1787
     *        a column in this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1788
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1789
     *         as a stream of two-byte Unicode characters.  If the value is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1790
     *         SQL {@code NULL}, the result is {@code null}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1791
     * @throws SQLException if the given column name does not match one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1792
     *            this rowset's column names or the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1793
     *            this rowset's rows or its insert row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1794
     * @deprecated use the method {@code getCharacterStream} instead
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1795
     */
14171
94eb36844bd7 7197395: Add @Deprecated to all deprecated methods to eliminate compiler warnings in JDBC
lancea
parents: 11129
diff changeset
  1796
    @Deprecated
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1797
    public java.io.InputStream getUnicodeStream(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1798
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1799
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1800
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1801
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1802
     * Retrieves the value of the designated column in the current row of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1803
     * {@code CachedRowSetImpl} object as a {@code java.io.InputStream}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1804
     * object.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1805
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1806
     * A column value can be retrieved as a stream of uninterpreted bytes
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1807
     * and then read in chunks from the stream.  This method is particularly
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1808
     * suitable for retrieving large {@code LONGVARBINARY} values.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1809
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1810
     * <P><B>Note:</B> All the data in the returned stream must be
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1811
     * read prior to getting the value of any other column. The next
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1812
     * call to a get method implicitly closes the stream. Also, a
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1813
     * stream may return {@code 0} for {@code CachedRowSetImpl.available()}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1814
     * whether there is data available or not.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1815
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1816
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1817
     *        a column in this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1818
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1819
     *         as a stream of uninterpreted bytes.  If the value is SQL
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1820
     *         {@code NULL}, the result is {@code null}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1821
     * @throws SQLException if (1) the given column name is unknown,
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1822
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1823
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1824
     *         SQL {@code BINARY, VARBINARY} or <b>{@code LONGVARBINARY}</b>
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1825
     *         The bold type indicates the SQL type that this method is recommened
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1826
     *         to retrieve.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1827
     * @see #getBinaryStream(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1828
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1829
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1830
    public java.io.InputStream getBinaryStream(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1831
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1832
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1833
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1834
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1835
    //=====================================================================
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1836
    // Advanced features:
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1837
    //=====================================================================
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1838
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1839
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1840
     * The first warning reported by calls on this {@code CachedRowSetImpl}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1841
     * object is returned. Subsequent {@code CachedRowSetImpl} warnings will
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1842
     * be chained to this {@code SQLWarning}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1843
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1844
     * <P>The warning chain is automatically cleared each time a new
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1845
     * row is read.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1846
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1847
     * <P><B>Note:</B> This warning chain only covers warnings caused
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1848
     * by {@code ResultSet} methods.  Any warning caused by statement
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1849
     * methods (such as reading OUT parameters) will be chained on the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1850
     * {@code Statement} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1851
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1852
     * @return the first SQLWarning or null
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1853
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1854
    public SQLWarning getWarnings() {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1855
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1856
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1857
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1858
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1859
     * Clears all the warnings reporeted for the {@code CachedRowSetImpl}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1860
     * object. After a call to this method, the {@code getWarnings} method
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1861
     * returns {@code null} until a new warning is reported for this
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1862
     * {@code CachedRowSetImpl} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1863
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1864
    public void clearWarnings() {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1865
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1866
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1867
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1868
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1869
     * Retrieves the name of the SQL cursor used by this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1870
     * {@code CachedRowSetImpl} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1871
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1872
     * <P>In SQL, a result table is retrieved through a cursor that is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1873
     * named. The current row of a {@code ResultSet} can be updated or deleted
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1874
     * using a positioned update/delete statement that references the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1875
     * cursor name. To ensure that the cursor has the proper isolation
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1876
     * level to support an update operation, the cursor's {@code SELECT}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1877
     * statement should be of the form {@code select for update}.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1878
     * If the {@code for update} clause
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1879
     * is omitted, positioned updates may fail.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1880
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1881
     * <P>JDBC supports this SQL feature by providing the name of the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1882
     * SQL cursor used by a {@code ResultSet} object. The current row
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1883
     * of a result set is also the current row of this SQL cursor.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1884
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1885
     * <P><B>Note:</B> If positioned updates are not supported, an
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1886
     * {@code SQLException} is thrown.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1887
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1888
     * @return the SQL cursor name for this {@code CachedRowSetImpl} object's
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1889
     *         cursor
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1890
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1891
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1892
    public String getCursorName() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1893
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1894
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1895
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1896
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1897
     * Retrieves a {@code ResultSetMetaData} object instance that
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1898
     * contains information about the {@code CachedRowSet} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1899
     * However, applications should cast the returned object to a
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1900
     * {@code RowSetMetaData} interface implementation. In the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1901
     * reference implementation, this cast can be done on the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1902
     * {@code RowSetMetaDataImpl} class.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1903
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1904
     * For example:
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1905
     * <pre>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1906
     * CachedRowSet crs = new CachedRowSetImpl();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1907
     * RowSetMetaDataImpl metaData =
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1908
     *     (RowSetMetaDataImpl)crs.getMetaData();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1909
     * // Set the number of columns in the RowSet object for
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1910
     * // which this RowSetMetaDataImpl object was created to the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1911
     * // given number.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1912
     * metaData.setColumnCount(3);
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1913
     * crs.setMetaData(metaData);
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1914
     * </pre>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1915
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1916
     * @return the {@code ResultSetMetaData} object that describes this
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1917
     *         {@code CachedRowSetImpl} object's columns
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1918
     * @throws SQLException if an error occurs in generating the RowSet
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1919
     * meta data; or if the {@code CachedRowSetImpl} is empty.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1920
     * @see javax.sql.RowSetMetaData
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1921
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1922
    public ResultSetMetaData getMetaData() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1923
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1924
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1925
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1926
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1927
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1928
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1929
     * of this {@code CachedRowSetImpl} object as an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1930
     * {@code Object} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1931
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1932
     * The type of the {@code Object} will be the default
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1933
     * Java object type corresponding to the column's SQL type,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1934
     * following the mapping for built-in types specified in the JDBC 3.0
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1935
     * specification.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1936
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1937
     * This method may also be used to read datatabase-specific
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1938
     * abstract data types.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1939
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1940
     * This implementation of the method {@code getObject} extends its
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1941
     * behavior so that it gets the attributes of an SQL structured type
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1942
     * as an array of {@code Object} values.  This method also custom
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1943
     * maps SQL user-defined types to classes in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1944
     * When the specified column contains
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1945
     * a structured or distinct value, the behavior of this method is as
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1946
     * if it were a call to the method {@code getObject(columnIndex,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1947
     * this.getStatement().getConnection().getTypeMap())}.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1948
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1949
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1950
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1951
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1952
     * @return a {@code java.lang.Object} holding the column value;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1953
     *         if the value is SQL {@code NULL}, the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1954
     * @throws SQLException if the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1955
     *            the cursor is not on a valid row, or there is a problem getting
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1956
     *            the {@code Class} object for a custom mapping
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1957
     * @see #getObject(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1958
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1959
    public Object getObject(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1960
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1961
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1962
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1963
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1964
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1965
     * of this {@code CachedRowSetImpl} object as an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1966
     * {@code Object} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1967
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1968
     * The type of the {@code Object} will be the default
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1969
     * Java object type corresponding to the column's SQL type,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1970
     * following the mapping for built-in types specified in the JDBC 3.0
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1971
     * specification.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1972
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1973
     * This method may also be used to read datatabase-specific
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1974
     * abstract data types.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1975
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1976
     * This implementation of the method {@code getObject} extends its
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1977
     * behavior so that it gets the attributes of an SQL structured type
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1978
     * as an array of {@code Object} values.  This method also custom
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1979
     * maps SQL user-defined types to classes
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1980
     * in the Java programming language. When the specified column contains
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1981
     * a structured or distinct value, the behavior of this method is as
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1982
     * if it were a call to the method {@code getObject(columnIndex,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1983
     * this.getStatement().getConnection().getTypeMap())}.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1984
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1985
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1986
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1987
     * @return a {@code java.lang.Object} holding the column value;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1988
     *         if the value is SQL {@code NULL}, the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1989
     * @throws SQLException if (1) the given column name does not match one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1990
     *            this rowset's column names, (2) the cursor is not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1991
     *            on a valid row, or (3) there is a problem getting
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  1992
     *            the {@code Class} object for a custom mapping
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1993
     * @see #getObject(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1994
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1995
    public Object getObject(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1996
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1997
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1998
90ce3da70b43 Initial load
duke
parents:
diff changeset
  1999
    //----------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2000
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2001
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2002
     * Maps the given column name for one of this {@code CachedRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2003
     * object's columns to its column number.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2004
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2005
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2006
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2007
     * @return the column index of the given column name
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2008
     * @throws SQLException if the given column name does not match one
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2009
     *            of this rowset's column names
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2010
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2011
    public int findColumn(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2012
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2013
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2014
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2015
    //--------------------------JDBC 2.0-----------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2016
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2017
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2018
    // Getter's and Setter's
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2019
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2020
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2021
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2022
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2023
     * of the current row as a {@code java.io.Reader} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2024
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2025
     * <P><B>Note:</B> All the data in the returned stream must
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2026
     * be read prior to getting the value of any other column. The
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2027
     * next call to a {@code getXXX} method implicitly closes the stream.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2028
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2029
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2030
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2031
     *        and equal to or less than the number of columns in the rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2032
     * @return a Java character stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2033
     * as a stream of two-byte unicode characters in a
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2034
     * {@code java.io.Reader} object.  If the value is
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2035
     * SQL {@code NULL}, the result is {@code null}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2036
     * @throws SQLException if (1) the given column index is out of bounds,
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2037
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2038
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2039
     *         SQL {@code CHAR, VARCHAR,} <b>{@code LONGVARCHAR}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2040
     *         {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2041
     *         The bold SQL type designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2042
     * @see #getCharacterStream(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2043
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2044
    public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2045
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2046
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2047
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2048
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2049
     * Retrieves the value stored in the designated column
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2050
     * of the current row as a {@code java.io.Reader} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2051
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2052
     * <P><B>Note:</B> All the data in the returned stream must
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2053
     * be read prior to getting the value of any other column. The
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2054
     * next call to a {@code getXXX} method implicitly closes the stream.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2055
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2056
     * @param columnName a {@code String} object giving the SQL name of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2057
     *        a column in this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2058
     * @return a Java input stream that delivers the database column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2059
     *         as a stream of two-byte Unicode characters.  If the value is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2060
     *         SQL {@code NULL}, the result is {@code null}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2061
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2062
     *         a column in this rowset, (2) the cursor is not on one of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2063
     *         this rowset's rows or its insert row, or (3) the designated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2064
     *         column does not store an SQL {@code CHAR, VARCHAR,}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2065
     *         <b>{@code LONGVARCHAR}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2066
     *         {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2067
     *         The bold SQL type designates the recommended return type.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2068
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2069
    public java.io.Reader getCharacterStream(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2070
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2071
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2072
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2073
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2074
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2075
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2076
     * {@code java.math.BigDecimal} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2077
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2078
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2079
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2080
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2081
     * @return a {@code java.math.BigDecimal} value with full precision;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2082
     *         if the value is SQL {@code NULL}, the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2083
     * @throws SQLException if (1) the given column index is out of bounds,
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2084
     *         (2) the cursor is not on one of this rowset's rows or its
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2085
     *         insert row, or (3) the designated column does not store an
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2086
     *         SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2087
     *         FLOAT, DOUBLE,} <b>{@code DECIMAL, NUMERIC}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2088
     *         {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2089
     *         The bold SQL type designates the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2090
     *         recommended return types that this method is used to retrieve.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2091
     * @see #getBigDecimal(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2092
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2093
    public BigDecimal getBigDecimal(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2094
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2095
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2096
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2097
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2098
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2099
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2100
     * {@code java.math.BigDecimal} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2101
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2102
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2103
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2104
     * @return a {@code java.math.BigDecimal} value with full precision;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2105
     *         if the value is SQL {@code NULL}, the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2106
     * @throws SQLException if (1) the given column name is not the name of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2107
     *         a column in this rowset, (2) the cursor is not on one of
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2108
     *         this rowset's rows or its insert row, or (3) the designated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2109
     *         column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2110
     *         BIGINT, REAL, FLOAT, DOUBLE,} <b>{@code DECIMAL, NUMERIC}</b>,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2111
     *         {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2112
     *         The bold SQL type designates the recommended return type
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2113
     *         that this method is used to retrieve.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2114
     * @see #getBigDecimal(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2115
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2116
    public BigDecimal getBigDecimal(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2117
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2118
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2119
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2120
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2121
    // Traversal/Positioning
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2122
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2123
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2124
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2125
     * Returns the number of rows in this {@code CachedRowSetImpl} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2126
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2127
     * @return number of rows in the rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2128
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2129
    public int size() {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2130
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2131
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2132
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2133
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2134
     * Indicates whether the cursor is before the first row in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2135
     * {@code CachedRowSetImpl} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2136
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2137
     * @return {@code true} if the cursor is before the first row;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2138
     *         {@code false} otherwise or if the rowset contains no rows
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2139
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2140
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2141
    public boolean isBeforeFirst() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2142
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2143
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2144
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2145
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2146
     * Indicates whether the cursor is after the last row in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2147
     * {@code CachedRowSetImpl} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2148
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2149
     * @return {@code true} if the cursor is after the last row;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2150
     *         {@code false} otherwise or if the rowset contains no rows
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2151
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2152
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2153
    public boolean isAfterLast() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2154
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2155
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2156
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2157
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2158
     * Indicates whether the cursor is on the first row in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2159
     * {@code CachedRowSetImpl} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2160
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2161
     * @return {@code true} if the cursor is on the first row;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2162
     *         {@code false} otherwise or if the rowset contains no rows
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2163
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2164
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2165
    public boolean isFirst() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2166
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2167
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2168
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2169
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2170
     * Indicates whether the cursor is on the last row in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2171
     * {@code CachedRowSetImpl} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2172
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2173
     * Note: Calling the method {@code isLast} may be expensive
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2174
     * because the JDBC driver might need to fetch ahead one row in order
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2175
     * to determine whether the current row is the last row in this rowset.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2176
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2177
     * @return {@code true} if the cursor is on the last row;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2178
     *         {@code false} otherwise or if this rowset contains no rows
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2179
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2180
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2181
    public boolean isLast() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2182
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2183
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2184
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2185
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2186
     * Moves this {@code CachedRowSetImpl} object's cursor to the front of
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2187
     * the rowset, just before the first row. This method has no effect if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2188
     * this rowset contains no rows.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2189
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2190
     * @throws SQLException if an error occurs or the type of this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2191
     *            is {@code ResultSet.TYPE_FORWARD_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2192
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2193
    public void beforeFirst() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2194
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2195
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2196
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2197
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2198
     * Moves this {@code CachedRowSetImpl} object's cursor to the end of
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2199
     * the rowset, just after the last row. This method has no effect if
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2200
     * this rowset contains no rows.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2201
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2202
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2203
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2204
    public void afterLast() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2205
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2206
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2207
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2208
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2209
     * Moves this {@code CachedRowSetImpl} object's cursor to the first row
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2210
     * and returns {@code true} if the operation was successful.  This
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2211
     * method also notifies registered listeners that the cursor has moved.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2212
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2213
     * @return {@code true} if the cursor is on a valid row;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2214
     *         {@code false} otherwise or if there are no rows in this
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2215
     *         {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2216
     * @throws SQLException if the type of this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2217
     *            is {@code ResultSet.TYPE_FORWARD_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2218
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2219
    public boolean first() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2220
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2221
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2222
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2223
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2224
     * Moves this {@code CachedRowSetImpl} object's cursor to the first
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2225
     * row and returns {@code true} if the operation is successful.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2226
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2227
     * This method is called internally by the methods {@code first},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2228
     * {@code isFirst}, and {@code absolute}.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2229
     * It in turn calls the method {@code internalNext} in order to
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2230
     * handle the case where the first row is a deleted row that is not visible.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2231
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2232
     * This is a implementation only method and is not required as a standard
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2233
     * implementation of the {@code CachedRowSet} interface.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2234
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2235
     * @return {@code true} if the cursor moved to the first row;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2236
     *         {@code false} otherwise
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2237
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2238
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2239
    protected boolean internalFirst() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2240
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2241
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2242
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2243
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2244
     * Moves this {@code CachedRowSetImpl} object's cursor to the last row
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2245
     * and returns {@code true} if the operation was successful.  This
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2246
     * method also notifies registered listeners that the cursor has moved.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2247
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2248
     * @return {@code true} if the cursor is on a valid row;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2249
     *         {@code false} otherwise or if there are no rows in this
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2250
     *         {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2251
     * @throws SQLException if the type of this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2252
     *            is {@code ResultSet.TYPE_FORWARD_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2253
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2254
    public boolean last() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2255
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2256
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2257
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2258
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2259
     * Moves this {@code CachedRowSetImpl} object's cursor to the last
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2260
     * row and returns {@code true} if the operation is successful.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2261
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2262
     * This method is called internally by the method {@code last}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2263
     * when rows have been deleted and the deletions are not visible.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2264
     * The method {@code internalLast} handles the case where the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2265
     * last row is a deleted row that is not visible by in turn calling
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2266
     * the method {@code internalPrevious}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2267
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2268
     * This is a implementation only method and is not required as a standard
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2269
     * implementation of the {@code CachedRowSet} interface.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2270
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2271
     * @return {@code true} if the cursor moved to the last row;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2272
     *         {@code false} otherwise
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2273
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2274
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2275
    protected boolean internalLast() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2276
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2277
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2278
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2279
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2280
     * Returns the number of the current row in this {@code CachedRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2281
     * object. The first row is number 1, the second number 2, and so on.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2282
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2283
     * @return the number of the current row;  {@code 0} if there is no
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2284
     *         current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2285
     * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2286
     *         is empty
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2287
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2288
    public int getRow() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2289
        return crsSync.getRow();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2290
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2291
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2292
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2293
     * Moves this {@code CachedRowSetImpl} object's cursor to the row number
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2294
     * specified.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2295
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2296
     * <p>If the number is positive, the cursor moves to an absolute row with
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2297
     * respect to the beginning of the rowset.  The first row is row 1, the second
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2298
     * is row 2, and so on.  For example, the following command, in which
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2299
     * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2300
     * to the fourth row, starting from the beginning of the rowset.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2301
     * <PRE>{@code
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2302
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2303
     *    crs.absolute(4);
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2304
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2305
     * }</PRE>
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2306
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2307
     * If the number is negative, the cursor moves to an absolute row position
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2308
     * with respect to the end of the rowset.  For example, calling
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2309
     * {@code absolute(-1)} positions the cursor on the last row,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2310
     * {@code absolute(-2)} moves it on the next-to-last row, and so on.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2311
     * If the {@code CachedRowSetImpl} object {@code crs} has five rows,
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2312
     * the following command moves the cursor to the fourth-to-last row, which
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2313
     * in the case of a  rowset with five rows, is also the second row, counting
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2314
     * from the beginning.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2315
     * <PRE>{@code
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2316
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2317
     *    crs.absolute(-4);
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2318
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2319
     * }</PRE>
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2320
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2321
     * If the number specified is larger than the number of rows, the cursor
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2322
     * will move to the position after the last row. If the number specified
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2323
     * would move the cursor one or more rows before the first row, the cursor
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2324
     * moves to the position before the first row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2325
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2326
     * Note: Calling {@code absolute(1)} is the same as calling the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2327
     * method {@code first()}.  Calling {@code absolute(-1)} is the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2328
     * same as calling {@code last()}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2329
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2330
     * @param row a positive number to indicate the row, starting row numbering from
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2331
     *        the first row, which is {@code 1}; a negative number to indicate
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2332
     *        the row, starting row numbering from the last row, which is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2333
     *        {@code -1}; it must not be {@code 0}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2334
     * @return {@code true} if the cursor is on the rowset; {@code false}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2335
     *         otherwise
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2336
     * @throws SQLException if the given cursor position is {@code 0} or the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2337
     *            type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2338
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2339
    public boolean absolute( int row ) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2340
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2341
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2342
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2343
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2344
     * Moves the cursor the specified number of rows from the current
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2345
     * position, with a positive number moving it forward and a
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2346
     * negative number moving it backward.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2347
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2348
     * If the number is positive, the cursor moves the specified number of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2349
     * rows toward the end of the rowset, starting at the current row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2350
     * For example, the following command, in which
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2351
     * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows,
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2352
     * moves the cursor forward four rows from the current row.  If the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2353
     * current row is 50, the cursor would move to row 54.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2354
     * <PRE>{@code
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2355
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2356
     *    crs.relative(4);
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2357
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2358
     * }</PRE>
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2359
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2360
     * If the number is negative, the cursor moves back toward the beginning
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2361
     * the specified number of rows, starting at the current row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2362
     * For example, calling the method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2363
     * {@code absolute(-1)} positions the cursor on the last row,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2364
     * {@code absolute(-2)} moves it on the next-to-last row, and so on.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2365
     * If the {@code CachedRowSetImpl} object {@code crs} has five rows,
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2366
     * the following command moves the cursor to the fourth-to-last row, which
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2367
     * in the case of a  rowset with five rows, is also the second row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2368
     * from the beginning.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2369
     * <PRE>{@code
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2370
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2371
     *    crs.absolute(-4);
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2372
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2373
     * }</PRE>
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2374
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2375
     * If the number specified is larger than the number of rows, the cursor
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2376
     * will move to the position after the last row. If the number specified
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2377
     * would move the cursor one or more rows before the first row, the cursor
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2378
     * moves to the position before the first row. In both cases, this method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2379
     * throws an {@code SQLException}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2380
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2381
     * Note: Calling {@code absolute(1)} is the same as calling the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2382
     * method {@code first()}.  Calling {@code absolute(-1)} is the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2383
     * same as calling {@code last()}.  Calling {@code relative(0)}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2384
     * is valid, but it does not change the cursor position.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2385
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2386
     * @param rows an {@code int} indicating the number of rows to move
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2387
     *             the cursor, starting at the current row; a positive number
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2388
     *             moves the cursor forward; a negative number moves the cursor
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2389
     *             backward; must not move the cursor past the valid
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2390
     *             rows
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2391
     * @return {@code true} if the cursor is on a row in this
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2392
     *         {@code CachedRowSetImpl} object; {@code false}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2393
     *         otherwise
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2394
     * @throws SQLException if there are no rows in this rowset, the cursor is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2395
     *         positioned either before the first row or after the last row, or
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2396
     *         the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2397
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2398
    public boolean relative(int rows) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2399
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2400
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2401
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2402
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2403
     * Moves this {@code CachedRowSetImpl} object's cursor to the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2404
     * previous row and returns {@code true} if the cursor is on
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2405
     * a valid row or {@code false} if it is not.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2406
     * This method also notifies all listeners registered with this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2407
     * {@code CachedRowSetImpl} object that its cursor has moved.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2408
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2409
     * Note: calling the method {@code previous()} is not the same
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2410
     * as calling the method {@code relative(-1)}.  This is true
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2411
     * because it is possible to call {@code previous()} from the insert
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2412
     * row, from after the last row, or from the current row, whereas
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2413
     * {@code relative} may only be called from the current row.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2414
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2415
     * The method {@code previous} may used in a {@code while}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2416
     * loop to iterate through a rowset starting after the last row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2417
     * and moving toward the beginning. The loop ends when {@code previous}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2418
     * returns {@code false}, meaning that there are no more rows.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2419
     * For example, the following code fragment retrieves all the data in
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2420
     * the {@code CachedRowSetImpl} object {@code crs}, which has
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2421
     * three columns.  Note that the cursor must initially be positioned
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2422
     * after the last row so that the first call to the method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2423
     * {@code previous} places the cursor on the last line.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2424
     * <PRE>{@code
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2425
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2426
     *     crs.afterLast();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2427
     *     while (previous()) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2428
     *         String name = crs.getString(1);
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2429
     *         int age = crs.getInt(2);
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2430
     *         short ssn = crs.getShort(3);
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2431
     *         System.out.println(name + "   " + age + "   " + ssn);
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2432
     *     }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2433
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2434
     * }</PRE>
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2435
     * This method throws an {@code SQLException} if the cursor is not
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2436
     * on a row in the rowset, before the first row, or after the last row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2437
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2438
     * @return {@code true} if the cursor is on a valid row;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2439
     *         {@code false} if it is before the first row or after the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2440
     *         last row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2441
     * @throws SQLException if the cursor is not on a valid position or the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2442
     *           type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2443
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2444
    public boolean previous() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2445
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2446
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2447
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2448
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2449
     * Moves the cursor to the previous row in this {@code CachedRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2450
     * object, skipping past deleted rows that are not visible; returns
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2451
     * {@code true} if the cursor is on a row in this rowset and
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2452
     * {@code false} when the cursor goes before the first row.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2453
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2454
     * This method is called internally by the method {@code previous}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2455
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2456
     * This is a implementation only method and is not required as a standard
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2457
     * implementation of the {@code CachedRowSet} interface.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2458
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2459
     * @return {@code true} if the cursor is on a row in this rowset;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2460
     *         {@code false} when the cursor reaches the position before
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2461
     *         the first row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2462
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2463
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2464
    protected boolean internalPrevious() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2465
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2466
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2467
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2468
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2469
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2470
    // Updates
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2471
    //---------------------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2472
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2473
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2474
     * Indicates whether the current row of this {@code CachedRowSetImpl}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2475
     * object has been updated.  The value returned
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2476
     * depends on whether this rowset can detect updates: {@code false}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2477
     * will always be returned if it does not detect updates.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2478
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2479
     * @return {@code true} if the row has been visibly updated
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2480
     *         by the owner or another and updates are detected;
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2481
     *         {@code false} otherwise
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2482
     * @throws SQLException if the cursor is on the insert row or not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2483
     *            not on a valid row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2484
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2485
     * @see DatabaseMetaData#updatesAreDetected
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2486
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2487
    public boolean rowUpdated() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2488
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2489
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2490
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2491
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2492
     * Indicates whether the designated column of the current row of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2493
     * this {@code CachedRowSetImpl} object has been updated. The
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2494
     * value returned depends on whether this rowset can detcted updates:
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2495
     * {@code false} will always be returned if it does not detect updates.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2496
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2497
     * @param idx the index identifier of the column that may be have been updated.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2498
     * @return {@code true} is the designated column has been updated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2499
     * and the rowset detects updates; {@code false} if the rowset has not
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2500
     * been updated or the rowset does not detect updates
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2501
     * @throws SQLException if the cursor is on the insert row or not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2502
     *          on a valid row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2503
     * @see DatabaseMetaData#updatesAreDetected
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2504
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2505
    public boolean columnUpdated(int idx) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2506
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2507
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2508
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2509
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2510
     * Indicates whether the designated column of the current row of
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2511
     * this {@code CachedRowSetImpl} object has been updated. The
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2512
     * value returned depends on whether this rowset can detcted updates:
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2513
     * {@code false} will always be returned if it does not detect updates.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2514
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2515
     * @param columnName the {@code String} column name column that may be have
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2516
     * been updated.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2517
     * @return {@code true} is the designated column has been updated
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2518
     * and the rowset detects updates; {@code false} if the rowset has not
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2519
     * been updated or the rowset does not detect updates
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2520
     * @throws SQLException if the cursor is on the insert row or not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2521
     *          on a valid row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2522
     * @see DatabaseMetaData#updatesAreDetected
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2523
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2524
    public boolean columnUpdated(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2525
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2526
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2527
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2528
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2529
     * Indicates whether the current row has been inserted.  The value returned
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2530
     * depends on whether or not the rowset can detect visible inserts.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2531
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2532
     * @return {@code true} if a row has been inserted and inserts are detected;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2533
     *         {@code false} otherwise
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2534
     * @throws SQLException if the cursor is on the insert row or not
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2535
     *            not on a valid row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2536
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2537
     * @see DatabaseMetaData#insertsAreDetected
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2538
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2539
    public boolean rowInserted() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2540
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2541
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2542
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2543
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2544
     * Indicates whether the current row has been deleted.  A deleted row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2545
     * may leave a visible "hole" in a rowset.  This method can be used to
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2546
     * detect such holes if the rowset can detect deletions. This method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2547
     * will always return {@code false} if this rowset cannot detect
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2548
     * deletions.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2549
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2550
     * @return {@code true} if (1)the current row is blank, indicating that
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2551
     *         the row has been deleted, and (2)deletions are detected;
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2552
     *         {@code false} otherwise
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2553
     * @throws SQLException if the cursor is on a valid row in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2554
     * @see DatabaseMetaData#deletesAreDetected
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2555
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2556
    public boolean rowDeleted() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2557
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2558
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2559
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2560
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2561
     * Sets the designated nullable column in the current row or the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2562
     * insert row of this {@code CachedRowSetImpl} object with
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2563
     * {@code null} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2564
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2565
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2566
     * row of this rowset; however, another method must be called to complete
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2567
     * the update process. If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2568
     * method {@link #updateRow} must be called to mark the row as updated
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2569
     * and to notify listeners that the row has changed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2570
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2571
     * must be called to insert the new row into this rowset and to notify
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2572
     * listeners that a row has changed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2573
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2574
     * In order to propagate updates in this rowset to the underlying
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2575
     * data source, an application must call the method {@link #acceptChanges}
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2576
     * after it calls either {@code updateRow} or {@code insertRow}.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2577
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2578
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2579
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2580
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2581
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2582
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2583
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2584
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2585
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2586
    public void updateNull(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2587
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2588
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2589
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2590
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2591
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2592
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2593
     * {@code boolean} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2594
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2595
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2596
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2597
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2598
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2599
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2600
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2601
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2602
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2603
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2604
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2605
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2606
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2607
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2608
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2609
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2610
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2611
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2612
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2613
    public void updateBoolean(int columnIndex, boolean x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2614
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2615
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2616
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2617
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2618
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2619
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2620
     * {@code byte} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2621
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2622
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2623
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2624
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2625
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2626
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2627
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2628
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2629
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2630
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2631
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2632
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2633
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2634
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2635
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2636
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2637
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2638
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2639
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2640
    public void updateByte(int columnIndex, byte x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2641
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2642
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2643
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2644
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2645
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2646
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2647
     * {@code short} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2648
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2649
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2650
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2651
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2652
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2653
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2654
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2655
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2656
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2657
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2658
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2659
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2660
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2661
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2662
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2663
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2664
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2665
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2666
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2667
    public void updateShort(int columnIndex, short x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2668
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2669
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2670
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2671
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2672
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2673
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2674
     * {@code int} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2675
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2676
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2677
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2678
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2679
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2680
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2681
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2682
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2683
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2684
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2685
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2686
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2687
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2688
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2689
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2690
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2691
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2692
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2693
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2694
    public void updateInt(int columnIndex, int x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2695
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2696
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2697
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2698
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2699
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2700
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2701
     * {@code long} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2702
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2703
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2704
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2705
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2706
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2707
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2708
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2709
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2710
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2711
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2712
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2713
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2714
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2715
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2716
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2717
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2718
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2719
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2720
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2721
    public void updateLong(int columnIndex, long x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2722
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2723
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2724
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2725
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2726
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2727
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2728
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2729
     * {@code float} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2730
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2731
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2732
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2733
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2734
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2735
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2736
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2737
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2738
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2739
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2740
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2741
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2742
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2743
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2744
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2745
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2746
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2747
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2748
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2749
    public void updateFloat(int columnIndex, float x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2750
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2751
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2752
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2753
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2754
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2755
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2756
     * {@code double} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2757
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2758
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2759
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2760
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2761
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2762
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2763
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2764
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2765
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2766
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2767
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2768
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2769
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2770
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2771
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2772
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2773
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2774
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2775
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2776
    public void updateDouble(int columnIndex, double x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2777
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2778
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2779
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2780
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2781
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2782
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2783
     * {@code java.math.BigDecimal} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2784
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2785
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2786
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2787
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2788
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2789
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2790
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2791
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2792
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2793
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2794
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2795
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2796
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2797
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2798
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2799
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2800
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2801
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2802
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2803
    public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2804
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2805
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2806
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2807
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2808
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2809
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2810
     * {@code String} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2811
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2812
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2813
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2814
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2815
     * method {@link #updateRow} must be called to mark the row as updated.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2816
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2817
     * must be called to insert the new row into this rowset and mark it
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2818
     * as inserted. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2819
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2820
     * <P>
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2821
     * The method {@code acceptChanges} must be called if the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2822
     * updated values are to be written back to the underlying database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2823
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2824
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2825
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2826
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2827
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2828
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2829
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2830
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2831
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2832
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2833
    public void updateString(int columnIndex, String x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2834
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2835
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2836
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2837
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2838
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2839
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2840
     * {@code byte} array.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2841
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2842
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2843
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2844
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2845
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2846
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2847
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2848
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2849
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2850
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2851
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2852
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2853
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2854
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2855
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2856
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2857
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2858
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2859
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2860
    public void updateBytes(int columnIndex, byte x[]) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2861
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2862
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2863
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2864
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2865
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2866
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2867
     * {@code Date} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2868
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2869
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2870
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2871
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2872
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2873
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2874
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2875
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2876
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2877
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2878
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2879
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2880
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2881
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2882
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2883
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2884
     *            insert row, (3) the type of the designated column is not
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2885
     *            an SQL {@code DATE} or {@code TIMESTAMP}, or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2886
     *            (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2887
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2888
    public void updateDate(int columnIndex, java.sql.Date x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2889
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2890
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2891
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2892
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2893
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2894
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2895
     * {@code Time} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2896
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2897
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2898
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2899
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2900
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2901
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2902
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2903
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2904
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2905
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2906
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2907
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2908
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2909
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2910
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2911
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2912
     *            insert row, (3) the type of the designated column is not
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2913
     *            an SQL {@code TIME} or {@code TIMESTAMP}, or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2914
     *            (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2915
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2916
    public void updateTime(int columnIndex, java.sql.Time x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2917
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2918
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2919
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2920
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2921
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2922
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2923
     * {@code Timestamp} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2924
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2925
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2926
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2927
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2928
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2929
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2930
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2931
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2932
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2933
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2934
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2935
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2936
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2937
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2938
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2939
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2940
     *            insert row, (3) the type of the designated column is not
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2941
     *            an SQL {@code DATE}, {@code TIME}, or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2942
     *            {@code TIMESTAMP}, or (4) this rowset is
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2943
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2944
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2945
    public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2946
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2947
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2948
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2949
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2950
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2951
     * row of this {@code CachedRowSetImpl} object with the given
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2952
     * ASCII stream value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2953
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2954
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2955
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2956
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2957
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2958
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2959
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2960
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2961
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2962
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2963
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2964
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2965
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2966
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2967
     * @param length the number of one-byte ASCII characters in the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2968
     * @throws SQLException if this method is invoked
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2969
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2970
    public void updateAsciiStream(int columnIndex, java.io.InputStream x, int length) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2971
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2972
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2973
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2974
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2975
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2976
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2977
     * {@code java.io.InputStream} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2978
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2979
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2980
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2981
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2982
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2983
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2984
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2985
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2986
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2987
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2988
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2989
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2990
     *        and equal to or less than the number of columns in this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2991
     * @param x the new column value; must be a {@code java.io.InputStream}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2992
     *          containing {@code BINARY}, {@code VARBINARY}, or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2993
     *          {@code LONGVARBINARY} data
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2994
     * @param length the length of the stream in bytes
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2995
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2996
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2997
     *            insert row, (3) the data in the stream is not binary, or
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  2998
     *            (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  2999
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3000
    public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3001
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3002
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3003
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3004
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3005
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3006
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3007
     * {@code java.io.Reader} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3008
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3009
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3010
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3011
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3012
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3013
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3014
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3015
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3016
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3017
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3018
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3019
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3020
     *        and equal to or less than the number of columns in this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3021
     * @param x the new column value; must be a {@code java.io.Reader}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3022
     *          containing {@code BINARY}, {@code VARBINARY},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3023
     *          {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3024
     *          or {@code LONGVARCHAR} data
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3025
     * @param length the length of the stream in characters
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3026
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3027
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3028
     *            insert row, (3) the data in the stream is not a binary or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3029
     *            character type, or (4) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3030
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3031
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3032
    public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3033
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3034
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3035
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3036
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3037
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3038
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3039
     * {@code Object} value.  The {@code scale} parameter indicates
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3040
     * the number of digits to the right of the decimal point and is ignored
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3041
     * if the new column value is not a type that will be mapped to an SQL
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3042
     * {@code DECIMAL} or {@code NUMERIC} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3043
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3044
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3045
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3046
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3047
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3048
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3049
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3050
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3051
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3052
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3053
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3054
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3055
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3056
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3057
     * @param scale the number of digits to the right of the decimal point (for
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3058
     *              {@code DECIMAL} and {@code NUMERIC} types only)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3059
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3060
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3061
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3062
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3063
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3064
    public void updateObject(int columnIndex, Object x, int scale) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3065
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3066
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3067
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3068
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3069
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3070
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3071
     * {@code Object} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3072
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3073
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3074
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3075
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3076
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3077
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3078
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3079
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3080
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3081
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3082
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3083
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3084
     *        and equal to or less than the number of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3085
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3086
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3087
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3088
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3089
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3090
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3091
    public void updateObject(int columnIndex, Object x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3092
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3093
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3094
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3095
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3096
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3097
     * Sets the designated nullable column in the current row or the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3098
     * insert row of this {@code CachedRowSetImpl} object with
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3099
     * {@code null} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3100
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3101
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3102
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3103
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3104
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3105
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3106
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3107
     * and the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3108
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3109
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3110
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3111
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3112
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3113
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3114
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3115
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3116
    public void updateNull(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3117
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3118
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3119
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3120
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3121
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3122
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3123
     * {@code boolean} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3124
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3125
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3126
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3127
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3128
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3129
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3130
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3131
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3132
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3133
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3134
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3135
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3136
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3137
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3138
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3139
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3140
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3141
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3142
    public void updateBoolean(String columnName, boolean x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3143
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3144
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3145
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3146
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3147
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3148
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3149
     * {@code byte} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3150
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3151
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3152
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3153
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3154
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3155
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3156
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3157
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3158
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3159
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3160
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3161
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3162
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3163
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3164
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3165
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3166
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3167
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3168
    public void updateByte(String columnName, byte x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3169
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3170
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3171
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3172
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3173
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3174
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3175
     * {@code short} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3176
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3177
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3178
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3179
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3180
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3181
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3182
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3183
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3184
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3185
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3186
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3187
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3188
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3189
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3190
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3191
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3192
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3193
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3194
    public void updateShort(String columnName, short x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3195
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3196
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3197
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3198
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3199
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3200
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3201
     * {@code int} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3202
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3203
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3204
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3205
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3206
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3207
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3208
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3209
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3210
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3211
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3212
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3213
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3214
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3215
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3216
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3217
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3218
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3219
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3220
    public void updateInt(String columnName, int x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3221
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3222
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3223
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3224
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3225
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3226
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3227
     * {@code long} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3228
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3229
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3230
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3231
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3232
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3233
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3234
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3235
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3236
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3237
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3238
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3239
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3240
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3241
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3242
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3243
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3244
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3245
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3246
    public void updateLong(String columnName, long x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3247
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3248
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3249
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3250
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3251
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3252
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3253
     * {@code float} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3254
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3255
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3256
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3257
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3258
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3259
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3260
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3261
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3262
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3263
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3264
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3265
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3266
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3267
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3268
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3269
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3270
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3271
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3272
    public void updateFloat(String columnName, float x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3273
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3274
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3275
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3276
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3277
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3278
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3279
     * {@code double} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3280
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3281
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3282
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3283
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3284
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3285
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3286
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3287
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3288
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3289
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3290
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3291
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3292
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3293
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3294
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3295
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3296
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3297
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3298
    public void updateDouble(String columnName, double x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3299
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3300
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3301
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3302
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3303
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3304
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3305
     * {@code java.math.BigDecimal} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3306
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3307
     * This method updates a column value in the current row or the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3308
     * row of this rowset, but it does not update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3309
     * If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3310
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3311
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3312
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3313
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3314
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3315
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3316
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3317
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3318
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3319
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3320
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3321
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3322
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3323
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3324
    public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3325
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3326
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3327
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3328
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3329
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3330
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3331
     * {@code String} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3332
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3333
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3334
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3335
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3336
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3337
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3338
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3339
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3340
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3341
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3342
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3343
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3344
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3345
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3346
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3347
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3348
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3349
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3350
    public void updateString(String columnName, String x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3351
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3352
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3353
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3354
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3355
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3356
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3357
     * {@code byte} array.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3358
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3359
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3360
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3361
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3362
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3363
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3364
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3365
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3366
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3367
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3368
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3369
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3370
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3371
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3372
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3373
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3374
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3375
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3376
    public void updateBytes(String columnName, byte x[]) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3377
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3378
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3379
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3380
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3381
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3382
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3383
     * {@code Date} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3384
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3385
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3386
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3387
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3388
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3389
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3390
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3391
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3392
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3393
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3394
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3395
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3396
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3397
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3398
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3399
     *            one of this rowset's rows or its insert row, (3) the type
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3400
     *            of the designated column is not an SQL {@code DATE} or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3401
     *            {@code TIMESTAMP}, or (4) this rowset is
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3402
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3403
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3404
    public void updateDate(String columnName, java.sql.Date x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3405
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3406
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3407
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3408
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3409
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3410
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3411
     * {@code Time} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3412
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3413
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3414
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3415
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3416
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3417
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3418
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3419
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3420
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3421
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3422
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3423
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3424
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3425
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3426
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3427
     *            one of this rowset's rows or its insert row, (3) the type
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3428
     *            of the designated column is not an SQL {@code TIME} or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3429
     *            {@code TIMESTAMP}, or (4) this rowset is
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3430
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3431
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3432
    public void updateTime(String columnName, java.sql.Time x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3433
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3434
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3435
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3436
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3437
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3438
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3439
     * {@code Timestamp} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3440
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3441
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3442
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3443
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3444
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3445
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3446
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3447
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3448
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3449
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3450
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3451
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3452
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3453
     * @throws SQLException if the given column index is out of bounds or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3454
     *            the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3455
     *            insert row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3456
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3457
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3458
     *            one of this rowset's rows or its insert row, (3) the type
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3459
     *            of the designated column is not an SQL {@code DATE},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3460
     *            {@code TIME}, or {@code TIMESTAMP}, or (4) this
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3461
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3462
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3463
    public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3464
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3465
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3466
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3467
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3468
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3469
     * row of this {@code CachedRowSetImpl} object with the given
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3470
     * ASCII stream value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3471
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3472
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3473
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3474
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3475
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3476
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3477
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3478
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3479
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3480
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3481
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3482
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3483
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3484
     * @param length the number of one-byte ASCII characters in the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3485
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3486
    public void updateAsciiStream(String columnName,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3487
    java.io.InputStream x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3488
    int length) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3489
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3490
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3491
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3492
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3493
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3494
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3495
     * {@code java.io.InputStream} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3496
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3497
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3498
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3499
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3500
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3501
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3502
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3503
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3504
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3505
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3506
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3507
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3508
     * @param x the new column value; must be a {@code java.io.InputStream}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3509
     *          containing {@code BINARY}, {@code VARBINARY}, or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3510
     *          {@code LONGVARBINARY} data
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3511
     * @param length the length of the stream in bytes
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3512
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3513
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3514
     *            one of this rowset's rows or its insert row, (3) the data
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3515
     *            in the stream is not binary, or (4) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3516
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3517
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3518
    public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3519
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3520
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3521
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3522
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3523
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3524
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3525
     * {@code java.io.Reader} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3526
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3527
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3528
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3529
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3530
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3531
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3532
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3533
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3534
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3535
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3536
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3537
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3538
     * @param reader the new column value; must be a
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3539
     * {@code java.io.Reader} containing {@code BINARY},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3540
     * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3541
     * {@code VARCHAR}, or {@code LONGVARCHAR} data
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3542
     * @param length the length of the stream in characters
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3543
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3544
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3545
     *            one of this rowset's rows or its insert row, (3) the data
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3546
     *            in the stream is not a binary or character type, or (4) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3547
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3548
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3549
    public void updateCharacterStream(String columnName,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3550
    java.io.Reader reader,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3551
    int length) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3552
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3553
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3554
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3555
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3556
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3557
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3558
     * {@code Object} value.  The {@code scale} parameter
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3559
     * indicates the number of digits to the right of the decimal point
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3560
     * and is ignored if the new column value is not a type that will be
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3561
     *  mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3562
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3563
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3564
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3565
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3566
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3567
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3568
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3569
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3570
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3571
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3572
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3573
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3574
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3575
     * @param scale the number of digits to the right of the decimal point (for
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3576
     *              {@code DECIMAL} and {@code NUMERIC} types only)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3577
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3578
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3579
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3580
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3581
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3582
    public void updateObject(String columnName, Object x, int scale) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3583
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3584
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3585
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3586
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3587
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3588
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3589
     * {@code Object} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3590
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3591
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3592
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3593
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3594
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3595
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3596
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3597
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3598
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3599
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3600
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3601
     *        SQL name of a column in this rowset, ignoring case
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3602
     * @param x the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3603
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3604
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3605
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3606
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3607
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3608
    public void updateObject(String columnName, Object x) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3609
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3610
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3611
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3612
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3613
     * Inserts the contents of this {@code CachedRowSetImpl} object's insert
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3614
     * row into this rowset immediately following the current row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3615
     * If the current row is the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3616
     * position after the last row or before the first row, the new row will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3617
     * be inserted at the end of the rowset.  This method also notifies
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3618
     * listeners registered with this rowset that the row has changed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3619
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3620
     * The cursor must be on the insert row when this method is called.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3621
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3622
     * @throws SQLException if (1) the cursor is not on the insert row,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3623
     *            (2) one or more of the non-nullable columns in the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3624
     *            row has not been given a value, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3625
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3626
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3627
    public void insertRow() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3628
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3629
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3630
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3631
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3632
     * Marks the current row of this {@code CachedRowSetImpl} object as
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3633
     * updated and notifies listeners registered with this rowset that the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3634
     * row has changed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3635
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3636
     * This method  cannot be called when the cursor is on the insert row, and
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3637
     * it should be called before the cursor moves to another row.  If it is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3638
     * called after the cursor moves to another row, this method has no effect,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3639
     * and the updates made before the cursor moved will be lost.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3640
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3641
     * @throws SQLException if the cursor is on the insert row or this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3642
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3643
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3644
    public void updateRow() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3645
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3646
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3647
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3648
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3649
     * Deletes the current row from this {@code CachedRowSetImpl} object and
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3650
     * notifies listeners registered with this rowset that a row has changed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3651
     * This method cannot be called when the cursor is on the insert row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3652
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3653
     * This method marks the current row as deleted, but it does not delete
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3654
     * the row from the underlying data source.  The method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3655
     * {@code acceptChanges} must be called to delete the row in
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3656
     * the data source.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3657
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3658
     * @throws SQLException if (1) this method is called when the cursor
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3659
     *            is on the insert row, before the first row, or after the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3660
     *            last row or (2) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3661
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3662
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3663
    public void deleteRow() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3664
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3665
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3666
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3667
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3668
     * Sets the current row with its original value and marks the row as
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3669
     * not updated, thus undoing any changes made to the row since the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3670
     * last call to the methods {@code updateRow} or {@code deleteRow}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3671
     * This method should be called only when the cursor is on a row in
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3672
     * this rowset.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3673
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3674
     * @throws SQLException if the cursor is on the insert row, before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3675
     *            first row, or after the last row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3676
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3677
    public void refreshRow() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3678
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3679
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3680
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3681
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3682
     * Rolls back any updates made to the current row of this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3683
     * {@code CachedRowSetImpl} object and notifies listeners that
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3684
     * a row has changed.  To have an effect, this method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3685
     * must be called after an {@code updateXXX} method has been
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3686
     * called and before the method {@code updateRow} has been called.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3687
     * If no updates have been made or the method {@code updateRow}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3688
     * has already been called, this method has no effect.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3689
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3690
     * @throws SQLException if the cursor is on the insert row, before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3691
     *            first row, or after the last row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3692
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3693
    public void cancelRowUpdates() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3694
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3695
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3696
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3697
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3698
     * Moves the cursor for this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3699
     * to the insert row.  The current row in the rowset is remembered
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3700
     * while the cursor is on the insert row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3701
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3702
     * The insert row is a special row associated with an updatable
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3703
     * rowset.  It is essentially a buffer where a new row may
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3704
     * be constructed by calling the appropriate {@code updateXXX}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3705
     * methods to assign a value to each column in the row.  A complete
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3706
     * row must be constructed; that is, every column that is not nullable
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3707
     * must be assigned a value.  In order for the new row to become part
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3708
     * of this rowset, the method {@code insertRow} must be called
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3709
     * before the cursor is moved back to the rowset.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3710
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3711
     * Only certain methods may be invoked while the cursor is on the insert
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3712
     * row; many methods throw an exception if they are called while the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3713
     * cursor is there.  In addition to the {@code updateXXX}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3714
     * and {@code insertRow} methods, only the {@code getXXX} methods
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3715
     * may be called when the cursor is on the insert row.  A {@code getXXX}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3716
     * method should be called on a column only after an {@code updateXXX}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3717
     * method has been called on that column; otherwise, the value returned is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3718
     * undetermined.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3719
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3720
     * @throws SQLException if this {@code CachedRowSetImpl} object is
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3721
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3722
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3723
    public void moveToInsertRow() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3724
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3725
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3726
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3727
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3728
     * Moves the cursor for this {@code CachedRowSetImpl} object to
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3729
     * the current row.  The current row is the row the cursor was on
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3730
     * when the method {@code moveToInsertRow} was called.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3731
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3732
     * Calling this method has no effect unless it is called while the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3733
     * cursor is on the insert row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3734
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3735
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3736
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3737
    public void moveToCurrentRow() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3738
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3739
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3740
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3741
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3742
     * Returns {@code null}.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3743
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3744
     * @return {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3745
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3746
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3747
    public Statement getStatement() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3748
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3749
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3750
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3751
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3752
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3753
     * {@code CachedRowSetImpl} object as an {@code Object} in
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3754
     * the Java programming language, using the given
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3755
     * {@code java.util.Map} object to custom map the value if
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3756
     * appropriate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3757
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3758
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3759
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3760
     *        and equal to or less than the number of columns in this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3761
     * @param map a {@code java.util.Map} object showing the mapping
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3762
     *            from SQL type names to classes in the Java programming
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3763
     *            language
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3764
     * @return an {@code Object} representing the SQL value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3765
     * @throws SQLException if the given column index is out of bounds or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3766
     *            the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3767
     *            insert row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3768
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3769
    public Object getObject(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3770
                            java.util.Map<String,Class<?>> map)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3771
          throws SQLException
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3772
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3773
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3774
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3775
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3776
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3777
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3778
     * {@code CachedRowSetImpl} object as a {@code Ref} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3779
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3780
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3781
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3782
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3783
     *        and equal to or less than the number of columns in this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3784
     * @return a {@code Ref} object representing an SQL{@code  REF} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3785
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3786
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3787
     *            insert row, or (3) the designated column does not store an
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3788
     *            SQL {@code REF} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3789
     * @see #getRef(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3790
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3791
    public Ref getRef(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3792
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3793
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3794
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3795
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3796
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3797
     * {@code CachedRowSetImpl} object as a {@code Blob} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3798
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3799
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3800
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3801
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3802
     *        and equal to or less than the number of columns in this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3803
     * @return a {@code Blob} object representing an SQL {@code BLOB} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3804
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3805
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3806
     *            insert row, or (3) the designated column does not store an
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3807
     *            SQL {@code BLOB} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3808
     * @see #getBlob(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3809
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3810
    public Blob getBlob(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3811
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3812
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3813
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3814
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3815
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3816
     * {@code CachedRowSetImpl} object as a {@code Clob} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3817
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3818
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3819
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3820
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3821
     *        and equal to or less than the number of columns in this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3822
     * @return a {@code Clob} object representing an SQL {@code CLOB} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3823
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3824
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3825
     *            insert row, or (3) the designated column does not store an
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3826
     *            SQL {@code CLOB} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3827
     * @see #getClob(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3828
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3829
    public Clob getClob(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3830
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3831
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3832
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3833
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3834
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3835
     * {@code CachedRowSetImpl} object as an {@code Array} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3836
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3837
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3838
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3839
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3840
     *        and equal to or less than the number of columns in this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3841
     * @return an {@code Array} object representing an SQL
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3842
     *         {@code ARRAY} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3843
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3844
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3845
     *            insert row, or (3) the designated column does not store an
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3846
     *            SQL {@code ARRAY} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3847
     * @see #getArray(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3848
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3849
    public Array getArray(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3850
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3851
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3852
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3853
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3854
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3855
     * {@code CachedRowSetImpl} object as an {@code Object} in
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3856
     * the Java programming language, using the given
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3857
     * {@code java.util.Map} object to custom map the value if
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3858
     * appropriate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3859
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3860
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3861
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3862
     * @param map a {@code java.util.Map} object showing the mapping
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3863
     *        from SQL type names to classes in the Java programming
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3864
     *        language
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3865
     * @return an {@code Object} representing the SQL value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3866
     * @throws SQLException if the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3867
     *         a column in this rowset or the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3868
     *         this rowset's rows or its insert row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3869
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3870
    public Object getObject(String columnName,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3871
                            java.util.Map<String,Class<?>> map)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3872
    throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3873
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3874
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3875
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3876
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3877
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3878
     * {@code CachedRowSetImpl} object as a {@code Ref} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3879
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3880
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3881
     * @param colName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3882
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3883
     * @return a {@code Ref} object representing an SQL{@code  REF} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3884
     * @throws SQLException  if (1) the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3885
     *            a column in this rowset, (2) the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3886
     *            this rowset's rows or its insert row, or (3) the column value
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3887
     *            is not an SQL {@code REF} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3888
     * @see #getRef(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3889
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3890
    public Ref getRef(String colName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3891
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3892
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3893
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3894
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3895
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3896
     * {@code CachedRowSetImpl} object as a {@code Blob} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3897
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3898
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3899
     * @param colName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3900
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3901
     * @return a {@code Blob} object representing an SQL {@code BLOB} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3902
     * @throws SQLException if (1) the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3903
     *            a column in this rowset, (2) the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3904
     *            this rowset's rows or its insert row, or (3) the designated
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3905
     *            column does not store an SQL {@code BLOB} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3906
     * @see #getBlob(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3907
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3908
    public Blob getBlob(String colName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3909
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3910
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3911
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3912
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3913
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3914
     * {@code CachedRowSetImpl} object as a {@code Clob} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3915
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3916
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3917
     * @param colName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3918
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3919
     * @return a {@code Clob} object representing an SQL
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3920
     *         {@code CLOB} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3921
     * @throws SQLException if (1) the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3922
     *            a column in this rowset, (2) the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3923
     *            this rowset's rows or its insert row, or (3) the designated
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3924
     *            column does not store an SQL {@code CLOB} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3925
     * @see #getClob(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3926
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3927
    public Clob getClob(String colName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3928
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3929
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3930
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3931
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3932
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3933
     * {@code CachedRowSetImpl} object as an {@code Array} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3934
     * in the Java programming langugage.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3935
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3936
     * @param colName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3937
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3938
     * @return an {@code Array} object representing an SQL
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3939
     *         {@code ARRAY} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3940
     * @throws SQLException if (1) the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3941
     *            a column in this rowset, (2) the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3942
     *            this rowset's rows or its insert row, or (3) the designated
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3943
     *            column does not store an SQL {@code ARRAY} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3944
     * @see #getArray(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3945
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3946
    public Array getArray(String colName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3947
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3948
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3949
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3950
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3951
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3952
     * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3953
     * object, using the given {@code Calendar} object to construct an
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3954
     * appropriate millisecond value for the date.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3955
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3956
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3957
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3958
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3959
     * @param cal the {@code java.util.Calendar} object to use in
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3960
     *            constructing the date
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3961
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3962
     *         the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3963
     * @throws SQLException if (1) the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3964
     *            a column in this rowset, (2) the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3965
     *            this rowset's rows or its insert row, or (3) the designated
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3966
     *            column does not store an SQL {@code DATE} or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3967
     *            {@code TIMESTAMP} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3968
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3969
    public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3970
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3971
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3972
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3973
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3974
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3975
     * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3976
     * object, using the given {@code Calendar} object to construct an
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3977
     * appropriate millisecond value for the date.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3978
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3979
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3980
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3981
     * @param cal the {@code java.util.Calendar} object to use in
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3982
     *            constructing the date
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3983
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3984
     *         the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3985
     * @throws SQLException if (1) the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3986
     *            a column in this rowset, (2) the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3987
     *            this rowset's rows or its insert row, or (3) the designated
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3988
     *            column does not store an SQL {@code DATE} or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3989
     *            {@code TIMESTAMP} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3990
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3991
    public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3992
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3993
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3994
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3995
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3996
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3997
     * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  3998
     * object, using the given {@code Calendar} object to construct an
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  3999
     * appropriate millisecond value for the date.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4000
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4001
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4002
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4003
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4004
     * @param cal the {@code java.util.Calendar} object to use in
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4005
     *            constructing the date
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4006
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4007
     *         the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4008
     * @throws SQLException if (1) the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4009
     *            a column in this rowset, (2) the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4010
     *            this rowset's rows or its insert row, or (3) the designated
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4011
     *            column does not store an SQL {@code TIME} or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4012
     *            {@code TIMESTAMP} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4013
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4014
    public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4015
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4016
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4017
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4018
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4019
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4020
     * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4021
     * object, using the given {@code Calendar} object to construct an
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4022
     * appropriate millisecond value for the date.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4023
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4024
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4025
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4026
     * @param cal the {@code java.util.Calendar} object to use in
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4027
     *            constructing the date
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4028
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4029
     *         the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4030
     * @throws SQLException if (1) the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4031
     *            a column in this rowset, (2) the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4032
     *            this rowset's rows or its insert row, or (3) the designated
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4033
     *            column does not store an SQL {@code TIME} or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4034
     *            {@code TIMESTAMP} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4035
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4036
    public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4037
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4038
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4039
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4040
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4041
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4042
     * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4043
     * object, using the given {@code Calendar} object to construct an
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4044
     * appropriate millisecond value for the date.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4045
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4046
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4047
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4048
     *        and equal to or less than the number of columns in the rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4049
     * @param cal the {@code java.util.Calendar} object to use in
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4050
     *            constructing the date
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4051
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4052
     *         the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4053
     * @throws SQLException if (1) the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4054
     *            a column in this rowset, (2) the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4055
     *            this rowset's rows or its insert row, or (3) the designated
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4056
     *            column does not store an SQL {@code TIME} or
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4057
     *            {@code TIMESTAMP} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4058
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4059
    public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4060
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4061
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4062
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4063
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4064
     * Retrieves the value of the designated column in the current row
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4065
     * of this {@code CachedRowSetImpl} object as a
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4066
     * {@code java.sql.Timestamp} object, using the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4067
     * {@code Calendar} object to construct an appropriate
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4068
     * millisecond value for the date.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4069
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4070
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4071
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4072
     * @param cal the {@code java.util.Calendar} object to use in
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4073
     *            constructing the date
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4074
     * @return the column value; if the value is SQL {@code NULL},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4075
     *         the result is {@code null}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4076
     * @throws SQLException if (1) the given column name is not the name of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4077
     *            a column in this rowset, (2) the cursor is not on one of
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4078
     *            this rowset's rows or its insert row, or (3) the designated
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4079
     *            column does not store an SQL {@code DATE},
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4080
     *            {@code TIME}, or {@code TIMESTAMP} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4081
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4082
    public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4083
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4084
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4085
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4086
    /*
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4087
     * RowSetInternal Interface
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4088
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4089
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4090
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4091
     * Retrieves the {@code Connection} object passed to this
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4092
     * {@code CachedRowSetImpl} object.  This connection may be
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4093
     * used to populate this rowset with data or to write data back
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4094
     * to its underlying data source.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4095
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4096
     * @return the {@code Connection} object passed to this rowset;
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4097
     *         may be {@code null} if there is no connection
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4098
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4099
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4100
    public Connection getConnection() throws SQLException{
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4101
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4102
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4103
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4104
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4105
     * Sets the metadata for this {@code CachedRowSetImpl} object
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4106
     * with the given {@code RowSetMetaData} object.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4107
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4108
     * @param md a {@code RowSetMetaData} object instance containing
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4109
     *            metadata about the columsn in the rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4110
     * @throws SQLException if invalid meta data is supplied to the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4111
     *            rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4112
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4113
    public void setMetaData(RowSetMetaData md) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4114
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4115
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4116
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4117
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4118
     * Returns a result set containing the original value of the rowset. The
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4119
     * original value is the state of the {@code CachedRowSetImpl} after the
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 14342
diff changeset
  4120
     * last population or synchronization (whichever occurred most recently) with
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4121
     * the data source.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4122
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4123
     * The cursor is positioned before the first row in the result set.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4124
     * Only rows contained in the result set returned by {@code getOriginal()}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4125
     * are said to have an original value.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4126
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4127
     * @return the original result set of the rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4128
     * @throws SQLException if an error occurs produce the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4129
     *           {@code ResultSet} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4130
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4131
    public ResultSet getOriginal() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4132
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4133
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4134
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4135
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4136
     * Returns a result set containing the original value of the current
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4137
     * row only.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4138
     * The original value is the state of the {@code CachedRowSetImpl} after
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 14342
diff changeset
  4139
     * the last population or synchronization (whichever occurred most recently)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4140
     * with the data source.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4141
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4142
     * @return the original result set of the row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4143
     * @throws SQLException if there is no current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4144
     * @see #setOriginalRow
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4145
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4146
    public ResultSet getOriginalRow() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4147
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4148
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4149
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4150
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4151
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4152
     * Marks the current row in this rowset as being an original row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4153
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4154
     * @throws SQLException if there is no current row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4155
     * @see #getOriginalRow
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4156
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4157
    public void setOriginalRow() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4158
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4159
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4160
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4161
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4162
     * Marks all rows in this rowset as being original rows. Any updates
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4163
     * made to the rows become the original values for the rowset.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4164
     * Calls to the method {@code setOriginal} connot be reversed.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4165
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4166
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4167
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4168
    public void setOriginal() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4169
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4170
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4171
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4172
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4173
     * Returns an identifier for the object (table) that was used to create this
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4174
     * rowset.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4175
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4176
     * @return a {@code String} object that identifies the table from
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4177
     *         which this {@code CachedRowSetImpl} object was derived
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4178
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4179
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4180
    public String getTableName() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4181
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4182
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4183
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4184
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4185
     * Sets the identifier for the table from which this rowset was derived
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4186
     * to the given table name.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4187
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4188
     * @param tabName a {@code String} object that identifies the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4189
     *          table from which this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4190
     *          was derived
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4191
     * @throws SQLException if an error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4192
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4193
    public void setTableName(String tabName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4194
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4195
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4196
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4197
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4198
     * Returns the columns that make a key to uniquely identify a
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4199
     * row in this {@code CachedRowSetImpl} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4200
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4201
     * @return an array of column numbers that constitutes a primary
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4202
     *           key for this rowset. This array should be empty
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4203
     *           if no column is representitive of a primary key
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4204
     * @throws SQLException if the rowset is empty or no columns
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4205
     *           are designated as primary keys
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4206
     * @see #setKeyColumns
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4207
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4208
    public int[] getKeyColumns() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4209
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4210
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4211
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4212
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4213
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4214
     * Sets this {@code CachedRowSetImpl} object's
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4215
     * {@code keyCols} field with the given array of column
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4216
     * numbers, which forms a key for uniquely identifying a row
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4217
     * in this rowset.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4218
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4219
     * @param keys an array of {@code int} indicating the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4220
     *        columns that form a primary key for this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4221
     *        {@code CachedRowSetImpl} object; every
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4222
     *        element in the array must be greater than
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4223
     *        {@code 0} and less than or equal to the number
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4224
     *        of columns in this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4225
     * @throws SQLException if any of the numbers in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4226
     *            given array is not valid for this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4227
     * @see #getKeyColumns
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4228
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4229
    public void setKeyColumns(int [] keys) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4230
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4231
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4232
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4233
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4234
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4235
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4236
     * {@code double} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4237
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4238
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4239
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4240
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4241
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4242
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4243
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4244
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4245
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4246
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4247
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4248
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4249
     *        and equal to or less than the number of columns in this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4250
     * @param ref the new column {@code java.sql.Ref} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4251
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4252
     *        (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4253
     *        insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4254
     *        {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4255
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4256
    public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4257
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4258
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4259
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4260
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4261
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4262
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4263
     * {@code double} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4264
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4265
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4266
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4267
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4268
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4269
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4270
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4271
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4272
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4273
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4274
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4275
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4276
     * @param ref the new column {@code java.sql.Ref} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4277
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4278
     *        name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4279
     *        one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4280
     *        rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4281
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4282
    public void updateRef(String columnName, java.sql.Ref ref) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4283
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4284
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4285
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4286
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4287
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4288
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4289
     * {@code double} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4290
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4291
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4292
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4293
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4294
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4295
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4296
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4297
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4298
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4299
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4300
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4301
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4302
     *        and equal to or less than the number of columns in this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4303
     * @param c the new column {@code Clob} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4304
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4305
     *        (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4306
     *        insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4307
     *        {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4308
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4309
    public void updateClob(int columnIndex, Clob c) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4310
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4311
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4312
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4313
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4314
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4315
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4316
     * {@code double} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4317
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4318
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4319
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4320
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4321
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4322
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4323
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4324
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4325
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4326
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4327
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4328
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4329
     * @param c the new column {@code Clob}value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4330
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4331
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4332
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4333
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4334
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4335
    public void updateClob(String columnName, Clob c) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4336
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4337
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4338
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4339
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4340
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4341
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4342
     * {@code java.sql.Blob} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4343
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4344
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4345
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4346
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4347
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4348
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4349
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4350
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4351
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4352
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4353
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4354
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4355
     *        and equal to or less than the number of columns in this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4356
     * @param b the new column {@code Blob} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4357
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4358
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4359
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4360
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4361
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4362
    public void updateBlob(int columnIndex, Blob b) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4363
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4364
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4365
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4366
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4367
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4368
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4369
     * {@code java.sql.Blob } value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4370
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4371
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4372
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4373
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4374
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4375
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4376
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4377
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4378
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4379
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4380
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4381
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4382
     * @param b the new column {@code Blob} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4383
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4384
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4385
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4386
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4387
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4388
    public void updateBlob(String columnName, Blob b) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4389
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4390
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4391
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4392
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4393
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4394
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4395
     * {@code java.sql.Array} values.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4396
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4397
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4398
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4399
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4400
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4401
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4402
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4403
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4404
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4405
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4406
     * @param columnIndex the first column is {@code 1}, the second
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4407
     *        is {@code 2}, and so on; must be {@code 1} or larger
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4408
     *        and equal to or less than the number of columns in this rowset
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4409
     * @param a the new column {@code Array} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4410
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4411
     *            (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4412
     *            insert row, or (3) this rowset is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4413
     *            {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4414
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4415
    public void updateArray(int columnIndex, Array a) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4416
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4417
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4418
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4419
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4420
     * Sets the designated column in either the current row or the insert
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4421
     * row of this {@code CachedRowSetImpl} object with the given
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4422
     * {@code java.sql.Array} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4423
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4424
     * This method updates a column value in either the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4425
     * the insert row of this rowset, but it does not update the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4426
     * database.  If the cursor is on a row in the rowset, the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4427
     * method {@link #updateRow} must be called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4428
     * If the cursor is on the insert row, the method {@link #insertRow}
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4429
     * must be called, which will insert the new row into both this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4430
     * and the database. Both of these methods must be called before the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4431
     * cursor moves to another row.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4432
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4433
     * @param columnName a {@code String} object that must match the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4434
     *        SQL name of a column in this rowset, ignoring case
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4435
     * @param a the new column {@code Array} value
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4436
     * @throws SQLException if (1) the given column name does not match the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4437
     *            name of a column in this rowset, (2) the cursor is not on
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4438
     *            one of this rowset's rows or its insert row, or (3) this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4439
     *            rowset is {@code ResultSet.CONCUR_READ_ONLY}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4440
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4441
    public void updateArray(String columnName, Array a) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4442
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4443
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4444
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4445
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4446
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4447
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4448
     * {@code CachedRowSetImpl} object as a {@code java.net.URL} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4449
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4450
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4451
     * @return a java.net.URL object containing the resource reference described by
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4452
     * the URL
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4453
     * @throws SQLException if (1) the given column index is out of bounds,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4454
     * (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4455
     * insert row, or (3) the designated column does not store an
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4456
     * SQL {@code DATALINK} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4457
     * @see #getURL(String)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4458
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4459
    public java.net.URL getURL(int columnIndex) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4460
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4461
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4462
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4463
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4464
     * Retrieves the value of the designated column in this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4465
     * {@code CachedRowSetImpl} object as a {@code java.net.URL} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4466
     * in the Java programming language.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4467
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4468
     * @return a java.net.URL object containing the resource reference described by
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4469
     * the URL
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4470
     * @throws SQLException if (1) the given column name not the name of a column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4471
     * in this rowset, or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4472
     * (2) the cursor is not on one of this rowset's rows or its
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4473
     * insert row, or (3) the designated column does not store an
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4474
     * SQL {@code DATALINK} value.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4475
     * @see #getURL(int)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4476
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4477
    public java.net.URL getURL(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4478
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4479
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4480
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4481
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4482
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4483
     * The first warning reported by calls on this {@code CachedRowSetImpl}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4484
     * object is returned. Subsequent {@code CachedRowSetImpl} warnings will
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4485
     * be chained to this {@code SQLWarning}. All {@code RowSetWarnings}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4486
     * warnings are generated in the disconnected environment and remain a
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4487
     * seperate warning chain to that provided by the {@code getWarnings}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4488
     * method.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4489
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4490
     * <P>The warning chain is automatically cleared each time a new
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4491
     * row is read.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4492
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4493
     * <P><B>Note:</B> This warning chain only covers warnings caused
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4494
     * by {@code CachedRowSet} (and their child interface)
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4495
     * methods. All {@code SQLWarnings} can be obtained using the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4496
     * {@code getWarnings} method which tracks warnings generated
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4497
     * by the underlying JDBC driver.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4498
     * @return the first SQLWarning or null
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4499
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4500
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4501
    public RowSetWarning getRowSetWarnings() {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4502
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4503
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4504
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4505
     /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4506
     * Commits all changes performed by the {@code acceptChanges()}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4507
     * methods
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4508
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4509
     * @see java.sql.Connection#commit
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4510
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4511
    public void commit() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4512
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4513
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4514
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4515
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4516
     * Rolls back all changes performed by the {@code acceptChanges()}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4517
     * methods
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4518
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4519
     * @see java.sql.Connection#rollback
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4520
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4521
    public void rollback() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4522
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4523
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4524
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4525
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4526
     * Rolls back all changes performed by the {@code acceptChanges()}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4527
     * to the last {@code Savepoint} transaction marker.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4528
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4529
     * @see java.sql.Connection#rollback(Savepoint)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4530
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4531
    public void rollback(Savepoint s) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4532
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4533
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4534
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4535
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4536
     * Unsets the designated parameter to the given int array.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4537
     * This was set using {@code setMatchColumn}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4538
     * as the column which will form the basis of the join.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4539
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4540
     * The parameter value unset by this method should be same
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4541
     * as was set.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4542
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4543
     * @param columnIdxes the index into this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4544
     *        object's internal representation of parameter values
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4545
     * @throws SQLException if an error occurs or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4546
     *  parameter index is out of bounds or if the columnIdx is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4547
     *  not the same as set using {@code setMatchColumn(int [])}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4548
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4549
    public void unsetMatchColumn(int[] columnIdxes) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4550
         throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4551
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4552
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4553
   /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4554
     * Unsets the designated parameter to the given String array.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4555
     * This was set using {@code setMatchColumn}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4556
     * as the column which will form the basis of the join.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4557
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4558
     * The parameter value unset by this method should be same
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4559
     * as was set.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4560
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4561
     * @param columnIdxes the index into this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4562
     *        object's internal representation of parameter values
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4563
     * @throws SQLException if an error occurs or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4564
     *  parameter index is out of bounds or if the columnName is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4565
     *  not the same as set using {@code setMatchColumn(String [])}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4566
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4567
    public void unsetMatchColumn(String[] columnIdxes) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4568
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4569
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4570
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4571
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4572
     * Retrieves the column name as {@code String} array
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4573
     * that was set using {@code setMatchColumn(String [])}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4574
     * for this rowset.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4575
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4576
     * @return a {@code String} array object that contains the column names
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4577
     *         for the rowset which has this the match columns
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4578
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4579
     * @throws SQLException if an error occurs or column name is not set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4580
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4581
    public String[] getMatchColumnNames() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4582
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4583
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4584
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4585
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4586
     * Retrieves the column id as {@code int} array that was set using
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4587
     * {@code setMatchColumn(int [])} for this rowset.
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4588
     *
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4589
     * @return a {@code int} array object that contains the column ids
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4590
     *         for the rowset which has this as the match columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4591
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4592
     * @throws SQLException if an error occurs or column index is not set
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4593
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4594
    public int[] getMatchColumnIndexes() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4595
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4596
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4597
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4598
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4599
     * Sets the designated parameter to the given int array.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4600
     * This forms the basis of the join for the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4601
     * {@code JoinRowSet} as the column which will form the basis of the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4602
     * join.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4603
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4604
     * The parameter value set by this method is stored internally and
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4605
     * will be supplied as the appropriate parameter in this rowset's
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4606
     * command when the method {@code getMatchColumnIndexes} is called.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4607
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4608
     * @param columnIdxes the indexes into this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4609
     *        object's internal representation of parameter values; the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4610
     *        first parameter is 0, the second is 1, and so on; must be
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4611
     *        {@code 0} or greater
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4612
     * @throws SQLException if an error occurs or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4613
     *                         parameter index is out of bounds
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4614
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4615
    public void setMatchColumn(int[] columnIdxes) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4616
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4617
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4618
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4619
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4620
     * Sets the designated parameter to the given String array.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4621
     *  This forms the basis of the join for the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4622
     * {@code JoinRowSet} as the column which will form the basis of the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4623
     * join.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4624
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4625
     * The parameter value set by this method is stored internally and
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4626
     * will be supplied as the appropriate parameter in this rowset's
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4627
     * command when the method {@code getMatchColumn} is called.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4628
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4629
     * @param columnNames the name of the column into this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4630
     *        object's internal representation of parameter values
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4631
     * @throws SQLException if an error occurs or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4632
     *  parameter index is out of bounds
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4633
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4634
    public void setMatchColumn(String[] columnNames) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4635
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4636
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4637
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4638
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4639
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4640
     * Sets the designated parameter to the given {@code int}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4641
     * object.  This forms the basis of the join for the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4642
     * {@code JoinRowSet} as the column which will form the basis of the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4643
     * join.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4644
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4645
     * The parameter value set by this method is stored internally and
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4646
     * will be supplied as the appropriate parameter in this rowset's
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4647
     * command when the method {@code getMatchColumn} is called.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4648
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4649
     * @param columnIdx the index into this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4650
     *        object's internal representation of parameter values; the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4651
     *        first parameter is 0, the second is 1, and so on; must be
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4652
     *        {@code 0} or greater
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4653
     * @throws SQLException if an error occurs or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4654
     *                         parameter index is out of bounds
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4655
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4656
    public void setMatchColumn(int columnIdx) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4657
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4658
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4659
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4660
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4661
     * Sets the designated parameter to the given {@code String}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4662
     * object.  This forms the basis of the join for the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4663
     * {@code JoinRowSet} as the column which will form the basis of the
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4664
     * join.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4665
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4666
     * The parameter value set by this method is stored internally and
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4667
     * will be supplied as the appropriate parameter in this rowset's
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4668
     * command when the method {@code getMatchColumn} is called.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4669
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4670
     * @param columnName the name of the column into this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4671
     *        object's internal representation of parameter values
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4672
     * @throws SQLException if an error occurs or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4673
     *  parameter index is out of bounds
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4674
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4675
    public void setMatchColumn(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4676
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4677
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4678
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4679
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4680
     * Unsets the designated parameter to the given {@code int}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4681
     * object.  This was set using {@code setMatchColumn}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4682
     * as the column which will form the basis of the join.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4683
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4684
     * The parameter value unset by this method should be same
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4685
     * as was set.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4686
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4687
     * @param columnIdx the index into this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4688
     *        object's internal representation of parameter values
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4689
     * @throws SQLException if an error occurs or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4690
     *  parameter index is out of bounds or if the columnIdx is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4691
     *  not the same as set using {@code setMatchColumn(int)}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4692
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4693
    public void unsetMatchColumn(int columnIdx) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4694
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4695
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4696
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4697
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4698
     * Unsets the designated parameter to the given {@code String}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4699
     * object.  This was set using {@code setMatchColumn}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4700
     * as the column which will form the basis of the join.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4701
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4702
     * The parameter value unset by this method should be same
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4703
     * as was set.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4704
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4705
     * @param columnName the index into this rowset
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4706
     *        object's internal representation of parameter values
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4707
     * @throws SQLException if an error occurs or the
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4708
     *  parameter index is out of bounds or if the columnName is
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4709
     *  not the same as set using {@code setMatchColumn(String)}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4710
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4711
    public void unsetMatchColumn(String columnName) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4712
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4713
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4714
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4715
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4716
     * Notifies registered listeners that a RowSet object in the given RowSetEvent
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4717
     * object has populated a number of additional rows. The {@code numRows} parameter
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4718
     * ensures that this event will only be fired every {@code numRow}.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4719
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4720
     * The source of the event can be retrieved with the method event.getSource.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4721
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4722
     * @param event a {@code RowSetEvent} object that contains the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4723
     *     {@code RowSet} object that is the source of the events
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4724
     * @param numRows when populating, the number of rows interval on which the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4725
     *     {@code CachedRowSet} populated should fire; the default value
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4726
     *     is zero; cannot be less than {@code fetchSize} or zero
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4727
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4728
    public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4729
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4730
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4731
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4732
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4733
     * Populates this {@code CachedRowSet} object with data from
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4734
     * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4735
     * method, an additional parameter is provided to allow starting position within
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4736
     * the {@code ResultSet} from where to populate the CachedRowSet
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4737
     * instance.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4738
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4739
     * This method is an alternative to the method {@code execute}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4740
     * for filling the rowset with data.  The method {@code populate}
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4741
     * does not require that the properties needed by the method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4742
     * {@code execute}, such as the {@code command} property,
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4743
     * be set. This is true because the method {@code populate}
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4744
     * is given the {@code ResultSet} object from
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4745
     * which to get data and thus does not need to use the properties
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4746
     * required for setting up a connection and executing this
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4747
     * {@code CachedRowSetImpl} object's command.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4748
     * <P>
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4749
     * After populating this rowset with data, the method
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4750
     * {@code populate} sets the rowset's metadata and
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4751
     * then sends a {@code RowSetChangedEvent} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4752
     * to all registered listeners prior to returning.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4753
     *
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4754
     * @param data the {@code ResultSet} object containing the data
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4755
     *             to be read into this {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4756
     * @param start the integer specifing the position in the
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4757
     *        {@code ResultSet} object to popultate the
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4758
     *        {@code CachedRowSetImpl} object.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4759
     * @throws SQLException if an error occurs; or the max row setting is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4760
     *          violated while populating the RowSet.Also id the start position
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4761
     *          is negative.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4762
     * @see #execute
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4763
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4764
     public void populate(ResultSet data, int start) throws SQLException{
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4765
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4766
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4767
     }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4768
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4769
    /**
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4770
     * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4771
     * containing the number of rows specified by page size.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4772
     * @return boolean value true indicating whether there are more pages to come and
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4773
     *         false indicating that this is the last page.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4774
     * @throws SQLException if an error occurs or this called before calling populate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4775
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4776
     public boolean nextPage() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4777
         throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4778
     }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4779
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4780
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4781
     * This is the setter function for setting the size of the page, which specifies
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4782
     * how many rows have to be retrived at a time.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4783
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4784
     * @param size which is the page size
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4785
     * @throws SQLException if size is less than zero or greater than max rows.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4786
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4787
     public void setPageSize (int size) throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4788
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4789
     }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4790
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4791
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4792
     * This is the getter function for the size of the page.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4793
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4794
     * @return an integer that is the page size.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4795
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4796
    public int getPageSize() {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4797
        throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4798
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4799
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4800
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4801
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4802
     * Retrieves the data present in the page prior to the page from where it is
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4803
     * called.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4804
     * @return boolean value true if it retrieves the previous page, flase if it
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4805
     *         is on the first page.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4806
     * @throws SQLException if it is called before populate is called or ResultSet
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4807
     *         is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4808
     *         occurs.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4809
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4810
    public boolean previousPage() throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4811
       throw new UnsupportedOperationException();
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4812
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4813
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4814
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4815
       * Updates the designated column with a character stream value, which will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4816
       * have the specified number of bytes. The driver does the necessary conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4817
       * from Java character format to the national character set in the database.
31061
fead7d86d75f 8081517: minor cleanup for docs
avstepan
parents: 28059
diff changeset
  4818
       * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4819
       * The updater methods are used to update column values in the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4820
       * the insert row. The updater methods do not update the underlying database;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4821
       * instead the updateRow or insertRow methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4822
       *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4823
       * @param columnIndex - the first column is 1, the second is 2, ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4824
       * @param x - the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4825
       * @param length - the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4826
       * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4827
       * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4828
       */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4829
       public void updateNCharacterStream(int columnIndex,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4830
                            java.io.Reader x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4831
                            int length)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4832
                            throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4833
          throw new UnsupportedOperationException("Operation not yet supported");
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4834
       }
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4835
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4836
     /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4837
       * Updates the designated column with a character stream value, which will
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4838
       * have the specified number of bytes. The driver does the necessary conversion
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4839
       * from Java character format to the national character set in the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4840
       * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4841
       * The updater methods are used to update column values in the current row or
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4842
       * the insert row. The updater methods do not update the underlying database;
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4843
       * instead the updateRow or insertRow methods are called to update the database.
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4844
       *
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4845
       * @param columnName - name of the Column
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4846
       * @param x - the new column value
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4847
       * @param length - the length of the stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4848
       * @exception SQLException if a database access error occurs
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4849
       * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4850
       */
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4851
       public void updateNCharacterStream(String columnName,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4852
                            java.io.Reader x,
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4853
                            int length)
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4854
                            throws SQLException {
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4855
          throw new UnsupportedOperationException("Operation not yet supported");
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4856
       }
6530
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4857
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4858
      /**
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4859
       * This method re populates the resBundle
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4860
       * during the deserialization process
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4861
       *
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4862
       */
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4863
       private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException {
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4864
         // Default state initialization happens here
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4865
         ois.defaultReadObject();
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4866
         // Initialization of transient Res Bundle happens here .
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4867
         try {
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4868
            resBundle = JdbcRowSetResourceBundle.getJdbcRowSetResourceBundle();
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4869
         } catch(IOException ioe) {
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4870
             throw new RuntimeException(ioe);
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4871
         }
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4872
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4873
       }
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4874
bfb7b294dd14 6680198: UnmarshalException caused by incompatible serialVersionUID
lancea
parents: 5506
diff changeset
  4875
       static final long serialVersionUID = -3345004441725080251L;
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
  4876
} //end class