Что такое resultset как с ним работать

Изучение интерфейсов ResultSet, ResultSetMetaData и DatabaseMetaData.

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

Существует три варианта объектов типа ResultSet: Standard, Scrollable и Updateable. При использовании стандартного варианта обновление полученного результата запроса невозможно, а перемещение по строкам результата запроса возможно только в одном направлении: от первой к последней записи. Вариант Scrollable позволяет перемещаться по строкам запроса как в прямом, так и в обратном направлении, а также позиционировать курсор как на абсолютную, так и на относительную текущей позицию. Вариант Updateable позволяет изменять данные результата запроса, вставлять и удалять строки. Оба последних варианта будут выполняться более медленно, чем стандартный вариант использования объекта типа ResultSet. По этому их лучше использовать только в необходимых для этого случаях.

При работе со стандартным вариантом использования объектов типа ResultSet используются следующие методы:

next() — перемещает курсор на следующую строку результата запроса;

isBeforeFirst() — Возвращает true если курсор находится на позиции “до первой записи” (BFR);

isFirst() — Возвращает true если курсор указывает на первую запись;

isAfterLast() — Возвращает true если курсор находится на позиции “после последней записи” (ALR);

isLast() — Возвращает true если курсор указывает на последнюю запись;

getRow() — Возвращает integer значение номера строки в результате запроса. 1 – первая строка; 2 – вторая строка и т.д. Метод возвращает 0 если строк не существует либо курсор находится в позиции BFR либо ALR.

Для изучения методов стандартного варианта использования объектов типа ResultSet необходимо создать класс с методом main, который регистрирует драйвер JDBC, устанавливает соединение, подготавливает и выполняет запрос в базу данных и демонстрирует использование перечисленных выше методов аналогично следующему примеру:

//Пример №3-1 // ResultSet rs = . ; System.out.println(«Row number «+rs.getRow()+»; BFR is «+rs.isBeforeFirst()); while (rs.next()) System.out.print(«Row number «+rs.getRow()+»; First is «+rs.isFirst()); System.out.print(«:\t»+rs.getInt(1)); System.out.println(«\t»+rs.getString(2)); System.out.println(«Row number «+rs.getRow()+»; Last is «+rs.isLast()); > System.out.println(«Row number «+rs.getRow()+»; ALR is «+rs.isAfterLast());

Два других варианта использования объектов типа ResultSet требуют указания дополнительных параметров методам createStatement(), prepareStatement() и prepareCall():

createStatement(int resultSetType, int resultSetConcurrency);

prepareStatement(String sql, int resultSetType, int resultSetConcurrency);

prepareCall(String sql, int resultSetType, int resultSetConcurrency).

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

TYPE_SCROLL_INSENSITIVE – предусматривает перемещение курсора в любых направлениях, допускает абсолютное и относительное позиционирование курсора. Не отражает изменений данных, сделанных в базе после выполнения запроса.

TYPE_SCROLL_SENSITIVE — предусматривает перемещение курсора в любых направлениях, допускает абсолютное и относительное позиционирование курсора. Отражает изменения данных, сделанных в базе после выполнения запроса.

TYPE_FORWARD_ONLY – параметр по умолчанию, стандартный ResultSet.

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

CONCUR_UPDATABLE – позволяет вносить изменения в данные;

CONCUR_READ_ONLY – параметр по умолчанию, стандартный ResultSet.

При работе со Scrollable и Updateable вариантами объектов типа ResultSet используются следующие методы:

next() — перемещает курсор на следующую строку результата запроса;

previous() — перемещает курсор на предыдущую строку результата запроса;

beforeFirst() — устанавливает курсор на позицию “до первой строки”; если сразу после выполнения этого метода выполнить метод getXXX() будет выдано исключение типа SQLException;

afterLast() — устанавливает курсор на позицию “после последней строки”; если сразу после выполнения этого метода выполнить метод getXXX() будет выдано исключение типа SQLException;

first() — устанавливает курсор на первую строку результата запроса;

last() — устанавливает курсор на последнюю строку результата запроса;

absolute() — устанавливает курсор на указанную строку относительно первой строки результата запроса;

relative() — устанавливает курсор на указанную строку относительно текущей строки;

moveToCurrentRow() — устанавливает курсор на строку, номер которой был запомнен в результате выполнения метода moveToInsertRow();

moveToInsertRow() — устанавливает курсор в специальную свободную позицию для заполнения пустой строки значениями с помощью методов updateXXX() и последующей вставки этой строки в базу данных с помощью метода insertRow();

deleteRow() — удаляет строку как из результата запроса, так и из базы данных.

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

//Пример №3-2 // ResultSet rs = . ; rs.afterLast(); System.out.println(«Row number «+rs.getRow()+»; BFR is «+rs.isBeforeFirst()); rs.last(); while (rs.previous()) System.out.print(«Row number «+rs.getRow()+»; First is «+rs.isFirst()); System.out.print(«:\t»+rs.getInt(1)); System.out.println(«\t»+rs.getString(2)); System.out.println(«Row number «+rs.getRow()+»; Last is «+rs.isLast()); > System.out.println(«Row number «+rs.getRow()+»; ALR is «+rs.isAfterLast()); //Пример №3-3 // Statement st = conn.createStatement( ResultSet.TYPE_SCROLL_SENSITIVE, ResultSet.CONCUR_UPDATABLE); ResultSet rs = st.executeQuery(«SELECT * FROM операторы_связи»); while (rs.next()) System.out.println(rs.getInt(1)+»\t»+rs.getString(2)); if(rs.getString(2).equals(«МТС»)) rs.updateString(2, «TELE2»); rs.updateRow(); > > //rs = st.executeQuery(«SELECT * FROM операторы_связи»); rs.beforeFirst(); while (rs.next()) System.out.println(rs.getInt(1)+»\t»+rs.getString(2)); > //Пример 3-4 // Statement st = . ; ResultSet rs = . ; while (rs.next()) System.out.println(rs.getInt(1)+»\t»+rs.getString(2)); if(rs.getString(2).equals(«SkyLink2»)) rs.deleteRow(); > > rs.moveToInsertRow(); rs.updateInt(1, 5); rs.updateString(2, «TELE2»); rs.insertRow(); //rs = st.executeQuery(«SELECT * FROM операторы_связи»); rs.beforeFirst(); while (rs.next()) System.out.println(rs.getInt(1)+»\t»+rs.getString(2)); >

Интерфейсы ResultSetMetaData и DatabaseMetaData предусматривают методы для работы с метаданными базы данных. Первый интерфейс предназначен для получения информации о данных результата запроса, таких как имена столбцов, типы данных, максимальная длина. Второй интерфейс необходим для получения данных о структуре базы данных, таких как имена таблиц, первичные и внешние ключи, типы данных. Объекты такого типа используются для написания универсальных методов обработки результатов запросов либо для создания системных приложений администрирования баз данных.

Объект типа ResultSetMetaData создается методом getMetaData() объекта типа ResultSet. Ниже перечислены некоторые наиболее часто используемые методы объекта типа ResultSetMetaData:

getTableName() — Возвращает имя таблицы, по которой выполнялся запрос; тип возвращаемого значения String.

getColumnCount() — Возвращает количество столбцов результата запроса; тип возвращаемого значения int.

getColumnName(int n) – Возвращает имя столбца номер n в результате запроса; тип возвращаемого значения String.

getColumnType(int n) – Возвращает JDBC тип данных столбца номер n результата запроса (java.sql.Types); тип возвращаемого значения int.

GetColumnTypeName(int n) – Возвращает имя типа данных столбца номер n результата запроса в соответствии с типом данных его в базе данных (SQL data types); тип возвращаемого значения String.

Номер столбца результата запроса, так же как и в базе данных нумеруется начиная с 1, а не с 0, как при работе с массивами. Попытка указать нулевой номер столбца приведет к появлению исключения типа SQLException.

Объект типа DatabaseMetaData создается методом getMetaData() объекта типа Connection. Метода полученного таким образом объекта можно разделить условно на две категории: характеристики и струкрура базы данных.

К первой категории относятся методы для получения такой информации, как список ключевых слов SQL, перечень SQL типов данных, поддерживаемых данной СУБД. Типами возвращаемого значения таких методов могут быть одиночные строки или строки, разделенные символом “точка”. Методы, предназначенные для получения количественных характеристик базы данных возвращают значение типа int, например: максимально допустимое количество активных соединений. Методы, предназначенные для получения информации типа поддерживается ли базой данных пакетное обновление, возвращают значение типа boolean.

Ко второй категории относятся методы, запрашивающие информацию о таблицах, хранимых процедурах и т.д. Такие методы возвращают объекты типа ResultSet. Параметры таких методов могут содержать метасимволы _ (любой одиночный символ) и % (любая последовательность символов).

Изучение интерфейсов ResultSetMetaData и DatabaseMetaData выносится на самостоятельную проработку. Для проверки изученного материала будет выдано индивидуальное контрольное задание, заключающееся в написании соответствующего программного кода на java, которое необходимо выполнить и защитить на контрольном занятии.

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

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

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

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

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

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

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

Методы получения данных.
Эти методы используются для просмотра данных конкретной записи, на которую ссылается указатель.
Методы изменения данных.
Методы этой группы используются для изменения данных текущей записи. Эти изменения передаются в используемую БД.
Методы навигации.
Эти методы используются для перемещения указателя.

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

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

createStatement (int RSType, int RSConcurrency);
prepareStatement (String SQL, int RSType, int RSConcurrency);
prepareCall (String SQL, int RSType, int RSConcurrency);

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

Типы ResultSet

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

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

ResultSet.TYPE-FORWARD_ONLY
Указатель двигается только вперёд по множеству полученных результатов.
.
ResultSet.TYPE_SCROLL_INSENSITIVE
Указатель может двигаться вперёд и назад и не чувствителен к изменениям в БД, которые сделаны другими пользователями после того, как ResultSet был создан.
ResultSet.TYPE_SCROLL_SENSITIVE
Указатель может двигаться вперёд и назад и чувствителен к изменениям в БД, которые сделаны другими пользователями после того, как ResultSet был создан.

Доступ ResultSet

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

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

ResultSet.CONCUR_READ_ONLY
Создаёт экземпляр ResultSet только для чтения. Устанавливается по умолчанию.
ResultSet.CONCUR_UPDATABLE
Создаёт экземпляр ResultSet, который может изменять данные.

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

 try < statement = connection.createStatement( ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY ); >catch (SQLException e) < e.printStackTrace(); >finally < /*do some job*/ >

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

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

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

public void beforeFirst () throws SQLException
Перемещает указатель на место перед первым рядом.
public void afterLast () throws SQLException
Перемещает указатель на место после крайнего ряда.
public boolean first () throws SQLException
Перемещает указатель на первый ряд.
public boolean last () throws SQLException
Перемещает указатель на крайний ряд.
public boolean previous () throws SQLException
Перемещает указатель на предыдущий ряд. Возвращает false, если предыдущий ряд находится за пределами множества результатов.
public boolean next () throws SQLException
Перемещает указатель на следующий ряд. Возвращает false, если следующий ряд находится за пределами множества результатов.
public void absolute (int row) throws SQLException
Перемещает указатель на указанный ряд.
public void relative (int row) throws SQLException
Перемещает указатель на указанное количество рядов от текущего
public int getRow () throws SQLException
Возвращает номер ряда, на который в данный момент указывает курсор.
public void moveToInsertRow () throws SQLException
Перемещает указатель на ряд в полученном множестве, который может быть использован для того, чтобы добавить новую запись в БД. Текущее положение указателя запоминается.
public void moveToCurrentRow () throws SQLExcpetion
Возвращает указатель обратно на текущий ряд в случае, если указатель ссылается на ряд, в который в данный момент добавляются данные.

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

 import java.sql.*; public class ResultSetNavigationDemo < static final String JDBC_DRIVER = "com.mysql.jdbc.Driver"; static final String DATABASE_URL = "jdbc:mysql://localhost/PROSELYTE_TUTORIALS"; static final String USER = "ВАШЕ_ИМЯ_ПОЛЬЗОВАТЕЛЯ"; static final String PASSWORD = "ВАШ_ПАРОЛЬ"; public static void main(String[] args) throws ClassNotFoundException, SQLException < Connection connection = null; Statement statement = null; Class.forName(JDBC_DRIVER); connection = DriverManager.getConnection(DATABASE_URL, USER, PASSWORD); System.out.println("Creating statement. "); try < statement = connection.createStatement( ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_UPDATABLE ); String SQL = "SELECT * FROM developers"; ResultSet resultSet = statement.executeQuery(SQL); System.out.println("Moving cursor to the last position. "); resultSet.last(); System.out.println("Getting record. "); int String name = resultSet.getString("name"); String specialty = resultSet.getString("specialty"); int salary = resultSet.getInt("salary"); System.out.println("Last record in result set:"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); System.out.println("Moving cursor to previous row. "); resultSet.previous(); System.out.println("Getting record. "); name = resultSet.getString("name"); specialty = resultSet.getString("specialty"); salary = resultSet.getInt("salary"); System.out.println("Previous record:"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); System.out.println("Moving cursor to the first row. "); resultSet.first(); System.out.println("Getting record. "); name = resultSet.getString("name"); specialty = resultSet.getString("specialty"); salary = resultSet.getInt("salary"); System.out.println("First record:"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); System.out.println("Adding record. "); SQL = "INSERT INTO developers VALUES (5, 'Mike', 'PHP', 1500)"; statement.executeUpdate(SQL); SQL = "SELECT * FROM developers"; resultSet = statement.executeQuery(SQL); resultSet.last(); System.out.println("Getting record. "); name = resultSet.getString("name"); specialty = resultSet.getString("specialty"); salary = resultSet.getInt("salary"); System.out.println("Last record:"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); System.out.println("Full list of records:"); SQL = "SELECT * FROM developers"; resultSet = statement.executeQuery(SQL); while (resultSet.next()) < name = resultSet.getString("name"); specialty = resultSet.getString("specialty"); salary = resultSet.getInt("salary"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); >> catch (SQLException e) < e.printStackTrace(); >finally < if (statement != null) < statement.close(); >if(connection!=null) < connection.close(); >> > >

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

 /*Some System Messages*/ Creating statement. Moving cursor to the last position. Getting record. Last record in result set: id: 4 Name: Eugene Specialty: Java Salary: $3000 ========================= Moving cursor to previous row. Getting record. Previous record: id: 3 Name: AsyaSmile Specialty: UI/UX Salary: $2000 ========================= Moving cursor to the first row. Getting record. First record: id: 1 Name: Proselyte Specialty: Java Salary: $3000 ========================= Adding record. Getting record. Last record: id: 5 Name: Mike Specialty: PHP Salary: $1500 ========================= Full list of records: id: 1 Name: Proselyte Specialty: Java Salary: $3000 ========================= id: 2 Name: Peter Specialty: C++ Salary: $3000 ========================= id: 3 Name: AsyaSmile Specialty: UI/UX Salary: $2000 ========================= id: 4 Name: Eugene Specialty: Java Salary: $3000 ========================= id: 5 Name: Mike Specialty: PHP Salary: $1500 =========================

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

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

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

public int getInt (int columnIndex) throws SQLException
Возвращает номер текущего ряда с указанным индексом колонки. Индексы начинаются с 1. Т.е. первая – 1, вторая – 2 и т.д.
public int getInt (String columnName) throws SQLException
Возвращает целое число в текущем ряду с колонкой с именем, переданном в параметре columnName.

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

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

 import java.sql.*; public class ResultSetViewDemo < static final String JDBC_DRIVER = "com.mysql.jdbc.Driver"; static final String DATABASE_URL = "jdbc:mysql://localhost/PROSELYTE_TUTORIALS"; static final String USER = "ВАШЕ_ИМЯ_ПОЛЬЗОВАТЕЛЯ"; static final String PASSWORD = "ВАШ_ПАРОЛЬ"; public static void main(String[] args) throws ClassNotFoundException, SQLException < Connection connection = null; Statement statement = null; Class.forName(JDBC_DRIVER); connection = DriverManager.getConnection(DATABASE_URL, USER, PASSWORD); System.out.println("Creating statement. "); try < statement = connection.createStatement( ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_UPDATABLE ); String SQL = "SELECT * FROM developers"; ResultSet resultSet = statement.executeQuery(SQL); System.out.println("Moving cursor to the last position. "); resultSet.last(); System.out.println("Getting record (by name). "); int String name = resultSet.getString("name"); String specialty = resultSet.getString("specialty"); int salary = resultSet.getInt("salary"); System.out.println("Last record in result set:"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); System.out.println("Moving cursor to previous row. "); resultSet.previous(); System.out.println("Getting record. "); name = resultSet.getString("name"); specialty = resultSet.getString("specialty"); salary = resultSet.getInt("salary"); System.out.println("Previous record:"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); System.out.println("Moving cursor to the first row. "); resultSet.first(); System.out.println("Getting record. "); name = resultSet.getString("name"); specialty = resultSet.getString("specialty"); salary = resultSet.getInt("salary"); System.out.println("First record:"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); System.out.println("Adding record. "); SQL = "INSERT INTO developers VALUES (5, 'Mike', 'PHP', 1500)"; statement.executeUpdate(SQL); SQL = "SELECT * FROM developers"; resultSet = statement.executeQuery(SQL); resultSet.last(); System.out.println("Getting record (by index). "); name = resultSet.getString(2); specialty = resultSet.getString(3); salary = resultSet.getInt(4); System.out.println("Last record:"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); System.out.println("Full list of records (by name):"); SQL = "SELECT * FROM developers"; resultSet = statement.executeQuery(SQL); while (resultSet.next()) < name = resultSet.getString("name"); specialty = resultSet.getString("specialty"); salary = resultSet.getInt("salary"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); >> catch (SQLException e) < e.printStackTrace(); >finally < if (statement != null) < statement.close(); >if (connection != null) < connection.close(); >> > >

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

 /*Some System Messages*/ Creating statement. Moving cursor to the last position. Getting record (by name). Last record in result set: id: 4 Name: Eugene Specialty: Java Salary: $3000 ========================= Moving cursor to previous row. Getting record. Previous record: id: 3 Name: AsyaSmile Specialty: UI/UX Salary: $2000 ========================= Moving cursor to the first row. Getting record. First record: id: 1 Name: Proselyte Specialty: Java Salary: $3000 ========================= Adding record. Getting record (by index). Last record: id: 5 Name: Mike Specialty: PHP Salary: $1500 ========================= Full list of records (by name): id: 1 Name: Proselyte Specialty: Java Salary: $3000 ========================= id: 2 Name: Peter Specialty: C++ Salary: $3000 ========================= id: 3 Name: AsyaSmile Specialty: UI/UX Salary: $2000 ========================= id: 4 Name: Eugene Specialty: Java Salary: $3000 ========================= id: 5 Name: Mike Specialty: PHP Salary: $1500 =========================

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

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

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

public void updateString (int columnIndex, String s) throws SQLException
Изменяет строку в указанной колонке.
public void updateString (String columnName, String s) throws SQLException
Изменяет строку в колонке с указанным именем.

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

public void insertRow()
Вставляет запись в таблицу БД. Может быть использован только в том случае, когда указатель ссылается на ряд для вставки.
public void updateRow()
Изменяет текущий ряд в таблице БД.
public void deleteRow()
Удаляет текущий ряд из таблицы БД.

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

 import java.sql.*; public class ResultSetUpdateDemo < static final String JDBC_DRIVER = "com.mysql.jdbc.Driver"; static final String DATABASE_URL = "jdbc:mysql://localhost/PROSELYTE_TUTORIALS"; static final String USER = "ВАШЕ_ИМЯ_ПОЛЬЗОВАТЕЛЯ"; static final String PASSWORD = "ВАШ_ПАРОЛЬ"; public static void main(String[] args) throws ClassNotFoundException, SQLException < Connection connection = null; Statement statement = null; Class.forName(JDBC_DRIVER); connection = DriverManager.getConnection(DATABASE_URL, USER, PASSWORD); System.out.println("Creating statement. "); try < statement = connection.createStatement( ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_UPDATABLE ); String SQL = "SELECT * FROM developers"; ResultSet resultSet = statement.executeQuery(SQL); System.out.println("Initial list of records:"); while (resultSet.next()) < int String name = resultSet.getString("name"); String specialty = resultSet.getString("specialty"); int salary = resultSet.getInt("salary"); System.out.println("Last record in result set:"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); >System.out.println("Increasing all developer's salary (+ $1,000). "); resultSet.first(); while (resultSet.next()) < int newSalary = resultSet.getInt("salary") + 1000; resultSet.updateInt("salary", newSalary); resultSet.updateRow(); >resultSet.first(); System.out.println("Final list of records:"); while (resultSet.next()) < int String name = resultSet.getString("name"); String specialty = resultSet.getString("specialty"); int salary = resultSet.getInt("salary"); System.out.println("id: " + id); System.out.println("Name: " + name); System.out.println("Specialty: " + specialty); System.out.println("Salary: $" + salary); System.out.println("\n=========================\n"); >resultSet.close(); > catch (SQLException e) < e.printStackTrace(); >finally < if (statement != null) < statement.close(); >if (connection != null) < connection.close(); >> > >

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

 Creating statement. Initial list of records: Last record in result set: id: 1 Name: Proselyte Specialty: Java Salary: $3000 ========================= Last record in result set: id: 2 Name: Peter Specialty: C++ Salary: $3000 ========================= Last record in result set: id: 3 Name: AsyaSmile Specialty: UI/UX Salary: $2000 ========================= Last record in result set: id: 4 Name: Eugene Specialty: Java Salary: $3000 ========================= Last record in result set: id: 5 Name: Mike Specialty: PHP Salary: $1500 ========================= Increasing all developer's salary (+ $1,000). Final list of records: id: 2 Name: Peter Specialty: C++ Salary: $4000 ========================= id: 3 Name: AsyaSmile Specialty: UI/UX Salary: $3000 ========================= id: 4 Name: Eugene Specialty: Java Salary: $4000 ========================= id: 5 Name: Mike Specialty: PHP Salary: $2500 =========================

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

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

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

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

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

Методы ResultSet

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

Метод	Описание
public boolean absolute(int row) throws SQLException	Метод перемещает курсор на заданное число строк от начала, если число положительно, и от конца — если отрицательно
public void afterLast() throws SQLException	Этот метод перемещает курсор в конец результирующего набора за последнюю строку
public void beforeFirst() throws SQLException	Этот метод перемещает курсор в начало результирующего набора перед первой строкой
public void deleteRow() throws SQLException	Удаляет текущую строку из результирующего набора и базы данных
public ResultSetMetaData getMetaData() throws SQLException	Предоставляет объект метаданных для данного ResultSet. Класс ResultSetMetaData содержит информацию о результирующие таблице, такую как количество столбцов, их заголовок и т.д.
public int getRow() throws SQLException	Возвращает номер текущей строки
public Statement getStatement() throws SQLException	Возвращает экземпляр Statement, который произвел данный результирующий набор
public boolean next() throws SQLException public boolean previous() throws SQLException	Эти методы позволяют переместиться в результирующем наборе на одну строку вперед или назад. Во вновь созданном результирующем наборе курсор устанавливается перед первой строкой, поэтому первое обращение к методу next() влечет позиционирование на первую строку. Эти методы возвращают true, если остается строка для дальнейшего перемещения. Если строк для обработки больше нет, возвращается false. Если открыт поток InputStream для предыдущей строки, он закрывается. Также очищается цепочка предупреждений SQLWarning
public void close() throws SQLException	Осуществляет немедленное закрытие ResultSet вручную. Обычно этого не требуется, так как закрытие Statement, связанного с ResultSet, автоматически закрывает ResultSet. К сожалению, не все разработчики JDBC-драйверов придерживаются этих концепций, например, драйвер Oracle самостоятельно не закрывает ResultSet’ы, так что настоятельно рекомендуется закрывать вручную

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

package mssql; import java.sql.*; public class Main < private static Connection con = null; private static String username = "name"; private static String password = "pass"; private static String URL = "jdbc:jtds:sqlserver://localhost:1433"; public static void main(String[] args) throws SQLException < // Загрузка драйвера DriverManager.registerDriver(new net.sourceforge.jtds.jdbc.Driver()); // Подключение к БД con = DriverManager.getConnection(URL, username, password); if(con != null) System.out.println("Connection Successful !\n"); else System.exit(0); // Создание Statement для отправки запроса базе данных Statement st = con.createStatement(); // Результирующий запрос ResultSet rs = st.executeQuery("select * from users"); // Количество колонок в результирующем запросе int columns = rs.getMetaData().getColumnCount(); // Перебор строк с данными while(rs.next())< for (int i = 1; i System.out.println(); > System.out.println(); if(rs != null) rs.close(); if(st != null) st.close(); if(con != null) con.close(); > >

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

Значение NULL в ResultSet

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

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

значение будет null для тех методов getXXX, которые возвращают объекты (getString, getBigDecimal, getBytes, getDate, getTime, getTimestamp, getAsciiStream, getUnicodeStream, getBinaryStream, getObject)
нулевое значение для методов, возвращающих целочисленное или вещественное значения (getByte, getShort, getInt, getLong, getFloat, and getDouble)
false для метода getBoolean

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

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

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

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

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

Statement stmt = connection.createStatement(); ResultSet rset = stmt.executeQuery ("select * from users"); String cursorName = rs.getCursorName();

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

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

String s = rs.getString("title"); String s = rs.getString(2);

При обращении к колонке по номеру следует помнить, что колонки нумеруются слева направо, начиная с 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-типы) рекомендуются для этих методов.

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

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

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

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

T I N Y I N T	S M A L L I N T	I N T E G E R	B I G I N T	R E A L	F L O A T	D O U B L E	D E C I M A L	N U M E R I C	B I T	C H A R	V A R C H A R	L O N G V A R C H A R	B I N A R Y	V A R B I N A R Y	L O N G V A R B I N A R Y	D A T E	T I M E	T I M E S T A M P
getByte	X	x	x	x	x	x	x	x	x	x	x	x	x
getShort	x	X	x	x	x	x	x	x	x	x	x	x	x
getInt	x	x	X	x	x	x	x	x	x	x	x	x	x
getLong	x	x	x	X	x	x	x	x	x	x	x	x	x
getFloat	x	x	x	x	X	x	x	x	x	x	x	x	x
getDouble	x	x	x	x	x	X	X	x	x	x	x	x	x
getBigDecimal	x	x	x	x	x	x	x	X	X	x	x	x	x
getBoolean	x	x	x	x	x	x	x	x	x	X	x	x	x
getString	x	x	x	x	x	x	x	x	x	x	X	X	x	x	x	x	x	x	x
getBytes	X	X	x
getDate	x	x	x	X	x
getTime	x	x	x	X	x
getTimestamp	x	x	x	x	X
getAsciiStream	x	x	X	x	x	x
getUnicodeStream	x	x	X	x	x	x
getBinaryStream	x	x	X
getObject	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x

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

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

byte[] binaryBuffer = null; try < Statement stmt = connection.createStatement(); ResultSet rset = stmt.executeQuery(sql); rset.next(); binaryBuffer = rset.getBytes(1); rset.close(); stmt.close(); >catch (SQLException e)

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

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

getBinaryStream возвращает поток байтов «как есть», без какого-либо предварительного преобразования
getAsciiStream возвращает поток, состоящий из однобайтовых ASCII-символов
getUnicodeStream возвращает поток двухбайтных символов Unicode

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

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

String sql = "select book from lib where name = 'Золушка'"; Statement stmt = connection.createStatement(); ResultSet rs = st.executeQuery(sql); rs.next(); Clob clob = rs.getClob(1); InputStream is = clob.getAsciiStream();

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

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

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

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

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

Продвинутая работа с ResultSet

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

При создании объекта statement в него можно передать кучу наших пожеланий. Эти пожелания можно разделить на три группы:

Тип связи с базой
Управление одновременным доступом
Сохраняемость и транзакции

Эти параметры можно передавать при создании объекта Statement или PreparedStatement . Пример:

 Statement statement = connection.createStatement( ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY, ResultSet.CLOSE_CURSORS_OVER_COMMIT ); PreparedStatement statement = connection.prepareStatement(sql, ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY, ResultSet.CLOSE_CURSORS_OVER_COMMIT);

Глубоко эти вещи мы изучать не будем, но я хочу, чтобы ты знал, что такое возможно, если встретишь что-то похожее в чужом коде.

Типы ResultSet

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

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

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

ResultSet.TYPE_FORWARD_ONLY
ResultSet.TYPE_SCROLL_INSENSITIVE
ResultSet.TYPE_SCROLL_SENSITIVE

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

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

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

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

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

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

Concurrency

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

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

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

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

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

Пример изменения данных в базе

С помощью этих параметров ты можешь управлять создаваемым Statement и его ResultSet.

Например, можно создать обновляемый ResultSet и с его помощью менять базу данных. При создании Statement важно соблюсти следующие условия:

указывается только одна таблица
не содержит предложений join или group by
столбцы запроса должны содержать первичный ключ

При выполнении вышеуказанных условий обновляемый ResultSet может быть использован для модификации таблицы в базе данных. При создании объекта Statement нужно указать такие параметры:

 Statement st = createStatement(Result.TYPE_SCROLL_INSENSITIVE, Result.CONCUR_UPDATABLE)

Результатом выполнения такого оператора является обновляемый набор результатов. Метод обновления заключается в перемещении курсора ResultSet в строку, которую ты хочешь обновить, а затем в вызове метода updateXXX() .

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

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

Также можно добавлять новые строки в таблицу:

Сначала нужно переместить курсор на пустую строку. Для этого нужно вызвать метод moveToInsertRow() .

Затем нужно заполнить эту строку данными с помощью метода updateXXX() .

Затем нужно вызвать метод inserRow() , чтобы строка добавилась в базу.

Ну и наконец нужно вернуть курсор обратно, вызвав метод moveToCurrentRow() .

Важно! Не все СУБД поддерживают данные параметры для расширенного оператора Statement. В случае наличия проблем смотри официальную документацию конкретной СУБД.

Что такое resultset как с ним работать