Интерфейс ResultSet

public interface ResultSet
extends Wrapper, AutoCloseable

Таблица данных, представляющая результат запроса к базе данных, обычно генерируемая выполнением оператора, который запрашивает базу данных.

Объект ResultSet поддерживает указатель, указывающий на текущую строку данных. Изначально указатель расположен перед первой строкой. Метод next перемещает указатель на следующую строку, и поскольку он возвращает false при отсутствии дополнительных строк в объекте ResultSet, его можно использовать в цикле while для итерации по набору результатов.

Стандартный объект ResultSet не обновляемый и имеет курсор, который перемещается только вперёд. Таким образом, вы можете пройти по нему только один раз и только от первой до последней строки. Можно создать объекты ResultSet, которые могут прокручиваться и/или обновляться. Следующий фрагмент кода, в котором con является допустимым объектом Connection, иллюстрирует, как создать набор результатов, который может прокручиваться и не чувствителен к обновлениям другими, и который может обновляться. См. поля ResultSet для других вариантов.

Statement stmt = con.createStatement(
                                      ResultSet.TYPE_SCROLL_INSENSITIVE,
                                      ResultSet.CONCUR_UPDATABLE);
       ResultSet rs = stmt.executeQuery("SELECT a, b FROM TABLE2");
       // rs will be scrollable, will not show changes made by others,
       // and will be updatable

Интерфейс ResultSet предоставляет методы получения (getBoolean, getLong, и т. д.) для извлечения значений столбцов из текущей строки. Значения можно извлечь, используя либо номер индекса столбца, либо имя столбца. Как правило, использование индекса столбца будет более эффективным. Столбцы нумеруются с 1. Для максимальной переносимости столбцы набора результатов в каждой строке следует читать слева направо, и каждый столбец следует читать только один раз.

Для методов получения JDBC-драйвер пытается преобразовать подлежащие данные в тип Java, указанный в методе получения, и возвращает подходящее значение Java. В спецификации JDBC есть таблица, показывающая допустимые соответствия между типами SQL и типами Java, которые могут использоваться методами получения ResultSet.

Имена столбцов, используемые в качестве входных данных для методов получения, нечувствительны к регистру. Когда метод получения вызывается с именем столбца и несколько столбцов имеют то же имя, возвращается значение первого совпавшего столбца. Вариант имени столбца предназначен для использования, когда имена столбцов используются в SQL-запросе, который сгенерировал набор результатов. Для столбцов, которые НЕ явно названы в запросе, лучше использовать номера столбцов. Если используются имена столбцов, программист должен позаботиться о том, чтобы они однозначно ссылались на нужные столбцы, что можно гарантировать с помощью SQL-оператор AS.

Набор методов обновления был добавлен в этот интерфейс в API JDBC 2.0 (Java™ 2 SDK, Standard Edition, версия 1.2). Комментарии относительно параметров к методам получения также относятся к параметрам к методам обновления.

Методы обновления могут использоваться двумя способами:

1. для обновления значения столбца в текущей строке. В прокручиваемом объекте ResultSet, курсор может перемещаться назад и вперед, к абсолютному положению или к положению относительно текущей строки. Следующий фрагмент кода обновляет столбец NAME в пятой строке объекта ResultSet rs и затем использует метод updateRow для обновления таблицы источника данных, из которой rs был получен.

   rs.absolute(5); // moves the cursor to the fifth row of rs
          rs.updateString("NAME", "AINSWORTH"); // updates the
             // NAME column of row 5 to be AINSWORTH
          rs.updateRow(); // updates the row in the data source

2. для вставки значений столбцов в строку вставки. Обновляемый объект ResultSet имеет специальную строку, связанную с ним, которая служит областью подготовки для построения строки, которая будет вставлена. Следующий фрагмент кода перемещает курсор в строку вставки, создает строку из трёх столбцов и вставляет её в rs и в таблицу источника данных с помощью метода insertRow.

   rs.moveToInsertRow(); // moves cursor to the insert row
          rs.updateString(1, "AINSWORTH"); // updates the
             // first column of the insert row to be AINSWORTH
          rs.updateInt(2,35); // updates the second column to be 35
          rs.updateBoolean(3, true); // updates the third column to true
          rs.insertRow();
          rs.moveToCurrentRow();

Объект ResultSet автоматически закрывается, когда объект Statement, который его сгенерировал, закрывается, повторно выполняется или используется для получения следующего результата из последовательности нескольких результатов.

Количество, типы и свойства столбцов объекта ResultSet предоставляются объектом ResultSetMetaData, возвращаемым методом ResultSet.getMetaData.