Пакет java.sql

Предоставляет API для доступа к данным, хранящимся в источнике данных (обычно в реляционной базе данных), и их обработки с помощью языка программирования Java. Этот API включает инфраструктуру, позволяющую динамически устанавливать различные драйверы для доступа к разным источникам данных. Хотя API JDBC в основном предназначен для передачи SQL-инструкций базе данных, он позволяет считывать данные из любого источника данных с табличным форматом и записывать их в него. Средство чтения/записи, доступное через группу интерфейсов javax.sql.RowSet, можно настроить для использования и обновления данных в электронной таблице, плоском файле или любом другом табличном источнике данных.

Что включает API JDBC 4.5

API JDBC 4.5 включает пакет java.sql, называемый базовым API JDBC, и пакет javax.sql, называемый API дополнительного пакета JDBC. Полный API JDBC входит в Java Standard Edition (Java SE). Пакет javax.sql расширяет функциональность API JDBC, превращая клиентский API в серверный API; он является неотъемлемой частью технологии Java Enterprise Edition (Java EE).

Версии

API JDBC 4.5 включает все предыдущие версии API JDBC:

• API JDBC 4.4
• API JDBC 4.3
• API JDBC 4.2
• API JDBC 4.1
• API JDBC 4.0
• API JDBC 3.0
• Базовый API JDBC 2.1
• API дополнительного пакета JDBC 2.0
  (Обратите внимание: базовый API JDBC 2.1 и API дополнительного пакета JDBC 2.0 вместе называются API JDBC 2.0.)
• API JDBC 1.2
• API JDBC 1.0

Для классов, интерфейсов, методов, полей, конструкторов и исключений используются следующие теги "since", указывающие, когда они были добавлены в платформу Java. В комментариях Javadoc для API JDBC эти теги "since" обозначают следующее:

• Since 26 — новое в API JDBC 4.5 и входит в платформу Java SE версии 26
• Since 24 — новое в API JDBC 4.4 и входит в платформу Java SE версии 24
• Since 9 — новое в API JDBC 4.3 и входит в платформу Java SE версии 9
• Since 1.8 — новое в API JDBC 4.2 и входит в платформу Java SE версии 8
• Since 1.7 — новое в API JDBC 4.1 и входит в платформу Java SE версии 7
• Since 1.6 — новое в API JDBC 4.0 и входит в платформу Java SE версии 6
• Since 1.4 — новое в API JDBC 3.0 и входит в платформу J2SE версии 1.4
• Since 1.2 — новое в API JDBC 2.0 и входит в платформу J2SE версии 1.2
• Since 1.1 или тег "since" отсутствует — присутствует в исходном API JDBC 1.0 и входит в JDK версии 1.1

ПРИМЕЧАНИЕ: Многие новые функции являются необязательными; поэтому драйверы и поддерживаемые ими функции могут различаться. Прежде чем использовать функцию, обязательно проверьте в документации драйвера, поддерживает ли он ее.

Содержимое пакета java.sql

Пакет java.sql содержит API для следующего:

• Установление соединения с базой данных с помощью средства DriverManager
  • класс DriverManager — устанавливает соединение с помощью драйвера
  • интерфейс Driver — предоставляет API для регистрации драйверов на основе технологии JDBC («драйверов JDBC») и установления соединений с их помощью; обычно используется только классом DriverManager
  • класс DriverPropertyInfo — предоставляет свойства для драйвера JDBC; не используется обычным пользователем
• Отправка SQL-инструкций в базу данных
  • Statement — используется для отправки простых SQL-инструкций
  • PreparedStatement — используется для отправки подготовленных или простых SQL-инструкций (производный от Statement)
  • CallableStatement — используется для вызова хранимых процедур базы данных (производный от PreparedStatement)
  • интерфейс Connection — предоставляет методы для создания инструкций и управления соединениями и их свойствами
  • Savepoint — предоставляет точки сохранения в транзакции
• Получение результатов запроса и их обновление
  • интерфейс ResultSet
• Стандартные сопоставления типов SQL с классами и интерфейсами языка программирования Java
  • интерфейс Array — сопоставление с типом SQL ARRAY
  • интерфейс Blob — сопоставление с типом SQL BLOB
  • интерфейс Clob — сопоставление с типом SQL CLOB
  • класс Date — сопоставление с типом SQL DATE
  • класс JDBCType — предоставляет константы перечисления для типов SQL
  • интерфейс NClob — сопоставление с типом SQL NCLOB
  • интерфейс Ref — сопоставление с типом SQL REF
  • интерфейс RowId — сопоставление с типом SQL ROWID
  • интерфейс Struct — сопоставление с типом SQL STRUCT
  • интерфейс SQLXML — сопоставление с типом SQL XML
  • класс Time — сопоставление с типом SQL TIME
  • класс Timestamp — сопоставление с типом SQL TIMESTAMP
  • класс Types — предоставляет константы для типов SQL
• Пользовательское сопоставление определяемого пользователем типа SQL (UDT) с классом языка программирования Java
  • интерфейс SQLData — определяет сопоставление UDT с экземпляром этого класса
  • интерфейс SQLInput — предоставляет методы для чтения атрибутов UDT из потока
  • интерфейс SQLOutput — предоставляет методы для записи атрибутов UDT обратно в поток
• Метаданные
  • интерфейс DatabaseMetaData — предоставляет информацию о базе данных
  • интерфейс ResultSetMetaData — предоставляет информацию о столбцах объекта ResultSet
  • интерфейс ParameterMetaData — предоставляет информацию о параметрах команд PreparedStatement
• Исключения
  • SQLException — выбрасывается большинством методов при возникновении проблемы с доступом к данным, а некоторыми методами — по другим причинам
  • SQLWarning — выбрасывается для обозначения предупреждения
  • DataTruncation — выбрасывается для обозначения возможного усечения данных
  • BatchUpdateException — выбрасывается для обозначения того, что не все команды пакетного обновления выполнены успешно

Функции java.sql и javax.sql, появившиеся в API JDBC 4.5

• Интерфейсы Array, Blob, Clob, NClob и SQLXML теперь расширяют интерфейс AutoCloseable и включают реализацию метода close по умолчанию
• В Connection добавлена поддержка заключения литералов и простых идентификаторов в кавычки
• SQLPermissions помечен как устаревший для последующего удаления
• Типы SQL JSON и DECFLOAT добавлены в JDBCType и Types

Функции java.sql и javax.sql, появившиеся в API JDBC 4.4

• Удалено упоминание SecurityManager и SecurityException, поскольку SecurityManager больше не поддерживается
• SQLPermissions больше нельзя использовать для управления доступом к ресурсам, поскольку SecurityManager больше не поддерживается
• В Connection добавлена поддержка заключения литералов и простых идентификаторов в кавычки

Функции java.sql и javax.sql, появившиеся в API JDBC 4.3

• Добавлена поддержка Sharding
• В Connection добавлена возможность передавать драйверу указания о начале или завершении запроса — независимой единицы работы
• В DatabaseMetaData добавлена возможность определять, поддерживается ли шардирование
• В DriverManager добавлен метод drivers, возвращающий поток текущих загруженных и доступных драйверов JDBC
• В Statement добавлена поддержка заключения литералов и простых идентификаторов в кавычки
• Уточнена версия Java SE, в которой методы были объявлены устаревшими

Функции java.sql и javax.sql, появившиеся в API JDBC 4.2

• Добавлены перечисление JDBCType и интерфейс SQLType
• Добавлена поддержка REF CURSORS в CallableStatement
• Методы DatabaseMetaData для получения максимального логического размера LOB и сведений о поддержке курсоров Ref
• Добавлена поддержка больших счетчиков обновлений

Функции java.sql и javax.sql, появившиеся в API JDBC 4.1

• Разрешено использовать объекты Connection, ResultSet и Statement в операторе try-with-resources
• В CallableStatement и ResultSet добавлена возможность указывать тип Java для преобразования с помощью метода getObject
• Методы DatabaseMetaData для получения псевдостолбцов и сведений о том, всегда ли возвращается сгенерированный ключ
• В Connection добавлена поддержка указания схемы базы данных, прерывания физического соединения и установки времени ожидания.
• Добавлена поддержка закрытия объекта Statement при закрытии зависимых от него объектов
• Добавлена поддержка получения родительского средства ведения журнала для Driver, DataSource, ConnectionPoolDataSource и XADataSource

Функции java.sql и javax.sql, появившиеся в API JDBC 4.0

• Автоматическое обнаружение java.sql.Driver — больше не нужно загружать класс java.sql.Driver с помощью Class.forName
• Добавлена поддержка национальных наборов символов
• Добавлена поддержка типа данных XML из SQL:2003
• Усовершенствования SQLException — добавлена поддержка цепочек причин; добавлены новые исключения SQL для распространенных кодов значений класса SQLState
• Расширена функциональность Blob/Clob — добавлена поддержка создания и освобождения экземпляров Blob/Clob, а также дополнительные методы для упрощения доступа
• Добавлена поддержка доступа к SQL ROWID
• Добавлена поддержка доступа приложения JDBC к экземпляру ресурса JDBC, обернутому поставщиком, обычно в среде сервера приложений или пула соединений.
• Добавлена возможность получать уведомления о закрытии PreparedStatement, связанного с PooledConnection, или о том, что драйвер считает его недействительным

Функции java.sql и javax.sql, появившиеся в API JDBC 3.0

• Пулируемые инструкции — повторное использование инструкций, связанных с пулом соединений
• Точки сохранения — позволяют откатить транзакцию до указанной точки сохранения
• Свойства, определенные для ConnectionPoolDataSource, — задают порядок объединения соединений в пул
• Метаданные параметров объекта PreparedStatement
• Возможность получать значения автоматически сгенерированных столбцов
• Возможность одновременно получать несколько объектов ResultSet из открытых объектов CallableStatement
• Возможность идентифицировать параметры объектов CallableStatement по имени, а также по индексу
• Удерживаемость ResultSet — возможность указывать, должны ли курсоры оставаться открытыми или закрываться в конце транзакции
• Возможность получать и обновлять экземпляр структурированного типа SQL, на который ссылается объект Ref
• Возможность программно обновлять значения BLOB, CLOB, ARRAY и REF.
• Добавлен тип данных java.sql.Types.DATALINK, предоставляющий драйверам JDBC доступ к объектам, хранящимся вне источника данных
• Добавлены метаданные для получения иерархий типов SQL

Функции java.sql, появившиеся в базовом API JDBC 2.1

• Прокручиваемые наборы результатов — новые методы интерфейса ResultSet позволяют перемещать курсор к определенной строке или в позицию относительно текущей
• Пакетные обновления
• Программные обновления — с помощью методов обновления ResultSet
• Новые типы данных — интерфейсы, сопоставляющие типы данных SQL3
• Пользовательское сопоставление определяемых пользователем типов (UDT)
• Различные функции, включая подсказки для повышения производительности, использование символьных потоков, полную точность значений java.math.BigDecimal, дополнительные средства безопасности и поддержку часовых поясов для значений даты, времени и метки времени.

Функции javax.sql, появившиеся в API дополнительного пакета JDBC 2.0

• Интерфейс DataSource для установления соединения. Java Naming and Directory Interface (JNDI) используется для регистрации объекта DataSource в службе именования, а также для его получения.
• Пулируемые соединения — позволяют использовать соединения повторно
• Распределенные транзакции — позволяют транзакции охватывать несколько серверов СУБД
• Технология RowSet — обеспечивает удобный способ обработки и передачи данных

Пользовательское сопоставление UDT

Определенный в SQL пользовательский тип (UDT) можно сопоставить с классом языка программирования Java. Структурированный тип SQL или тип SQL DISTINCT — это UDT, для которых можно задать пользовательское сопоставление. Пользовательское сопоставление настраивается в три этапа:

1. Определение структурированного типа SQL или типа DISTINCT в SQL
2. Определение класса языка программирования Java, с которым будет сопоставлен UDT SQL. Этот класс должен реализовывать интерфейс SQLData.
3. Добавление записи в карту типов объекта Connection, содержащей два элемента:
   • полное имя UDT в SQL
   • объект Class для класса, реализующего интерфейс SQLData

После настройки этих элементов для UDT вызов методов ResultSet.getObject или CallableStatement.getObject для этого UDT автоматически получит для него пользовательское сопоставление. Кроме того, метод PreparedStatement.setObject автоматически сопоставит объект с его типом SQL для сохранения в источнике данных.

Спецификация пакета

• Спецификация JDBC 4.5

Связанная документация

• Урок: основы JDBC (учебные материалы Java > доступ к базам данных JDBC)