root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity

Revised SqlRowSet javadoc 

Issue: SPR-12476
This commit is contained in:
Juergen Hoeller 2014-11-27 01:41:48 +01:00
parent 0e3b26da27
commit a6a837bc3b
1 changed files with 115 additions and 102 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

217
spring-jdbc/src/main/java/org/springframework/jdbc/support/rowset/SqlRowSet.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright 2002-2012 the original author or authors. * Copyright 2002-2014 the original author or authors.
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
@ -27,8 +27,8 @@ import java.util.Map;
import org.springframework.jdbc.InvalidResultSetAccessException; import org.springframework.jdbc.InvalidResultSetAccessException;
/** /**
* Mirror interface for {@code javax.sql.RowSet}, representing * Mirror interface for {@link javax.sql.RowSet}, representing
* disconnected {@code java.sql.ResultSet} data. * disconnected {@link java.sql.ResultSet} data.
* *
* <p>The main difference to the standard JDBC RowSet is that an SQLException * <p>The main difference to the standard JDBC RowSet is that an SQLException
* is never thrown here. This allows a SqlRowSet to be used without having * is never thrown here. This allows a SqlRowSet to be used without having
@ -51,15 +51,15 @@ import org.springframework.jdbc.InvalidResultSetAccessException;
public interface SqlRowSet extends Serializable { public interface SqlRowSet extends Serializable {
/** /**
* Retrieves the meta data (number, types and properties for the columns) * Retrieve the meta data, i.e. number, types and properties
* of this row set. * for the columns of this row set.
* @return a corresponding SqlRowSetMetaData instance * @return a corresponding SqlRowSetMetaData instance
* @see java.sql.ResultSet#getMetaData() * @see java.sql.ResultSet#getMetaData()
*/ */
SqlRowSetMetaData getMetaData(); SqlRowSetMetaData getMetaData();
/** /**
* Maps the given column label to its column index. * Map the given column label to its column index.
* @param columnLabel the name of the column * @param columnLabel the name of the column
* @return the column index for the given column label * @return the column index for the given column label
* @see java.sql.ResultSet#findColumn(String) * @see java.sql.ResultSet#findColumn(String)
@ -70,8 +70,8 @@ public interface SqlRowSet extends Serializable {
// RowSet methods for extracting data values // RowSet methods for extracting data values
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* an BigDecimal object. * as a BigDecimal object.
* @param columnIndex the column index * @param columnIndex the column index
* @return an BigDecimal object representing the column value * @return an BigDecimal object representing the column value
* @see java.sql.ResultSet#getBigDecimal(int) * @see java.sql.ResultSet#getBigDecimal(int)
@ -79,8 +79,8 @@ public interface SqlRowSet extends Serializable {
BigDecimal getBigDecimal(int columnIndex) throws InvalidResultSetAccessException; BigDecimal getBigDecimal(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* an BigDecimal object. * as a BigDecimal object.
* @param columnLabel the column label * @param columnLabel the column label
* @return an BigDecimal object representing the column value * @return an BigDecimal object representing the column value
* @see java.sql.ResultSet#getBigDecimal(java.lang.String) * @see java.sql.ResultSet#getBigDecimal(java.lang.String)
@ -88,8 +88,8 @@ public interface SqlRowSet extends Serializable {
BigDecimal getBigDecimal(String columnLabel) throws InvalidResultSetAccessException; BigDecimal getBigDecimal(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a boolean. * as a boolean.
* @param columnIndex the column index * @param columnIndex the column index
* @return a boolean representing the column value * @return a boolean representing the column value
* @see java.sql.ResultSet#getBoolean(int) * @see java.sql.ResultSet#getBoolean(int)
@ -97,8 +97,8 @@ public interface SqlRowSet extends Serializable {
boolean getBoolean(int columnIndex) throws InvalidResultSetAccessException; boolean getBoolean(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a boolean. * as a boolean.
* @param columnLabel the column label * @param columnLabel the column label
* @return a boolean representing the column value * @return a boolean representing the column value
* @see java.sql.ResultSet#getBoolean(java.lang.String) * @see java.sql.ResultSet#getBoolean(java.lang.String)
@ -106,8 +106,8 @@ public interface SqlRowSet extends Serializable {
boolean getBoolean(String columnLabel) throws InvalidResultSetAccessException; boolean getBoolean(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a byte. * as a byte.
* @param columnIndex the column index * @param columnIndex the column index
* @return a byte representing the column value * @return a byte representing the column value
* @see java.sql.ResultSet#getByte(int) * @see java.sql.ResultSet#getByte(int)
@ -115,8 +115,8 @@ public interface SqlRowSet extends Serializable {
byte getByte(int columnIndex) throws InvalidResultSetAccessException; byte getByte(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a byte. * as a byte.
* @param columnLabel the column label * @param columnLabel the column label
* @return a byte representing the column value * @return a byte representing the column value
* @see java.sql.ResultSet#getByte(java.lang.String) * @see java.sql.ResultSet#getByte(java.lang.String)
@ -124,8 +124,8 @@ public interface SqlRowSet extends Serializable {
byte getByte(String columnLabel) throws InvalidResultSetAccessException; byte getByte(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Date object. * as a Date object.
* @param columnIndex the column index * @param columnIndex the column index
* @param cal the Calendar to use in constructing the Date * @param cal the Calendar to use in constructing the Date
* @return a Date object representing the column value * @return a Date object representing the column value
@ -134,8 +134,8 @@ public interface SqlRowSet extends Serializable {
Date getDate(int columnIndex, Calendar cal) throws InvalidResultSetAccessException; Date getDate(int columnIndex, Calendar cal) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Date object. * as a Date object.
* @param columnIndex the column index * @param columnIndex the column index
* @return a Date object representing the column value * @return a Date object representing the column value
* @see java.sql.ResultSet#getDate(int) * @see java.sql.ResultSet#getDate(int)
@ -143,8 +143,8 @@ public interface SqlRowSet extends Serializable {
Date getDate(int columnIndex) throws InvalidResultSetAccessException; Date getDate(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Date object. * as a Date object.
* @param columnLabel the column label * @param columnLabel the column label
* @param cal the Calendar to use in constructing the Date * @param cal the Calendar to use in constructing the Date
* @return a Date object representing the column value * @return a Date object representing the column value
@ -153,8 +153,8 @@ public interface SqlRowSet extends Serializable {
Date getDate(String columnLabel, Calendar cal) throws InvalidResultSetAccessException; Date getDate(String columnLabel, Calendar cal) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Date object. * as a Date object.
* @param columnLabel the column label * @param columnLabel the column label
* @return a Date object representing the column value * @return a Date object representing the column value
* @see java.sql.ResultSet#getDate(java.lang.String) * @see java.sql.ResultSet#getDate(java.lang.String)
@ -162,8 +162,8 @@ public interface SqlRowSet extends Serializable {
Date getDate(String columnLabel) throws InvalidResultSetAccessException; Date getDate(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Double object. * as a Double object.
* @param columnIndex the column index * @param columnIndex the column index
* @return a Double object representing the column value * @return a Double object representing the column value
* @see java.sql.ResultSet#getDouble(int) * @see java.sql.ResultSet#getDouble(int)
@ -171,8 +171,8 @@ public interface SqlRowSet extends Serializable {
double getDouble(int columnIndex) throws InvalidResultSetAccessException; double getDouble(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Double object. * as a Double object.
* @param columnLabel the column label * @param columnLabel the column label
* @return a Double object representing the column value * @return a Double object representing the column value
* @see java.sql.ResultSet#getDouble(java.lang.String) * @see java.sql.ResultSet#getDouble(java.lang.String)
@ -180,8 +180,8 @@ public interface SqlRowSet extends Serializable {
double getDouble(String columnLabel) throws InvalidResultSetAccessException; double getDouble(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a float. * as a float.
* @param columnIndex the column index * @param columnIndex the column index
* @return a float representing the column value * @return a float representing the column value
* @see java.sql.ResultSet#getFloat(int) * @see java.sql.ResultSet#getFloat(int)
@ -189,8 +189,8 @@ public interface SqlRowSet extends Serializable {
float getFloat(int columnIndex) throws InvalidResultSetAccessException; float getFloat(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a float. * as a float.
* @param columnLabel the column label * @param columnLabel the column label
* @return a float representing the column value * @return a float representing the column value
* @see java.sql.ResultSet#getFloat(java.lang.String) * @see java.sql.ResultSet#getFloat(java.lang.String)
@ -198,8 +198,8 @@ public interface SqlRowSet extends Serializable {
float getFloat(String columnLabel) throws InvalidResultSetAccessException; float getFloat(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* an int. * as an int.
* @param columnIndex the column index * @param columnIndex the column index
* @return an int representing the column value * @return an int representing the column value
* @see java.sql.ResultSet#getInt(int) * @see java.sql.ResultSet#getInt(int)
@ -207,8 +207,8 @@ public interface SqlRowSet extends Serializable {
int getInt(int columnIndex) throws InvalidResultSetAccessException; int getInt(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* an int. * as an int.
* @param columnLabel the column label * @param columnLabel the column label
* @return an int representing the column value * @return an int representing the column value
* @see java.sql.ResultSet#getInt(java.lang.String) * @see java.sql.ResultSet#getInt(java.lang.String)
@ -216,8 +216,8 @@ public interface SqlRowSet extends Serializable {
int getInt(String columnLabel) throws InvalidResultSetAccessException; int getInt(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a long. * as a long.
* @param columnIndex the column index * @param columnIndex the column index
* @return a long representing the column value * @return a long representing the column value
* @see java.sql.ResultSet#getLong(int) * @see java.sql.ResultSet#getLong(int)
@ -225,8 +225,8 @@ public interface SqlRowSet extends Serializable {
long getLong(int columnIndex) throws InvalidResultSetAccessException; long getLong(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a long. * as a long.
* @param columnLabel the column label * @param columnLabel the column label
* @return a long representing the column value * @return a long representing the column value
* @see java.sql.ResultSet#getLong(java.lang.String) * @see java.sql.ResultSet#getLong(java.lang.String)
@ -234,8 +234,8 @@ public interface SqlRowSet extends Serializable {
long getLong(String columnLabel) throws InvalidResultSetAccessException; long getLong(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* an Object. * as an Object.
* @param columnIndex the column index * @param columnIndex the column index
* @param map a Map object containing the mapping from SQL types to Java types * @param map a Map object containing the mapping from SQL types to Java types
* @return a Object representing the column value * @return a Object representing the column value
@ -244,8 +244,8 @@ public interface SqlRowSet extends Serializable {
Object getObject(int columnIndex, Map<String, Class<?>> map) throws InvalidResultSetAccessException; Object getObject(int columnIndex, Map<String, Class<?>> map) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* an Object. * as an Object.
* @param columnIndex the column index * @param columnIndex the column index
* @return a Object representing the column value * @return a Object representing the column value
* @see java.sql.ResultSet#getObject(int) * @see java.sql.ResultSet#getObject(int)
@ -253,8 +253,8 @@ public interface SqlRowSet extends Serializable {
Object getObject(int columnIndex) throws InvalidResultSetAccessException; Object getObject(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* an Object. * as an Object.
* @param columnLabel the column label * @param columnLabel the column label
* @param map a Map object containing the mapping from SQL types to Java types * @param map a Map object containing the mapping from SQL types to Java types
* @return a Object representing the column value * @return a Object representing the column value
@ -263,8 +263,8 @@ public interface SqlRowSet extends Serializable {
Object getObject(String columnLabel, Map<String, Class<?>> map) throws InvalidResultSetAccessException; Object getObject(String columnLabel, Map<String, Class<?>> map) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* an Object. * as an Object.
* @param columnLabel the column label * @param columnLabel the column label
* @return a Object representing the column value * @return a Object representing the column value
* @see java.sql.ResultSet#getObject(java.lang.String) * @see java.sql.ResultSet#getObject(java.lang.String)
@ -272,8 +272,8 @@ public interface SqlRowSet extends Serializable {
Object getObject(String columnLabel) throws InvalidResultSetAccessException; Object getObject(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a short. * as a short.
* @param columnIndex the column index * @param columnIndex the column index
* @return a short representing the column value * @return a short representing the column value
* @see java.sql.ResultSet#getShort(int) * @see java.sql.ResultSet#getShort(int)
@ -281,8 +281,8 @@ public interface SqlRowSet extends Serializable {
short getShort(int columnIndex) throws InvalidResultSetAccessException; short getShort(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a short. * as a short.
* @param columnLabel the column label * @param columnLabel the column label
* @return a short representing the column value * @return a short representing the column value
* @see java.sql.ResultSet#getShort(java.lang.String) * @see java.sql.ResultSet#getShort(java.lang.String)
@ -290,8 +290,8 @@ public interface SqlRowSet extends Serializable {
short getShort(String columnLabel) throws InvalidResultSetAccessException; short getShort(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a String. * as a String.
* @param columnIndex the column index * @param columnIndex the column index
* @return a String representing the column value * @return a String representing the column value
* @see java.sql.ResultSet#getString(int) * @see java.sql.ResultSet#getString(int)
@ -299,8 +299,8 @@ public interface SqlRowSet extends Serializable {
String getString(int columnIndex) throws InvalidResultSetAccessException; String getString(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a String. * as a String.
* @param columnLabel the column label * @param columnLabel the column label
* @return a String representing the column value * @return a String representing the column value
* @see java.sql.ResultSet#getString(java.lang.String) * @see java.sql.ResultSet#getString(java.lang.String)
@ -308,8 +308,8 @@ public interface SqlRowSet extends Serializable {
String getString(String columnLabel) throws InvalidResultSetAccessException; String getString(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Time object. * as a Time object.
* @param columnIndex the column index * @param columnIndex the column index
* @param cal the Calendar to use in constructing the Date * @param cal the Calendar to use in constructing the Date
* @return a Time object representing the column value * @return a Time object representing the column value
@ -318,8 +318,8 @@ public interface SqlRowSet extends Serializable {
Time getTime(int columnIndex, Calendar cal) throws InvalidResultSetAccessException; Time getTime(int columnIndex, Calendar cal) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Time object. * as a Time object.
* @param columnIndex the column index * @param columnIndex the column index
* @return a Time object representing the column value * @return a Time object representing the column value
* @see java.sql.ResultSet#getTime(int) * @see java.sql.ResultSet#getTime(int)
@ -327,8 +327,8 @@ public interface SqlRowSet extends Serializable {
Time getTime(int columnIndex) throws InvalidResultSetAccessException; Time getTime(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Time object. * as a Time object.
* @param columnLabel the column label * @param columnLabel the column label
* @param cal the Calendar to use in constructing the Date * @param cal the Calendar to use in constructing the Date
* @return a Time object representing the column value * @return a Time object representing the column value
@ -337,8 +337,8 @@ public interface SqlRowSet extends Serializable {
Time getTime(String columnLabel, Calendar cal) throws InvalidResultSetAccessException; Time getTime(String columnLabel, Calendar cal) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Time object. * as a Time object.
* @param columnLabel the column label * @param columnLabel the column label
* @return a Time object representing the column value * @return a Time object representing the column value
* @see java.sql.ResultSet#getTime(java.lang.String) * @see java.sql.ResultSet#getTime(java.lang.String)
@ -346,8 +346,8 @@ public interface SqlRowSet extends Serializable {
Time getTime(String columnLabel) throws InvalidResultSetAccessException; Time getTime(String columnLabel) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Timestamp object. * as a Timestamp object.
* @param columnIndex the column index * @param columnIndex the column index
* @param cal the Calendar to use in constructing the Date * @param cal the Calendar to use in constructing the Date
* @return a Timestamp object representing the column value * @return a Timestamp object representing the column value
@ -356,8 +356,8 @@ public interface SqlRowSet extends Serializable {
Timestamp getTimestamp(int columnIndex, Calendar cal) throws InvalidResultSetAccessException; Timestamp getTimestamp(int columnIndex, Calendar cal) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Timestamp object. * as a Timestamp object.
* @param columnIndex the column index * @param columnIndex the column index
* @return a Timestamp object representing the column value * @return a Timestamp object representing the column value
* @see java.sql.ResultSet#getTimestamp(int) * @see java.sql.ResultSet#getTimestamp(int)
@ -365,8 +365,8 @@ public interface SqlRowSet extends Serializable {
Timestamp getTimestamp(int columnIndex) throws InvalidResultSetAccessException; Timestamp getTimestamp(int columnIndex) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Timestamp object. * as a Timestamp object.
* @param columnLabel the column label * @param columnLabel the column label
* @param cal the Calendar to use in constructing the Date * @param cal the Calendar to use in constructing the Date
* @return a Timestamp object representing the column value * @return a Timestamp object representing the column value
@ -375,8 +375,8 @@ public interface SqlRowSet extends Serializable {
Timestamp getTimestamp(String columnLabel, Calendar cal) throws InvalidResultSetAccessException; Timestamp getTimestamp(String columnLabel, Calendar cal) throws InvalidResultSetAccessException;
/** /**
* Retrieves the value of the indicated column in the current row as * Retrieve the value of the indicated column in the current row
* a Timestamp object. * as a Timestamp object.
* @param columnLabel the column label * @param columnLabel the column label
* @return a Timestamp object representing the column value * @return a Timestamp object representing the column value
* @see java.sql.ResultSet#getTimestamp(java.lang.String) * @see java.sql.ResultSet#getTimestamp(java.lang.String)
@ -387,101 +387,114 @@ public interface SqlRowSet extends Serializable {
// RowSet navigation methods // RowSet navigation methods
/** /**
* Moves the cursor to the given row number in the RowSet, just after the last row. * Move the cursor to the given row number in the row set,
* just after the last row.
* @param row the number of the row where the cursor should move * @param row the number of the row where the cursor should move
* @return true if the cursor is on the RowSet, false otherwise * @return {@code true} if the cursor is on the row set,
* {@code false} otherwise
* @see java.sql.ResultSet#absolute(int) * @see java.sql.ResultSet#absolute(int)
*/ */
boolean absolute(int row) throws InvalidResultSetAccessException; boolean absolute(int row) throws InvalidResultSetAccessException;
/** /**
* Moves the cursor to the end of this RowSet. * Move the cursor to the end of this row set.
* @see java.sql.ResultSet#afterLast() * @see java.sql.ResultSet#afterLast()
*/ */
void afterLast() throws InvalidResultSetAccessException; void afterLast() throws InvalidResultSetAccessException;
/** /**
* Moves the cursor to the front of this RowSet, just before the first row. * Move the cursor to the front of this row set,
* just before the first row.
* @see java.sql.ResultSet#beforeFirst() * @see java.sql.ResultSet#beforeFirst()
*/ */
void beforeFirst() throws InvalidResultSetAccessException; void beforeFirst() throws InvalidResultSetAccessException;
/** /**
* Moves the cursor to the first row of this RowSet. * Move the cursor to the first row of this row set.
* @return true if the cursor is on a valid row, false otherwise * @return {@code true} if the cursor is on a valid row,
* {@code false} otherwise
* @see java.sql.ResultSet#first() * @see java.sql.ResultSet#first()
*/ */
boolean first() throws InvalidResultSetAccessException; boolean first() throws InvalidResultSetAccessException;
/** /**
* Retrieves the current row number. * Retrieve the current row number.
* @return the current row number * @return the current row number
* @see java.sql.ResultSet#getRow() * @see java.sql.ResultSet#getRow()
*/ */
int getRow() throws InvalidResultSetAccessException; int getRow() throws InvalidResultSetAccessException;
/** /**
* Retrieves whether the cursor is after the last row of this RowSet. * Retrieve whether the cursor is after the last row of this row set.
* @return true if the cursor is after the last row, false otherwise * @return {@code true} if the cursor is after the last row,
* {@code false} otherwise
* @see java.sql.ResultSet#isAfterLast() * @see java.sql.ResultSet#isAfterLast()
*/ */
boolean isAfterLast() throws InvalidResultSetAccessException; boolean isAfterLast() throws InvalidResultSetAccessException;
/** /**
* Retrieves whether the cursor is after the first row of this RowSet. * Retrieve whether the cursor is before the first row of this row set.
* @return true if the cursor is after the first row, false otherwise * @return {@code true} if the cursor is before the first row,
* {@code false} otherwise
* @see java.sql.ResultSet#isBeforeFirst() * @see java.sql.ResultSet#isBeforeFirst()
*/ */
boolean isBeforeFirst() throws InvalidResultSetAccessException; boolean isBeforeFirst() throws InvalidResultSetAccessException;
/** /**
* Retrieves whether the cursor is on the first row of this RowSet. * Retrieve whether the cursor is on the first row of this row set.
* @return true if the cursor is after the first row, false otherwise * @return {@code true} if the cursor is after the first row,
* {@code false} otherwise
* @see java.sql.ResultSet#isFirst() * @see java.sql.ResultSet#isFirst()
*/ */
boolean isFirst() throws InvalidResultSetAccessException; boolean isFirst() throws InvalidResultSetAccessException;
/** /**
* Retrieves whether the cursor is on the last row of this RowSet. * Retrieve whether the cursor is on the last row of this row set.
* @return true if the cursor is after the last row, false otherwise * @return {@code true} if the cursor is after the last row,
* {@code false} otherwise
* @see java.sql.ResultSet#isLast() * @see java.sql.ResultSet#isLast()
*/ */
boolean isLast() throws InvalidResultSetAccessException; boolean isLast() throws InvalidResultSetAccessException;
/** /**
* Moves the cursor to the last row of this RowSet. * Move the cursor to the last row of this row set.
* @return true if the cursor is on a valid row, false otherwise * @return {@code true} if the cursor is on a valid row,
* {@code false} otherwise
* @see java.sql.ResultSet#last() * @see java.sql.ResultSet#last()
*/ */
boolean last() throws InvalidResultSetAccessException; boolean last() throws InvalidResultSetAccessException;
/** /**
* Moves the cursor to the next row. * Move the cursor to the next row.
* @return true if the new row is valid, false if there are no more rows * @return {@code true} if the new row is valid,
* {@code false} if there are no more rows
* @see java.sql.ResultSet#next() * @see java.sql.ResultSet#next()
*/ */
boolean next() throws InvalidResultSetAccessException; boolean next() throws InvalidResultSetAccessException;
/** /**
* Moves the cursor to the previous row. * Move the cursor to the previous row.
* @return true if the new row is valid, false if it is off the RowSet * @return {@code true} if the new row is valid,
* {@code false} if it is off the row set
* @see java.sql.ResultSet#previous() * @see java.sql.ResultSet#previous()
*/ */
boolean previous() throws InvalidResultSetAccessException; boolean previous() throws InvalidResultSetAccessException;
/** /**
* Moves the cursor a relative number f rows, either positive or negative. * Move the cursor a relative number of rows,
* @return true if the cursor is on a row, false otherwise * either positive or negative.
* @return {@code true} if the cursor is on a row,
* {@code false} otherwise
* @see java.sql.ResultSet#relative(int) * @see java.sql.ResultSet#relative(int)
*/ */
boolean relative(int rows) throws InvalidResultSetAccessException; boolean relative(int rows) throws InvalidResultSetAccessException;
/** /**
* Reports whether the last column read had a value of SQL {@code NULL}. * Report whether the last column read had a value of SQL {@code NULL}.
* Note that you must first call one of the getter methods and then call * <p>Note that you must first call one of the getter methods
* the {@code wasNull} method. * and then call the {@code wasNull()} method.
* @return true if the most recent coumn retrieved was SQL {@code NULL}, * @return {@code true} if the most recent coumn retrieved was
* false otherwise * SQL {@code NULL}, {@code false} otherwise
* @see java.sql.ResultSet#wasNull() * @see java.sql.ResultSet#wasNull()
*/ */
boolean wasNull() throws InvalidResultSetAccessException; boolean wasNull() throws InvalidResultSetAccessException;