Подключение к интерфейсу

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

Делает все изменения, внесенные с момента предыдущего выполнения commit/rollback, постоянными и освобождает все блокировки базы данных, в настоящее время удерживаемые этим 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-структурированных типов и типов DISTINCT.

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

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

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

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

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

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

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

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

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

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

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 массива на тип SQL JDBC по умолчанию, определенный в 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 и для сброса до значения по умолчанию при выходе из этой области. Вызов этого метода не оказывает влияния на уже ожидающие запросы.

Значение таймаута сети независимо от значения таймаута, указанного в 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 отмечает завершение запроса, последующие вызовы обрабатываются как команды без действия. Вызов endRequest без предварительного вызова beginRequest — команда без действия.

Точное поведение этого метода зависит от поставщика. В частности, реализации могут обнаруживать условия, указывающие на зависимость от других работ, таких как открытая транзакция. Рекомендуется, хотя и не обязательно, чтобы реализации выбрасывали исключение 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

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