Интерфейс подключения

static final int TRANSACTION_NONE

Константа, указывающая, что транзакции не поддерживаются.

static final int TRANSACTION_READ_UNCOMMITTED

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

static final int TRANSACTION_READ_COMMITTED

Константа, указывающая, что грязные чтения предотвращены; могут произойти невоспроизводимые чтения и призрачные чтения. Этот уровень запрещает транзакции читать строку с неподтверждёнными изменениями в ней.

static final int TRANSACTION_REPEATABLE_READ

Константа, указывающая, что грязные чтения и невоспроизводимые чтения предотвращены; могут произойти призрачные чтения. Этот уровень запрещает транзакции читать строку с неподтверждёнными изменениями в ней, а также запрещает ситуацию, когда одна транзакция читает строку, вторая транзакция изменяет строку, а первая транзакция перечитывает строку, получая разные значения во второй раз ( "невоспроизводимое чтение").

static final int TRANSACTION_SERIALIZABLE

Константа, указывающая, что грязные чтения, невоспроизводимые чтения и призрачные чтения предотвращены. Этот уровень включает запреты в TRANSACTION_REPEATABLE_READ и дополнительно запрещает ситуацию, когда одна транзакция читает все строки, удовлетворяющие условию WHERE, вторая транзакция вставляет строку, удовлетворяющую этому условию WHERE, а первая транзакция перечитывает для того же условия, получая дополнительную "призрачную" строку при втором чтении.

Statement createStatement() throws SQLException

Создаёт объект Statement для отправки SQL-запросов в базу данных. SQL-запросы без параметров обычно выполняются с использованием объектов Statement. Если один и тот же SQL-запрос выполняется многократно, может быть эффективнее использовать объект PreparedStatement.

Результаты, созданные с помощью возвращаемого объекта Statement по умолчанию будут типа TYPE_FORWARD_ONLY и иметь уровень конкурентности CONCUR_READ_ONLY. Уровень сохраняемости созданных наборов результатов можно определить, вызвав getHoldability().

PreparedStatement prepareStatement(String sql) throws SQLException

Создаёт объект PreparedStatement для отправки параметризованных SQL-запросов в базу данных.

SQL-запрос с параметрами IN или без них может быть предварительно скомпилирован и сохранён в объекте PreparedStatement . Этот объект может использоваться для эффективного выполнения этого запроса многократно.

Примечание: Этот метод оптимизирован для обработки параметризованных SQL-запросов, которые извлекают выгоду из предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement отправит запрос в базу данных для предварительной компиляции. Некоторые драйверы могут не поддерживать предварительную компиляцию. В этом случае запрос может быть отправлен в базу данных только при выполнении объекта PreparedStatement. Это не оказывает прямого влияния на пользователей; однако это влияет на то, какие методы выбрасывают определённые объекты SQLException.

Результаты, созданные с помощью возвращаемого объекта PreparedStatement по умолчанию будут типа TYPE_FORWARD_ONLY и иметь уровень конкурентности CONCUR_READ_ONLY. Уровень сохраняемости созданных наборов результатов можно определить, вызвав getHoldability().

CallableStatement prepareCall(String sql) throws SQLException

Создаёт объект CallableStatement для вызова хранимых процедур базы данных. Объект CallableStatement предоставляет методы для настройки параметров IN и OUT и методы для выполнения вызова хранимой процедуры.

Примечание: Этот метод оптимизирован для обработки вызовов хранимых процедур. Некоторые драйверы могут отправить запрос вызова в базу данных, когда метод prepareCall выполнится; другие могут подождать, пока объект CallableStatement будет выполнен. Это не оказывает прямого влияния на пользователей; однако это влияет на то, какие методы выбрасывают определённые объекты SQLException.

Результаты, созданные с помощью возвращаемого объекта CallableStatement по умолчанию будут типа TYPE_FORWARD_ONLY и иметь уровень конкурентности CONCUR_READ_ONLY. Уровень сохраняемости созданных наборов результатов можно определить, вызвав getHoldability().

String nativeSQL(String sql) throws SQLException

Преобразует данный SQL-запрос в системную родную грамматику SQL. Драйвер может преобразовать грамматику JDBC SQL в системную родную грамматику SQL перед отправкой. Этот метод возвращает родной вид запроса, который драйвер отправил бы.

void setAutoCommit(boolean autoCommit) throws SQLException

Устанавливает режим автоматического подтверждения соединения в заданное состояние. Если соединение находится в режиме автоматического подтверждения, все его SQL-запросы будут выполняться и подтверждаться как отдельные транзакции. В противном случае SQL-запросы группируются в транзакции, которые завершаются вызовом метода commit или метода rollback. По умолчанию новые соединения находятся в режиме автоматического подтверждения.

Подтверждение происходит по завершении запроса. Время завершения запроса зависит от типа SQL-запроса:

• Для DML-запросов, таких как Insert, Update или Delete, и DDL-запросов, запрос завершается сразу же после выполнения.
• Для Select-запросов, запрос завершается при закрытии связанного набора результатов.
• Для объектов CallableStatement или для запросов, возвращающих несколько результатов, запрос завершается, когда все связанные наборы результатов закрыты, и все значения обновлений и выходные параметры получены.

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

boolean getAutoCommit() throws SQLException

Возвращает текущий режим автоматического подтверждения для этого объекта Connection.

void commit() throws SQLException

Делает все изменения, внесённые с момента предыдущего коммита/отката, постоянными и освобождает любые блокировки базы данных, в настоящее время удерживаемые этим Connection объектом. Этот метод следует использовать только при отключенном режиме автокоммита.

void rollback() throws SQLException

Отменяет все изменения, внесённые в текущей транзакции, и освобождает любые блокировки базы данных, в настоящее время удерживаемые этим Connection объектом. Этот метод следует использовать только при отключенном режиме автокоммита.

void close() throws SQLException

Освобождает ресурсы базы данных и JDBC этого Connection объекта немедленно вместо ожидания их автоматического освобождения.

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

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

boolean isClosed() throws SQLException

Получает, закрыт ли этот Connection объект. Соединение считается закрытым, если для него был вызван метод close или произошли некоторые фатальные ошибки. Этот метод гарантированно возвращает true только при вызове после вызова метода Connection.close.

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

DatabaseMetaData getMetaData() throws SQLException

Получает объект DatabaseMetaData, содержащий метаданные о базе данных, к которой это Connection объект представляет собой подключение. Метаданные включают информацию о таблицах базы данных, её поддерживаемом синтаксисе SQL, её хранимых процедурах, возможностях этого подключения и т.д.

void setReadOnly(boolean readOnly) throws SQLException

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

Примечание: Этот метод нельзя вызывать во время транзакции.

boolean isReadOnly() throws SQLException

Получает, находится ли этот Connection объект в режиме только для чтения.

void setCatalog(String catalog) throws SQLException

Устанавливает имя каталога для выбора подпространства базы данных этого Connection объекта для работы.

Если драйвер не поддерживает каталоги, он проигнорирует этот запрос.

Вызов setCatalog не влияет на ранее созданные или подготовленные Statement объекты. Определяется реализацией, происходит ли операция подготовки DBMS немедленно при вызове метода Connection или prepareCall. Для максимальной переносимости следует вызывать setCatalog перед созданием или подготовкой Statement.

String getCatalog() throws SQLException

Получает текущее имя каталога этого Connection объекта.

void setTransactionIsolation(int level) throws SQLException

Попытка изменить уровень изоляции транзакции для этого Connection объекта на заданный. Возможные уровни изоляции транзакций определены в интерфейсе Connection.

Примечание: Если этот метод вызывается во время транзакции, результат определяется реализацией.

int getTransactionIsolation() throws SQLException

Получает текущий уровень изоляции транзакции для этого Connection объекта.

SQLWarning getWarnings() throws SQLException

Получает первое предупреждение, сгенерированное вызовами для этого Connection объекта. Если предупреждений несколько, последующие будут привязаны к первому и их можно получить, вызвав метод SQLWarning.getNextWarning на предупреждении, полученном ранее.

Этот метод не может быть вызван для закрытого соединения; в противном случае будет выброшено SQLException.

Примечание: Последующие предупреждения будут привязаны к этому SQLWarning.

void clearWarnings() throws SQLException

Очищает все предупреждения, полученные для этого Connection объекта. После вызова этого метода метод getWarnings возвращает null до тех пор, пока для этого Connection объекта не будет получено новое предупреждение.

Statement createStatement(int resultSetType, int resultSetConcurrency) throws SQLException

Создаёт объект Statement, который будет генерировать объекты ResultSet с заданным типом и конкурентностью. Этот метод идентичен методу createStatement выше, но позволяет переопределить тип и конкурентность набора результатов по умолчанию. Удерживаемость созданных наборов результатов можно определить, вызвав getHoldability().

PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency) throws SQLException

Создаёт объект PreparedStatement, который будет генерировать объекты ResultSet с заданным типом и конкурентностью. Этот метод идентичен методу prepareStatement выше, но позволяет переопределить тип и конкурентность набора результатов по умолчанию. Удерживаемость созданных наборов результатов можно определить, вызвав getHoldability().

CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency) throws SQLException

Создаёт объект CallableStatement, который будет генерировать объекты ResultSet с заданным типом и конкурентностью. Этот метод идентичен методу prepareCall выше, но позволяет переопределить тип и конкурентность набора результатов по умолчанию. Удерживаемость созданных наборов результатов можно определить, вызвав getHoldability().

Map<String,Class<?>> getTypeMap() throws SQLException

Возвращает объект Map связанный с этим объектом Connection . Если приложение не добавило запись, возвращаемая карта типов будет пустой.

Вы должны вызвать setTypeMap после внесения изменений в объект Map возвращённый методом getTypeMap, так как драйвер JDBC может создать внутреннюю копию объекта Map переданного в setTypeMap:

      Map<String,Class<?>> myMap = con.getTypeMap();
      myMap.put("mySchemaName.ATHLETES", Athletes.class);
      con.setTypeMap(myMap);
 

void setTypeMap(Map<String,Class<?>> map) throws SQLException

Устанавливает заданный объект TypeMap в качестве карты типов для этого объекта Connection . Карта типов будет использоваться для пользовательского сопоставления SQL-структурированных типов и типов-различий.

Вы должны установить значения для TypeMap до вызова setMap , так как драйвер JDBC может создать внутреннюю копию TypeMap :

      Map myMap<String,Class<?>> = new HashMap<String,Class<?>>();
      myMap.put("mySchemaName.ATHLETES", Athletes.class);
      con.setTypeMap(myMap);
 

void setHoldability(int holdability) throws SQLException

Изменяет удерживаемость по умолчанию объектов ResultSet , созданных с помощью этого объекта Connection , на заданную удерживаемость. Удерживаемость по умолчанию объектов ResultSet можно определить, вызвав DatabaseMetaData.getResultSetHoldability().

int getHoldability() throws SQLException

Возвращает текущую удерживаемость объектов ResultSet , созданных с помощью этого объекта Connection.

Savepoint setSavepoint() throws SQLException

Создаёт бесनामный сохраняемый пункт в текущей транзакции и возвращает новый объект Savepoint , который его представляет.

если setSavepoint вызывается вне активной транзакции, транзакция будет начата в этом новом сохранённом пункте.

Savepoint setSavepoint(String name) throws SQLException

Создаёт сохраняемый пункт с заданным именем в текущей транзакции и возвращает новый объект Savepoint , который его представляет.

если setSavepoint вызывается вне активной транзакции, транзакция будет начата в этом новом сохранённом пункте.

void rollback(Savepoint savepoint) throws SQLException

Отменяет все изменения, внесённые после того, как был задан данный объект Savepoint.

Этот метод следует использовать только в случае, если автоматический ввод-вывод отключён.

void releaseSavepoint(Savepoint savepoint) throws SQLException

Удаляет указанный объект Savepoint и последующие объекты Savepoint из текущей транзакции. Любая ссылка на сохранение точки после её удаления приведёт к возникновению исключения SQLException.

Statement createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException

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

PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException

Создаёт объект PreparedStatement, который будет генерировать объекты ResultSet с заданным типом, конкурентностью и сохраняемостью.

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

CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException

Создаёт объект CallableStatement, который будет генерировать объекты ResultSet с заданным типом и конкурентностью. Этот метод эквивалентен методу prepareCall выше, но позволяет переопределить значения по умолчанию для типа и конкурентности набора результатов и сохраняемости.

PreparedStatement prepareStatement(String sql, int autoGeneratedKeys) throws SQLException

Создаёт объект PreparedStatement по умолчанию, который имеет возможность извлекать автоматически сгенерированные ключи. Заданная константа указывает драйверу, следует ли ему сделать автоматически сгенерированные ключи доступными для извлечения. Этот параметр игнорируется, если SQL-запрос не является INSERT запросом или SQL-запросом, способным возвращать автоматически сгенерированные ключи (список таких запросов зависит от поставщика).

PreparedStatement prepareStatement(String sql, int[] columnIndexes) throws SQLException

Создаёт объект по умолчанию, способный возвращать автоматически сгенерированные ключи, указанные заданным массивом. Этот массив содержит индексы столбцов в целевой таблице, которые содержат автоматически сгенерированные ключи, которые должны быть доступны. Драйвер проигнорирует массив, если SQL-запрос не является INSERT запросом или запросом, способным возвращать автоматически сгенерированные ключи (список таких запросов зависит от поставщика).

SQL-запрос с параметрами IN или без них может быть предварительно скомпилирован и сохранён в объекте PreparedStatement. Этот объект может затем использоваться для эффективного многократного выполнения этого запроса.

Примечание: Этот метод оптимизирован для обработки параметрических SQL-запросов, которые извлекают выгоду из предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement отправит запрос в базу данных для предварительной компиляции. Некоторые драйверы могут не поддерживать предварительную компиляцию. В этом случае запрос может быть отправлен в базу данных только при выполнении объекта PreparedStatement. Это не оказывает непосредственного влияния на пользователей, но влияет на то, какие методы выбрасывают определённые SQLException.

Результаты запроса, созданные с помощью возвращённого объекта PreparedStatement , по умолчанию будут иметь тип TYPE_FORWARD_ONLY и уровень одновременности CONCUR_READ_ONLY. Уровень доступности созданных наборов результатов можно определить, вызвав getHoldability().

PreparedStatement prepareStatement(String sql, String[] columnNames) throws SQLException

Создаёт объект по умолчанию, способный возвращать автоматически сгенерированные ключи, указанные заданным массивом. Этот массив содержит имена столбцов в целевой таблице, которые содержат автоматически сгенерированные ключи, которые должны быть возвращены. Драйвер проигнорирует массив, если SQL-запрос не является INSERT запросом или запросом, способным возвращать автоматически сгенерированные ключи (список таких запросов зависит от поставщика).

SQL-запрос с параметрами IN или без них может быть предварительно скомпилирован и сохранён в объекте PreparedStatement. Этот объект может затем использоваться для эффективного многократного выполнения этого запроса.

Примечание: Этот метод оптимизирован для обработки параметрических SQL-запросов, которые извлекают выгоду из предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement отправит запрос в базу данных для предварительной компиляции. Некоторые драйверы могут не поддерживать предварительную компиляцию. В этом случае запрос может быть отправлен в базу данных только при выполнении объекта PreparedStatement. Это не оказывает непосредственного влияния на пользователей, но влияет на то, какие методы выбрасывают определённые SQLException.

Результаты запроса, созданные с помощью возвращённого объекта PreparedStatement , по умолчанию будут иметь тип TYPE_FORWARD_ONLY и уровень одновременности CONCUR_READ_ONLY. Уровень доступности созданных наборов результатов можно определить, вызвав getHoldability().

Clob createClob() throws SQLException

Создаёт объект, реализующий интерфейс Clob. Возвращаемый объект изначально не содержит данных. Методы setAsciiStream, setCharacterStream и setString интерфейса Clob могут использоваться для добавления данных в Clob.

Blob createBlob() throws SQLException

Создаёт объект, реализующий интерфейс Blob. Возвращаемый объект изначально не содержит данных. Методы setBinaryStream и setBytes интерфейса Blob могут использоваться для добавления данных в Blob.

NClob createNClob() throws SQLException

Создаёт объект, реализующий интерфейс NClob. Возвращаемый объект изначально не содержит данных. Методы setAsciiStream, setCharacterStream и setString интерфейса NClob могут использоваться для добавления данных в NClob.

SQLXML createSQLXML() throws SQLException

Создаёт объект, реализующий интерфейс SQLXML. Возвращаемый объект изначально не содержит данных. Метод createXmlStreamWriter и setString интерфейса SQLXML могут использоваться для добавления данных в объект SQLXML.

boolean isValid(int timeout) throws SQLException

Возвращает true, если соединение не закрыто и всё ещё валидно. Драйвер должен отправить запрос к соединению или использовать другой механизм, который положительно проверяет, что соединение всё ещё валидно, когда этот метод вызван.

Запрос, отправленный драйвером для проверки соединения, должен выполняться в контексте текущей транзакции.

void setClientInfo(String name, String value) throws SQLClientInfoException

Устанавливает значение свойства информации о клиенте, указанного именем, в значение, указанное значением.

Приложения могут использовать метод DatabaseMetaData.getClientInfoProperties, чтобы определить свойства информации о клиенте, поддерживаемые драйвером, и максимальную длину, которая может быть указана для каждого свойства.

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

Драйвер должен сгенерировать предупреждение, если имя информации о клиенте, указанное, не распознается драйвером.

Если значение, указанное для этого метода, больше максимальной длины для свойства, драйвер может либо обрезать значение и сгенерировать предупреждение, либо сгенерировать SQLClientInfoException. Если драйвер сгенерирует SQLClientInfoException, указанное значение не было установлено для подключения.

Ниже приведены стандартные свойства информации о клиенте. Драйверы не обязаны поддерживать эти свойства, однако если драйвер поддерживает свойство информации о клиенте, которое можно описать одним из стандартных свойств, должно использоваться стандартное имя свойства.

• ApplicationName - Название приложения, в настоящее время использующего подключение
• ClientUser - Имя пользователя, от имени которого приложение, использующее подключение, выполняет работу. Это может не совпадать с именем пользователя, которое было использовано при установлении подключения.
• ClientHostname - Имя хоста компьютера, на котором выполняется приложение, использующее подключение.

void setClientInfo(Properties properties) throws SQLClientInfoException

Устанавливает значения свойств информации о клиенте подключения. Объект Properties содержит имена и значения свойств информации о клиенте, которые необходимо установить. Набор свойств информации о клиенте, содержащихся в списке свойств, заменяет текущий набор свойств информации о клиенте в подключении. Если свойство, которое в настоящее время установлено в подключении, отсутствует в списке свойств, это свойство очищается. Указание пустого списка свойств очистит все свойства в подключении. См. setClientInfo (String, String) для получения дополнительной информации.

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

String getClientInfo(String name) throws SQLException

Возвращает значение свойства информации о клиенте, заданного именем. Этот метод может вернуть null, если указанное свойство информации о клиенте не было установлено и не имеет значения по умолчанию. Этот метод также вернет null, если указанное имя свойства информации о клиенте не поддерживается драйвером.

Приложения могут использовать метод DatabaseMetaData.getClientInfoProperties для определения свойств информации о клиенте, поддерживаемых драйвером.

Properties getClientInfo() throws SQLException

Возвращает список, содержащий имя и текущее значение каждого свойства информации о клиенте, поддерживаемого драйвером. Значение свойства информации о клиенте может быть null, если свойство не было установлено и не имеет значения по умолчанию.

Array createArrayOf(String typeName, Object[] elements) throws SQLException

Метод фабрики для создания массивов объектов.

Примечание: Когда createArrayOf используется для создания объекта массива, который отображается на примитивный тип данных, тогда определяется реализацией, является ли объект Array массивом этого примитивного типа данных или массивом Object.

Примечание: Драйвер JDBC отвечает за отображение элементов массива Object в стандартный тип JDBC SQL, определённый в java.sql.Types для данного класса Object. Стандартное отображение указано в Приложении B спецификации JDBC. Если полученный тип JDBC не является подходящим типом для данного typeName, то определяется реализацией, будет ли выброшено SQLException или драйвер поддерживает преобразование.

Struct createStruct(String typeName, Object[] attributes) throws SQLException

Метод фабрики для создания объектов Struct.

void setSchema(String schema) throws SQLException

Устанавливает имя схемы для доступа.

Если драйвер не поддерживает схемы, он проигнорирует этот запрос.

Вызов setSchema не оказывает никакого влияния на ранее созданные или подготовленные объекты Statement. Определяется реализацией, происходит ли операция подготовки DBMS немедленно при вызове метода Connection prepareStatement или prepareCall. Для максимальной переносимости setSchema следует вызывать перед созданием или подготовкой объекта Statement.

String getSchema() throws SQLException

Возвращает текущее имя схемы для этого объекта Connection.

void abort(Executor executor) throws SQLException

Прерывает открытое соединение. Вызов abort приводит к:

• Соединение помечено как закрытое
• Закрытие физического соединения с базой данных
• Освобождение ресурсов, используемых соединением
• Гарантируется, что любая нить, которая в настоящее время обращается к соединению, либо завершит свою работу, либо выбросит SQLException.

Вызов abort помечает соединение как закрытое и освобождает все ресурсы. Вызов abort для закрытого соединения — это бесполезная операция.

Возможны задержки при прерывании и освобождении ресурсов, удерживаемых соединением. Когда метод abort возвращается, соединение будет помечено как закрытое, а нить Executor, переданная в качестве параметра методу abort, может по-прежнему выполнять задачи по освобождению ресурсов.

Данный метод проверяет наличие объекта SQLPermission перед продолжением работы. Если объект SecurityManager существует и его метод checkPermission запрещает вызов abort, данный метод выбросит исключение java.lang.SecurityException.

void setNetworkTimeout(Executor executor, int milliseconds) throws SQLException

Устанавливает максимальный период ожидания ответа базы данных для Connection или объектов, созданных из Connection. Если какой-либо запрос остается без ответа, метод ожидания возвращается с SQLException, а Connection или объекты, созданные из Connection, помечаются как закрытые. Любое последующее использование объектов, за исключением методов close, isClosed или Connection.isValid, приведет к SQLException.

Примечание: Данный метод предназначен для решения редкой, но серьезной проблемы, когда сетевые разрывы могут привести к зависанию нитей, выполняющих вызовы JDBC в операциях чтения сокета, до достижения TCP-TIMEOUT операционной системы (обычно 10 минут). Этот метод связан с методом abort() , который предоставляет административной нити средство освобождения таких нитей в случаях, когда соединение JDBC доступно административной нити. Метод setNetworkTimeout будет охватывать случаи, когда нет административной нити или она не имеет доступа к соединению. Этот метод имеет серьезные последствия и должен иметь достаточно высокое значение, чтобы он никогда не срабатывал раньше других, более стандартных таймаутов, таких как таймауты транзакции.

Реализации драйверов JDBC могут также выбрать поддержку метода setNetworkTimeout для наложения ограничения на время ответа базы данных в средах, где нет сети.

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

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

Таймаут Statement.setQueryTimeout() независим от таймаута, указанного в setNetworkTimeout. Если таймаут запроса истечет раньше таймаута сети, выполнение оператора будет отменено. Если сеть по-прежнему активна, результатом будет то, что оператор и соединение по-прежнему работоспособны. Однако, если таймаут сети истечет раньше таймаута запроса или если таймаут оператора завершится из-за проблем с сетью, соединение будет помечено как закрытое, любые ресурсы, удерживаемые соединением, будут освобождены, и соединение и оператор станут непригодными для использования.

Когда драйвер определяет, что значение таймаута setNetworkTimeout истекло, драйвер JDBC помечает соединение как закрытое и освобождает все ресурсы, удерживаемые соединением.

Данный метод проверяет наличие объекта SQLPermission перед продолжением работы. Если объект SecurityManager существует и его метод checkPermission запрещает вызов setNetworkTimeout, этот метод выбросит исключение java.lang.SecurityException.

int getNetworkTimeout() throws SQLException

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

default void beginRequest() throws SQLException

Подсказка драйверу о начале запроса — независимой единицы работы — для данного соединения. Каждый запрос независим от всех других запросов по отношению к состоянию, локальному для соединения, как на клиенте, так и на сервере. Работа, выполненная между парами beginRequest, endRequest, не зависит от любой другой работы, выполненной на соединении, как части другого запроса, так и вне любого запроса. Запрос может включать несколько транзакций. Могут существовать зависимости от состояния базы данных, которое не является локальным для соединения.

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

Вызовы beginRequest и endRequest не являются вложенными. Несколько вызовов beginRequest без промежуточного вызова endRequest не является ошибкой. Первый вызов beginRequest отмечает начало запроса, и последующие вызовы обрабатываются как бесполезная операция.

Использование beginRequest и endRequest является необязательным, зависящим от поставщика и должно быть в основном прозрачным. В частности, реализации могут обнаруживать условия, которые указывают на зависимость от другой работы, например, открытую транзакцию. Тем не менее, рекомендуется, хотя и не обязательно, чтобы реализации выбрасывали SQLException, если активна транзакция и вызван beginRequest. Использование этих методов может улучшить производительность или предоставить другие преимущества. Обратитесь к документации поставщика для получения дополнительной информации.

Рекомендуется заключать каждую единицу работы в пары beginRequest, endRequest, чтобы в начале или конце запроса не было открытой транзакции и не было зависимостей от локального состояния, которые пересекают границы запросов. Состояние базы данных после подтверждения не является локальным.

default void endRequest() throws SQLException

Подсказка драйверу о завершении запроса, независимой единицы работы. Вызовы beginRequest и endRequest не являются вложенными. Несколько вызовов endRequest без промежуточного вызова beginRequest не являются ошибкой. Первый вызов endRequest отмечает завершение запроса, а последующие вызовы обрабатываются как no-op. Если endRequest вызван без предварительного вызова beginRequest, это no-op.

Точное поведение этого метода зависит от поставщика. В частности, реализации могут обнаруживать условия, указывающие на зависимость от другой работы, такой как открытая транзакция. Хотя не является обязательным, рекомендуется, чтобы реализации выбрасывали SQLException, если активна транзакция, и endRequest вызывается.

default boolean setShardingKeyIfValid(ShardingKey shardingKey, ShardingKey superShardingKey, int timeout) throws SQLException

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

default boolean setShardingKeyIfValid(ShardingKey shardingKey, int timeout) throws SQLException

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

default void setShardingKey(ShardingKey shardingKey, ShardingKey superShardingKey) throws SQLException

Устанавливает ключ фрагментации и суперключ фрагментации для использования с этим соединением

default void setShardingKey(ShardingKey shardingKey) throws SQLException

Устанавливает ключ фрагментации для использования с этим соединением