Package cz.cvut.kbss.ontodriver.iteration

Interface ResultRow

All Known Implementing Classes:
DelegatingResultRow
public interface ResultRow
Represents a single row in a ResultSet.

This interface replicates the value retrieval API of ResultSet and serves as a view of the current row in a result set.

The main purpose of this interface is to support iteration over result sets.

  • Method Summary

    Modifier and Type
    Method
    Description
    int
    findColumn(String columnLabel)
    Retrieves index of a column with the specified label.
    boolean
    getBoolean(int columnIndex)
    Retrieves value from column at the specified index and returns it as a boolean.
    boolean
    getBoolean(String columnLabel)
    Retrieves value from column with the specified label and returns it as a boolean.
    byte
    getByte(int columnIndex)
    Retrieves value from column at the specified index and returns it as byte.
    byte
    getByte(String columnLabel)
    Retrieves value from column with the specified label and returns it as byte.
    int
    getColumnCount()
    Gets the count of available columns.
    double
    getDouble(int columnIndex)
    Retrieves value from column at the specified index and returns it as double.
    double
    getDouble(String columnLabel)
    Retrieves value from column with the specified label and returns it as double.
    float
    getFloat(int columnIndex)
    Retrieves value from column at the specified index and returns it as float.
    float
    getFloat(String columnLabel)
    Retrieves value from column with the specified label and returns it as float.
    int
    getIndex()
    Gets the index of this row (first row has index 0).
    int
    getInt(int columnIndex)
    Retrieves value from column at the specified index and returns it as int.
    int
    getInt(String columnLabel)
    Retrieves value from column with the specified label and returns it as int.
    long
    getLong(int columnIndex)
    Retrieves value from column at the specified index and returns it as long.
    long
    getLong(String columnLabel)
    Retrieves value from column with the specified label and returns it as long.
    Object
    getObject(int columnIndex)
    Retrieves value from column at the specified index and returns it as Object.
    <T> T
    getObject(int columnIndex, Class<T> cls)
    Retrieves value from column at the specified index and returns it as an instance of the specified class.
    Object
    getObject(String columnLabel)
    Retrieves value from column with the specified label and returns it as Object.
    <T> T
    getObject(String columnLabel, Class<T> cls)
    Retrieves value from column with the specified label and returns it as an instance of the specified class.
    short
    getShort(int columnIndex)
    Retrieves value of column at the specified index and returns it as short.
    short
    getShort(String columnLabel)
    Retrieves value of column with the specified label and returns it as short.
    String
    getString(int columnIndex)
    Retrieves value of column at the specified index and returns it as String.
    String
    getString(String columnLabel)
    Retrieves value of column with the specified label and returns it as String.
    boolean
    isBound(int variableIndex)
    Checks whether a value at the specified index is bound in the current result row.
    boolean
    isBound(String variableName)
    Checks whether a value of the specified variable is bound in the current result row.

  • Method Details

    • findColumn

      int findColumn(String columnLabel)
      Retrieves index of a column with the specified label.
      Parameters:
      columnLabel - Label of the column
      Returns:
      index of the column or -1 if there is no such column
      Throws:
      IllegalStateException - If called on a closed result set

    • getColumnCount

      int getColumnCount()
      Gets the count of available columns.

      This number corresponds to the number of result variables bound in the query.

      Returns:
      Number of columns in the result set
      Throws:
      IllegalStateException - If called on a closed result set

    • isBound

      boolean isBound(int variableIndex) throws OntoDriverException
      Checks whether a value at the specified index is bound in the current result row.

      Note that this method will return false also in case the index is out of range of the variables known to the result set as a whole.

      Parameters:
      variableIndex - Index of the variable
      Returns:
      true when value is bound in the current row, false otherwise
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - When unable to resolve binding status

    • isBound

      boolean isBound(String variableName) throws OntoDriverException
      Checks whether a value of the specified variable is bound in the current result row.

      Note that this method will return false also in case the variable is not known to the result set at all.

      Parameters:
      variableName - Variable name
      Returns:
      true when value is bound in the current row, false otherwise
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - When unable to resolve binding status

    • getBoolean

      boolean getBoolean(int columnIndex) throws OntoDriverException
      Retrieves value from column at the specified index and returns it as a boolean.
      Parameters:
      columnIndex - Column index, the first column has index 0
      Returns:
      boolean value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If the columnIndex is not a valid column index, the value cannot be cast to boolean or there occurs some other error

    • getBoolean

      boolean getBoolean(String columnLabel) throws OntoDriverException
      Retrieves value from column with the specified label and returns it as a boolean.
      Parameters:
      columnLabel - Label of the column
      Returns:
      boolean value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If there is no column with the specified label, the value cannot be cast to boolean or there occurs some other error

    • getByte

      byte getByte(int columnIndex) throws OntoDriverException
      Retrieves value from column at the specified index and returns it as byte.
      Parameters:
      columnIndex - Column index, the first column has index 0
      Returns:
      byte value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If the columnIndex is not a valid column index, the value cannot be cast to byte or there occurs some other error

    • getByte

      byte getByte(String columnLabel) throws OntoDriverException
      Retrieves value from column with the specified label and returns it as byte.
      Parameters:
      columnLabel - Label of the column
      Returns:
      byte value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If there is no column with the specified label, the value cannot be cast to byte or there occurs some other error

    • getDouble

      double getDouble(int columnIndex) throws OntoDriverException
      Retrieves value from column at the specified index and returns it as double.
      Parameters:
      columnIndex - Column index, the first column has index 0
      Returns:
      double value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If the columnIndex is not a valid column index, the value cannot be cast to double or there occurs some other error

    • getDouble

      double getDouble(String columnLabel) throws OntoDriverException
      Retrieves value from column with the specified label and returns it as double.
      Parameters:
      columnLabel - Label of the column
      Returns:
      double value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If there is no column with the specified label, the value cannot be cast to double or there occurs some other error

    • getFloat

      float getFloat(int columnIndex) throws OntoDriverException
      Retrieves value from column at the specified index and returns it as float.
      Parameters:
      columnIndex - Column index, the first column has index 0
      Returns:
      float value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If the columnIndex is not a valid column index, the value cannot be cast to float or there occurs some other error

    • getFloat

      float getFloat(String columnLabel) throws OntoDriverException
      Retrieves value from column with the specified label and returns it as float.
      Parameters:
      columnLabel - Label of the column
      Returns:
      float value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If there is no column with the specified label, the value cannot be cast to float or there occurs some other error

    • getInt

      int getInt(int columnIndex) throws OntoDriverException
      Retrieves value from column at the specified index and returns it as int.
      Parameters:
      columnIndex - Column index, the first column has index 0
      Returns:
      int value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If the columnIndex is not a valid column index, the value cannot be cast to int or there occurs some other error

    • getInt

      int getInt(String columnLabel) throws OntoDriverException
      Retrieves value from column with the specified label and returns it as int.
      Parameters:
      columnLabel - Label of the column
      Returns:
      int value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If there is no column with the specified label, the value cannot be cast to int or there occurs some other error

    • getLong

      long getLong(int columnIndex) throws OntoDriverException
      Retrieves value from column at the specified index and returns it as long.
      Parameters:
      columnIndex - Column index, the first column has index 0
      Returns:
      long value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If the columnIndex is not a valid column index, the value cannot be cast to long or there occurs some other error

    • getLong

      long getLong(String columnLabel) throws OntoDriverException
      Retrieves value from column with the specified label and returns it as long.
      Parameters:
      columnLabel - Label of the column
      Returns:
      long value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If there is no column with the specified label, the value cannot be cast to long or there occurs some other error

    • getObject

      Object getObject(int columnIndex) throws OntoDriverException
      Retrieves value from column at the specified index and returns it as Object.
      Parameters:
      columnIndex - Column index, the first column has index 0
      Returns:
      column value cast to Object
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If the columnIndex is not a valid column index or there occurs some other error

    • getObject

      Object getObject(String columnLabel) throws OntoDriverException
      Retrieves value from column with the specified label and returns it as Object.
      Parameters:
      columnLabel - Label of the column
      Returns:
      column value cast to Object
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If there is no column with the specified label or there occurs some other error

    • getObject

      <T> T getObject(int columnIndex, Class<T> cls) throws OntoDriverException
      Retrieves value from column at the specified index and returns it as an instance of the specified class.

      The mechanism of transforming the value to the specified class is not specified, it can be merely type casting or calling a constructor of the specified type.

      Type Parameters:
      T - Return type
      Parameters:
      columnIndex - Column index, the first column has index 0
      cls - Requested class type
      Returns:
      Value of the column
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If the columnIndex is not a valid column index, the value cannot be cast to the specified type or there occurs some other error

    • getObject

      <T> T getObject(String columnLabel, Class<T> cls) throws OntoDriverException
      Retrieves value from column with the specified label and returns it as an instance of the specified class.

      The mechanism of transforming the value to the specified class is not specified, it can be merely type casting or calling a constructor of the specified type.

      Type Parameters:
      T - Return type
      Parameters:
      columnLabel - Label of the column
      cls - Requested class type
      Returns:
      Value of the column.
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If there is no column with the specified label, the value cannot be cast to the specified type or there occurs some other error

    • getShort

      short getShort(int columnIndex) throws OntoDriverException
      Retrieves value of column at the specified index and returns it as short.
      Parameters:
      columnIndex - Column index, the first column has index 0
      Returns:
      short value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If the columnIndex is not a valid column index, the value cannot be cast to short or there occurs some other error

    • getShort

      short getShort(String columnLabel) throws OntoDriverException
      Retrieves value of column with the specified label and returns it as short.
      Parameters:
      columnLabel - Label of the column
      Returns:
      short value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If there is no column with the specified label, the value cannot be cast to short or there occurs some other error

    • getString

      String getString(int columnIndex) throws OntoDriverException
      Retrieves value of column at the specified index and returns it as String.
      Parameters:
      columnIndex - Column index, the first column has index 0
      Returns:
      String value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If the columnIndex is not a valid column index, the value cannot be cast to String or there occurs some other error

    • getString

      String getString(String columnLabel) throws OntoDriverException
      Retrieves value of column with the specified label and returns it as String.
      Parameters:
      columnLabel - Label of the column
      Returns:
      String value
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If there is no column with the specified label, the value cannot be cast to String or there occurs some other error

    • getIndex

      int getIndex() throws OntoDriverException
      Gets the index of this row (first row has index 0).
      Returns:
      Index of this row
      Throws:
      IllegalStateException - If called on a closed result set
      OntoDriverException - If some other error occurs