Интерфейс Connection

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

См. также:

• Значения констант полей

Statement createStatement() throws SQLException

Возвращает:

новый объект Statement по умолчанию

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

PreparedStatement prepareStatement(String sql) throws SQLException

Параметры:

sql — SQL-оператор, который может содержать один или несколько заполнителей параметров IN «?»

Возвращает:

новый объект PreparedStatement по умолчанию, содержащий предварительно скомпилированный SQL-оператор

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

CallableStatement prepareCall(String sql) throws SQLException

Параметры:

sql — SQL-оператор, который может содержать один или несколько заполнителей параметров «?». Обычно этот оператор задаётся с использованием синтаксиса вызова JDBC.

Возвращает:

новый объект CallableStatement по умолчанию, содержащий предварительно скомпилированный SQL-оператор

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

String nativeSQL(String sql) throws SQLException

Параметры:

sql — SQL-оператор, который может содержать один или несколько заполнителей параметров «?»

Возвращает:

собственную форму этого оператора

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

void setAutoCommit(boolean autoCommit) throws SQLException

Параметры:

autoCommit — true для включения режима автоматической фиксации; false для его отключения

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, setAutoCommit(true) вызвано во время участия в распределённой транзакции или этот метод вызван для закрытого соединения

См. также:

• getAutoCommit()

boolean getAutoCommit() throws SQLException

Возвращает:

текущее состояние режима автоматической фиксации этого объекта Connection

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

См. также:

• setAutoCommit(boolean)

void commit() throws SQLException

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван во время участия в распределённой транзакции, для закрытого соединения или если этот объект Connection работает в режиме автоматической фиксации

См. также:

• setAutoCommit(boolean)

void rollback() throws SQLException

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван во время участия в распределённой транзакции, для закрытого соединения или если этот объект Connection работает в режиме автоматической фиксации

См. также:

• setAutoCommit(boolean)

void close() throws SQLException

Определено в:

close в интерфейсе AutoCloseable

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных

boolean isClosed() throws SQLException

Возвращает:

true, если этот объект Connection закрыт; false, если он всё ещё открыт

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных

DatabaseMetaData getMetaData() throws SQLException

Возвращает:

объект DatabaseMetaData для этого объекта Connection

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

void setReadOnly(boolean readOnly) throws SQLException

Параметры:

readOnly — true включает режим только для чтения; false отключает его

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или во время транзакции

boolean isReadOnly() throws SQLException

Возвращает:

true, если этот объект Connection доступен только для чтения; в противном случае — false

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

void setCatalog(String catalog) throws SQLException

Параметры:

catalog — имя каталога (подпространства базы данных этого объекта Connection), в котором будет выполняться работа

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

См. также:

• getCatalog()

String getCatalog() throws SQLException

Возвращает:

текущее имя каталога или null, если каталог отсутствует

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

См. также:

• setCatalog(String)

void setTransactionIsolation(int level) throws SQLException

Параметры:

level — одна из следующих констант Connection: Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ или Connection.TRANSACTION_SERIALIZABLE. (Обратите внимание, что Connection.TRANSACTION_NONE использовать нельзя, поскольку она указывает, что транзакции не поддерживаются.)

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или заданный параметр не является одной из констант Connection

См. также:

• DatabaseMetaData.supportsTransactionIsolationLevel(int)
• getTransactionIsolation()

int getTransactionIsolation() throws SQLException

Возвращает:

текущий уровень изоляции транзакций, соответствующий одной из следующих констант: Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ, Connection.TRANSACTION_SERIALIZABLE или Connection.TRANSACTION_NONE.

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

См. также:

• setTransactionIsolation(int)

SQLWarning getWarnings() throws SQLException

Возвращает:

первый объект SQLWarning или null, если предупреждений нет

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

См. также:

• SQLWarning

void clearWarnings() throws SQLException

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

Statement createStatement(int resultSetType, int resultSetConcurrency) throws SQLException

Параметры:

resultSetType — тип набора результатов; один из ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE

resultSetConcurrency — тип параллелизма; один из ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE

Возвращает:

новый объект Statement, который будет формировать объекты ResultSet с заданными типом и уровнем параллелизма

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или заданные параметры не являются константами ResultSet, указывающими тип и уровень параллелизма

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод или метод не поддерживается для указанного типа набора результатов и уровня параллелизма набора результатов.

Начиная с:

1.2

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

Параметры:

sql — объект String, представляющий SQL-оператор, который будет отправлен в базу данных; может содержать один или несколько параметров IN «?»

resultSetType — тип набора результатов; один из ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE

resultSetConcurrency — тип параллелизма; один из ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE

Возвращает:

новый объект PreparedStatement, содержащий предварительно скомпилированный SQL-оператор, который будет формировать объекты ResultSet с заданными типом и уровнем параллелизма

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или заданные параметры не являются константами ResultSet, указывающими тип и уровень параллелизма

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод или метод не поддерживается для указанного типа набора результатов и уровня параллелизма набора результатов.

Начиная с:

1.2

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

Параметры:

sql — объект String, представляющий SQL-оператор, который будет отправлен в базу данных; может содержать один или несколько параметров «?»

resultSetType — тип набора результатов; один из ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE

resultSetConcurrency — тип параллелизма; один из ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE

Возвращает:

новый объект CallableStatement, содержащий предварительно скомпилированный SQL-оператор, который будет формировать объекты ResultSet с заданными типом и уровнем параллелизма

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или заданные параметры не являются константами ResultSet, указывающими тип и уровень параллелизма

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод или метод не поддерживается для указанного типа набора результатов и уровня параллелизма набора результатов.

Начиная с:

1.2

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

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

Возвращает:

объект java.util.Map, связанный с этим объектом Connection

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

Начиная с:

1.2

См. также:

• setTypeMap(Map)

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

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

Параметры:

map — объект java.util.Map, который следует установить вместо карты типов по умолчанию для этого объекта Connection

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или заданный параметр не является объектом java.util.Map

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

Начиная с:

1.2

См. также:

• getTypeMap()

void setHoldability(int holdability) throws SQLException

Параметры:

holdability — константа удержания ResultSet; одна из ResultSet.HOLD_CURSORS_OVER_COMMIT или ResultSet.CLOSE_CURSORS_AT_COMMIT

Выбрасывает:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или заданный параметр не является константой ResultSet, указывающей значение удержания

SQLFeatureNotSupportedException — если заданное значение удержания не поддерживается

Начиная с:

1.4

См. также:

• getHoldability()
• DatabaseMetaData.getResultSetHoldability()
• ResultSet

int getHoldability() throws SQLException

Возвращает:

удерживаемость: одно из значений ResultSet.HOLD_CURSORS_OVER_COMMIT или ResultSet.CLOSE_CURSORS_AT_COMMIT

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

Начиная с:

1.4

См. также:

• setHoldability(int)
• DatabaseMetaData.getResultSetHoldability()
• ResultSet

Savepoint setSavepoint() throws SQLException

Возвращает:

новый объект Savepoint

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван во время участия в распределённой транзакции или для закрытого соединения либо если этот объект Connection находится в режиме автофиксации

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

Начиная с:

1.4

См. также:

• Savepoint

Savepoint setSavepoint(String name) throws SQLException

Параметры:

name — объект String, содержащий имя точки сохранения

Возвращает:

новый объект Savepoint

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван во время участия в распределённой транзакции или для закрытого соединения либо если этот объект Connection находится в режиме автофиксации

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

Начиная с:

1.4

См. также:

• Savepoint

void rollback(Savepoint savepoint) throws SQLException

Параметры:

savepoint — объект Savepoint, к которому следует выполнить откат

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван во время участия в распределённой транзакции или для закрытого соединения, объект Savepoint больше недействителен либо этот объект Connection находится в режиме автофиксации

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

Начиная с:

1.4

См. также:

• Savepoint
• rollback()

void releaseSavepoint(Savepoint savepoint) throws SQLException

Параметры:

savepoint — объект Savepoint, который нужно удалить

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или указанный объект Savepoint не является допустимой точкой сохранения в текущей транзакции

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

Начиная с:

1.4

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

Параметры:

resultSetType — одна из следующих констант ResultSet: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE

resultSetConcurrency — одна из следующих констант ResultSet: ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE

resultSetHoldability — одна из следующих констант ResultSet: ResultSet.HOLD_CURSORS_OVER_COMMIT или ResultSet.CLOSE_CURSORS_AT_COMMIT

Возвращает:

новый объект Statement, который будет формировать объекты ResultSet с указанными типом, уровнем параллелизма и удерживаемостью

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или указанные параметры не являются константами ResultSet, задающими тип, уровень параллелизма и удерживаемость

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод или этот метод не поддерживается для указанного типа набора результатов, удерживаемости набора результатов и уровня параллелизма набора результатов.

Начиная с:

1.4

См. также:

• ResultSet

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

Параметры:

sql — объект String, содержащий SQL-инструкцию для отправки в базу данных; может содержать один или несколько входных параметров «?»

resultSetType — одна из следующих констант ResultSet: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE

resultSetConcurrency — одна из следующих констант ResultSet: ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE

resultSetHoldability — одна из следующих констант ResultSet: ResultSet.HOLD_CURSORS_OVER_COMMIT или ResultSet.CLOSE_CURSORS_AT_COMMIT

Возвращает:

новый объект PreparedStatement, содержащий предварительно скомпилированную SQL-инструкцию и формирующий объекты ResultSet с указанными типом, уровнем параллелизма и удерживаемостью

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или указанные параметры не являются константами ResultSet, задающими тип, уровень параллелизма и удерживаемость

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод или этот метод не поддерживается для указанного типа набора результатов, удерживаемости набора результатов и уровня параллелизма набора результатов.

Начиная с:

1.4

См. также:

• ResultSet

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

Параметры:

sql — объект String, содержащий SQL-инструкцию для отправки в базу данных; может содержать один или несколько параметров «?»

resultSetType — одна из следующих констант ResultSet: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE

resultSetConcurrency — одна из следующих констант ResultSet: ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE

resultSetHoldability — одна из следующих констант ResultSet: ResultSet.HOLD_CURSORS_OVER_COMMIT или ResultSet.CLOSE_CURSORS_AT_COMMIT

Возвращает:

новый объект CallableStatement, содержащий предварительно скомпилированную SQL-инструкцию и формирующий объекты ResultSet с указанными типом, уровнем параллелизма и удерживаемостью

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или указанные параметры не являются константами ResultSet, задающими тип, уровень параллелизма и удерживаемость

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод или этот метод не поддерживается для указанного типа набора результатов, удерживаемости набора результатов и уровня параллелизма набора результатов.

Начиная с:

1.4

См. также:

• ResultSet

PreparedStatement prepareStatement(String sql, int autoGeneratedKeys) throws SQLException

Параметры:

sql — SQL-инструкция, которая может содержать один или несколько заполнителей входных параметров «?»

autoGeneratedKeys — флаг, указывающий, следует ли возвращать автоматически сгенерированные ключи; одно из значений Statement.RETURN_GENERATED_KEYS или Statement.NO_GENERATED_KEYS

Возвращает:

новый объект PreparedStatement, содержащий предварительно скомпилированную SQL-инструкцию и способный возвращать автоматически сгенерированные ключи

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения или указанный параметр не является константой Statement, указывающей, следует ли возвращать автоматически сгенерированные ключи

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод с константой Statement.RETURN_GENERATED_KEYS

Начиная с:

1.4

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

Параметры:

sql — SQL-инструкция, которая может содержать один или несколько заполнителей входных параметров «?»

columnIndexes — массив индексов столбцов, указывающий столбцы, которые следует вернуть из вставленной строки или строк

Возвращает:

новый объект PreparedStatement, содержащий предварительно скомпилированную инструкцию и способный возвращать автоматически сгенерированные ключи, указанные в данном массиве индексов столбцов

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

Начиная с:

1.4

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

Параметры:

sql — SQL-инструкция, которая может содержать один или несколько заполнителей входных параметров «?»

columnNames — массив имён столбцов, указывающий столбцы, которые следует вернуть из вставленной строки или строк

Возвращает:

новый объект PreparedStatement, содержащий предварительно скомпилированную инструкцию и способный возвращать автоматически сгенерированные ключи, указанные в данном массиве имён столбцов

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

Начиная с:

1.4

Clob createClob() throws SQLException

Возвращает:

Объект, реализующий интерфейс Clob

Вызывает исключение:

SQLException — если объект, реализующий интерфейс Clob, не может быть создан, этот метод вызван для закрытого соединения или произошла ошибка доступа к базе данных.

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот тип данных

Начиная с:

1.6

Blob createBlob() throws SQLException

Возвращает:

Объект, реализующий интерфейс Blob

Вызывает исключение:

SQLException — если объект, реализующий интерфейс Blob, не может быть создан, этот метод вызван для закрытого соединения или произошла ошибка доступа к базе данных.

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот тип данных

Начиная с:

1.6

NClob createNClob() throws SQLException

Возвращает:

Объект, реализующий интерфейс NClob

Вызывает исключение:

SQLException — если объект, реализующий интерфейс NClob, не может быть создан, этот метод вызван для закрытого соединения или произошла ошибка доступа к базе данных.

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот тип данных

Начиная с:

1.6

SQLXML createSQLXML() throws SQLException

Возвращает:

Объект, реализующий интерфейс SQLXML

Вызывает исключение:

SQLException — если объект, реализующий интерфейс SQLXML, не может быть создан, этот метод вызван для закрытого соединения или произошла ошибка доступа к базе данных.

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот тип данных

Начиная с:

1.6

boolean isValid(int timeout) throws SQLException

Параметры:

timeout — время в секундах, отведённое на завершение операции с базой данных, используемой для проверки соединения. Если время ожидания истечёт до завершения операции, этот метод вернёт false. Значение 0 означает, что для операции с базой данных не применяется ограничение времени ожидания.

Возвращает:

true, если соединение действительно, иначе false

Вызывает исключение:

SQLException — если значение, переданное для timeout, меньше 0

Начиная с:

1.6

См. также:

• DatabaseMetaData.getClientInfoProperties()

void setClientInfo(String name, String value) throws SQLClientInfoException

Параметры:

name — имя свойства сведений о клиенте, которое нужно установить

value — значение, которое нужно установить для свойства сведений о клиенте. Если значение равно null, текущее значение указанного свойства сбрасывается.

Вызывает исключение:

SQLClientInfoException — если сервер базы данных возвращает ошибку при установке значения сведений о клиенте на сервере базы данных или этот метод вызван для закрытого соединения

Начиная с:

1.6

void setClientInfo(Properties properties) throws SQLClientInfoException

Параметры:

properties — список свойств сведений о клиенте, которые нужно установить

Вызывает исключение:

SQLClientInfoException — если сервер базы данных возвращает ошибку при установке значений clientInfo на сервере базы данных или этот метод вызван для закрытого соединения

Начиная с:

1.6

См. также:

• setClientInfo(String, String)

String getClientInfo(String name) throws SQLException

Параметры:

name — имя свойства сведений о клиенте, значение которого нужно получить

Возвращает:

Значение указанного свойства сведений о клиенте

Вызывает исключение:

SQLException — если сервер базы данных возвращает ошибку при получении значения сведений о клиенте из базы данных или этот метод вызван для закрытого соединения

Начиная с:

1.6

См. также:

• DatabaseMetaData.getClientInfoProperties()

Properties getClientInfo() throws SQLException

Возвращает:

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

Вызывает исключение:

SQLException — если сервер базы данных возвращает ошибку при получении значений сведений о клиенте из базы данных или этот метод вызван для закрытого соединения

Начиная с:

1.6

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

Параметры:

typeName - имя типа SQL, которому соответствуют элементы массива. typeName — это имя, специфичное для базы данных; оно может быть именем встроенного типа, пользовательского типа или стандартного типа SQL, поддерживаемого этой базой данных. Это значение, возвращаемое Array.getBaseTypeName

elements - элементы, заполняющие возвращаемый объект

Возвращает:

объект Array, элементы которого соответствуют указанному типу SQL

Выбрасывает:

SQLException - если произошла ошибка базы данных, тип JDBC не подходит для typeName и преобразование не поддерживается, typeName имеет значение null или этот метод вызван для закрытого соединения

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот тип данных

Начиная с:

1.6

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

Параметры:

typeName - имя типа SQL для структурированного типа SQL, которому соответствует этот объект Struct. typeName — это имя пользовательского типа, определённого для этой базы данных. Это значение, возвращаемое Struct.getSQLTypeName.

attributes - атрибуты, заполняющие возвращаемый объект

Возвращает:

объект Struct, соответствующий указанному типу SQL и заполненный указанными атрибутами

Выбрасывает:

SQLException - если произошла ошибка базы данных, typeName имеет значение null или этот метод вызван для закрытого соединения

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот тип данных

Начиная с:

1.6

void setSchema(String schema) throws SQLException

Параметры:

schema - имя схемы, в которой нужно работать

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

Начиная с:

1.7

См. также:

• getSchema()

String getSchema() throws SQLException

Возвращает:

текущее имя схемы или null, если схема отсутствует

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого соединения

Начиная с:

1.7

См. также:

• setSchema(String)

void abort(Executor executor) throws SQLException

Параметры:

executor - реализация Executor, которая будет использоваться методом abort.

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных или executor имеет значение null

Начиная с:

1.7

См. также:

• Executor

void setNetworkTimeout(Executor executor, int milliseconds) throws SQLException

Параметры:

executor - реализация Executor, которая будет использоваться методом setNetworkTimeout.

milliseconds - время ожидания завершения операции с базой данных в миллисекундах. Если драйвер JDBC не поддерживает миллисекунды, он округлит значение вверх до ближайшей секунды. Если период ожидания истечёт до завершения операции, будет выброшено исключение SQLException. Значение 0 означает отсутствие тайм-аута для операций с базой данных.

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных, этот метод вызван для закрытого соединения, executor имеет значение null или значение, указанное для seconds, меньше 0.

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

Начиная с:

1.7

См. также:

• Statement.setQueryTimeout(int)
• getNetworkTimeout()
• abort(Executor)
• Executor

int getNetworkTimeout() throws SQLException

Возвращает:

текущее ограничение тайм-аута в миллисекундах; ноль означает отсутствие ограничения

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого Connection

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

Начиная с:

1.7

См. также:

• setNetworkTimeout(Executor, int)

default void beginRequest() throws SQLException

Примечание API:

Этот метод предназначен для использования менеджерами пула соединений.

Перед возвратом соединения вызывающему коду менеджер пула должен вызвать beginRequest для базового соединения.

Менеджеру пула не нужно вызывать beginRequest, если:

• Пул соединений кэширует объекты PooledConnection
• При вызове приложением getConnection возвращается дескриптор логического соединения
• Логическое Connection закрывается вызовом Connection.close до возврата PooledConnection в кэш.

Требования к реализации:

Реализация по умолчанию ничего не делает.

Выбрасывает:

SQLException - если произошла ошибка

Начиная с:

9

См. также:

• endRequest()
• PooledConnection

default void endRequest() throws SQLException

Примечание API:

Этот метод предназначен для использования менеджерами пула соединений.

Когда приложение возвращает соединение в пул, менеджер пула должен вызвать endRequest для базового соединения.

Менеджеру пула не нужно вызывать endRequest, если:

• Пул соединений кэширует объекты PooledConnection
• При вызове приложением getConnection возвращается дескриптор логического соединения
• Логическое Connection закрывается вызовом Connection.close до возврата PooledConnection в кэш.

Требования к реализации:

Реализация по умолчанию ничего не делает.

Выбрасывает:

SQLException - если произошла ошибка

Начиная с:

9

См. также:

• beginRequest()
• PooledConnection

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

Примечание API:

Этот метод проверяет, допустимы ли ключи сегментирования для Connection. Значение тайм-аута указывает, как долго драйвер должен ожидать, пока Connection проверит допустимость ключа сегментирования, прежде чем setShardingKeyIfValid вернёт false.

Требования к реализации:

Реализация по умолчанию выбрасывает SQLFeatureNotSupportedException.

Параметры:

shardingKey - ключ сегментирования для проверки относительно этого соединения. Ключ сегментирования может иметь значение null

superShardingKey - суперключ сегментирования для проверки относительно этого соединения. Суперключ сегментирования может иметь значение null.

timeout - время в секундах, за которое должна завершиться проверка; в противном случае процесс проверки прерывается. Значение 0 означает, что время проверки не ограничено.

Возвращает:

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

Выбрасывает:

SQLException - если при выполнении этой проверки произошла ошибка; если указан superShardingKey без shardingKey; если этот метод вызван для закрытого connection; или если значение timeout отрицательно.

SQLFeatureNotSupportedException - если драйвер не поддерживает сегментирование

Начиная с:

9

См. также:

• ShardingKey
• ShardingKeyBuilder

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

Примечание API:

Этот метод проверяет, допустим ли ключ сегментирования для Connection. Значение тайм-аута указывает, как долго драйвер должен ожидать, пока Connection проверит допустимость ключа сегментирования, прежде чем setShardingKeyIfValid вернёт false.

Требования к реализации:

Реализация по умолчанию выбрасывает SQLFeatureNotSupportedException.

Параметры:

shardingKey - ключ сегментирования для проверки относительно этого соединения. Ключ сегментирования может иметь значение null

timeout - время в секундах, за которое должна завершиться проверка; в противном случае процесс проверки прерывается. Значение 0 означает, что время проверки не ограничено.

Возвращает:

true, если соединение действительно и ключ сегментирования допустимо установить для этого соединения; false, если ключ сегментирования недопустим или срок ожидания истекает до завершения операции.

Выбрасывает:

SQLException - если при выполнении этой проверки произошла ошибка; если этот метод вызван для закрытого connection; или если значение timeout отрицательно.

SQLFeatureNotSupportedException - если драйвер не поддерживает сегментирование

Начиная с:

9

См. также:

• ShardingKey
• ShardingKeyBuilder

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

Примечание API:

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

Требования к реализации:

Реализация по умолчанию выбрасывает SQLFeatureNotSupportedException.

Параметры:

shardingKey - ключ сегментирования, задаваемый для этого соединения. Ключ сегментирования может иметь значение null

superShardingKey - суперключ сегментирования, задаваемый для этого соединения. Суперключ сегментирования может иметь значение null

Выбрасывает:

SQLException - если при задании ключей сегментирования произошла ошибка; если этот метод вызван для закрытого connection; или если указан superShardingKey без shardingKey

SQLFeatureNotSupportedException - если драйвер не поддерживает сегментирование

Начиная с:

9

См. также:

• ShardingKey
• ShardingKeyBuilder

default void setShardingKey(ShardingKey shardingKey) throws SQLException

Примечание API:

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

Требования к реализации:

Реализация по умолчанию выбрасывает SQLFeatureNotSupportedException.

Параметры:

shardingKey - ключ сегментирования, задаваемый для этого соединения. Ключ сегментирования может иметь значение null

Выбрасывает:

SQLException - если при задании ключа сегментирования произошла ошибка или этот метод вызван для закрытого connection

SQLFeatureNotSupportedException - если драйвер не поддерживает сегментирование

Начиная с:

9

См. также:

• ShardingKey
• ShardingKeyBuilder