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

Подключение (сессия) к конкретной базе данных. SQL-запросы выполняются и результаты возвращаются в контексте подключения.

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

Примечание: При конфигурировании Connection, приложения JDBC должны использовать соответствующий метод Connection, такой как setAutoCommit или setTransactionIsolation. Приложения не должны напрямую вызывать SQL-команды для изменения конфигурации подключения, если доступен метод JDBC. По умолчанию объект Connection находится в режиме автоматического подтверждения, что означает автоматическое подтверждение изменений после выполнения каждого запроса. Если режим автоматического подтверждения отключён, метод commit должен быть вызван явно для подтверждения изменений; в противном случае изменения в базе данных не будут сохранены.

Новый объект Connection, созданный с помощью ядра JDBC 2.1 API, имеет связанную с ним карту типов, изначально пустую. Пользователь может ввести пользовательское отображение для UDT в этой карте типов. Когда UDT извлекается из источника данных методом ResultSet.getObject, метод getObject проверит карту типов подключения, чтобы узнать, есть ли в ней запись для данного UDT. Если есть, метод getObject сопоставит UDT с указанным классом. Если записи нет, UDT будет сопоставлен с помощью стандартного отображения.

Пользователь может создать новую карту типов, которая является объектом java.util.Map, сделать запись в ней и передать её методам java.sql, которые могут выполнять пользовательское отображение. В этом случае метод будет использовать переданную карту типов вместо карты, связанной с подключением.

Например, следующий фрагмент кода указывает, что SQL-тип ATHLETES будет сопоставлен с классом Athletes в языке программирования Java. Фрагмент кода извлекает карту типов для объекта Connection con, вставляет запись в неё и затем устанавливает карту типов с новой записью в качестве карты типов подключения.

java.util.Map map = con.getTypeMap();
      map.put("mySchemaName.ATHLETES", Class.forName("Athletes"));
      con.setTypeMap(map);

Поля

TRANSACTION_NONE

static final int TRANSACTION_NONE

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

См. также:

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

TRANSACTION_READ_UNCOMMITTED

static final int TRANSACTION_READ_UNCOMMITTED

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

См. также:

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

TRANSACTION_READ_COMMITTED

static final int TRANSACTION_READ_COMMITTED

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

См. также:

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

TRANSACTION_REPEATABLE_READ

static final int TRANSACTION_REPEATABLE_READ

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

См. также:

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

TRANSACTION_SERIALIZABLE

static final int TRANSACTION_SERIALIZABLE

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

См. также:

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

Методы

createStatement

Statement createStatement()
                   throws SQLException

Возвращает:

новый стандартный объект Statement

Исключения:

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

prepareStatement

PreparedStatement prepareStatement(String sql)
                            throws SQLException

Параметры:

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

Возвращает:

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

Исключения:

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

prepareCall

CallableStatement prepareCall(String sql)
                       throws SQLException

Параметры:

sql - SQL-запрос, который может содержать один или несколько заполнительных параметров '?'. Обычно этот запрос указывается с использованием синтаксиса JDBC call escape.

Возвращает:

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

Исключения:

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

nativeSQL

String nativeSQL(String sql)
          throws SQLException

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

Параметры:

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

Возвращает:

родную форму этого запроса

Исключения:

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

setAutoCommit

void setAutoCommit(boolean autoCommit)
            throws SQLException

Параметры:

autoCommit - true для включения режима автоматического подтверждения; false для его отключения

Исключения:

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

См. также:

getAutoCommit()

getAutoCommit

boolean getAutoCommit()
               throws SQLException

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

Возвращает:

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

Исключения:

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

См. также:

setAutoCommit(boolean)

commit

void commit()
     throws SQLException

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

Исключения:

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

См. также:

setAutoCommit(boolean)

rollback

void rollback()
       throws SQLException

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

Исключения:

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

См. также:

setAutoCommit(boolean)

close

void close()
    throws SQLException

Указано в:

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

Исключения:

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

isClosed

boolean isClosed()
          throws SQLException

Возвращает:

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

Исключения:

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

getMetaData

DatabaseMetaData getMetaData()
                      throws SQLException

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

Возвращает:

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

Исключения:

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

setReadOnly

void setReadOnly(boolean readOnly)
          throws SQLException

Параметры:

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

Исключения:

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

isReadOnly

boolean isReadOnly()
            throws SQLException

Возвращает, находится ли это соединение Connection в режиме только для чтения.

Возвращает:

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

Исключения:

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

setCatalog

void setCatalog(String catalog)
         throws SQLException

Параметры:

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

Исключения:

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

См. также:

getCatalog()

getCatalog

String getCatalog()
           throws SQLException

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

Возвращает:

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

Исключения:

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

См. также:

setCatalog(java.lang.String)

setTransactionIsolation

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()

getTransactionIsolation

int getTransactionIsolation()
                     throws SQLException

Возвращает текущий уровень изоляции транзакции объекта Connection.

Возвращает:

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

Исключения:

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

См. также:

setTransactionIsolation(int)

getWarnings

SQLWarning getWarnings()
                throws SQLException

Возвращает:

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

Исключения:

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

См. также:

SQLWarning

clearWarnings

void clearWarnings()
            throws SQLException

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

Исключения:

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

createStatement

Statement createStatement(int resultSetType,
                          int resultSetConcurrency)
                   throws SQLException

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

Параметры:

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

prepareStatement

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

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

Параметры:

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

prepareCall

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

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

Параметры:

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

getTypeMap

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(java.util.Map<java.lang.String, java.lang.Class<?>>)

setTypeMap

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()

setHoldability

void setHoldability(int holdability)
             throws SQLException

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

Параметры:

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

Исключения:

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

SQLFeatureNotSupportedException - если заданная удерживаемость не поддерживается

С:

1.4

См. также:

getHoldability(), DatabaseMetaData.getResultSetHoldability(), ResultSet

getHoldability

int getHoldability()
            throws SQLException

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

Возвращает:

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

Исключения:

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

С:

1.4

См. также:

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

setSavepoint

Savepoint setSavepoint()
                throws SQLException

Возвращает:

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

Исключения:

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

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

С:

1.4

См. также:

Savepoint

setSavepoint

Savepoint setSavepoint(String name)
                throws SQLException

Параметры:

name - строка, содержащая имя контрольного пункта

Возвращает:

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

Исключения:

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

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

С:

1.4

См. также:

Savepoint

rollback

void rollback(Savepoint savepoint)
       throws SQLException

Параметры:

savepoint - объект Savepoint для отката

Исключения:

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

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

С:

1.4

См. также:

Savepoint, rollback()

releaseSavepoint

void releaseSavepoint(Savepoint savepoint)
               throws SQLException

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

Параметры:

savepoint - объект Savepoint для удаления

Исключения:

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

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

С:

1.4

createStatement

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

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

Параметры:

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

prepareStatement

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

prepareCall

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

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

Параметры:

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

prepareStatement

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

prepareStatement

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

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

С:

1.4

prepareStatement

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

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

С:

1.4

createClob

Clob createClob()
         throws SQLException

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

Возвращает:

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

Исключения:

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

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

С:

1.6

createBlob

Blob createBlob()
         throws SQLException

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

Возвращает:

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

Издает исключение:

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

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

С тех пор:

1.6

createNClob

NClob createNClob()
           throws SQLException

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

Возвращает:

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

Издает исключение:

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

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

С тех пор:

1.6

createSQLXML

SQLXML createSQLXML()
             throws SQLException

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

Возвращает:

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

Издает исключение:

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

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

С тех пор:

1.6

isValid

boolean isValid(int timeout)
         throws SQLException

Параметры:

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

Возвращает:

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

Издает исключение:

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

С тех пор:

1.6

См. также:

DatabaseMetaData.getClientInfoProperties()

setClientInfo

void setClientInfo(String name,
                   String value)
            throws SQLClientInfoException

Параметры:

name - имя свойства клиентской информации для установки

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

Издает исключение:

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

С тех пор:

1.6

setClientInfo

void setClientInfo(Properties properties)
            throws SQLClientInfoException

Параметры:

properties - список свойств клиентской информации для установки

Издает исключение:

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

С тех пор:

1.6

См. также:

setClientInfo(String, String)

getClientInfo

String getClientInfo(String name)
              throws SQLException

Параметры:

name - имя свойства клиентской информации для извлечения

Возвращает:

Значение заданного свойства клиентской информации

Издает исключение:

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

С тех пор:

1.6

См. также:

DatabaseMetaData.getClientInfoProperties()

getClientInfo

Properties getClientInfo()
                  throws SQLException

Возвращает:

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

Издает исключение:

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

С тех пор:

1.6

createArrayOf

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

Параметры:

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

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

Возвращает:

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

Издает исключение:

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

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

С тех пор:

1.6

createStruct

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

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

Параметры:

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

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

Возвращает:

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

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

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

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

С:

1.6

setSchema

void setSchema(String schema)
        throws SQLException

Параметры:

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

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

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

С:

1.7

См. также:

getSchema()

getSchema

String getSchema()
          throws SQLException

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

Возвращает:

текущее имя схемы или null, если его нет

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

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

С:

1.7

См. также:

setSchema(java.lang.String)

abort

void abort(Executor executor)
    throws SQLException

Параметры:

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

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

SQLException — если возникает ошибка доступа к базе данных, или объект executor находится в состоянии null

SecurityException — если существует менеджер безопасности и его метод checkPermission запрещает вызов abort

С:

1.7

См. также:

SecurityManager.checkPermission(java.security.Permission), Executor

setNetworkTimeout

void setNetworkTimeout(Executor executor,
                       int milliseconds)
                throws SQLException

Параметры:

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

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

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

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

SecurityException — если существует менеджер безопасности и его метод checkPermission запрещает вызов setNetworkTimeout.

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

С:

1.7

См. также:

SecurityManager.checkPermission(java.security.Permission), Statement.setQueryTimeout(int), getNetworkTimeout(), abort(java.util.concurrent.Executor), Executor

getNetworkTimeout

int getNetworkTimeout()
               throws SQLException

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

Возвращает:

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

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

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

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

С:

1.7

См. также:

setNetworkTimeout(java.util.concurrent.Executor, int)