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 and support for JDBC 4.x ResultSet additions 

Issue: SPR-12476
Issue: SPR-12480
This commit is contained in:
Juergen Hoeller 2014-11-27 18:01:19 +01:00
parent 0caeffcd54
commit fc92c0010e
2 changed files with 333 additions and 234 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

174
spring-jdbc/src/main/java/org/springframework/jdbc/support/rowset/ResultSetWrappingSqlRowSet.java
View File

@ -221,7 +221,28 @@ public class ResultSetWrappingSqlRowSet implements SqlRowSet {
}
/**
* @see java.sql.ResultSet#getDate(int, java.util.Calendar)
* @see java.sql.ResultSet#getDate(int)
*/
@Override
public Date getDate(int columnIndex) throws InvalidResultSetAccessException {
try {
return this.resultSet.getDate(columnIndex);
}
catch (SQLException se) {
throw new InvalidResultSetAccessException(se);
}
}
/**
* @see java.sql.ResultSet#getDate(String)
*/
@Override
public Date getDate(String columnLabel) throws InvalidResultSetAccessException {
return getDate(findColumn(columnLabel));
}
/**
* @see java.sql.ResultSet#getDate(int, Calendar)
*/
@Override
public Date getDate(int columnIndex, Calendar cal) throws InvalidResultSetAccessException {
@ -234,33 +255,13 @@ public class ResultSetWrappingSqlRowSet implements SqlRowSet {
}
/**
* @see java.sql.ResultSet#getDate(int)
*/
@Override
public Date getDate(int columnIndex) throws InvalidResultSetAccessException {
try {
return this.resultSet.getDate(columnIndex);
}
catch (SQLException se) {
throw new InvalidResultSetAccessException(se);
}
}
/**
* @see java.sql.ResultSet#getDate(String, java.util.Calendar)
* @see java.sql.ResultSet#getDate(String, Calendar)
*/
@Override
public Date getDate(String columnLabel, Calendar cal) throws InvalidResultSetAccessException {
return getDate(findColumn(columnLabel), cal);
}
/**
* @see java.sql.ResultSet#getDate(String)
*/
@Override
public Date getDate(String columnLabel) throws InvalidResultSetAccessException {
return getDate(findColumn(columnLabel));
}
/**
* @see java.sql.ResultSet#getDouble(int)
*/
@ -302,6 +303,7 @@ public class ResultSetWrappingSqlRowSet implements SqlRowSet {
public float getFloat(String columnLabel) throws InvalidResultSetAccessException {
return getFloat(findColumn(columnLabel));
}
/**
* @see java.sql.ResultSet#getInt(int)
*/
@ -345,18 +347,26 @@ public class ResultSetWrappingSqlRowSet implements SqlRowSet {
}
/**
* @see java.sql.ResultSet#getObject(int, java.util.Map)
* @see java.sql.ResultSet#getNString(int)
*/
@Override
public Object getObject(int i, Map<String, Class<?>> map) throws InvalidResultSetAccessException {
public String getNString(int columnIndex) throws InvalidResultSetAccessException {
try {
return this.resultSet.getObject(i, map);
return this.resultSet.getNString(columnIndex);
}
catch (SQLException se) {
throw new InvalidResultSetAccessException(se);
}
}
/**
* @see java.sql.ResultSet#getNString(String)
*/
@Override
public String getNString(String columnLabel) throws InvalidResultSetAccessException {
return getNString(findColumn(columnLabel));
}
/**
* @see java.sql.ResultSet#getObject(int)
*/
@ -370,14 +380,6 @@ public class ResultSetWrappingSqlRowSet implements SqlRowSet {
}
}
/**
* @see java.sql.ResultSet#getObject(String, java.util.Map)
*/
@Override
public Object getObject(String columnLabel, Map<String, Class<?>> map) throws InvalidResultSetAccessException {
return getObject(findColumn(columnLabel), map);
}
/**
* @see java.sql.ResultSet#getObject(String)
*/
@ -386,6 +388,48 @@ public class ResultSetWrappingSqlRowSet implements SqlRowSet {
return getObject(findColumn(columnLabel));
}
/**
* @see java.sql.ResultSet#getObject(int, Map)
*/
@Override
public Object getObject(int columnIndex, Map<String, Class<?>> map) throws InvalidResultSetAccessException {
try {
return this.resultSet.getObject(columnIndex, map);
}
catch (SQLException se) {
throw new InvalidResultSetAccessException(se);
}
}
/**
* @see java.sql.ResultSet#getObject(String, Map)
*/
@Override
public Object getObject(String columnLabel, Map<String, Class<?>> map) throws InvalidResultSetAccessException {
return getObject(findColumn(columnLabel), map);
}
/**
* @see java.sql.ResultSet#getObject(int, Class)
*/
@Override
public <T> T getObject(int columnIndex, Class<T> type) throws InvalidResultSetAccessException {
try {
return this.resultSet.getObject(columnIndex, type);
}
catch (SQLException se) {
throw new InvalidResultSetAccessException(se);
}
}
/**
* @see java.sql.ResultSet#getObject(String, Class)
*/
@Override
public <T> T getObject(String columnLabel, Class<T> type) throws InvalidResultSetAccessException {
return getObject(findColumn(columnLabel), type);
}
/**
* @see java.sql.ResultSet#getShort(int)
*/
@ -428,19 +472,6 @@ public class ResultSetWrappingSqlRowSet implements SqlRowSet {
return getString(findColumn(columnLabel));
}
/**
* @see java.sql.ResultSet#getTime(int, java.util.Calendar)
*/
@Override
public Time getTime(int columnIndex, Calendar cal) throws InvalidResultSetAccessException {
try {
return this.resultSet.getTime(columnIndex, cal);
}
catch (SQLException se) {
throw new InvalidResultSetAccessException(se);
}
}
/**
* @see java.sql.ResultSet#getTime(int)
*/
@ -454,14 +485,6 @@ public class ResultSetWrappingSqlRowSet implements SqlRowSet {
}
}
/**
* @see java.sql.ResultSet#getTime(String, java.util.Calendar)
*/
@Override
public Time getTime(String columnLabel, Calendar cal) throws InvalidResultSetAccessException {
return getTime(findColumn(columnLabel), cal);
}
/**
* @see java.sql.ResultSet#getTime(String)
*/
@ -471,18 +494,26 @@ public class ResultSetWrappingSqlRowSet implements SqlRowSet {
}
/**
* @see java.sql.ResultSet#getTimestamp(int, java.util.Calendar)
* @see java.sql.ResultSet#getTime(int, Calendar)
*/
@Override
public Timestamp getTimestamp(int columnIndex, Calendar cal) throws InvalidResultSetAccessException {
public Time getTime(int columnIndex, Calendar cal) throws InvalidResultSetAccessException {
try {
return this.resultSet.getTimestamp(columnIndex, cal);
return this.resultSet.getTime(columnIndex, cal);
}
catch (SQLException se) {
throw new InvalidResultSetAccessException(se);
}
}
/**
* @see java.sql.ResultSet#getTime(String, Calendar)
*/
@Override
public Time getTime(String columnLabel, Calendar cal) throws InvalidResultSetAccessException {
return getTime(findColumn(columnLabel), cal);
}
/**
* @see java.sql.ResultSet#getTimestamp(int)
*/
@ -496,14 +527,6 @@ public class ResultSetWrappingSqlRowSet implements SqlRowSet {
}
}
/**
* @see java.sql.ResultSet#getTimestamp(String, java.util.Calendar)
*/
@Override
public Timestamp getTimestamp(String columnLabel, Calendar cal) throws InvalidResultSetAccessException {
return getTimestamp(findColumn(columnLabel), cal);
}
/**
* @see java.sql.ResultSet#getTimestamp(String)
*/
@ -512,6 +535,27 @@ public class ResultSetWrappingSqlRowSet implements SqlRowSet {
return getTimestamp(findColumn(columnLabel));
}
/**
* @see java.sql.ResultSet#getTimestamp(int, Calendar)
*/
@Override
public Timestamp getTimestamp(int columnIndex, Calendar cal) throws InvalidResultSetAccessException {
try {
return this.resultSet.getTimestamp(columnIndex, cal);
}
catch (SQLException se) {
throw new InvalidResultSetAccessException(se);
}
}
/**
* @see java.sql.ResultSet#getTimestamp(String, Calendar)
*/
@Override
public Timestamp getTimestamp(String columnLabel, Calendar cal) throws InvalidResultSetAccessException {
return getTimestamp(findColumn(columnLabel), cal);
}
// RowSet navigation methods

393
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");
* 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;
/**
* Mirror interface for {@code javax.sql.RowSet}, representing
* disconnected {@code java.sql.ResultSet} data.
* Mirror interface for {@link javax.sql.RowSet}, representing
* disconnected {@link java.sql.ResultSet} data.
*
* <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
@ -51,15 +51,15 @@ import org.springframework.jdbc.InvalidResultSetAccessException;
public interface SqlRowSet extends Serializable {
/**
* Retrieves the meta data (number, types and properties for the columns)
* of this row set.
* Retrieve the meta data, i.e. number, types and properties
* for the columns of this row set.
* @return a corresponding SqlRowSetMetaData instance
* @see java.sql.ResultSet#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
* @return the column index for the given column label
* @see java.sql.ResultSet#findColumn(String)
@ -70,8 +70,8 @@ public interface SqlRowSet extends Serializable {
// RowSet methods for extracting data values
/**
* Retrieves the value of the indicated column in the current row as
* an BigDecimal object.
* Retrieve the value of the indicated column in the current row
* as a BigDecimal object.
* @param columnIndex the column index
* @return an BigDecimal object representing the column value
* @see java.sql.ResultSet#getBigDecimal(int)
@ -79,17 +79,17 @@ public interface SqlRowSet extends Serializable {
BigDecimal getBigDecimal(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* an BigDecimal object.
* Retrieve the value of the indicated column in the current row
* as a BigDecimal object.
* @param columnLabel the column label
* @return an BigDecimal object representing the column value
* @see java.sql.ResultSet#getBigDecimal(java.lang.String)
* @see java.sql.ResultSet#getBigDecimal(String)
*/
BigDecimal getBigDecimal(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a boolean.
* Retrieve the value of the indicated column in the current row
* as a boolean.
* @param columnIndex the column index
* @return a boolean representing the column value
* @see java.sql.ResultSet#getBoolean(int)
@ -97,17 +97,17 @@ public interface SqlRowSet extends Serializable {
boolean getBoolean(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a boolean.
* Retrieve the value of the indicated column in the current row
* as a boolean.
* @param columnLabel the column label
* @return a boolean representing the column value
* @see java.sql.ResultSet#getBoolean(java.lang.String)
* @see java.sql.ResultSet#getBoolean(String)
*/
boolean getBoolean(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a byte.
* Retrieve the value of the indicated column in the current row
* as a byte.
* @param columnIndex the column index
* @return a byte representing the column value
* @see java.sql.ResultSet#getByte(int)
@ -115,27 +115,17 @@ public interface SqlRowSet extends Serializable {
byte getByte(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a byte.
* Retrieve the value of the indicated column in the current row
* as a byte.
* @param columnLabel the column label
* @return a byte representing the column value
* @see java.sql.ResultSet#getByte(java.lang.String)
* @see java.sql.ResultSet#getByte(String)
*/
byte getByte(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Date object.
* @param columnIndex the column index
* @param cal the Calendar to use in constructing the Date
* @return a Date object representing the column value
* @see java.sql.ResultSet#getDate(int, java.util.Calendar)
*/
Date getDate(int columnIndex, Calendar cal) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Date object.
* Retrieve the value of the indicated column in the current row
* as a Date object.
* @param columnIndex the column index
* @return a Date object representing the column value
* @see java.sql.ResultSet#getDate(int)
@ -143,27 +133,37 @@ public interface SqlRowSet extends Serializable {
Date getDate(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Date object.
* @param columnLabel the column label
* @param cal the Calendar to use in constructing the Date
* @return a Date object representing the column value
* @see java.sql.ResultSet#getDate(java.lang.String, java.util.Calendar)
*/
Date getDate(String columnLabel, Calendar cal) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Date object.
* Retrieve the value of the indicated column in the current row
* as a Date object.
* @param columnLabel the column label
* @return a Date object representing the column value
* @see java.sql.ResultSet#getDate(java.lang.String)
* @see java.sql.ResultSet#getDate(String)
*/
Date getDate(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Double object.
* Retrieve the value of the indicated column in the current row
* as a Date object.
* @param columnIndex the column index
* @param cal the Calendar to use in constructing the Date
* @return a Date object representing the column value
* @see java.sql.ResultSet#getDate(int, Calendar)
*/
Date getDate(int columnIndex, Calendar cal) throws InvalidResultSetAccessException;
/**
* Retrieve the value of the indicated column in the current row
* as a Date object.
* @param columnLabel the column label
* @param cal the Calendar to use in constructing the Date
* @return a Date object representing the column value
* @see java.sql.ResultSet#getDate(String, Calendar)
*/
Date getDate(String columnLabel, Calendar cal) throws InvalidResultSetAccessException;
/**
* Retrieve the value of the indicated column in the current row
* as a Double object.
* @param columnIndex the column index
* @return a Double object representing the column value
* @see java.sql.ResultSet#getDouble(int)
@ -171,17 +171,17 @@ public interface SqlRowSet extends Serializable {
double getDouble(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Double object.
* Retrieve the value of the indicated column in the current row
* as a Double object.
* @param columnLabel the column label
* @return a Double object representing the column value
* @see java.sql.ResultSet#getDouble(java.lang.String)
* @see java.sql.ResultSet#getDouble(String)
*/
double getDouble(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a float.
* Retrieve the value of the indicated column in the current row
* as a float.
* @param columnIndex the column index
* @return a float representing the column value
* @see java.sql.ResultSet#getFloat(int)
@ -189,17 +189,17 @@ public interface SqlRowSet extends Serializable {
float getFloat(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a float.
* Retrieve the value of the indicated column in the current row
* as a float.
* @param columnLabel the column label
* @return a float representing the column value
* @see java.sql.ResultSet#getFloat(java.lang.String)
* @see java.sql.ResultSet#getFloat(String)
*/
float getFloat(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* an int.
* Retrieve the value of the indicated column in the current row
* as an int.
* @param columnIndex the column index
* @return an int representing the column value
* @see java.sql.ResultSet#getInt(int)
@ -207,17 +207,17 @@ public interface SqlRowSet extends Serializable {
int getInt(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* an int.
* Retrieve the value of the indicated column in the current row
* as an int.
* @param columnLabel the column label
* @return an int representing the column value
* @see java.sql.ResultSet#getInt(java.lang.String)
* @see java.sql.ResultSet#getInt(String)
*/
int getInt(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a long.
* Retrieve the value of the indicated column in the current row
* as a long.
* @param columnIndex the column index
* @return a long representing the column value
* @see java.sql.ResultSet#getLong(int)
@ -225,27 +225,37 @@ public interface SqlRowSet extends Serializable {
long getLong(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a long.
* Retrieve the value of the indicated column in the current row
* as a long.
* @param columnLabel the column label
* @return a long representing the column value
* @see java.sql.ResultSet#getLong(java.lang.String)
* @see java.sql.ResultSet#getLong(String)
*/
long getLong(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* an Object.
* Retrieve the value of the indicated column in the current row
* as a String (for NCHAR, NVARCHAR, LONGNVARCHAR columns).
* @param columnIndex the column index
* @param map a Map object containing the mapping from SQL types to Java types
* @return a Object representing the column value
* @see java.sql.ResultSet#getObject(int, java.util.Map)
* @return a String representing the column value
* @see java.sql.ResultSet#getNString(int)
* @since 4.1.3
*/
Object getObject(int columnIndex, Map<String, Class<?>> map) throws InvalidResultSetAccessException;
String getNString(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* an Object.
* Retrieve the value of the indicated column in the current row
* as a String (for NCHAR, NVARCHAR, LONGNVARCHAR columns).
* @param columnLabel the column label
* @return a String representing the column value
* @see java.sql.ResultSet#getNString(String)
* @since 4.1.3
*/
String getNString(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieve the value of the indicated column in the current row
* as an Object.
* @param columnIndex the column index
* @return a Object representing the column value
* @see java.sql.ResultSet#getObject(int)
@ -253,27 +263,59 @@ public interface SqlRowSet extends Serializable {
Object getObject(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* an Object.
* @param columnLabel the column label
* @param map a Map object containing the mapping from SQL types to Java types
* @return a Object representing the column value
* @see java.sql.ResultSet#getObject(java.lang.String, java.util.Map)
*/
Object getObject(String columnLabel, Map<String, Class<?>> map) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* an Object.
* Retrieve the value of the indicated column in the current row
* as an Object.
* @param columnLabel the column label
* @return a Object representing the column value
* @see java.sql.ResultSet#getObject(java.lang.String)
* @see java.sql.ResultSet#getObject(String)
*/
Object getObject(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a short.
* Retrieve the value of the indicated column in the current row
* as an Object.
* @param columnIndex the column index
* @param map a Map object containing the mapping from SQL types to Java types
* @return a Object representing the column value
* @see java.sql.ResultSet#getObject(int, Map)
*/
Object getObject(int columnIndex, Map<String, Class<?>> map) throws InvalidResultSetAccessException;
/**
* Retrieve the value of the indicated column in the current row
* as an Object.
* @param columnLabel the column label
* @param map a Map object containing the mapping from SQL types to Java types
* @return a Object representing the column value
* @see java.sql.ResultSet#getObject(String, Map)
*/
Object getObject(String columnLabel, Map<String, Class<?>> map) throws InvalidResultSetAccessException;
/**
* Retrieve the value of the indicated column in the current row
* as an Object.
* @param columnIndex the column index
* @param type the Java type to convert the designated column to
* @return a Object representing the column value
* @see java.sql.ResultSet#getObject(int)
* @since 4.1.3
*/
<T> T getObject(int columnIndex, Class<T> type) throws InvalidResultSetAccessException;
/**
* Retrieve the value of the indicated column in the current row
* as an Object.
* @param columnLabel the column label
* @param type the Java type to convert the designated column to
* @return a Object representing the column value
* @see java.sql.ResultSet#getObject(int)
* @since 4.1.3
*/
<T> T getObject(String columnLabel, Class<T> type) throws InvalidResultSetAccessException;
/**
* Retrieve the value of the indicated column in the current row
* as a short.
* @param columnIndex the column index
* @return a short representing the column value
* @see java.sql.ResultSet#getShort(int)
@ -281,17 +323,17 @@ public interface SqlRowSet extends Serializable {
short getShort(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a short.
* Retrieve the value of the indicated column in the current row
* as a short.
* @param columnLabel the column label
* @return a short representing the column value
* @see java.sql.ResultSet#getShort(java.lang.String)
* @see java.sql.ResultSet#getShort(String)
*/
short getShort(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a String.
* Retrieve the value of the indicated column in the current row
* as a String.
* @param columnIndex the column index
* @return a String representing the column value
* @see java.sql.ResultSet#getString(int)
@ -299,27 +341,17 @@ public interface SqlRowSet extends Serializable {
String getString(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a String.
* Retrieve the value of the indicated column in the current row
* as a String.
* @param columnLabel the column label
* @return a String representing the column value
* @see java.sql.ResultSet#getString(java.lang.String)
* @see java.sql.ResultSet#getString(String)
*/
String getString(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Time object.
* @param columnIndex the column index
* @param cal the Calendar to use in constructing the Date
* @return a Time object representing the column value
* @see java.sql.ResultSet#getTime(int, java.util.Calendar)
*/
Time getTime(int columnIndex, Calendar cal) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Time object.
* Retrieve the value of the indicated column in the current row
* as a Time object.
* @param columnIndex the column index
* @return a Time object representing the column value
* @see java.sql.ResultSet#getTime(int)
@ -327,37 +359,37 @@ public interface SqlRowSet extends Serializable {
Time getTime(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Time object.
* @param columnLabel the column label
* @param cal the Calendar to use in constructing the Date
* @return a Time object representing the column value
* @see java.sql.ResultSet#getTime(java.lang.String, java.util.Calendar)
*/
Time getTime(String columnLabel, Calendar cal) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Time object.
* Retrieve the value of the indicated column in the current row
* as a Time object.
* @param columnLabel the column label
* @return a Time object representing the column value
* @see java.sql.ResultSet#getTime(java.lang.String)
* @see java.sql.ResultSet#getTime(String)
*/
Time getTime(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Timestamp object.
* Retrieve the value of the indicated column in the current row
* as a Time object.
* @param columnIndex the column index
* @param cal the Calendar to use in constructing the Date
* @return a Timestamp object representing the column value
* @see java.sql.ResultSet#getTimestamp(int, java.util.Calendar)
* @return a Time object representing the column value
* @see java.sql.ResultSet#getTime(int, Calendar)
*/
Timestamp getTimestamp(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
* a Timestamp object.
* Retrieve the value of the indicated column in the current row
* as a Time object.
* @param columnLabel the column label
* @param cal the Calendar to use in constructing the Date
* @return a Time object representing the column value
* @see java.sql.ResultSet#getTime(String, Calendar)
*/
Time getTime(String columnLabel, Calendar cal) throws InvalidResultSetAccessException;
/**
* Retrieve the value of the indicated column in the current row
* as a Timestamp object.
* @param columnIndex the column index
* @return a Timestamp object representing the column value
* @see java.sql.ResultSet#getTimestamp(int)
@ -365,123 +397,146 @@ public interface SqlRowSet extends Serializable {
Timestamp getTimestamp(int columnIndex) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Timestamp object.
* Retrieve the value of the indicated column in the current row
* as a Timestamp object.
* @param columnLabel the column label
* @return a Timestamp object representing the column value
* @see java.sql.ResultSet#getTimestamp(String)
*/
Timestamp getTimestamp(String columnLabel) throws InvalidResultSetAccessException;
/**
* Retrieve the value of the indicated column in the current row
* as a Timestamp object.
* @param columnIndex the column index
* @param cal the Calendar to use in constructing the Date
* @return a Timestamp object representing the column value
* @see java.sql.ResultSet#getTimestamp(int, Calendar)
*/
Timestamp getTimestamp(int columnIndex, Calendar cal) throws InvalidResultSetAccessException;
/**
* Retrieve the value of the indicated column in the current row
* as a Timestamp object.
* @param columnLabel the column label
* @param cal the Calendar to use in constructing the Date
* @return a Timestamp object representing the column value
* @see java.sql.ResultSet#getTimestamp(java.lang.String, java.util.Calendar)
* @see java.sql.ResultSet#getTimestamp(String, Calendar)
*/
Timestamp getTimestamp(String columnLabel, Calendar cal) throws InvalidResultSetAccessException;
/**
* Retrieves the value of the indicated column in the current row as
* a Timestamp object.
* @param columnLabel the column label
* @return a Timestamp object representing the column value
* @see java.sql.ResultSet#getTimestamp(java.lang.String)
*/
Timestamp getTimestamp(String columnLabel) throws InvalidResultSetAccessException;
// 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
* @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)
*/
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()
*/
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()
*/
void beforeFirst() throws InvalidResultSetAccessException;
/**
* Moves the cursor to the first row of this RowSet.
* @return true if the cursor is on a valid row, false otherwise
* Move the cursor to the first row of this row set.
* @return {@code true} if the cursor is on a valid row,
* {@code false} otherwise
* @see java.sql.ResultSet#first()
*/
boolean first() throws InvalidResultSetAccessException;
/**
* Retrieves the current row number.
* Retrieve the current row number.
* @return the current row number
* @see java.sql.ResultSet#getRow()
*/
int getRow() throws InvalidResultSetAccessException;
/**
* Retrieves whether the cursor is after the last row of this RowSet.
* @return true if the cursor is after the last row, false otherwise
* Retrieve whether the cursor is after the last row of this row set.
* @return {@code true} if the cursor is after the last row,
* {@code false} otherwise
* @see java.sql.ResultSet#isAfterLast()
*/
boolean isAfterLast() throws InvalidResultSetAccessException;
/**
* Retrieves whether the cursor is after the first row of this RowSet.
* @return true if the cursor is after the first row, false otherwise
* Retrieve whether the cursor is before the first row of this row set.
* @return {@code true} if the cursor is before the first row,
* {@code false} otherwise
* @see java.sql.ResultSet#isBeforeFirst()
*/
boolean isBeforeFirst() throws InvalidResultSetAccessException;
/**
* Retrieves whether the cursor is on the first row of this RowSet.
* @return true if the cursor is after the first row, false otherwise
* Retrieve whether the cursor is on the first row of this row set.
* @return {@code true} if the cursor is after the first row,
* {@code false} otherwise
* @see java.sql.ResultSet#isFirst()
*/
boolean isFirst() throws InvalidResultSetAccessException;
/**
* Retrieves whether the cursor is on the last row of this RowSet.
* @return true if the cursor is after the last row, false otherwise
* Retrieve whether the cursor is on the last row of this row set.
* @return {@code true} if the cursor is after the last row,
* {@code false} otherwise
* @see java.sql.ResultSet#isLast()
*/
boolean isLast() throws InvalidResultSetAccessException;
/**
* Moves the cursor to the last row of this RowSet.
* @return true if the cursor is on a valid row, false otherwise
* Move the cursor to the last row of this row set.
* @return {@code true} if the cursor is on a valid row,
* {@code false} otherwise
* @see java.sql.ResultSet#last()
*/
boolean last() throws InvalidResultSetAccessException;
/**
* Moves the cursor to the next row.
* @return true if the new row is valid, false if there are no more rows
* Move the cursor to the next row.
* @return {@code true} if the new row is valid,
* {@code false} if there are no more rows
* @see java.sql.ResultSet#next()
*/
boolean next() throws InvalidResultSetAccessException;
/**
* Moves the cursor to the previous row.
* @return true if the new row is valid, false if it is off the RowSet
* Move the cursor to the previous row.
* @return {@code true} if the new row is valid,
* {@code false} if it is off the row set
* @see java.sql.ResultSet#previous()
*/
boolean previous() throws InvalidResultSetAccessException;
/**
* Moves the cursor a relative number f rows, either positive or negative.
* @return true if the cursor is on a row, false otherwise
* Move the cursor a relative number of rows,
* either positive or negative.
* @return {@code true} if the cursor is on a row,
* {@code false} otherwise
* @see java.sql.ResultSet#relative(int)
*/
boolean relative(int rows) throws InvalidResultSetAccessException;
/**
* Reports 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
* the {@code wasNull} method.
* @return true if the most recent coumn retrieved was SQL {@code NULL},
* false otherwise
* Report whether the last column read had a value of SQL {@code NULL}.
* <p>Note that you must first call one of the getter methods
* and then call the {@code wasNull()} method.
* @return {@code true} if the most recent coumn retrieved was
* SQL {@code NULL}, {@code false} otherwise
* @see java.sql.ResultSet#wasNull()
*/
boolean wasNull() throws InvalidResultSetAccessException;