Соединение (Платформа Java SE 8 b92)

Все Суперинтерфейсы:

AutoCloseable, Обертка
```
public interface Connection
extends Wrapper, AutoCloseable
```
Соединение (сеанс) с определенной базой данных. SQL-операторы выполняются, и результаты возвращаются в пределах контекста соединения.
A Connection база данных объекта в состоянии предоставить информацию, описывающую ее таблицы, ее поддерживаемую грамматику SQL, ее хранимые процедуры, возможности этого соединения, и так далее. Эта информация получается с getMetaData метод.
Отметьте: конфигурируя a Connection, Приложения JDBC должны использовать соответствующее Connection метод такой как setAutoCommit или setTransactionIsolation. Приложения не должны вызвать команды SQL непосредственно, чтобы изменить конфигурацию соединения, когда есть доступный метод JDBC. По умолчанию a Connection объект находится в режиме автоматической фиксации, что означает, что это автоматически фиксирует изменения после выполнения каждого оператора. Если режим автоматической фиксации был отключен, метод commit должен быть вызван явно, чтобы фиксировать изменения; иначе, изменения базы данных не будут сохранены.
Новое Connection объект создал использование JDBC, у 2.1 базовых API есть первоначально пустая карта типа, связанная с этим. Пользователь может ввести пользовательское отображение для UDT в этой карте типа. Когда UDT получается от источника данных с методом ResultSet.getObject, getObject метод проверит, что тип соединения отображается, чтобы видеть, есть ли запись для этого UDT. Если так, getObject метод отобразит UDT на обозначенный class. Если не будет никакой записи, то UDT будет отображен, используя стандартное отображение.
Пользователь может создать новую карту типа, которая является a java.util.Map возразите, сделайте запись в этом, и передайте это к java.sql методы, которые могут выполнить пользовательское отображение. В этом случае метод будет использовать данную карту типа вместо того, связанного с соединением.
Например, следующий фрагмент кода определяет, что SQL вводит ATHLETES будет отображен на class Athletes в языке программирования Java. Фрагмент кода получает карту типа для Connection объект con, вставляет запись в это, и затем устанавливает карту типа с новой записью как карта типа соединения.
```
      java.util.Map map = con.getTypeMap();
      map.put("mySchemaName.ATHLETES", Class.forName("Athletes"));
      con.setTypeMap(map);
 
```
См. Также:

DriverManager.getConnection(java.lang.String, java.util.Properties), Statement, ResultSet, DatabaseMetaData

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static int`	`TRANSACTION_NONE` Постоянное указание, что транзакции не поддерживаются.
`static int`	`TRANSACTION_READ_COMMITTED` Постоянное указание, что грязные чтения предотвращаются; неповторяемые чтения и фантомные чтения могут произойти.
`static int`	`TRANSACTION_READ_UNCOMMITTED` Постоянное указание, что грязные чтения, неповторяемые чтения и фантомные чтения могут произойти.
`static int`	`TRANSACTION_REPEATABLE_READ` Постоянное указание, что грязные чтения и неповторяемые чтения предотвращаются; могут произойти фантомные чтения.
`static int`	`TRANSACTION_SERIALIZABLE` Постоянное указание, что грязные чтения, неповторяемые чтения и фантомные чтения предотвращаются.

Сводка метода

Все Методы Методы экземпляра Абстрактные Методы
Модификатор и Тип	Метод и Описание
`void`	`abort(Executor executor)` Завершает открытое соединение.
`void`	`clearWarnings()` Очищает все предупреждения, о которых сообщают для этого `Connection` объект.
`void`	`close()` Выпуски это `Connection` база данных объекта и ресурсы JDBC сразу вместо того, чтобы ожидать их, чтобы быть автоматически выпущенным.
`void`	`commit()` Делает все изменения сделанными начиная с предыдущей фиксации/отката постоянный и выпускает любые блокировки базы данных, в настоящий момент сохраненные этим `Connection` объект.
`Массив`	`createArrayOf(String typeName, Object[] elements)` Метод фабрики для того, чтобы создать объекты Массива.
`Блоб`	`createBlob()` Создает объект, который реализует `Blob` интерфейс.
`Clob`	`createClob()` Создает объект, который реализует `Clob` интерфейс.
`NClob`	`createNClob()` Создает объект, который реализует `NClob` интерфейс.
`SQLXML`	`createSQLXML()` Создает объект, который реализует `SQLXML` интерфейс.
`Оператор`	`createStatement()` Создает a `Statement` объект для того, чтобы отправить SQL-операторы базе данных.
`Оператор`	`createStatement(int resultSetType, int resultSetConcurrency)` Создает a `Statement` объект, который генерирует `ResultSet` объекты с данным типом и параллелизмом.
`Оператор`	`createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability)` Создает a `Statement` объект, который генерирует `ResultSet` объекты с данным типом, параллелизмом, и holdability.
`Struct`	`createStruct(String typeName, Object[] attributes)` Метод фабрики для того, чтобы создать объекты Стракта.
`boolean`	`getAutoCommit()` Получает текущий режим автоматической фиксации для этого `Connection` объект.
`Строка`	`getCatalog()` Получает это `Connection` текущее имя каталога объекта.
`Свойства`	`getClientInfo()` Возвращает список, содержащий имя и текущую стоимость каждого клиентского свойства информации, поддерживаемого драйвером.
`Строка`	`getClientInfo(String name)` Возвращает значение клиентского свойства информации, определенного по имени.
`int`	`getHoldability()` Получает ток holdability `ResultSet` объекты создали использование этого `Connection` объект.
`DatabaseMetaData`	`getMetaData()` Получает a `DatabaseMetaData` объект, который содержит метаданные о базе данных к который это `Connection` объект представляет соединение.
`int`	`getNetworkTimeout()` Получает число миллисекунд, которые драйвер будет ожидать запроса к базе данных, чтобы завершить.
`Строка`	`getSchema()` Получает это `Connection` текущее имя схемы объекта.
`int`	`getTransactionIsolation()` Получает это `Connection` текущий уровень изоляции транзакции объекта.
`Map<String,Class<?>>`	`getTypeMap()` Получает `Map` объект связался с этим `Connection` объект.
`SQLWarning`	`getWarnings()` Получает первое предупреждение, о котором сообщают запросы к этому `Connection` объект.
`boolean`	`isClosed()` Получает ли это `Connection` объект был закрыт.
`boolean`	`isReadOnly()` Получает ли это `Connection` объект находится в режиме только для чтения.
`boolean`	`isValid(int timeout)` Возвращает true, если соединение не было закрыто и все еще допустимо.
`Строка`	`nativeSQL(String sql)` Преобразовывает данный SQL-оператор в собственную грамматику SQL системы.
`CallableStatement`	`prepareCall(String sql)` Создает a `CallableStatement` объект для того, чтобы вызвать хранимые процедуры базы данных.
`CallableStatement`	`prepareCall(String sql, int resultSetType, int resultSetConcurrency)` Создает a `CallableStatement` объект, который генерирует `ResultSet` объекты с данным типом и параллелизмом.
`CallableStatement`	`prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)` Создает a `CallableStatement` объект, который генерирует `ResultSet` объекты с данным типом и параллелизмом.
`PreparedStatement`	`prepareStatement(String sql)` Создает a `PreparedStatement` объект для того, чтобы отправить параметризованные SQL-операторы базе данных.
`PreparedStatement`	`prepareStatement(String sql, int autoGeneratedKeys)` Создает значение по умолчанию `PreparedStatement` объект, у которого есть возможность получить автоматически сгенерированные ключи.
`PreparedStatement`	`prepareStatement(String sql, int[] columnIndexes)` Создает значение по умолчанию `PreparedStatement` объект, способный к возврату автоматически сгенерированных ключей, определяется данным массивом.
`PreparedStatement`	`prepareStatement(String sql, int resultSetType, int resultSetConcurrency)` Создает a `PreparedStatement` объект, который генерирует `ResultSet` объекты с данным типом и параллелизмом.
`PreparedStatement`	`prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)` Создает a `PreparedStatement` объект, который генерирует `ResultSet` объекты с данным типом, параллелизмом, и holdability.
`PreparedStatement`	`prepareStatement(String sql, String[] columnNames)` Создает значение по умолчанию `PreparedStatement` объект, способный к возврату автоматически сгенерированных ключей, определяется данным массивом.
`void`	`releaseSavepoint(Savepoint savepoint)` Удаляет указанное `Savepoint` и последующий `Savepoint` объекты от текущей транзакции.
`void`	`rollback()` Отмены все изменения, произведенные в текущей транзакции и выпусках любая база данных, блокируют в настоящий момент сохраненный этим `Connection` объект.
`void`	`rollback(Savepoint savepoint)` Отмены все изменения, произведенные после данного `Savepoint` объект был установлен.
`void`	`setAutoCommit(boolean autoCommit)` Наборы режим автоматической фиксации этого соединения к данному состоянию.
`void`	`setCatalog(String catalog)` Приводит в порядок данное имя каталога, чтобы выбрать подпространство этого `Connection` база данных объекта, в которой можно работать.
`void`	`setClientInfo(Properties properties)` Устанавливает значение клиентских свойств информации соединения.
`void`	`setClientInfo(String name, String value)` Устанавливает значение клиентского свойства информации, определенного по имени к значению, определенному значением.
`void`	`setHoldability(int holdability)` Изменяет значение по умолчанию holdability `ResultSet` объекты создали использование этого `Connection` возразите против данного holdability.
`void`	`setNetworkTimeout(Executor executor, int milliseconds)` Устанавливает максимальный период a `Connection` или объекты, создаваемые из `Connection` будет ожидать базы данных, чтобы ответить на любой запрос.
`void`	`setReadOnly(boolean readOnly)` Помещает это соединение в режим только для чтения как подсказка к драйверу, чтобы включить оптимизации базы данных.
`Точка сохранения`	`setSavepoint()` Создает неназванную точку сохранения в текущей транзакции и возвращает новое `Savepoint` объект, который представляет это.
`Точка сохранения`	`setSavepoint(String name)` Создает точку сохранения с именем в текущей транзакции и возвращает новое `Savepoint` объект, который представляет это.
`void`	`setSchema(String schema)` Определяет данное имя схемы к доступу.
`void`	`setTransactionIsolation(int level)` Попытки изменить уровень изоляции транзакции для этого `Connection` возразите против один данный.
`void`	`setTypeMap(Map<String,Class<?>> map)` Устанавливает данный `TypeMap` возразите как карта типа для этого `Connection` объект.

Методы, наследованные от интерфейса java.sql. Обертка
isWrapperFor, unwrap

- Полевая Деталь
  - 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 и далее запрещает ситуацию, где одна транзакция читает все строки, которые удовлетворяют a WHERE условие, вторая транзакция вставляет строку, которая удовлетворяет это WHERE условие, и первая транзакция перечитывают для того же самого условия, получая дополнительную "фантомную" строку во втором чтении.
    
    См. Также:
    
    Постоянные Значения полей
- Деталь метода
  - createStatement
```
Statement createStatement()
                   throws SQLException
```
    Создает a Statement объект для того, чтобы отправить SQL-операторы базе данных. SQL-операторы без параметров обычно выполняются, используя Statement объекты. Если тот же самый SQL-оператор выполняется много раз, может быть более эффективно использовать a PreparedStatement объект.
    Наборы результатов создали использование возвращенного Statement объект по умолчанию будет типом TYPE_FORWARD_ONLY и имейте уровень параллелизма CONCUR_READ_ONLY. holdability создаваемых наборов результатов может быть определен, вызывая getHoldability().
    
    Возвраты:
    
    новое значение по умолчанию Statement объект
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
  - prepareStatement
```
PreparedStatement prepareStatement(String sql)
                            throws SQLException
```
    Создает a PreparedStatement объект для того, чтобы отправить параметризованные SQL-операторы базе данных.
    SQL-оператор с или без В параметрах может быть предварительно скомпилирован и сохранен в a PreparedStatement объект. Этот объект может тогда использоваться, чтобы эффективно выполнить этот оператор многократно.
    Отметьте: Этот метод оптимизируется для того, чтобы обработать параметрические SQL-операторы то преимущество от предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement отправит оператор базе данных для предварительной компиляции. Некоторые драйверы, возможно, не поддерживают предварительную компиляцию. В этом случае оператор не может быть отправлен базе данных до PreparedStatement объект выполняется. Это не оказывает прямого влияния на пользователей; однако, это действительно влияет который бесспорный бросок методов SQLException объекты.
    Наборы результатов создали использование возвращенного PreparedStatement объект по умолчанию будет типом TYPE_FORWARD_ONLY и имейте уровень параллелизма CONCUR_READ_ONLY. holdability создаваемых наборов результатов может быть определен, вызывая getHoldability().
    
    Параметры:
    
    sql - SQL-оператор, который может содержать один или более'?' В заполнителях параметра
    
    Возвраты:
    
    новое значение по умолчанию PreparedStatement объект, содержащий предварительно скомпилированный SQL-оператор
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
  - prepareCall
```
CallableStatement prepareCall(String sql)
                       throws SQLException
```
    Создает a CallableStatement объект для того, чтобы вызвать хранимые процедуры базы данных. CallableStatement объект обеспечивает методы для того, чтобы они установили В и параметры, и методы для того, чтобы выполнить звонок в хранимую процедуру.
    Отметьте: Этот метод оптимизируется для того, чтобы обработать операторы вызова хранимой процедуры. Некоторые драйверы могут отправить оператор вызова базе данных когда метод prepareCall делается; другие могут ожидать до CallableStatement объект выполняется. Это не оказывает прямого влияния на пользователей; однако, это действительно влияет, какой метод бросает определенный SQLExceptions.
    Наборы результатов создали использование возвращенного CallableStatement объект по умолчанию будет типом TYPE_FORWARD_ONLY и имейте уровень параллелизма CONCUR_READ_ONLY. holdability создаваемых наборов результатов может быть определен, вызывая getHoldability().
    
    Параметры:
    
    sql - SQL-оператор, который может содержать один или более'?' заполнители параметра. Обычно этот оператор определяется, используя синтаксис escape вызова JDBC.
    
    Возвраты:
    
    новое значение по умолчанию CallableStatement объект, содержащий предварительно скомпилированный SQL-оператор
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
  - nativeSQL
```
String nativeSQL(String sql)
          throws SQLException
```
    Преобразовывает данный SQL-оператор в собственную грамматику SQL системы. Драйвер может преобразовать грамматику SQL JDBC в собственную грамматику SQL своей системы до отправки этого. Этот метод возвращает собственную форму оператора, который отправил бы драйвер.
    
    Параметры:
    
    sql - SQL-оператор, который может содержать один или более'?' заполнители параметра
    
    Возвраты:
    
    собственная форма этого оператора
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
  - setAutoCommit
```
void setAutoCommit(boolean autoCommit)
            throws SQLException
```
    Наборы режим автоматической фиксации этого соединения к данному состоянию. Если соединение будет в режиме автоматической фиксации, то все его SQL-операторы будут выполняться и фиксироваться как отдельные транзакции. Иначе, его SQL-операторы группируются в транзакции, которые завершаются звонком в любого метод commit или метод rollback. По умолчанию новые соединения находятся в режиме автоматической фиксации.
    Фиксация происходит, когда оператор завершается. Время, когда оператор завершается, зависит от типа SQL-оператора:
    - Для операторов DML, тех, которые Вставляют, Обновление или Удаляют, и операторы DDL, оператор полон, как только это закончило выполняться.
    - Для операторов Select оператор полон, когда связанный набор результатов закрывается.
    - Для CallableStatement объекты или для операторов, которые возвращают многократные результаты, оператор, полны, когда все связанные наборы результатов были закрыты, и все количества обновления и выходные параметры были получены.
    ОТМЕТЬТЕ: Если этот метод вызывают во время транзакции, и режим автоматической фиксации изменяется, транзакция фиксируется. Если setAutoCommit вызывается и режим автоматической фиксации не изменяется, вызов нет.
    Параметры:
    
    autoCommit - true включать режиму автоматической фиксации; false отключить это
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, setAutoCommit (истина) вызывается, участвуя в распределенной транзакции, или этот метод вызывают на закрытом соединении
    
    См. Также:
    
    getAutoCommit()
  - getAutoCommit
```
boolean getAutoCommit()
               throws SQLException
```
    Получает текущий режим автоматической фиксации для этого Connection объект.
    
    Возвраты:
    
    текущее состояние этого Connection режим автоматической фиксации объекта
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
    
    См. Также:
    
    setAutoCommit(boolean)
  - фиксация
```
void commit()
     throws SQLException
```
    Делает все изменения сделанными начиная с предыдущей фиксации/отката постоянный и выпускает любые блокировки базы данных, в настоящий момент сохраненные этим Connection объект. Этот метод должен использоваться только, когда режим автоматической фиксации был отключен.
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, этот метод вызывают, участвуя в распределенной транзакции, если этот метод вызывают на закрытом conection или этом Connection объект находится в режиме автоматической фиксации
    
    См. Также:
    
    setAutoCommit(boolean)
  - откат
```
void rollback()
       throws SQLException
```
    Отмены все изменения, произведенные в текущей транзакции и выпусках любая база данных, блокируют в настоящий момент сохраненный этим Connection объект. Этот метод должен использоваться только, когда режим автоматической фиксации был отключен.
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, этот метод вызывают, участвуя в распределенной транзакции, этот метод вызывают на закрытом соединении или этом Connection объект находится в режиме автоматической фиксации
    
    См. Также:
    
    setAutoCommit(boolean)
  - близко
```
void close()
    throws SQLException
```
    Выпуски это Connection база данных объекта и ресурсы JDBC сразу вместо того, чтобы ожидать их, чтобы быть автоматически выпущенным.
    Вызов метода close на a Connection объект, который уже закрывается, нет.
    Строго рекомендуется, чтобы приложение явно фиксировало или откатывало активную транзакцию до вызова close метод. Если close метод вызывают и есть активная транзакция, результаты определяются с помощью реализации.
    
    Определенный:
    
    close в интерфейсе AutoCloseable
    
    Броски:
    
    SQLException - SQLException, если ошибка доступа к базе данных происходит
  - isClosed
```
boolean isClosed()
          throws SQLException
```
    Получает ли это Connection объект был закрыт. Соединение закрывается если метод close был вызван на этом или если определенные фатальные ошибки произошли. Этот метод, как гарантируют, возвратится true только, когда это вызывают после метода Connection.close был вызван.
    Этот метод обычно нельзя вызвать, чтобы определить, допустимо ли соединение с базой данных или недопустимо. Типичный клиент может решить, что соединение недопустимо, ловя любые исключения, которые могли бы быть выданы, когда работа предпринимается.
    
    Возвраты:
    
    true если это Connection объект закрывается; false если это все еще открыто
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит
  - getMetaData
```
DatabaseMetaData getMetaData()
                      throws SQLException
```
    Получает a DatabaseMetaData объект, который содержит метаданные о базе данных к который это Connection объект представляет соединение. Метаданные включают информацию о таблицах базы данных, ее поддерживаемой грамматике SQL, ее хранимых процедурах, возможностях этого соединения, и так далее.
    
    Возвраты:
    
    a 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
```
    Приводит в порядок данное имя каталога, чтобы выбрать подпространство этого Connection база данных объекта, в которой можно работать.
    Если драйвер не будет поддерживать каталоги, то он тихо проигнорирует этот запрос.
    Вызов setCatalog не имеет никакого эффекта на ранее создаваемый или готовом Statement объекты. Это - реализация, определенная, готовится ли DBMS, работа сразу имеет место когда Connection метод prepareStatement или prepareCall вызывается. Для максимальной мобильности, setCatalog должен быть вызван прежде a Statement создается или готовится.
    
    Параметры:
    
    catalog - имя каталога (подпространство в этом Connection база данных объекта), в котором можно работать
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
    
    См. Также:
    
    getCatalog()
  - getCatalog
```
String getCatalog()
           throws SQLException
```
    Получает это Connection текущее имя каталога объекта.
    
    Возвраты:
    
    текущее имя каталога или null если нет ни одного
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
    
    См. Также:
    
    setCatalog(java.lang.String)
  - setTransactionIsolation
```
void setTransactionIsolation(int level)
                      throws SQLException
```
    Попытки изменить уровень изоляции транзакции для этого Connection возразите против один данный. Константы определяются в интерфейсе Connection возможные уровни изоляции транзакции.
    Отметьте: Если этот метод вызывают во время транзакции, результат определяется с помощью реализации.
    
    Параметры:
    
    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
```
    Получает первое предупреждение, о котором сообщают запросы к этому Connection объект. Если будет больше чем одно предупреждение, то последующие предупреждения будут объединены в цепочку к первому и могут быть получены, вызывая метод SQLWarning.getNextWarning на предупреждении, которое было получено ранее.
    Этот метод нельзя вызвать на закрытом соединении; выполнение так вызовет SQLException быть брошенным.
    Отметьте: Последующие предупреждения будут объединены в цепочку к этому SQLWarning.
    
    Возвраты:
    
    первое SQLWarning объект или null если нет ни одного
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
    
    См. Также:
    
    SQLWarning
  - clearWarnings
```
void clearWarnings()
            throws SQLException
```
    Очищает все предупреждения, о которых сообщают для этого Connection объект. После звонка в этот метод, метод getWarnings возвраты null пока о новом предупреждении не сообщают для этого Connection объект.
    
    Броски:
    
    SQLException - SQLException, если ошибка доступа к базе данных происходит или этот метод, вызывают на закрытом соединении
  - createStatement
```
Statement createStatement(int resultSetType,
                          int resultSetConcurrency)
                   throws SQLException
```
    Создает a Statement объект, который генерирует ResultSet объекты с данным типом и параллелизмом. Этот метод является тем же самым как createStatement метод выше, но это позволяет типу набора результатов значения по умолчанию и параллелизму быть переопределенным. holdability создаваемых наборов результатов может быть определен, вызывая 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
```
    Создает a PreparedStatement объект, который генерирует ResultSet объекты с данным типом и параллелизмом. Этот метод является тем же самым как prepareStatement метод выше, но это позволяет типу набора результатов значения по умолчанию и параллелизму быть переопределенным. holdability создаваемых наборов результатов может быть определен, вызывая getHoldability().
    
    Параметры:
    
    sql - a String объект, который является SQL-оператором, который будет отправлен базе данных; может содержать один или более'?' В параметрах
    
    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
```
    Создает a CallableStatement объект, который генерирует ResultSet объекты с данным типом и параллелизмом. Этот метод является тем же самым как prepareCall метод выше, но это позволяет типу набора результатов значения по умолчанию и параллелизму быть переопределенным. holdability создаваемых наборов результатов может быть определен, вызывая getHoldability().
    
    Параметры:
    
    sql - a 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 объект связался с этим Connection объект. Если приложение не добавило запись, возвращенная карта типа будет пуста.
    Следует вызвать setTypeMap после произведения изменений в Map объект, возвращенный из getTypeMap поскольку драйвер JDBC может создать внутреннюю копию Map объект, к которому передают setTypeMap:
```
      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
```
    Устанавливает данный TypeMap возразите как карта типа для этого Connection объект. Карта типа будет использоваться для пользовательского отображения SQL структурированные типы и отличные типы.
    Следует установить значения для TypeMap до callng setMap поскольку драйвер JDBC может создать внутреннюю копию TypeMap:
```
      Map myMap<String,Class<?>> = new HashMap<String,Class<?>>();
      myMap.put("mySchemaName.ATHLETES", Athletes.class);
      con.setTypeMap(myMap);
 
```
    Параметры:
    
    map - java.util.Map возразите, чтобы установить как замена для этого Connection значение по умолчанию объекта вводит карту
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом соединении, или данный параметр не является a java.util.Map объект
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.2
    
    См. Также:
    
    getTypeMap()
  - setHoldability
```
void setHoldability(int holdability)
             throws SQLException
```
    Изменяет значение по умолчанию holdability ResultSet объекты создали использование этого Connection возразите против данного holdability. Значение по умолчанию holdability ResultSet объекты могут быть быть определенными, вызывая DatabaseMetaData.getResultSetHoldability().
    
    Параметры:
    
    holdability - a ResultSet постоянный holdability; один из ResultSet.HOLD_CURSORS_OVER_COMMIT или ResultSet.CLOSE_CURSORS_AT_COMMIT
    
    Броски:
    
    SQLException - если доступ к базе данных происходит, этот метод вызывают на закрытом соединении, или данный параметр не является a ResultSet постоянное указание holdability
    
    SQLFeatureNotSupportedException - если данный holdability не поддерживается
    
    С тех пор:
    
    1.4
    
    См. Также:
    
    getHoldability(), DatabaseMetaData.getResultSetHoldability(), ResultSet
  - getHoldability
```
int getHoldability()
            throws SQLException
```
    Получает ток holdability ResultSet объекты создали использование этого Connection объект.
    
    Возвраты:
    
    holdability, один из ResultSet.HOLD_CURSORS_OVER_COMMIT или ResultSet.CLOSE_CURSORS_AT_COMMIT
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
    
    С тех пор:
    
    1.4
    
    См. Также:
    
    setHoldability(int), DatabaseMetaData.getResultSetHoldability(), ResultSet
  - setSavepoint
```
Savepoint setSavepoint()
                throws SQLException
```
    Создает неназванную точку сохранения в текущей транзакции и возвращает новое Savepoint объект, который представляет это.
    если setSavepoint будет вызван за пределами активной транзакции, то транзакция будет запущена в этой недавно создаваемой точке сохранения.
    
    Возвраты:
    
    новое Savepoint объект
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, этот метод вызывают, участвуя в распределенной транзакции, этот метод вызывают на закрытом соединении или этом Connection объект находится в настоящий момент в режиме автоматической фиксации
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.4
    
    См. Также:
    
    Savepoint
  - setSavepoint
```
Savepoint setSavepoint(String name)
                throws SQLException
```
    Создает точку сохранения с именем в текущей транзакции и возвращает новое Savepoint объект, который представляет это.
    если setSavepoint будет вызван за пределами активной транзакции, то транзакция будет запущена в этой недавно создаваемой точке сохранения.
    
    Параметры:
    
    name - a String содержа имя точки сохранения
    
    Возвраты:
    
    новое Savepoint объект
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, этот метод вызывают, участвуя в распределенной транзакции, этот метод вызывают на закрытом соединении или этом Connection объект находится в настоящий момент в режиме автоматической фиксации
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.4
    
    См. Также:
    
    Savepoint
  - откат
```
void rollback(Savepoint savepoint)
       throws SQLException
```
    Отмены все изменения, произведенные после данного Savepoint объект был установлен.
    Этот метод должен использоваться только, когда автоматическая фиксация была отключена.
    
    Параметры:
    
    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
```
    Создает a Statement объект, который генерирует ResultSet объекты с данным типом, параллелизмом, и holdability. Этот метод является тем же самым как createStatement метод выше, но это позволяет типу набора результатов значения по умолчанию, параллелизму, и holdability быть переопределенным.
    
    Параметры:
    
    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 объекты с данным типом, параллелизмом, и holdability
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом соединении, или данные параметры не ResultSet константы, указывающие на тип, параллелизм, и holdability
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод, или этот метод не поддерживается для указанного типа набора результатов, набор результатов holdability и параллелизм набора результатов.
    
    С тех пор:
    
    1.4
    
    См. Также:
    
    ResultSet
  - prepareStatement
```
PreparedStatement prepareStatement(String sql,
                                   int resultSetType,
                                   int resultSetConcurrency,
                                   int resultSetHoldability)
                            throws SQLException
```
    Создает a PreparedStatement объект, который генерирует ResultSet объекты с данным типом, параллелизмом, и holdability.
    Этот метод является тем же самым как prepareStatement метод выше, но это позволяет типу набора результатов значения по умолчанию, параллелизму, и holdability быть переопределенным.
    
    Параметры:
    
    sql - a 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 объекты с данным типом, параллелизмом, и holdability
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом соединении, или данные параметры не ResultSet константы, указывающие на тип, параллелизм, и holdability
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод, или этот метод не поддерживается для указанного типа набора результатов, набор результатов holdability и параллелизм набора результатов.
    
    С тех пор:
    
    1.4
    
    См. Также:
    
    ResultSet
  - prepareCall
```
CallableStatement prepareCall(String sql,
                              int resultSetType,
                              int resultSetConcurrency,
                              int resultSetHoldability)
                       throws SQLException
```
    Создает a CallableStatement объект, который генерирует ResultSet объекты с данным типом и параллелизмом. Этот метод является тем же самым как prepareCall метод выше, но это позволяет типу набора результатов значения по умолчанию, типу параллелизма набора результатов и holdability быть переопределенным.
    
    Параметры:
    
    sql - a 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 объекты с данным типом, параллелизмом, и holdability
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом соединении, или данные параметры не ResultSet константы, указывающие на тип, параллелизм, и holdability
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод, или этот метод не поддерживается для указанного типа набора результатов, набор результатов holdability и параллелизм набора результатов.
    
    С тех пор:
    
    1.4
    
    См. Также:
    
    ResultSet
  - prepareStatement
```
PreparedStatement prepareStatement(String sql,
                                   int autoGeneratedKeys)
                            throws SQLException
```
    Создает значение по умолчанию PreparedStatement объект, у которого есть возможность получить автоматически сгенерированные ключи. Данная константа говорит драйвер, должно ли это сделать автоматически сгенерированные ключи доступными для извлечения. Этот параметр игнорируется, если SQL-оператор не INSERT оператор, или SQL-оператор, который в состоянии возвратить автоматически сгенерированные ключи (список таких операторов специфичен для поставщика).
    Отметьте: Этот метод оптимизируется для того, чтобы обработать параметрические SQL-операторы то преимущество от предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement отправит оператор базе данных для предварительной компиляции. Некоторые драйверы, возможно, не поддерживают предварительную компиляцию. В этом случае оператор не может быть отправлен базе данных до PreparedStatement объект выполняется. Это не оказывает прямого влияния на пользователей; однако, это действительно влияет, какие методы бросают определенный SQLExceptions.
    Наборы результатов создали использование возвращенного PreparedStatement объект по умолчанию будет типом TYPE_FORWARD_ONLY и имейте уровень параллелизма CONCUR_READ_ONLY. holdability создаваемых наборов результатов может быть определен, вызывая getHoldability().
    
    Параметры:
    
    sql - SQL-оператор, который может содержать один или более'?' В заполнителях параметра
    
    autoGeneratedKeys - флаг, указывающий, должны ли автоматически сгенерированные ключи быть возвращены; один из Statement.RETURN_GENERATED_KEYS или Statement.NO_GENERATED_KEYS
    
    Возвраты:
    
    новое PreparedStatement объект, содержа предварительно скомпилированный SQL-оператор, у которого будет возможность возврата автоматически сгенерированных ключей
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом соединении, или данный параметр не является a Statement постоянное указание, должны ли автоматически сгенерированные ключи быть возвращены
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод с константой Оператора. RETURN_GENERATED_KEYS
    
    С тех пор:
    
    1.4
  - prepareStatement
```
PreparedStatement prepareStatement(String sql,
                                   int[] columnIndexes)
                            throws SQLException
```
    Создает значение по умолчанию PreparedStatement объект, способный к возврату автоматически сгенерированных ключей, определяется данным массивом. Этот массив содержит индексирование столбцов в целевой таблице, которые содержат автоматически сгенерированные ключи, которые должны быть сделаны доступными. Драйвер проигнорирует массив, если SQL-оператор не будет INSERT оператор, или SQL-оператор, который в состоянии возвратить автоматически сгенерированные ключи (список таких операторов специфичен для поставщика).
    SQL-оператор с или без В параметрах может быть предварительно скомпилирован и сохранен в a PreparedStatement объект. Этот объект может тогда использоваться, чтобы эффективно выполнить этот оператор многократно.
    Отметьте: Этот метод оптимизируется для того, чтобы обработать параметрические SQL-операторы то преимущество от предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement отправит оператор базе данных для предварительной компиляции. Некоторые драйверы, возможно, не поддерживают предварительную компиляцию. В этом случае оператор не может быть отправлен базе данных до PreparedStatement объект выполняется. Это не оказывает прямого влияния на пользователей; однако, это действительно влияет, какие методы бросают определенный SQLExceptions.
    Наборы результатов создали использование возвращенного PreparedStatement объект по умолчанию будет типом TYPE_FORWARD_ONLY и имейте уровень параллелизма CONCUR_READ_ONLY. holdability создаваемых наборов результатов может быть определен, вызывая getHoldability().
    
    Параметры:
    
    sql - SQL-оператор, который может содержать один или более'?' В заполнителях параметра
    
    columnIndexes - массив столбца индексирует указание на столбцы, которые должны быть возвращены из вставленной строки или строк
    
    Возвраты:
    
    новое PreparedStatement объект, содержа предварительно скомпилированный оператор, который способен к возврату автоматически сгенерированных ключей, определяемых данным массивом столбца, индексирует
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.4
  - prepareStatement
```
PreparedStatement prepareStatement(String sql,
                                   String[] columnNames)
                            throws SQLException
```
    Создает значение по умолчанию PreparedStatement объект, способный к возврату автоматически сгенерированных ключей, определяется данным массивом. Этот массив содержит имена столбцов в целевой таблице, которые содержат автоматически сгенерированные ключи, которые должны быть возвращены. Драйвер проигнорирует массив, если SQL-оператор не будет INSERT оператор, или SQL-оператор, который в состоянии возвратить автоматически сгенерированные ключи (список таких операторов специфичен для поставщика).
    SQL-оператор с или без В параметрах может быть предварительно скомпилирован и сохранен в a PreparedStatement объект. Этот объект может тогда использоваться, чтобы эффективно выполнить этот оператор многократно.
    Отметьте: Этот метод оптимизируется для того, чтобы обработать параметрические SQL-операторы то преимущество от предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement отправит оператор базе данных для предварительной компиляции. Некоторые драйверы, возможно, не поддерживают предварительную компиляцию. В этом случае оператор не может быть отправлен базе данных до PreparedStatement объект выполняется. Это не оказывает прямого влияния на пользователей; однако, это действительно влияет, какие методы бросают определенный SQLExceptions.
    Наборы результатов создали использование возвращенного PreparedStatement объект по умолчанию будет типом TYPE_FORWARD_ONLY и имейте уровень параллелизма CONCUR_READ_ONLY. holdability создаваемых наборов результатов может быть определен, вызывая getHoldability().
    
    Параметры:
    
    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
```
    Возвращает true, если соединение не было закрыто и все еще допустимо. Драйвер должен представить запрос на соединении или использовать некоторый другой механизм, который положительно проверяет, что соединение все еще допустимо, когда этот метод вызывают.
    Запрос, представленный драйвером, чтобы проверить соединения, должен выполняться в контексте текущей транзакции.
    
    Параметры:
    
    timeout - Время в секундах, чтобы ожидать работы базы данных, используемой, чтобы проверить соединения, чтобы завершиться. Если период тайм-аута истекает прежде, чем работа завершается, этот метод возвращает false. Значение 0 указывает, что тайм-аут не применяется к работе базы данных.
    
    Возвраты:
    
    истина, если соединение допустимо, ложно иначе
    
    Броски:
    
    SQLException - если значение, предоставленное для timeout менее тогда 0
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    DatabaseMetaData.getClientInfoProperties()
  - setClientInfo
```
void setClientInfo(String name,
                   String value)
            throws SQLClientInfoException
```
    Устанавливает значение клиентского свойства информации, определенного по имени к значению, определенному значением.
    Приложения могут использовать DatabaseMetaData.getClientInfoProperties метод, чтобы определить клиентские свойства информации, поддерживаемые драйвером и максимальной длиной, которая может быть определена для каждого свойства.
    Драйвер хранит значение, определенное в подходящем расположении в базе данных. Например в специальном регистре, параметре сеанса, или столбце системной таблицы. Для эффективности драйвер может задержать установку значения в базе данных до следующего раза, когда оператор выполняется или готовится. Кроме того, чтобы хранить клиентскую информацию в соответствующем месте в базе данных, эти методы не должны изменять поведение соединения в так или иначе. Значения, предоставленные этим методам, используются для учета, диагностики и отладки целей только.
    Драйвер должен генерировать предупреждение, если клиентское определенное имя информации не будет распознано драйвером.
    Если значение, определенное к этому методу, больше чем максимальная длина для свойства, драйвер может или усечь значение и генерировать предупреждение или генерировать a SQLClientInfoException. Если драйвер генерирует a SQLClientInfoException, определенное значение не было установлено на соединении.
    Следующее является стандартными клиентскими свойствами информации. Драйверы не обязаны поддерживать эти свойства однако, если драйвер поддерживает клиентское свойство информации, которое может быть описано одним из стандартных свойств, стандартное имя свойства должно использоваться.
    - ApplicationName - имя приложения, в настоящий момент использующего соединение
    - ClientUser - имя пользователя, для которого приложение, используя соединение выполняет работу. Это, возможно, не то же самое как имя пользователя, которое использовалось в установлении соединения.
    - ClientHostname - имя узла компьютера приложение, используя соединение работает.
    Параметры:
    
    name - Имя клиентского свойства информации, чтобы установить
    
    value - Значение, чтобы установить клиентское свойство информации в. Если значение является нулем, текущая стоимость указанного свойства очищается.
    
    Броски:
    
    SQLClientInfoException - если сервер базы данных возвращает ошибку, устанавливая клиентское значение информации на сервере базы данных, или этот метод вызывают на закрытом соединении
    
    С тех пор:
    
    1.6
  - setClientInfo
```
void setClientInfo(Properties properties)
            throws SQLClientInfoException
```
    Устанавливает значение клиентских свойств информации соединения. Properties объект содержит имена и значения клиентских свойств информации, которые будут установлены. Набор клиентских свойств информации, содержавшихся в списке свойств, заменяет текущий набор клиентских свойств информации на соединении. Если свойство, которое в настоящий момент устанавливается на соединении, не присутствует в списке свойств, то свойство очищается. Определение пустого списка свойств очистит все свойства на соединении. См. setClientInfo (String, String) для получения дополнительной информации.
    Если ошибка происходит в установке какого-либо из клиентских свойств информации, a SQLClientInfoException бросается. SQLClientInfoException содержит информацию, указывающую, какие клиентские свойства информации не были установлены. Состояние информации о клиенте неизвестно, потому что некоторые базы данных не позволяют многократным клиентским свойствам информации быть установленными атомарно. Для тех баз данных, возможно, были установлены одно или более свойств прежде, чем ошибка произошла.
    
    Параметры:
    
    properties - список клиентских свойств информации, чтобы установить
    
    Броски:
    
    SQLClientInfoException - если сервер базы данных возвращает ошибку, устанавливая значения clientInfo на сервере базы данных, или этот метод вызывают на закрытом соединении
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    setClientInfo(String, String)
  - getClientInfo
```
String getClientInfo(String name)
              throws SQLException
```
    Возвращает значение клиентского свойства информации, определенного по имени. Этот метод может возвратить нуль, если указанное клиентское свойство информации не было установлено и не имеет значения по умолчанию. Этот метод также возвратит нуль, если указанное клиентское имя свойства информации не будет поддерживаться драйвером.
    Приложения могут использовать DatabaseMetaData.getClientInfoProperties метод, чтобы определить клиентские свойства информации, поддерживаемые драйвером.
    
    Параметры:
    
    name - Имя клиентского свойства информации, чтобы получить
    
    Возвраты:
    
    Значение клиентского свойства информации определяется
    
    Броски:
    
    SQLException - если сервер базы данных возвращает ошибку, выбирая клиентское значение информации от базы данных, или этот метод вызывают на закрытом соединении
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    DatabaseMetaData.getClientInfoProperties()
  - getClientInfo
```
Properties getClientInfo()
                  throws SQLException
```
    Возвращает список, содержащий имя и текущую стоимость каждого клиентского свойства информации, поддерживаемого драйвером. Значение клиентского свойства информации может быть нулем, если свойство не было установлено и не имеет значения по умолчанию.
    
    Возвраты:
    
    A Properties объект, который содержит имя и текущую стоимость каждого из клиентских свойств информации, поддерживаемых драйвером.
    
    Броски:
    
    SQLException - если сервер базы данных возвращает ошибку, выбирая клиентские значения информации от базы данных, или этот метод вызывают на закрытом соединении
    
    С тех пор:
    
    1.6
  - createArrayOf
```
Array createArrayOf(String typeName,
                    Object[] elements)
             throws SQLException
```
    Метод фабрики для того, чтобы создать объекты Массива.
    Отметьте: Когда createArrayOf используется, чтобы создать объект массива, что карты к примитивному типу данных, тогда он определяется с помощью реализации ли Array объект является массивом того примитивного типа данных или массивом Object.
    Отметьте: драйвер JDBC ответственен за отображение элементов Object выстройте к значению по умолчанию тип SQL JDBC, определенный в java.sql. Типы для данного class Object. Отображение значения по умолчанию определяется в Приложении B спецификации JDBC. Если получающийся тип JDBC не является соответствующим типом для данного имени типа тогда, это - реализация, определенная ли SQLException бросается или драйвер поддерживает получающееся преобразование.
    
    Параметры:
    
    typeName - имя SQL типа элементы массива отображается на. Имя типа является специфичным для базы данных именем, которое может быть именем встроенного типа, определяемого пользователем типа или стандартного типа SQL, поддерживаемого этой базой данных. Это - значение, возвращенное Array.getBaseTypeName
    
    elements - элементы, которые заполняют возвращенный объект
    
    Возвраты:
    
    объект Массива, элементы которого отображаются на указанный тип SQL
    
    Броски:
    
    SQLException - если ошибка базы данных происходит, тип JDBC не является подходящим для имени типа, и преобразование не поддерживается, имя типа является нулем, или этот метод вызывают на закрытом соединении
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот тип данных
    
    С тех пор:
    
    1.6
  - createStruct
```
Struct createStruct(String typeName,
                    Object[] attributes)
             throws SQLException
```
    Метод фабрики для того, чтобы создать объекты Стракта.
    
    Параметры:
    
    typeName - имя типа SQL SQL структурированный тип, что это Struct возразите отображается на. Имя типа является именем определяемого пользователем типа, который был определен для этой базы данных. Это - значение, возвращенное Struct.getSQLTypeName.
    
    attributes - атрибуты, которые заполняют возвращенный объект
    
    Возвраты:
    
    Struct возражает, что карты к данному SQL вводят, и заполняется с данными атрибутами
    
    Броски:
    
    SQLException - если ошибка базы данных происходит, имя типа является нулем, или этот метод вызывают на закрытом соединении
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот тип данных
    
    С тех пор:
    
    1.6
  - setSchema
```
void setSchema(String schema)
        throws SQLException
```
    Определяет данное имя схемы к доступу.
    Если драйвер не будет поддерживать схемы, то он тихо проигнорирует этот запрос.
    Вызов setSchema не имеет никакого эффекта на ранее создаваемый или готовом Statement объекты. Это - реализация, определенная, готовится ли DBMS, работа сразу имеет место когда Connection метод prepareStatement или prepareCall вызывается. Для максимальной мобильности, setSchema должен быть вызван прежде a Statement создается или готовится.
    
    Параметры:
    
    schema - имя схемы, в которой можно работать
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
    
    С тех пор:
    
    1.7
    
    См. Также:
    
    getSchema()
  - getSchema
```
String getSchema()
          throws SQLException
```
    Получает это Connection текущее имя схемы объекта.
    
    Возвраты:
    
    текущее имя схемы или null если нет ни одного
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении
    
    С тех пор:
    
    1.7
    
    См. Также:
    
    setSchema(java.lang.String)
  - аварийное прекращение работы
```
void abort(Executor executor)
    throws SQLException
```
    Завершает открытое соединение. Вызов abort результаты в:
    - Соединение, отмеченное как закрыто
    - Завершения любое физическое соединение с базой данных
    - Высвобождает средства, используемые соединением
    - Обеспечивает, чтобы любой поток, который в настоящий момент получает доступ к соединению, или прогрессировал до завершения или бросил SQLException.
    Вызов abort отмечает закрытое соединение и высвобождает любые средства. Вызов abort на закрытом соединении нет.
    Возможно, что прерывание и выпуск ресурсов, которые сохранены соединением, могут взять длительный период времени. Когда abort возвраты метода, соединение будет отмечено как закрыто и Executor это передали в качестве параметра, чтобы прерваться, может все еще выполнять задачи высвободить средства.
    Эти проверки метода, чтобы видеть, что есть SQLPermission объект прежде, чем позволить методу продолжаться. Если a SecurityManager существует и checkPermission метод отрицает вызывать abort, этот метод бросает a java.lang.SecurityException.
    Параметры:
    
    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
```
    Устанавливает максимальный период a Connection или объекты, создаваемые из Connection будет ожидать базы данных, чтобы ответить на любой запрос. Если какой-либо запрос останется оставшимся без ответа, то метод ожидания возвратится с a SQLException, и Connection или объекты, создаваемые из Connection будет отмечен как закрыто. Любое последующее использование объектов, за исключением close, isClosed или Connection.isValid методы, приведет к a SQLException.
    Отметьте: Этот метод предназначается, чтобы адресовать редкое, но серьезное условие, где сетевые разделы могут заставить потоки, выпуская вызовы JDBC зависать непрерывно в чтениях сокета до ТАЙМ-АУТА TCP ОС (обычно 10 минут). Этот метод связывается с abort() метод, который предоставляет администратору, распараллеливает средство освободить любые такие потоки в случаях, где соединение JDBC доступно для потока администратора. setNetworkTimeout метод покроет случаи, где нет никакого потока администратора, или у него нет никакого доступа к соединению. Этот метод серьезен в, это - эффекты, и должно быть дано достаточно высокое значение, таким образом, это никогда не инициировано прежде больше нормальные тайм-ауты, такие как тайм-ауты транзакции.
    Реализации драйвера JDBC могут также хотеть поддерживать setNetworkTimeout метод, чтобы наложить предел на время отклика базы данных, в средах, где никакая сеть не присутствует.
    Драйверы могут внутренне реализовать некоторых или все их вызовы API с многократными внутренними передачами базы данных драйвера, и это оставляют реализации драйвера определить, будет ли предел всегда применяться к ответу на вызов API, или на какую-либо единственную просьбу, обращенную во время вызова API.
    Этот метод может быть вызван не раз, такой относительно установленного предел для области кода JDBC, и сбрасывать к значению по умолчанию на выходе от этой области. Вызов этого метода не оказывает влияния на уже выдающиеся запросы.
    Statement.setQueryTimeout() значение тайм-аута независимо от значения тайм-аута, определенного в setNetworkTimeout. Если тайм-аут запроса истечет то перед сетевым тайм-аутом тогда будет отменено выполнение оператора. Если сеть будет все еще активной, то результат будет состоять в том, что и оператор и соединение все еще применимы. Однако, если сетевой тайм-аут истечет перед тайм-аутом запроса или если тайм-аут оператора перестанет работать из-за сетевых проблем, то соединение будет отмечено как закрыто, любые средства, сохраненные соединением, будут высвобождены, и и соединение и оператор будут неприменимы.
    Когда драйвер решает что setNetworkTimeout значение тайм-аута истекло, драйвер JDBC отмечает закрытое соединение и высвобождает любые средства, сохраненные соединением.
    Эти проверки метода, чтобы видеть, что есть SQLPermission объект прежде, чем позволить методу продолжаться. Если a SecurityManager существует и checkPermission метод отрицает вызывать setNetworkTimeout, этот метод бросает a java.lang.SecurityException.
    
    Параметры:
    
    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
```
    Получает число миллисекунд, которые драйвер будет ожидать запроса к базе данных, чтобы завершить. Если предел превышается, a SQLException бросается.
    
    Возвраты:
    
    текущий тайм-аут ограничивает в миллисекундах; обнулите означает, что нет никакого предела
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом Connection
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    
    С тех пор:
    
    1.7
    
    См. Также:
    
    setNetworkTimeout(java.util.concurrent.Executor, int)

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Соединение интерфейса

Полевая Сводка

Сводка метода

Методы, наследованные от интерфейса java.sql. Обертка

Полевая Деталь

TRANSACTION_NONE

TRANSACTION_READ_UNCOMMITTED

TRANSACTION_READ_COMMITTED

TRANSACTION_REPEATABLE_READ

TRANSACTION_SERIALIZABLE

Деталь метода

createStatement

prepareStatement

prepareCall

nativeSQL

setAutoCommit

getAutoCommit

фиксация

откат

близко

isClosed

getMetaData

setReadOnly

isReadOnly

setCatalog

getCatalog

setTransactionIsolation

getTransactionIsolation

getWarnings

clearWarnings

createStatement

prepareStatement

prepareCall

getTypeMap

setTypeMap

setHoldability

getHoldability

setSavepoint

setSavepoint

откат

releaseSavepoint

createStatement

prepareStatement

prepareCall

prepareStatement

prepareStatement

prepareStatement

createClob

createBlob

createNClob

createSQLXML

isValid

setClientInfo

setClientInfo

getClientInfo

getClientInfo

createArrayOf

createStruct

setSchema

getSchema

аварийное прекращение работы

setNetworkTimeout

getNetworkTimeout