Основы проектирования приложений баз данных
       

Интерфейс RESULTSET


Интерфейс java.sql.ResultSet реализует средства для работы с результирующим набором и предоставляет следующие константы и методы:

  • static int CONCUR_READ_ONLY - константа, определяющая режим результирующего набора "только чтение";
  • static int CONCUR_UPDATABLE - константа, определяющая, что результирующий набор может быть изменяемым;
  • static int FETCH_FORWARD - константа, определяющая, что строки в результирующем наборе обрабатываются только в одном направлении: от первой к последней;
  • static int FETCH_REVERSE - константа, определяющая, что строки в результирующем наборе обрабатываются только в одном обратном направлении: от последней к первой. Эта константа используется в методе setFetchDirection как подсказка драйверу, которую тот может и игнорировать.
  • static int FETCH_UNKNOWN - константа, указывающая, что порядок, в котором будут обрабатываться строки результирующего набора, не определен;
  • static int TYPE_FORWARD_ONLY - константа, определяющая режим, при котором позиция курсора может перемещаться только в направлении вперед;
  • static int TYPE_SCROLL_INSENSITIVE - константа, определяющая режим, при котором позиция курсора может изменяться в любом направлении, но результирующий набор нечувствителен к изменениям, вносимым другими транзакциями;
  • static int TYPE_SCROLL_SENSITIVE - константа, определяющая режим, при котором позиция курсора может изменяться в любом направлении и результирующий набор чувствителен к изменениям, вносимым другими транзакциями;
  • boolean absolute (int row) - метод, выполняющий перемещение позиции курсора результирующего набора на указанную строку;
  • void afterLast () - метод, устанавливающий позицию курсора в конец результирующего набора после последней строки;
  • void beforeFirst () - метод, устанавливающий позицию курсора в начало результирующего набора перед первой строкой;
  • void cancelRowUpdates () - метод, отменяющий изменения, сделанные в текущей строке результирующего набора;
  • void clearWarnings () - метод, удаляющий все уведомляющие сообщения, полученные для результирующего набора;
  • void close () - метод, закрывающий результирующий набор и освобождающий все JDBC-ресурсы;
  • void deleteRow () - метод, удаляющий текущую строку из результирующего набора и из источника данных;
  • int findColumn (String columnName) - метод, возвращающий индекс столбца результирующего набора по заданному имени;
  • boolean first () - метод, перемещающий позицию курсора на первую строку результирующего набора;
  • Array getArray (int i) и Array getArray (String colName) - методы, возвращающие значение указанного столбца в виде массива (столбец может быть указан по имени или по индексу);
  • BigDecimal getBigDecimal (int columnIndex) и BigDecimal getBigDecimal (String columnName) - методы, возвращающие значение указанного столбца как объект типа java.math.BigDecimal;
  • Blob getBlob (int i) и Blob getBlob (String colName) - методы, возвращающие значение указанного столбца как Blob-объект;
  • boolean getBoolean (int columnIndex) и boolean getBoolean (String columnName) - методы, возвращающие значение указанного столбца как логическое значение;
  • byte getByte (int columnIndex) и byte getByte (String columnName) - методы, возвращающие значение указанного столбца как байт;
  • byte[] getBytes (int columnIndex) и byte[] getBytes (String columnName) - методы, возвращающие значение указанного столбца как массив байтов;
  • Clob getClob (int i) и Clob getClob (String colName) - методы, возвращающие значение указанного столбца как Сlob-объект;
  • int getConcurrency () - метод, возвращающий установленный режим параллельности, который определяется значением CONCUR_READ_ONLY или CONCUR_UPDATABLE;
  • String getCursorName() - метод, возвращающий имя курсора, используемое объектом ResultSet;
  • Date getDate(int columnIndex), Date getDate(String columnName), Date getDate(int columnIndex, Calendar cal) и Date getDate(String columnName, Calendar cal) - методы, возвращающие значение указанного столбца как объект типа java.sql.Date;
  • double getDouble (int columnIndex) и double getDouble (String columnName) - методы, возвращающие значение указанного столбца как значение типа double;
  • int getFetchDirection() - метод, возвращающий используемое направление выборки данных из результирующего набора;
  • int getFetchSize() - метод, возвращающий для объекта ResultSet размер текущей выборки данных;
  • float getFloat(int columnIndex) и float getFloat(String columnName) - методы, возвращающие значение указанного столбца как значение типа float;
  • int getInt(int columnIndex) и int getInt(String columnName) - методы, возвращающие значение указанного столбца как значение типа int;
  • long getLong(int columnIndex) и long getLong(String columnName) - методы, возвращающие значение указанного столбца как значение типа long;
  • ResultSetMetaData getMetaData() - метод, возвращающий в объекте ResultSetMetaData информацию о количестве, типе и свойствах столбцов результирующего набора;
  • int getRow() - метод, возвращающий номер текущей строки;
  • short getShort(int columnIndex) и short getShort(String columnName) - методы, возвращающие значение указанного столбца как значение типа short;
  • Statement getStatement() - метод, возвращающий объект Statement, который был использован для создания данного результирующего набора;
  • String getString(int columnIndex) и String getString(String columnName) - методы, возвращающие значение указанного столбца как значение типа String;
  • Time getTime (int columnIndex), Time getTime (String columnName), Time getTime (int columnIndex, Calendar cal) и Time getTime (String columnName, Calendar cal) - методы, возвращающие значение указанного столбца как значение типа java.sql.Time;
  • Timestamp getTimestamp (int columnIndex), Timestamp getTimestamp (String columnName), Timestamp getTimestamp (int columnIndex, Calendar cal) и Timestamp getTimestamp (String columnName, Calendar cal) - методы, возвращающие значение указанного столбца как значение типа java.sql.Timestamp;
  • int getType () - метод, возвращающий тип данного результирующего набора;
  • SQLWarning getWarnings () - метод, возвращающий первое уведомляющее сообщение, которое было получено для результирующего набора;
  • void insertRow () - метод, вставляющий строку, которая была сформирована как новая строка в специальной области результирующего набора, в результирующий набор и в источник данных;
  • boolean isAfterLast () - метод, определяющий, находится ли позиция курсора после последней строки результирующего набора;
  • boolean isBeforeFirst () - метод, определяющий, находится ли позиция курсора перед первой строкой результирующего набора;
  • boolean isFirst () - метод, определяющий, находится ли позиция курсора на первой строке результирующего набора;
  • boolean isLast () - метод, определяющий, находится ли позиция курсора на последней строке результирующего набора;
  • boolean last () - метод, перемещающий позицию курсора на последнюю строку результирующего набора;
  • void moveToCurrentRow () - метод, возвращающий позицию курсора на текущую строку;
  • void moveToInsertRow () - метод, перемещающий позицию курсора на вставляемую строку;
  • boolean next () - метод, перемещающий позицию курсора на следующую строку результирующего набора;
  • boolean previous () - метод, перемещающий позицию курсора на предыдущую строку результирующего набора;
  • void refreshRow () - метод, выполняющий обновление значений текущей строки значениями из базы данных;
  • void updateRow () - метод, выполняющий внесение изменений значений текущей строки в базу данных;
  • boolean relative(int rows) - метод, перемещающий позицию курсора на указанное количество строк (когда такое перемещение разрешено) вперед, если параметр rows - больше нуля, или назад, если значение rows отрицательное;
  • boolean rowDeleted () - метод, определяющий, была ли строка удалена;
  • boolean rowInserted () - метод, определяющий, была ли текущая строка вставлена;
  • boolean rowUpdated () - метод, определяющий, была ли текущая строка изменена;
  • void setFetchDirection(int direction) - метод, устанавливающий направление обработки строк результирующего набора;
  • void setFetchSize(int rows) - метод, предлагающий JDBCдрайверу ограничить количество строк, выбираемых в результирующий набор из базы данных;
  • boolean wasNull() - метод, определяющий, имел ли последний прочитанный столбец значение SQL NULL;
  • void updateNull(int columnIndex) и void updateNull(String columnName) - методы, устанавливающие значение указанного столбца как null;
  • void updateBigDecimal(int columnIndex, BigDecimal x), void updateBigDecimal(String columnName, BigDecimal x), voidupdateBoolean(int columnIndex, boolean x), void updateBoolean(String columnName, boolean x), void updateBoolean(String columnName, boolean x), void updateByte(int columnIndex, byte x), void updateByte(String columnName, byte x), void updateBytes(int columnIndex, byte[] x), void updateBytes(String columnName, byte[] x), void updateDate(int columnIndex, Date x), void updateDate(String columnName, Date x), void updateDouble(int columnIndex, double x), void updateDouble(String columnName, double x), void updateFloat(int columnIndex, float x), void updateFloat(String columnName, float x), void updateInt(int columnIndex, int x), void updateInt(String columnName, int x), void updateLong(int columnIndex, long x), void updateLong(String columnName, long x), void updateObject(int columnIndex, Object x), void updateObject(int columnIndex, Object x, int scale), void updateObject(String columnName, Object x), void updateObject(String columnName, Object x, int scale), void updateShort(int columnIndex, short x), void updateShort(String columnName, short x), void updateString(int columnIndex, String x), void updateString(String columnName, String x), void updateTime(int columnIndex, Time x), void updateTime(String columnName, Time x), void updateTimestamp(int columnIndex, Timestamp x), void updateTimestamp(String columnName, Timestamp x) - методы, используемые для изменения значений столбцов в соответствии с их типами.



Содержание раздела