Интерфейс 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

default String enquoteLiteral(String val) throws SQLException

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

Реализация по умолчанию создаёт литерал следующим образом: "'" + val.replace("'", "''") + "'".

Примечание к реализации:

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

Параметры:

val — строка символов

Возвращает:

строку в одинарных кавычках, в которой каждая одинарная кавычка заменена двумя одинарными кавычками

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

NullPointerException — если val имеет значение null

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

Начиная с версии:

26

default String enquoteIdentifier(String identifier, boolean alwaysDelimit) throws SQLException

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

Реализация по умолчанию использует следующие критерии для определения допустимого простого идентификатора SQL:

• Строка не заключена в двойные кавычки
• Первый символ является буквой латинского алфавита от a ('\0061') до z ('\u007A') или от A ('\u0041') до Z ('\u005A')
• Имя содержит только буквенно-цифровые символы ([0-9A-Za-z]) или символ "_"

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

• DatabaseMetaData.getIdentifierQuoteString() возвращает не двойную кавычку
• identifier содержит символ null или двойную кавычку
• Длина identifier меньше 1 или больше 128 символов

Примеры преобразования:

Идентификатор	Всегда заключать в разделители	Результат
Hello	false	Hello
Hello	true	"Hello"
G'Day	false	"G'Day"
"Bruce Wayne"	false	"Bruce Wayne"
"Bruce Wayne"	true	"Bruce Wayne"
"select"	false	"select"
"select"	true	"select"
GoodDay$	false	"GoodDay$"
Hello"World	false	SQLException
"Hello"World"	false	SQLException

Примечание к реализации:

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

Параметры:

identifier — идентификатор SQL

alwaysDelimit — указывает, следует ли возвращать простой идентификатор SQL как идентификатор с разделителями

Возвращает:

простой идентификатор SQL или идентификатор с разделителями

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

SQLException — если identifier не является допустимым идентификатором

SQLFeatureNotSupportedException — если источник данных не поддерживает идентификаторы с разделителями

NullPointerException — если identifier имеет значение null

Начиная с версии:

26

default boolean isSimpleIdentifier(String identifier) throws SQLException

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

Реализация по умолчанию использует следующие критерии, чтобы определить, является ли идентификатор простым идентификатором SQL:

• Идентификатор не заключен в двойные кавычки
• Первый символ — алфавитный символ от a до z или от A до Z
• Идентификатор содержит только буквенно-цифровые символы ([0-9A-Za-z]) или символ «_»
• Идентификатор не является зарезервированным словом SQL
• Длина идентификатора составляет от 1 до 128 символов включительно

Примеры преобразования:

идентификатор	Простой идентификатор
Hello	true
G'Day	false
"Bruce Wayne"	false
GoodDay$	false
Hello"World	false
"Hello"World"	false
"select"	false
"from"	false

Примечание по реализации:

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

Параметры:

identifier — идентификатор SQL

Возвращает:

true, если это простой идентификатор SQL; в противном случае — false

Вызывает:

NullPointerException — если идентификатор — null

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

Начиная с версии:

26

default String enquoteNCharLiteral(String val) throws SQLException

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

Реализация по умолчанию создает литерал следующим образом: "N'" + val.replace("'", "''") + "'".

Примечание по реализации:

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

Параметры:

val — строка символов

Возвращает:

результат замены каждого одинарного символа кавычки в аргументе двумя одинарными кавычками; перед всей полученной строкой добавляется «N».

Вызывает:

NullPointerException — если val — null

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

Начиная с версии:

26