Package net.ontopia.topicmaps.query.core

Interface QueryResultIF

All Superinterfaces:
AutoCloseable
All Known Subinterfaces:
BufferedQueryResultIF
All Known Implementing Classes:
BooleanQueryResult, BufferedQueryResult, QueryResult, QueryResult
public interface QueryResultIF extends AutoCloseable
PUBLIC: Used to represent the results of queries. A query result is conceptually a table where each column corresponds to a variable bound by the query, and each row corresponds to a match to the query. That is, each row has a value for each column, and this is the value of the variable in that particular match.

The query result object always has a current row in the result (except before the first call to next()), and the getValue(int ix) method will return the value in column ix of this row. To find the column number for a particular variable, call getIndex("VAR"); alternatively, call getValue("VAR") directly.

The next() method is used to simultaneously step to the next row and check if there is a next row.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    close()
    PUBLIC: Closes the query result, which allows it to free its resources.
    String
    getColumnName(int ix)
    PUBLIC: Returns the name of the given column.
    String[]
    getColumnNames()
    PUBLIC: Returns the names of the columns.
    int
    getIndex(String colname)
    PUBLIC: Returns the index of the named column.
    Object
    getValue(int ix)
    PUBLIC: Returns the value in the given column in the current match.
    Object
    getValue(String colname)
    PUBLIC: Returns the value in the given column in the current match.
    Object[]
    getValues()
    PUBLIC: Returns the current match as an array of values.
    Object[]
    getValues(Object[] values)
    PUBLIC: Reads the values of the current match into the specified array.
    int
    getWidth()
    PUBLIC: Returns the number of columns in the result.
    boolean
    next()
    PUBLIC: Steps to the next match, returning true if a valid match was found, and false if there are no more matches.

  • Method Details

    • next

      boolean next()
      PUBLIC: Steps to the next match, returning true if a valid match was found, and false if there are no more matches. Must be called before values can be returned.

    • getWidth

      int getWidth()
      PUBLIC: Returns the number of columns in the result.

    • getIndex

      int getIndex(String colname)
      PUBLIC: Returns the index of the named column. Returns -1 if the column does not exist. The column index is zero-based.

    • getColumnNames

      String[] getColumnNames()
      PUBLIC: Returns the names of the columns.

    • getColumnName

      String getColumnName(int ix)
      PUBLIC: Returns the name of the given column. The column index is zero-based.
      Throws:
      IndexOutOfBoundsException - if there is no such column.

    • getValue

      Object getValue(int ix)
      PUBLIC: Returns the value in the given column in the current match. The column index is zero-based. Requires next() to have been called first.
      Throws:
      IndexOutOfBoundsException - if there is no such column.

    • getValue

      Object getValue(String colname)
      PUBLIC: Returns the value in the given column in the current match. Requires next() to have been called first.
      Throws:
      IllegalArgumentException - if there is no such column.

    • getValues

      Object[] getValues()
      PUBLIC: Returns the current match as an array of values. Note that the returned array should not be modified as it may lead to undefined results. Requires next() to have been called first.

    • getValues

      Object[] getValues(Object[] values)
      PUBLIC: Reads the values of the current match into the specified array. Requires next() to have been called first.
      Since:
      1.3.2

    • close

      void close()
      PUBLIC: Closes the query result, which allows it to free its resources.

      Specified by:
      close in interface AutoCloseable
      Since:
      1.3.4