package com.cyc.query.client;
/*
* #%L
* File: QueryResultSetImpl.java
* Project: Query Client
* %%
* Copyright (C) 2013 - 2017 Cycorp, Inc.
* %%
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
* #L%
*/
import com.cyc.base.cycobject.CycVariable;
import com.cyc.base.inference.InferenceResultSet;
import com.cyc.baseclient.inference.DefaultResultSet;
import com.cyc.kb.KbObject;
import com.cyc.kb.Variable;
import com.cyc.kb.client.KbObjectImpl;
import com.cyc.kb.client.VariableImpl;
import com.cyc.kb.exception.CreateException;
import com.cyc.kb.exception.KbException;
import com.cyc.kb.exception.KbTypeException;
import com.cyc.query.InferenceIdentifier;
import com.cyc.query.QueryAnswer;
import com.cyc.query.QueryResultSet;
import com.cyc.query.exception.QueryRuntimeException;
import java.sql.Date;
import java.sql.SQLException;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
*
QueryResultSetImpl provides a class for easy access and manipulation of
inference results. It tries to closely mimic the {@link java.sql.ResultSet}
* interface, but does not implement all of its methods.
*
* In this paradigm, the results of a Query are a table with one row for each
* answer, and one column for each query variable. There is a cursor that can be
* moved from row to row, and various getter methods that retrieve the binding
* for a particular variable (i.e. the value in the column corresponding to that
* variable) on the current row.
*
* The cursor starts out just before the first row, and can be advanced to just
* after the last row. Otherwise, it is on whatever the current row is.
*
* In general, KBInferenceResult sets should not be created by application
* developers, but should be retrieved from a {@link Query} object using
* {@link Query#getResultSet()}.
*
* @author daves
*/
public class QueryResultSetImpl implements QueryResultSet, Iterable {
private final Logger logger = LoggerFactory.getLogger(QueryResultSetImpl.class.getName());
private final InferenceResultSet rs;
private volatile List columns = null;
/**
* Create a new KBInferenceResultSet from a list of results.
*
* @param results
*/
protected QueryResultSetImpl(List results) {
this.rs = new DefaultResultSet(results);
}
/**
* Construct a new KBInferenceResultSet from an InferenceResultSet.
*
* @param rs
*/
protected QueryResultSetImpl(InferenceResultSet rs) {
this.rs = rs;
}
@Override
public String toString() {
return rs.toString();
}
/**
* Return the object at columnIndex as an instance of type.
*
* @param the expected type of the value.
* @param columnIndex the index of the column.
* @param type the expected type of the value.
* @return the object at columnIndex as an instance of type
* @throws IllegalArgumentException if the object at columnIndex cannot be
* converted to type
* @throws ArrayIndexOutOfBoundsException if columnIndex doesn't correspond to
* a valid column in the result set.
*/
@Override
public T getObject(int columnIndex, Class type) throws IllegalArgumentException, ArrayIndexOutOfBoundsException {
Object obj = rs.getObject(columnIndex);
try {
return KbObjectImpl.checkAndCastObject(obj);
} catch (CreateException ex) {
throw new IllegalArgumentException(ex);
}
}
/**
* Return the binding for variable as an instance of type.
*
* @param the expected type of the value.
* @param columnIndex
* @param type the expected type of the value.
* @return the binding for variable as an instance of
* type.
* @throws IllegalArgumentException if the binding for variable
* cannot be converted to type.
* @throws ArrayIndexOutOfBoundsException if columnIndex doesn't correspond to
* a valid column in the result set.
*/
@Override
public T getObject(Variable columnIndex, Class type) {
return this.getObject("?" + columnIndex.getName(), type);
}
/**
* Return the object at the column with columnLabel as an instance of type.
*
* @param the expected type of the value.
* @param columnLabel the label of the column, i.e. the name of the variable,
* e.g. "?X".
* @param type the expected type of the value.
* @return the object at columnIndex as an instance of type
* @throws IllegalArgumentException if the value cannot be converted to
* type
* @throws ArrayIndexOutOfBoundsException if columnIndex doesn't correspond to
* a valid column in the result set.
*/
@Override
public T getObject(String columnLabel, Class type) {
try {
Object obj = rs.getObject(columnLabel);
return KbObjectImpl.checkAndCastObject(obj);
} catch (SQLException | CreateException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Return the object at the column with columnLabel.
*
* @param columnLabel
* @return the value at the current row for the specified column.
* @throws com.cyc.kb.exception.KBApiException
* @throws IllegalArgumentException
* @throws ArrayIndexOutOfBoundsException
*/
// @Override
// public Object getObject(String columnLabel) throws KBApiException {
// return getKBObject(columnLabel);
// }
/**
* Return the object at columnIndex as a {@link KbObject} or java
* primitive, with an expected type of T.
*
* @param the expected type of the value.
* @param columnIndex the index of the column. Cf.
* {@link #findColumn(Variable)}.
* @return the value at the current row for the specified column.
* @throws IllegalArgumentException
* @throws ArrayIndexOutOfBoundsException
*/
@Override
public T getKbObject(int columnIndex, Class type) throws IllegalArgumentException, ArrayIndexOutOfBoundsException {
Object obj = rs.getObject(columnIndex);
try {
return KbObjectImpl.checkAndCastObject(obj);
} catch (KbException ex) {
logger.error("Problem getting KBObject.", ex);
throw new QueryRuntimeException(ex);
}
}
/**
* Return the binding for variable as a {@link KbObject} or java
* primitive, with an expected type of T.
*
* @param the expected type of the value.
* @param variable the variable for which a binding is sought.
* @return the value at the current row for the specified column.
* @throws IllegalArgumentException
* @throws com.cyc.kb.exception.KbException
* @throws ArrayIndexOutOfBoundsException
*/
@Override
public T getKbObject(Variable variable, Class type) throws IllegalArgumentException, KbException {
return getKbObject("?" + variable.getName(), type);
}
/**
* Return the object at the column with columnLabel as a
* {@link KbObject} or java primitive, with an expected type of
* T.
*
* @param the expected type of the value.
* @param columnLabel
* @param type
* @return the value at the current row for the specified column.
* @throws IllegalArgumentException
* @throws com.cyc.kb.exception.KbException
* @throws ArrayIndexOutOfBoundsException
*/
@Override
public T getKbObject(String columnLabel, Class type) throws IllegalArgumentException, KbException {
try {
Object obj = rs.getObject(columnLabel);
return KbObjectImpl.checkAndCastObject(obj);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* @return the InferenceIdentifier associated with this QueryResultSetImpl.
If the inference is not available on the Cyc server, this will return null.
*/
@Override
public InferenceIdentifier getInferenceIdentifier() {
return rs.getInferenceIdentifier();
}
/**
* Returns the InferenceResultSet that underlies this QueryResultSetImpl.
*
* @return the InferenceResultSet that underlies this QueryResultSetImpl
*/
InferenceResultSet getInferenceResultSet() {
return rs;
}
/**
* Returns a list of column names that are available.
*
* @return a list of column names that are available.
*/
@Override
public List getColumnNames() {
return rs.getColumnNames();
}
@Override
public List getColumns() {
List result = this.columns;
if (result == null) {
// Double-checked locking, woohoo...
synchronized (this) {
result = this.columns;
if (result == null) {
try {
result = new ArrayList();
for (String name : getColumnNames()) {
result.add(new VariableImpl(name));
}
this.columns = result;
} catch (KbTypeException ex) {
throw new QueryRuntimeException(ex);
}
}
}
}
return result;
}
/**
* Returns whether the inference associated with this
* InferenceResultSet object is finished.
*
* @return true if the inference associated with this
* InferenceResultSet object is finished;false if
* the inference associated with this InferenceResultSet might
* possibly produce more results.
*/
@Override
public boolean isInferenceComplete() {
return rs.isInferenceComplete();
}
/**
* Releases this QueryResultSetImpl object's server side
* inference resources. Failure to close a result set may leave significant
* resources hanging around the server until the client CycAccess
* object is closed.
*
* Calling the method close on a InferenceResultSet
* object that is already closed is a no-op.
*/
@Override
public synchronized void close() {
rs.close();
}
/**
* Moves the cursor forward one row from its current position. A
* QueryResultSetImpl cursor is initially positioned before the
* first row; the first call to the method next makes the first
* row the current row; the second call makes the second row the current row,
* and so on.
*
* @return true if the new current row is valid;
* false if there are no more rows
*/
@Override
public boolean next() {
return rs.next();
}
/**
* Returns the column index for variable.
*
* @param variable The variable of interest.
* @return the column index for variable.
* @throws IllegalArgumentException
*/
@Override
public int findColumn(Variable variable) throws IllegalArgumentException {
return rs.findColumn((CycVariable) (variable.getCore()));
}
/**
* Returns the number of rows currently in the result set.
*
* @return the number of rows currently in the result set
*/
@Override
public Integer getCurrentRowCount() {
return rs.getCurrentRowCount();
}
/**
* Returns the truth value for this query.
*
* @return the truth value for this boolean query
* @throws QueryRuntimeException if the query has open variables.
*/
@Override
public boolean getTruthValue() {
return rs.getTruthValue();
}
/**
* Returns, as a String, the value at the current row and at the
* column identified by columnIndex. Returns null if
* no value is set for the current row and given column.
*
* @param columnIndex the column index of interest (one-based)
* @return the value, as a String, at the current row and at the
* column identified by columnIndex. Returns null,
* if no value is set for the current row and given column.
* @throws IllegalArgumentException if columnIndex is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* String
*/
@Override
public String getString(int columnIndex) {
return rs.getString(columnIndex);
}
/**
* Implementation of {@link java.sql.ResultSet#getBoolean(int)}.
*
* @param columnIndex
* @return the value at the specified column in the current row.
*/
@Override
public boolean getBoolean(int columnIndex) {
try {
return rs.getBoolean(columnIndex);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Returns, as a int, the value at the current row and at the
* column identified by columnIndex. Returns null if
* no value is set for the current row and given column.
*
* @param columnIndex the column index of interest (one-based)
* @return the value, as a int, at the current row and at the
* column identified by columnIndex. Returns null,
* if no value is set for the current row and given column.
* @throws IllegalArgumentException if columnIndex is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* int
*/
@Override
public int getInt(int columnIndex) {
return rs.getInt(columnIndex);
}
/**
* Returns, as a long, the value at the current row and at the
* column identified by columnIndex. Returns null if
* no value is set for the current row and given column.
*
* @param columnIndex the column index of interest (one-based)
* @return the value, as a long, at the current row and at the
* column identified by columnIndex. Returns null,
* if no value is set for the current row and given column.
* @throws IllegalArgumentException if columnIndex is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* long
*/
@Override
public long getLong(int columnIndex) {
return rs.getLong(columnIndex);
}
/**
* Implementation of {@link java.sql.ResultSet#getFloat(int)}.
*
* @param columnIndex
* @return the value at the specified column in the current row.
*/
@Override
public float getFloat(int columnIndex) {
try {
return rs.getFloat(columnIndex);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#getDouble(int)}.
*
* @param columnIndex
* @return the value at the specified column in the current row.
*/
@Override
public double getDouble(int columnIndex) {
try {
return rs.getDouble(columnIndex);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Returns, as a String, the value at the current row for
* variable. Returns null if no value is set for the
* current row and given column.
*
*
* Note: Use the method
* int colIindex = findColumn(col) once and the version of this
* method that takes an integer for maximum performance.
*
* @param variable the variable of interest
* @return the value, as a String, at the current row for
* variable. Returns null, if no value is set for
* the current row and given column.
* @throws IllegalArgumentException if variable is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* String
*/
@Override
public String getString(Variable variable) {
return getString("?" + variable.getName());
}
/**
* Returns, as a String, the value at the current row and at the
* column identified by columnLabel. Returns null if
* no value is set for the current row and given column.
*
*
* Note: Use the method
* int colIindex = findColumn(col) once and the version of this
* method that takes an integer for maximum performance.
*
* @param columnLabel the name of the variable that represents the column of
* interest
* @return the value, as a String, at the current row and at the
* column identified by the columnLabel. Returns
* null, if no value is set for the current row and given column.
* @throws IllegalArgumentException if columnLabel is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* String
*/
@Override
public String getString(String columnLabel) {
return rs.getString(columnLabel);
}
/**
* Returns, as a boolean, the value at the current row for
* variable. Returns null if no value is set for the
* current row and given column.
*
*
* Note: Use the method
* int colIindex = findColumn(col) once and the version of this
* method that takes an integer for maximum performance.
*
* @param variable the variable of interest
* @return the value, as a boolean, at the current row for
* variable. Returns null, if no value is set for
* the current row and given column.
* @throws IllegalArgumentException if variable is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* boolean
*/
@Override
public boolean getBoolean(Variable variable) {
return getBoolean("?" + variable.getName());
}
/**
* Implementation of {@link java.sql.ResultSet#getBoolean(String)}.
*
* @param columnLabel
* @return the value at the specified column in the current row.
*/
@Override
public boolean getBoolean(String columnLabel) {
try {
return rs.getBoolean(columnLabel);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Returns, as a int, the value at the current row for
* variable. Returns null if no value is set for the
* current row and given column.
*
*
* Note: Use the method
* int colIindex = findColumn(col) once and the version of this
* method that takes an integer for maximum performance.
*
* @param variable the variable of interest
* @return the value, as a int, at the current row and for
* variable. Returns null, if no value is set for
* the current row and given column.
* @throws IllegalArgumentException if variable is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* int
*/
@Override
public int getInt(Variable variable) {
return getInt("?" + variable.getName());
}
/**
* Returns, as a int, the value at the current row and at the
* column identified by columnLabel. Returns null if
* no value is set for the current row and given column.
*
*
* Note: Use the method
* int colIindex = findColumn(col) once and the version of this
* method that takes an integer for maximum performance.
*
* @param columnLabel the name of the variable that represents the column of
* interest
* @return the value, as a int, at the current row and at the
* column identified by the columnLabely. Returns
* null, if no value is set for the current row and given column.
* @throws IllegalArgumentException if columnLabel is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* int
*/
@Override
public int getInt(String columnLabel) {
return rs.getInt(columnLabel);
}
/**
* Returns, as a long, the value at the current row for
* variable. Returns null if no value is set for the
* current row and given column.
*
*
* Note: Use the method
* int colIindex = findColumn(col) once and the version of this
* method that takes an integer for maximum performance.
*
* @param variable the name of the variable that represents the column of
* interest
* @return the value, as a long, at the current row for
* variable. Returns null, if no value is set for
* the current row and given column.
* @throws IllegalArgumentException if variable is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* long
*/
@Override
public long getLong(Variable variable) {
return getLong("?" + variable.getName());
}
/**
* Returns, as a long, the value at the current row and at the
* column identified by columnLabel. Returns null if
* no value is set for the current row and given column.
*
*
* Note: Use the method
* int colIindex = findColumn(col) once and the version of this
* method that takes an integer for maximum performance.
*
* @param columnLabel the name of the variable that represents the column of
* interest
* @return the value, as a long, at the current row and at the
* column identified by the columnLabel. Returns
* null, if no value is set for the current row and given column.
* @throws IllegalArgumentException if columnLabel is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* long
*/
@Override
public long getLong(String columnLabel) {
return rs.getLong(columnLabel);
}
/**
* Returns, as a float, the value at the current row for
* variable. Returns null if no value is set for the
* current row and given column.
*
*
* Note: Use the method
* int colIindex = findColumn(col) once and the version of this
* method that takes an integer for maximum performance.
*
* @param variable the name of the variable that represents the column of
* interest
* @return the value, as a float, at the current row for
* variable. Returns null, if no value is set for
* the current row and given column.
* @throws IllegalArgumentException if variable is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* float
*/
@Override
public float getFloat(Variable variable) {
return getFloat("?" + variable.getName());
}
/**
* Returns, as a float, the value at the current row and at the
* column identified by columnLabel. Returns null if
* no value is set for the current row and given column.
*
*
* Note: Use the method
* int colIindex = findColumn(col) once and the version of this
* method that takes an integer for maximum performance.
*
* @param columnLabel the name of the variable that represents the column of
* interest
* @return the value, as a float, at the current row and at the
* column identified by the columnLabel. Returns
* null, if no value is set for the current row and given column.
* @throws IllegalArgumentException if columnLabel is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* float
*/
@Override
public float getFloat(String columnLabel) {
try {
return rs.getFloat(columnLabel);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Returns, as a double, the value at the current row for
* variable. Returns null if no value is set for the
* current row and given column.
*
*
* Note: Use the method
* int colIindex = findColumn(col) once and the version of this
* method that takes an integer for maximum performance.
*
* @param variable the name of the variable that represents the column of
* interest
* @return the value, as a double, at the current row for
* variable. Returns null, if no value is set for
* the current row and given column.
* @throws IllegalArgumentException if variable is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* double
*/
@Override
public double getDouble(Variable variable) {
return getDouble("?" + variable.getName());
}
/**
* Returns, as a double, the value at the current row and at the
* column identified by columnLabel. Returns null if
* no value is set for the current row and given column.
*
*
* Note: Use the method
* int colIindex = findColumn(col) once and the version of this
* method that takes an integer for maximum performance.
*
* @param columnLabel the name of the variable that represents the column of
* interest
* @return the value, as a double, at the current row and at the
* column identified by the columnLabel. Returns
* null, if no value is set for the current row and given column.
* @throws IllegalArgumentException if columnLabel is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* double
*/
@Override
public double getDouble(String columnLabel) {
try {
return rs.getDouble(columnLabel);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
@Override
public Date getDate(int columnIndex) {
try {
return rs.getDate(columnIndex);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Returns, as a java.sql.Date object, the value in the current
* row at the column identified by columnLabel, which should be
* the name of a Variable in the original query. Returns
* null if no value is set for the current row and given column.
*
* This method fails on dates that do not use #$YearFn (i.e. it will not
* work on skolemized dates, or other forms of dates that don't use the
* #$YearFn vocabulary).
*
* @param columnLabel
* @return the value at the current row and at the column identified by
* columnLabel as a Date object
* @throws IllegalArgumentException if columnLabel is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* {@link java.sql.Date}
*/
@Override
public Date getDate(String columnLabel) {
try {
return rs.getDate(columnLabel);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Returns, as a java.sql.Date object, the value in the current
* row for variable. Returns null if no value is set for the
* current row and given variable.
*
* This method fails on dates that do not use #$YearFn (i.e. it will not
* work on skolemized dates, or other forms of dates that don't use the
* #$YearFn vocabulary).
*
* @param variable
* @return the value at the current row and at the column identified by
* variable as a Date object
* @throws IllegalArgumentException if variable is not valid
* @throws ArrayIndexOutOfBoundsException if the current cursor is not on a
* valid row
* @throws ClassCastException if the value is not convertible to a
* {@link java.sql.Date}
*/
@Override
public Date getDate(Variable variable) {
return getDate("?" + variable.getName());
}
/**
* Returns the column index for columnLabel.
*
* @param columnLabel the column name to look up
* @return the column index for the given columnLabel.
* @throws IllegalArgumentException if called with an invalid
* columnLabel
*/
@Override
public int findColumn(String columnLabel) {
try {
return rs.findColumn(columnLabel);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#isBeforeFirst()}.
*
* @return true if the cursor is before the first row;
* false if the cursor is at any other position or the result set
* contains no rows
*/
@Override
public boolean isBeforeFirst() {
try {
return rs.isBeforeFirst();
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#isAfterLast()}.
*
* @return true if the cursor is after the last row;
* false if the cursor is at any other position or the result set
* contains no rows
*/
@Override
public boolean isAfterLast() {
try {
return rs.isAfterLast();
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#isFirst()}.
*
* @return true if the cursor is on the first row;
* false otherwise
*/
@Override
public boolean isFirst() {
try {
return rs.isFirst();
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#isLast()}.
*
* @return true if the cursor is on the last row;
* false otherwise
*/
@Override
public boolean isLast() {
try {
return rs.isLast();
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#beforeFirst()}.
*
* Places the cursor just before the first row.
*
*/
@Override
public void beforeFirst() {
try {
rs.beforeFirst();
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#afterLast()}.
*
* Places the cursor just after the last row.
*
*/
@Override
public void afterLast() {
try {
rs.afterLast();
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#first()}. Moves the cursor to
* the first row.
*
* @return true if the cursor is on a valid row;
* false if there are no rows in the result set
*/
@Override
public boolean first() {
try {
return rs.first();
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#last()}. Moves the cursor to
* the last row.
*
* @return true if the cursor is on a valid row;
* false if there are no rows in the result set
*/
@Override
public boolean last() {
try {
return rs.last();
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#getRow()}.
*
* @return the current row number; 0 if there is no current row
*/
@Override
public int getRow() {
try {
return rs.getRow();
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#absolute(int)}. Moves the
* cursor to the specified row.
*
* @param row the row to which to move the cursor
* @return true if the cursor is moved to a position in this
* QueryResultSetImpl object; false if the cursor
* is before the first row or after the last row
*/
@Override
public boolean absolute(int row) {
try {
return rs.absolute(row);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#relative(int)}. Moves the
* cursor up or down the specified number of rows.
*
* @param rows the number of rows to move the cursor.
* @return true if the cursor is on a row; false
* otherwise
*/
@Override
public boolean relative(int rows) {
try {
return rs.relative(rows);
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#previous()}. Moves the cursor
* to the previous row.
*
* @return true if the cursor is now positioned on a valid row;
* false if the cursor is positioned before the first row
*/
@Override
public boolean previous() {
try {
return rs.previous();
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
/**
* Implementation of {@link java.sql.ResultSet#isClosed()}.
*
* @return true if this QueryResultSetImpl object is closed;
* false if it is still open
*/
@Override
public boolean isClosed() {
try {
return rs.isClosed();
} catch (SQLException ex) {
throw new QueryRuntimeException(ex);
}
}
@Override
public Iterator iterator() {
//@todo figure out how to implement this...
throw new UnsupportedOperationException("Not supported yet.");
}
}
