Resultset java что это

Непопулярное в JDBC

О API JDBC достаточно много информации и гайдов, но к сожалению почти все как под копирку. Сам достаточно долгое время осваивал это чудо, переводя ресурсы умных.

Привет, Хабр!

Не так давно узнал о некоторых приемах создания соединения и дальнейшей работы с ним.
На 100% уникальность не претендую, лавры не собираю.

В общем, типичная задача, подключится к БД и запросить данные из таблицы. Что мы делаем для этого:

Прокручиваемый ResultSet

Начиная с версии JDBC 2.0 появилась возможность направленной прокрутки набора результата.
Для этого, при создании Statement необходимо указать параметр желаемой прокрутки.

Редактируемый ResultSet

Возможно, в коде выше вы заметили второй параметр — ResultSet.CONCUR_READ_ONLY, он означает, что выбранный результат доступен только для чтения.

Вместо создания привычных стейтментов для обновления (вставка, редактирование, удаление) мы можем воспользоваться ранее созданным ResultSet`ом. Но для этого во второй параметр метода по созданию Statement необходимо указать ResultSet.CONCUR_UPDATABLE.

В таком ResultSet вы сможете не только обновлять выбранные записи, но и создавать новые, а также производить удаление.

Пакетные обновления

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

Сразу скажу, что в этих случаях необходимо выключит AutoCommit у соединения, т.к. отправлять изменения на сервер мы будем принудительно.

А также, нужно проверить, поддерживает ли версия драйвера пакетные обновления — DatabaseMetaData.supportsBatchUpdates().

Заключение

Данная статья не является гайдом о том как нужно делать. Большинство примеров представлено в тезисном варианте, цель которого — передать коротко и лаконично основную мысль. В следующей статье напишу про RowSet`ы и что нибудь еще, непопулярное!

Источник

Руководство JDBC TM

5.1 Обзор

5.1.1 Строки и курсоры

5.1.2 Колонки

Для указания колонки можно использовать либо ее имя, либо ее номер. Например, если вторая колонка объекта ResultSet rs называется «title» и хранит строковое значение, то извлечь его можно одним из двух способов:

Имейте ввиду, что колонки нумеруются слева направо, начиная с 1. Имена колонок в вызове методов getXXX нечувствительны к регистру букв.

Вариант с использование имен колонок существует для того, чтобы пользователь задавал методам getXXX те же имена колонок, что он использует в запросе. Если выражение select не указывает имена колонок (например » select * from table1 » или в случаях, когда колонка вычисляется) должны использоваться номера колонок. В этих случаях пользователь не может знать наверняка имена колонок.

В нектороых случаях имена двух колонок могут совпадать. Тогда при использовании имен колонок в методах getXXX возвращается значение первой подходящей колонки. Таким образом, чтобы считать значение других колонок с таким же именем, надо использовать индексы колонок. Кроме того, использование индексов немного эффективнее.

5.1.3 Типы данных и их преобразование

Использование методов ResultSet.getXXX при доступе к различным типам данных SQL.
«x» означает, что метод getXXX может быть использован,
«X» означает, что соответствующий метод рекомендуется использовать для этого типа данных.

5.1.4 Использование потоков для очень больших значений

В JDBC API есть три отдельных метода для получения потоков:

Эти потоки отличаются от обычных потоков Java, которые возвращают нетипизированные байты, и могут, например, быть ASCII- или Unicode-символами.

Следующий пример демонстрирует использование getAsciiStream :

5.1.5 Значения NULL в результатах

5.1.6 Необязательные или множественные наборы результатов (Result Sets)

Источник

Результаты запроса ResultSet

Класс ResultSet представляет результирующий набор данных и обеспечивает приложению построчный доступ к результатам запросов. При обработке запроса ResultSet поддерживает указатель на текущую обрабатываемую строку.

Доступ к данным ResultSet обеспечивает посредством набора get-методов, которые организуют доступ к колонкам текущей строки. Метод ResultSet.next используется для перемещения к следующей строке ResultSet, делая ее текущей.

Методы ResultSet

Список наиболее часто используемых методов класса ResultSet представлен в таблице :

Пример использования ResultSet

Результирующий набор данных ResultSet можно не закрывать. Это делается автоматически родительским объектом Statement, когда он закрывается, начинает выполняться повторно или используется для извлечения следующего результата в последовательности нескольких результатов. Но лучше все же закрывать и не надеяться, что это сделает разработчик драйвера JDBC.

Значение NULL в ResultSet

Чтобы определить, равно ли значение определенной колонки NULL или нет, необходимо сначала прочитать значение колонки, а затем использовать метод wasNull класса ResultSet для выяснения данного факта. Если wasNull возвращает значение true, то это означает, что считанное значение равно NULL.

В случае, если возвращаемое значение NULL, то методы ResultSet.getXXX, равны:

Строки, колонки и курсоры ResultSet

ResultSet содержит так называемый курсор, который позиционируется на текущей строке данных. При вызове метода next, курсор перемещается на следующую строку.

При открытии набора данных ResultSet курсор расположен перед первой строкой, и первый вызов next передвигает его на первую строку.

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

Курсор для результирующей таблицы имеет имя. Если БД поддерживает позиционированные обновления или позиционированные удаления, то командам обновления или удаления можно передать в качестве параметра имя курсора, которое можно получить с помощью вызова метода getCursorName()

Но не все СУБД могут поддерживать позиционированные обновления или удаления. Чтобы узнать, поддерживает ли данное соединение Connection эти операции или нет, можно вызвать методы DatabaseMetaData.supportsPositionedDelete и supportsPositionedUpdate.

Методы ResultSet.getXXX предоставляют доступ к значениям в колонках в текущей строке. В пределах одной строки значения могут быть считаны в любом порядке. Для обеспечения бо́льшей совместимости рекомендуется считывать их подряд слева направо и делать это только один раз. Для указания колонки можно использовать либо ее имя, либо ее номер. Например, если вторая колонка объекта ResultSet rs называется «title» и хранит строковое значение, то извлечь его можно одним из двух способов:

При обращении к колонке по номеру следует помнить, что колонки нумеруются слева направо, начиная с 1, а имена колонок в вызове методов getXXX нечувствительны к регистру букв.

Наименования колонок совпадает с соответствующими наименованиями колонок в запросе. Если же в выражении select не указываются имена колонок (например «select * from users»), то необходимо либо использовать номера колонок, либо «подключать» метаданные. Информацию о колонках в ResultSet можно получить с помощью вызова ResultSet.getMetaData. Возвращаемый объект ResultSetMetaData содержит информацию о количестве, типах и свойствах колонок объекта ResultSet.

В некоторых случаях имена двух колонок могут совпадать. Тогда при использовании имен колонок в методах getXXX возвращается значение первой подходящей колонки. Таким образом, чтобы считать значение других колонок с таким же именем, надо использовать индексы колонок. Кроме того, использование индексов немного эффективнее.

Если имя колонки известно, а индекс нет, то для поиска номера колонки можно использовать метод findColumn().

Типы данных и их преобразование

Различные методы чтения записей типа getXXX конвертируют низкоуровневые данные в типы данных Java. Например, если в таблице БД тип данных VARCHAR, то при использовании метода getString, драйвер JDBC конвертирует VARCHAR в объект String. Т.е. возвращаемым из метода getString значением будет объект String.

Следующая таблица показывает, какие типы данных различные методы getXXX могут считывать и какие JDBC-типы (SQL-типы) рекомендуются для этих методов.

Например, для типа данных LONGVARCHAR значение можно извлечь любым из методов getXXX кроме getBytes и getBinaryStream, но рекомендуется использовать методы getAsciiStream и getUnicodeStream.

Метод getObject возвращает значение как Object и может быть использован в тех случаях, когда соответствующий низкоуровневый тип данных является специфичным для данной СУБД, или когда приложению необходимо принять любой тип данных.

Таблица соответствия методов ResultSet.getXXX при чтении значений различных типам данных SQL.

Чтение больших LOB объектов

Для чтения больших объектов LOB (Large Object Bynary) также используется ResultSet. Методы getBytes и getString возвращают эти данные в виде одного большого массива (байт, символов). Можно узнать размер объекта с помощью метода Statement.getMaxFieldSize.

Можно большие объекты LOB читать с помощью потоков (java.io.InputStream), которые возвращаются некоторыми методами ResultSet. Следует обратить внимание на то, что к этим потокам надо обращаться сразу, так как они будут закрыты при следующем вызове getXXX объекта ResultSet. Такое поведение диктуется низкоуровневой реализацией доступа к большим двоичным объектам.

JDBC API включает три отдельных метода для чтения данных в поток :

Эти потоки отличаются от обычных потоков Java, которые возвращают нетипизированные байты.

Следующий пример демонстрирует использование getAsciiStream :

Пример записи файлов в бинарные (BLOB) и символьные (CLOB/TEXT) поля баз данных Oracle и MySQL можно увидеть здесь.

Множественные наборы : getResultSet, getUpdateCount, getMoreResults

Обычно при выполнении SQL-запросов используют либо метод executeQuery, возвращающий единственный ResultSet, либо executeUpdate, который может быть использован для изменения значения в таблице БД и который возвращают количество измененных строк. Тем не менее, в отдельных случаях приложению заранее может быть неизвестно, возвратит ли данный запрос результат или нет. Кроме этого, некоторые хранимые процедры могут возвратить несколько наборов данных и/или счетчиков обновления.

Для этого случая в JDBC есть механизм, когда приложение может обрабатывать произвольную коллекцию наборов результатов или счетчиков обновления. Данный механизм основан на вызове метода execute и последующем вызове трех других методов getResultSet, getUpdateCount и getMoreResults.

Методы getResultSet, getUpdateCount и getMoreResults позволяют приложению получать результаты запроса по-очереди и для каждого результата определять, является ли он набором данных или счетчиком обновлений.

Источник

Руководство по JDBC. Result Set.

В прошлом уроке мы рассмотрели понятие Statements и их виды. Мы узнали, что в результате SQL – запроса мы получаем данные.

Данные, полученные в результате SQL – запроса возвращаются в виде множества результатов, которые хранятся в сущности под названием Result Set.

Стандартный способ получить записи из нашей базе данных (далее – БД) – это применение ключевого слова SELECT. Стандартный способ просмотреть эти данные – это использовать Result set.

Интерфейс java.sql.ResultSet представляет собой множество результатов, запроса в БД.

Экземпляр ResultSet имеет указатель, который указывает на текущую строку в полученном множестве.

Все методы интерфейса java.sql.ResultSet мы можем разделить на три большие группы:

Курсор двигается на основе свойств ResultSet. Эти свойства указываются при создании экземпляра ResultSet.

Для определения этих свойств используются следующие методы:

Аргумент RSType определяет тип ResultSet, а второй – определяет, используется ли данный экземпляр ResultSet только для чтения, или для чтения и изменения также.

Типы ResultSet

Возможные типы ResultSet приведены ниже. Тип TYPE_FORWARD_ONLY используется по умолчанию.

Рассмотрим эти типы:

Доступ ResultSet

По умолчанию RSConcurrency экземпляра ResultSet установлен тип CONCUR_READ_ONLY, т.е. только для чтения.

Всего существует два типа этого параметра:

В виде кода, создание экземпляра ResultSet с необходимыми нам параметрами выглядит, примерно так:

Навигация по ResultSet

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

Некоторые из них приведены ниже:

Для понимания того, как это работает на практике, рассмотрим пример простого приложения.

В результате работы программы мы получим, следующий результат:

Просмотр результатов ResultSet

Для получения и редактирования данных, в интерфейса ResultSet существует множество методов.

Мы можем получить данные, как по имени, так и индексу:

Существуют также методы для получения определённых типов данных SQL (java.sql.Time, java.sql.Date и т.д.).

Для понимания того, как это работает на практике, рассмотрим следующий пример.

В результате работы программы мы получим следующий результат:

Редактирование данных ResultSet

Для редактирования данных, в интерфейсе java.sql.ResultSet, также разработано множество методов.

Мы можем изменять данные, как по имени, так и по индексу колонки:

Мы также можем работать с рядами в таблице БД:

Для понимания того, как это работает на практике, рассмотрим такой пример.

В результате работы программы мы получим следующий результат:

В этом уроке мы изучили такой важный элемент, как ResultSet, его методы, применение и рассмотрели примеры приложений с его использованием.

В следующем уроке мы изучим типы данных JDBC.

Источник

JDBC ResultSet на Java

Интерфейс Java JDBC ResultSet представляет результат запроса к базе данных. Текст о запросах показывает, как результат запроса возвращается как java.sql.ResultSet. Затем этот ResultSet повторяется для проверки результата.

ResultSet содержит записи

JDBC ResultSet содержит записи. Каждая запись содержит набор столбцов. Каждая запись содержит одинаковое количество столбцов, хотя не все столбцы могут иметь значение. Столбец может иметь нулевое значение. Вот иллюстрация JDBC ResultSet:

Этот ResultSet имеет 3 разных столбца(имя, возраст, пол) и 3 записи с разными значениями для каждого столбца.

Создание ResultSet

Вы создаете ResultSet, выполняя Statement или PreparedStatement, например так:

Тип ResultSet, параллелизм и удерживаемость

Когда вы создаете ResultSet, вы можете установить три атрибута. Эти:

Вы устанавливаете их уже при создании Statement или PreparedStatement, например так:

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

Итерация

Для итерации ResultSet вы используете его метод next(). Метод next() возвращает значение true, если ResultSet имеет следующую запись, и перемещает ResultSet, чтобы он указывал на следующую запись. Если больше не было записей, next() возвращает false, и вы больше не можете. Как только метод next() вернул false, вы не должны больше его вызывать. Это может привести к исключению.

Вот пример итерации ResultSet с использованием метода next():

Как видите, метод next() на самом деле вызывается до доступа к первой записи. Это означает, что ResultSet начинает указывать перед первой записью. После того, как next() был вызван один раз, он указывает на первую запись.

Точно так же, когда next() вызывается и возвращает false, ResultSet фактически указывает после последней записи.

Вы не можете получить количество строк в ResultSet, за исключением случаев, когда вы выполняете все итерации по нему и подсчитываете строки. Однако, если ResultSet предназначен только для пересылки, вы не сможете впоследствии перемещаться назад. Даже если бы вы могли двигаться назад, это был бы медленный способ подсчета строк в ResultSet. Вам лучше структурировать свой код так, что вам не нужно заранее знать количество записей.

Доступ к значениям столбца

При переборе ResultSet вы хотите получить доступ к значениям столбцов каждой записи. Вы делаете это, вызывая один или несколько методов getXXX(). Вы передаете имя столбца, чтобы получить значение многих методов getXXX(). Например:

Есть много методов getXXX(), которые вы можете вызвать, которые возвращают значение столбца в виде определенного типа данных, например String, int, long, double, BigDecimal и т. Д. Все они берут имя столбца, чтобы получить столбец значение для, как параметр. Вот список быстрых примеров этих методов getXXX():

Методы getXXX() также существуют в версиях, которые принимают индекс столбца вместо имени столбца. Например:

Индекс столбца обычно зависит от индекса столбца в операторе SQL. Например, оператор SQL

имеет три столбца. Имя столбца указывается первым и, следовательно, будет иметь индекс 1 в ResultSet. Возраст столбца будет иметь индекс 2, а коэффициент столбца будет иметь индекс 3.

Иногда вы не знаете индекс определенного столбца раньше времени. Например, если вы используете SQL-запрос select * from, вы не знаете последовательность столбцов.

Если вы не знаете индекс определенного столбца, вы можете найти индекс этого столбца, используя метод ResultSet.findColumn(String columnName), например:

ResultSet Types

ResultSet может быть определенного типа. Тип определяет некоторые характеристики и возможности ResultSet.

Не все типы поддерживаются всеми базами данных и драйверами JDBC. Вам придется проверить свою базу данных и драйвер JDBC, чтобы увидеть, поддерживает ли он тип, который вы хотите использовать. Метод DatabaseMetaData.supportsResultSetType(int type) возвращает true или false в зависимости от того, поддерживается данный тип или нет. Класс DatabaseMetaData описан в следующем тексте.

На момент написания статьи существует три типа ResultSet:

Тип по умолчанию – TYPE_FORWARD_ONLY

TYPE_FORWARD_ONLY означает, что ResultSet можно перемещать только вперед. То есть вы можете перемещаться только из строки 1, строки 2, строки 3 и т. Д. В ResultSet вы не можете двигаться назад.

TYPE_SCROLL_INSENSITIVE означает, что ResultSet можно перемещать(прокручивать) как вперед, так и назад. Вы также можете перейти к позиции относительно текущей позиции или перейти к абсолютной позиции. ResultSet нечувствителен к изменениям в базовом источнике данных, пока ResultSet открыт. То есть, если запись в ResultSet изменяется в базе данных другим потоком или процессом, она не будет отражена в уже открытых ResulsSet этого типа.

TYPE_SCROLL_SENSITIVE означает, что ResultSet можно перемещать(прокручивать) как вперед, так и назад. Вы также можете перейти к позиции относительно текущей позиции или перейти к абсолютной позиции. ResultSet чувствителен к изменениям в базовом источнике данных, пока ResultSet открыт. То есть, если запись в ResultSet изменяется в базе данных другим потоком или процессом, она будет отражена в уже открытых ResulsSet этого типа.

Методы навигации

Интерфейс ResultSet содержит следующие методы навигации. Помните, что не все методы работают со всеми типами ResultSet. Какие методы работают, зависит от вашей базы данных, драйвера JDBC и типа ResultSet.

Интерфейс ResultSet также содержит набор методов, которые вы можете использовать для запроса текущей позиции ResultSet. Эти:

Наконец, интерфейс ResultSet также содержит метод для обновления строки изменениями базы данных, если ResultSet чувствителен к изменениям.

Concurrency

Параллельность ResultSet определяет, может ли ResultSet обновляться или только считываться.

Некоторые базы данных и драйверы JDBC поддерживают обновление ResultSet, но не все базы данных и драйверы JDBC поддерживают это. Метод DatabaseMetaData.supportsResultSetConcurrency(int concurrency) возвращает значение true или false в зависимости от того, поддерживается данный режим параллелизма или нет. Класс DatabaseMetaData описан в следующем тексте.

ResultSet может иметь один из двух уровней параллелизма:

CONCUR_READ_ONLY означает, что ResultSet может быть прочитан только.

CONCUR_UPDATABLE означает, что ResultSet может быть прочитан и обновлен.

Обновление ResultSet

Если ResultSet является обновляемым, вы можете обновить столбцы каждой строки в ResultSet. Вы делаете это, используя множество методов updateXXX(). Например:

Вы также можете обновить столбец, используя индекс столбца вместо имени столбца. Вот пример:

Обратите внимание на вызов updateRow(). Когда вызывается updateRow(), база данных обновляется со значениями строки. Если вы не вызываете этот метод, значения, обновленные в ResultSet, никогда не отправляются в базу данных. Если вы вызываете updateRow() внутри транзакции, данные фактически не фиксируются в базе данных, пока транзакция не будет зафиксирована.

Вставка строк в ResultSet

Если ResultSet является обновляемым, в него также можно вставлять строки. Вы делаете это:

Строка, на которую указывает после вызова moveToInsertRow(), является специальной строкой, буфером, который можно использовать для построения строки, пока все значения столбцов не будут установлены в строке правильно.

Когда строка будет готова для вставки в ResultSet, вызовите метод insertRow().

После вставки строки ResultSet по-прежнему указывает на строку вставки. Однако вы не можете быть уверены, что произойдет, если вы попытаетесь получить к нему доступ после вставки строки. Поэтому вы должны переместить ResultSet в правильную позицию после вставки новой строки. Если вам нужно вставить другую строку, явно вызовите moveToInsertRow(), чтобы сообщить об этом ResultSet.

Удерживаемость ResultSet

Удерживаемость ResultSet определяет, будет ли ResultSet закрыт при вызове метода commit() базового соединения.

Источник