Пакет java.sql

Обеспечивает API для доступа и обработки данных, сохраненных в источнике данных (обычно реляционная база данных) использование языка программирования ^JavaTM.

См.: Описание

Сводка интерфейса

Интерфейс	Описание
Массив	Отображение в языке программирования Java для типа SQL ARRAY.
Блоб	Представление (отображающееся) в языке программирования JavaTM SQL BLOB значение.
CallableStatement	Интерфейс, используемый, чтобы выполнить хранимые процедуры SQL.
Clob	Отображение в языке программирования JavaTM для SQL CLOB ввести.
Соединение	Соединение (сеанс) с определенной базой данных.
DatabaseMetaData	Исчерпывающая информация о базе данных в целом.
Драйвер	Интерфейс, который должен реализовать каждый драйвер class.
DriverAction	Интерфейс, который должен быть реализован, когда Драйвер хочет быть уведомленным DriverManager.
NClob	Отображение в языке программирования JavaTM для SQL NCLOB ввести.
ParameterMetaData	Объект, который может использоваться, чтобы получить информацию о типах и свойствах для каждого маркера параметра в a PreparedStatement объект.
PreparedStatement	Объект, который представляет предварительно скомпилированный SQL-оператор.
Касательно	Отображение в языке программирования Java SQL REF значение, которое является ссылкой на SQL структурированное значение типа в базе данных.
ResultSet	Таблица данных, представляющих набор результатов базы данных, который обычно сгенерирован, выполняя оператор, который запрашивает базу данных.
ResultSetMetaData	Объект, который может использоваться, чтобы получить информацию о типах и свойствах столбцов в a ResultSet объект.
RowId	Представление (отображающееся) в языке программирования Java SQL значение ROWID.
Точка сохранения	Представление точки сохранения, которая является точкой в пределах текущей транзакции, на которую можно сослаться от Connection.rollback метод.
SQLData	Интерфейс, используемый для пользовательского отображения SQL определяемый пользователем тип (UDT) к class в языке программирования Java.
SQLInput	Входной поток, который содержит поток значений, представляющих экземпляр SQL структурированный тип или SQL отличный тип.
SQLOutput	Поток вывода для того, чтобы записать атрибуты обратно определяемого пользователем типа к базе данных.
SQLType	Объект, который используется, чтобы идентифицировать универсальный тип SQL, названный типом JDBC или поставщиком определенный тип данных.
SQLXML	Отображение в языке программирования JavaTM для типа XML SQL.
Оператор	Объект, используемый для того, чтобы выполнить статический SQL-оператор и возвратить результаты, это производит.
Struct	Стандартное отображение в языке программирования Java для SQL структурированный тип.
Обертка	Интерфейс для классов JDBC, которые обеспечивают возможность получить экземпляр делегата, когда рассматриваемый экземпляр является фактически прокси class.

Сводка класса

Класс	Описание
Дата	Тонкая обертка вокруг значения миллисекунды, которое позволяет JDBC идентифицировать это как SQL DATE значение.
DriverManager	Основная услуга для того, чтобы управлять рядом драйверов JDBC. ОТМЕТЬТЕ: DataSource интерфейс, новый в JDBC 2.0 API, обеспечивает другой способ соединиться с источником данных.
DriverPropertyInfo	Свойства драйвера для того, чтобы сделать соединение.
SQLPermission	Разрешение то, для который SecurityManager проверит, когда код, который запускает приложение с a SecurityManager включенный, вызовы DriverManager.deregisterDriver метод, DriverManager.setLogWriter метод, DriverManager.setLogStream (осуждаемый) метод, SyncFactory.setJNDIContext метод, SyncFactory.setLogger метод, Connection.setNetworktimeout метод, или Connection.abort метод.
Время	Тонкая обертка вокруг java.util.Date class, который позволяет API JDBC идентифицировать это как SQL TIME значение.
Метка времени	Тонкая обертка вокруг java.util.Date это позволяет API JDBC идентифицировать это как SQL TIMESTAMP значение.
Типы	class, который определяет константы, которые используются, чтобы идентифицировать универсальные типы SQL, названные типами JDBC.

Перечислимая Сводка

Перечисление	Описание
ClientInfoStatus	Перечисление для состояния причины, что свойство не могло быть установлено через звонок Connection.setClientInfo
JDBCType	Определяет константы, которые используются, чтобы идентифицировать универсальные типы SQL, названные типами JDBC.
PseudoColumnUsage	Перечисление для псевдо/скрытого использования столбца.
RowIdLifetime	Перечисление для значений времени жизни RowId.

Сводка исключения

Исключение	Описание
BatchUpdateException	Подкласс SQLException брошенный, когда ошибка происходит во время работы пакетного обновления.
DataTruncation	Исключение, выданное как a DataTruncation исключение (на записях) или сообщило как a DataTruncation предупреждение (на чтениях), когда значения данных является неожиданно усеченным по причинам кроме того, что это имело execeeded MaxFieldSize.
SQLClientInfoException	Подкласс SQLException бросается, когда одно или более клиентских свойств информации не могли быть установлены на a Connection.
SQLDataException	Подкласс SQLException брошенный, когда значение class SQLState '22', или при определенных поставщиком условиях.
SQLException	Исключение, которое предоставляет информацию об ошибке доступа к базе данных или других ошибках.
SQLFeatureNotSupportedException	Подкласс SQLException брошенный, когда значение class SQLState является '0A' (значение является 'нулем' A).
SQLIntegrityConstraintViolationException	Подкласс SQLException брошенный, когда значение class SQLState '23', или при определенных поставщиком условиях.
SQLInvalidAuthorizationSpecException	Подкласс SQLException брошенный, когда значение class SQLState '28', или при определенных поставщиком условиях.
SQLNonTransientConnectionException	Подкласс SQLException брошенный для class SQLState оценивают '08', или при определенных поставщиком условиях.
SQLNonTransientException	Подкласс SQLException брошенный, когда экземпляр, где повторная попытка той же самой работы не перестала бы работать если причина SQLException исправляется.
SQLRecoverableException	Подкласс SQLException добавленные ситуации, где ранее отказавшая работа могла бы быть в состоянии успешно выполниться, если приложение выполняет некоторое восстановление, ступают и повторяют всю транзакцию или в случае распределенной транзакции, ответвления транзакции.
SQLSyntaxErrorException	Подкласс SQLException брошенный, когда значение class SQLState '42', или при определенных поставщиком условиях.
SQLTimeoutException	Подкласс SQLException брошенный, когда тайм-аут, определенный Statement.setQueryTimeout, DriverManager.setLoginTimeout, DataSource.setLoginTimeout,XADataSource.setLoginTimeout истек.
SQLTransactionRollbackException	Подкласс SQLException брошенный, когда значение class SQLState '40', или при определенных поставщиком условиях.
SQLTransientConnectionException	Подкласс SQLException поскольку class SQLState оценивает '08', или при определенных поставщиком условиях.
SQLTransientException	Подкласс SQLException бросается в ситуации, где previoulsy, за которым отказавшая работа могла бы быть в состоянии следовать, когда работа повторяется без любого вмешательства функциональности уровня приложения.
SQLWarning	Исключение, которое предоставляет информацию о предупреждениях доступа к базе данных.

Пакет java.sql Описание

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

Что ^JDBCTM Включают 4.2 API

^JDBCTM 4.2 API включает обоих java.sql пакет, называемый базовым API JDBC, и javax.sql пакет, называемый Дополнительным API Пакета JDBC. Это завершается, API JDBC включается в ^JavaTM Standard Edition (Java ^SETM), версия 7. javax.sql пакет расширяет функциональность API JDBC от клиентского API до серверного API, и это - основная часть ^JavaTM Enterprise Edition (Java ^EETM) технология.

Версии

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

• 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 API

У классов, интерфейсов, методов, полей, конструкторов, и исключений есть следующий "начиная с" тегов, которые указывают, когда они были введены в платформу Java. Когда они "начиная с" тегов используются в комментариях ^JavadocTM для API JDBC, они указывают на следующее:

• С тех пор 1.8 - новый в JDBC 4.2 API и часть Java платформа SE, версия 8
• С тех пор 1.7 - новый в JDBC 4.1 API и часть Java платформа SE, версия 7
• С тех пор 1.6 - новый в JDBC 4.0 API и часть Java платформа SE, версия 6
• С тех пор 1.4 - новый в JDBC 3.0 API и часть платформы J2SE, версии 1.4
• С тех пор 1.2 - новый в JDBC 2.0 API и часть платформы J2SE, версии 1.2
• С тех пор 1.1 или не "начиная с" тега - в исходном JDBC 1.0 API и часть ^JDKTM, версии 1.1

ОТМЕТЬТЕ: Многие из новых функций являются дополнительными; следовательно, есть некоторое изменение в драйверах и функциях, которые они поддерживают. Всегда проверяйте документацию своего драйвера, чтобы видеть, поддерживает ли она функцию прежде, чем Вы попытаетесь использовать ее.

ОТМЕТЬТЕ: class SQLPermission был добавлен в ^JavaTM 2 SDK, Standard Edition, выпуск версии 1.3. Этот class используется, чтобы предотвратить несанкционированный доступ к потоку журналирования, связанному с DriverManager, который может содержать информацию, такую как имена таблиц, данные столбца, и так далее.

Что java.sql Пакет Содержит

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

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

java.sql и javax.sql Функции, Представленные в JDBC 4.2 API

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

java.sql и javax.sql Функции, Представленные в JDBC 4.1 API

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

java.sql и javax.sql Функции, Представленные в JDBC 4.0 API

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

java.sql и javax.sql Функции, Представленные в JDBC 3.0 API

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

java.sql Функции, Представленные в JDBC 2.1 Базовых API

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

javax.sql Функции, Представленные в JDBC 2.0 Дополнительных API Пакета

• DataSource взаимодействуйте через интерфейс как средство создания соединения. Именование Java и Каталог ^InterfaceTM (JNDI) используются для того, чтобы зарегистрировать a DataSource объект со службой именования и также для того, чтобы получить это.
• Объединенные в пул соединения - разрешение соединений использоваться и снова использованным
• Распределенные транзакции - разрешение транзакции охватить разнообразные серверы DBMS
• RowSet технология - обеспечение удобного средства обработки и передачи данных

Пользовательское Отображение UDTs

Определяемый пользователем тип (UDT), определенный в SQL, может быть отображен на class в языке программирования Java. SQL структурированный тип или SQL DISTINCT тип является UDTs, который может быть пользовательский отображенный. Следующие три шага, установленные пользовательское отображение:

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

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

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

• Спецификация JDBC 4.0 API

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

• Начинание - краткие обзоры главных интерфейсов

• Главы по API JDBC - от сетевой версии Продолжительного Учебного руководства по Java

• Учебное руководство ^JDBCTMAPI и Ссылка, Третий Выпуск - полная ссылка и учебное руководство для JDBC 3.0 API

С тех пор:

1.1