Spec-Zone .ru
спецификации, руководства, описания, API
|
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 на обозначенный класс. Если не будет никакой записи, то UDT будет отображен, используя стандартное отображение.
Пользователь может создать новую карту типа, которая является a 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);
Модификатор и Тип | Поле и Описание |
---|---|
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 объект. |
isWrapperFor, unwrap
static final int TRANSACTION_NONE
static final int TRANSACTION_READ_UNCOMMITTED
static final int TRANSACTION_READ_COMMITTED
static final int TRANSACTION_REPEATABLE_READ
static final int TRANSACTION_SERIALIZABLE
TRANSACTION_REPEATABLE_READ
и далее запрещает ситуацию, где одна транзакция читает все строки, которые удовлетворяют a WHERE
условие, вторая транзакция вставляет строку, которая удовлетворяет это WHERE
условие, и первая транзакция перечитывают для того же самого условия, получая дополнительную "фантомную" строку во втором чтении.Statement createStatement() throws SQLException
Statement
объект для того, чтобы отправить SQL-операторы базе данных. SQL-операторы без параметров обычно выполняются, используя Statement
объекты. Если тот же самый SQL-оператор выполняется много раз, может быть более эффективно использовать a PreparedStatement
объект. Наборы результатов создали использование возвращенного Statement
объект по умолчанию будет типом TYPE_FORWARD_ONLY
и имейте уровень параллелизма CONCUR_READ_ONLY
. holdability создаваемых наборов результатов может быть определен, вызывая getHoldability()
.
Statement
объектSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединенииPreparedStatement prepareStatement(String sql) throws SQLException
PreparedStatement
объект для того, чтобы отправить параметризованные SQL-операторы базе данных. SQL-оператор с или без В параметрах может быть предварительно скомпилирован и сохранен в a PreparedStatement
объект. Этот объект может тогда использоваться, чтобы эффективно выполнить этот оператор многократно.
Отметьте: Этот метод оптимизируется для того, чтобы обработать параметрические SQL-операторы то преимущество от предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement
отправит оператор базе данных для предварительной компиляции. Некоторые драйверы, возможно, не поддерживают предварительную компиляцию. В этом случае оператор не может быть отправлен базе данных до PreparedStatement
объект выполняется. Это не оказывает прямого влияния на пользователей; однако, это действительно влияет который бесспорный бросок методов SQLException
объекты.
Наборы результатов создали использование возвращенного PreparedStatement
объект по умолчанию будет типом TYPE_FORWARD_ONLY
и имейте уровень параллелизма CONCUR_READ_ONLY
. holdability создаваемых наборов результатов может быть определен, вызывая getHoldability()
.
sql
- SQL-оператор, который может содержать один или более'?' В заполнителях параметраPreparedStatement
объект, содержащий предварительно скомпилированный SQL-операторSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединенииCallableStatement prepareCall(String sql) throws SQLException
CallableStatement
объект для того, чтобы вызвать хранимые процедуры базы данных. CallableStatement
объект обеспечивает методы для того, чтобы они установили В и параметры, и методы для того, чтобы выполнить звонок в хранимую процедуру. Отметьте: Этот метод оптимизируется для того, чтобы обработать операторы вызова хранимой процедуры. Некоторые драйверы могут отправить оператор вызова базе данных когда метод prepareCall
делается; другие могут ожидать до CallableStatement
объект выполняется. Это не оказывает прямого влияния на пользователей; однако, это действительно влияет, какой метод бросает определенный SQLExceptions.
Наборы результатов создали использование возвращенного CallableStatement
объект по умолчанию будет типом TYPE_FORWARD_ONLY
и имейте уровень параллелизма CONCUR_READ_ONLY
. holdability создаваемых наборов результатов может быть определен, вызывая getHoldability()
.
sql
- SQL-оператор, который может содержать один или более'?' заполнители параметра. Обычно этот оператор определяется, используя синтаксис escape вызова JDBC.CallableStatement
объект, содержащий предварительно скомпилированный SQL-операторSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединенииString nativeSQL(String sql) throws SQLException
sql
- SQL-оператор, который может содержать один или более'?' заполнители параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединенииvoid setAutoCommit(boolean autoCommit) throws SQLException
commit
или метод rollback
. По умолчанию новые соединения находятся в режиме автоматической фиксации. Фиксация происходит, когда оператор завершается. Время, когда оператор завершается, зависит от типа SQL-оператора:
CallableStatement
объекты или для операторов, которые возвращают многократные результаты, оператор, полны, когда все связанные наборы результатов были закрыты, и все количества обновления и выходные параметры были получены.
ОТМЕТЬТЕ: Если этот метод вызывают во время транзакции, и режим автоматической фиксации изменяется, транзакция фиксируется. Если setAutoCommit
вызывается и режим автоматической фиксации не изменяется, вызов нет.
autoCommit
- true
включать режиму автоматической фиксации; false
отключить этоSQLException
- если ошибка доступа к базе данных происходит, setAutoCommit (истина) вызывается, участвуя в распределенной транзакции, или этот метод вызывают на закрытом соединении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, если ошибка доступа к базе данных происходитboolean isClosed() throws SQLException
Connection
объект был закрыт. Соединение закрывается если метод close
был вызван на этом или если определенные фатальные ошибки произошли. Этот метод, как гарантируют, возвратится true
только, когда это вызывают после метода Connection.close
был вызван. Этот метод обычно нельзя вызвать, чтобы определить, допустимо ли соединение с базой данных или недопустимо. Типичный клиент может решить, что соединение недопустимо, ловя любые исключения, которые могли бы быть выданы, когда работа предпринимается.
true
если это Connection
объект закрывается; false
если это все еще открытоSQLException
- если ошибка доступа к базе данных происходитDatabaseMetaData getMetaData() throws SQLException
DatabaseMetaData
объект, который содержит метаданные о базе данных к который это Connection
объект представляет соединение. Метаданные включают информацию о таблицах базы данных, ее поддерживаемой грамматике SQL, ее хранимых процедурах, возможностях этого соединения, и так далее.DatabaseMetaData
объект для этого Connection
объектSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединенииvoid setReadOnly(boolean readOnly) throws SQLException
Отметьте: Этот метод нельзя вызвать во время транзакции.
readOnly
- true
режим только для чтения включений; false
отключения этоSQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом соединении, или этот метод вызывают во время транзакцииboolean isReadOnly() throws SQLException
Connection
объект находится в режиме только для чтения.true
если это Connection
объект только для чтения; false
иначеSQLException
- SQLException, если ошибка доступа к базе данных происходит или этот метод, вызывают на закрытом соединенииvoid setCatalog(String catalog) throws SQLException
Connection
база данных объекта, в которой можно работать. Если драйвер не будет поддерживать каталоги, то он тихо проигнорирует этот запрос.
Вызов setCatalog
не имеет никакого эффекта на ранее создаваемый или готовом Statement
объекты. Это - реализация, определенная, готовится ли DBMS, работа сразу имеет место когда Connection
метод prepareStatement
или prepareCall
вызывается. Для максимальной мобильности, setCatalog
должен быть вызван прежде a Statement
создается или готовится.
catalog
- имя каталога (подпространство в этом Connection
база данных объекта), в котором можно работатьSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединенииgetCatalog()
String getCatalog() throws SQLException
Connection
текущее имя каталога объекта.null
если нет ни одногоSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединенииsetCatalog(java.lang.String)
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()
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)
SQLWarning getWarnings() throws SQLException
Connection
объект. Если будет больше чем одно предупреждение, то последующие предупреждения будут объединены в цепочку к первому и могут быть получены, вызывая метод SQLWarning.getNextWarning
на предупреждении, которое было получено ранее. Этот метод нельзя вызвать на закрытом соединении; выполнение так вызовет SQLException
быть брошенным.
Отметьте: Последующие предупреждения будут объединены в цепочку к этому SQLWarning.
SQLWarning
объект или null
если нет ни одногоSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединенииSQLWarning
void clearWarnings() throws SQLException
Connection
объект. После звонка в этот метод, метод getWarnings
возвраты null
пока о новом предупреждении не сообщают для этого Connection
объект.SQLException
- SQLException, если ошибка доступа к базе данных происходит или этот метод, вызывают на закрытом соединенииStatement createStatement(int resultSetType, int resultSetConcurrency) throws SQLException
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 не поддерживает этот метод, или этот метод не поддерживается для указанного типа набора результатов и параллелизма набора результатов.PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency) throws SQLException
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
ResultSet
объекты с данным типом и параллелизмомSQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом соединении, или данные параметры не ResultSet
константы, указывающие на тип и параллелизмSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот метод, или этот метод не поддерживается для указанного типа набора результатов и параллелизма набора результатов.CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency) throws SQLException
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 не поддерживает этот метод, или этот метод не поддерживается для указанного типа набора результатов и параллелизма набора результатов.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 не поддерживает этот методsetTypeMap(java.util.Map<java.lang.String, java.lang.Class<?>>)
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 не поддерживает этот методgetTypeMap()
void setHoldability(int holdability) throws SQLException
ResultSet
объекты создали использование этого Connection
возразите против данного holdability. Значение по умолчанию holdability ResultSet
объекты могут быть быть определенными, вызывая DatabaseMetaData.getResultSetHoldability()
.holdability
- a ResultSet
постоянный holdability; один из ResultSet.HOLD_CURSORS_OVER_COMMIT
или ResultSet.CLOSE_CURSORS_AT_COMMIT
SQLException
- если доступ к базе данных происходит, этот метод вызывают на закрытом соединении, или данный параметр не является a ResultSet
постоянное указание holdabilitySQLFeatureNotSupportedException
- если данный holdability не поддерживаетсяgetHoldability()
, DatabaseMetaData.getResultSetHoldability()
, ResultSet
int getHoldability() throws SQLException
ResultSet
объекты создали использование этого Connection
объект.ResultSet.HOLD_CURSORS_OVER_COMMIT
или ResultSet.CLOSE_CURSORS_AT_COMMIT
SQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединенииsetHoldability(int)
, DatabaseMetaData.getResultSetHoldability()
, ResultSet
Savepoint setSavepoint() throws SQLException
Savepoint
объект, который представляет это. если setSavepoint будет вызван за пределами активной транзакции, то транзакция будет запущена в этой недавно создаваемой точке сохранения.
Savepoint
объектSQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают, участвуя в распределенной транзакции, этот метод вызывают на закрытом соединении или этом Connection
объект находится в настоящий момент в режиме автоматической фиксацииSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методSavepoint
Savepoint setSavepoint(String name) throws SQLException
Savepoint
объект, который представляет это. если setSavepoint будет вызван за пределами активной транзакции, то транзакция будет запущена в этой недавно создаваемой точке сохранения.
name
- a String
содержа имя точки сохраненияSavepoint
объектSQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают, участвуя в распределенной транзакции, этот метод вызывают на закрытом соединении или этом Connection
объект находится в настоящий момент в режиме автоматической фиксацииSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методSavepoint
void rollback(Savepoint savepoint) throws SQLException
Savepoint
объект был установлен. Этот метод должен использоваться только, когда автоматическая фиксация была отключена.
savepoint
- Savepoint
объект откатывать кSQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают, участвуя в распределенной транзакции, этот метод вызывают на закрытом соединении, Savepoint
объект больше не действителен, или это Connection
объект находится в настоящий момент в режиме автоматической фиксацииSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методSavepoint
, rollback()
void releaseSavepoint(Savepoint savepoint) throws SQLException
Savepoint
и последующий Savepoint
объекты от текущей транзакции. Любая ссылка на точку сохранения после этого была удалена, вызовет SQLException
быть брошенным.savepoint
- Savepoint
объект, который будет удаленSQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом соединении или данном Savepoint
объект не является допустимой точкой сохранения в текущей транзакцииSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методStatement createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException
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
объекты с данным типом, параллелизмом, и holdabilitySQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом соединении, или данные параметры не ResultSet
константы, указывающие на тип, параллелизм, и holdabilitySQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот метод, или этот метод не поддерживается для указанного типа набора результатов, набор результатов holdability и параллелизм набора результатов.ResultSet
PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException
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
объекты с данным типом, параллелизмом, и holdabilitySQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом соединении, или данные параметры не ResultSet
константы, указывающие на тип, параллелизм, и holdabilitySQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот метод, или этот метод не поддерживается для указанного типа набора результатов, набор результатов holdability и параллелизм набора результатов.ResultSet
CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException
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
объекты с данным типом, параллелизмом, и holdabilitySQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом соединении, или данные параметры не ResultSet
константы, указывающие на тип, параллелизм, и holdabilitySQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот метод, или этот метод не поддерживается для указанного типа набора результатов, набор результатов holdability и параллелизм набора результатов.ResultSet
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_KEYSPreparedStatement 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 не поддерживает этот метод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 не поддерживает этот методClob createClob() throws SQLException
Clob
интерфейс. Объект, возвращенный первоначально, не содержит данных. setAsciiStream
, setCharacterStream
и setString
методы Clob
интерфейс может использоваться, чтобы добавить данные к Clob
.Clob
интерфейсSQLException
- если объект, который реализует Clob
интерфейс не может быть создан, этот метод вызывают на закрытом соединении, или ошибка доступа к базе данных происходит.SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот тип данныхBlob createBlob() throws SQLException
Blob
интерфейс. Объект, возвращенный первоначально, не содержит данных. setBinaryStream
и setBytes
методы Blob
интерфейс может использоваться, чтобы добавить данные к Blob
.Blob
интерфейсSQLException
- если объект, который реализует Blob
интерфейс не может быть создан, этот метод вызывают на закрытом соединении, или ошибка доступа к базе данных происходит.SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот тип данныхNClob createNClob() throws SQLException
NClob
интерфейс. Объект, возвращенный первоначально, не содержит данных. setAsciiStream
, setCharacterStream
и setString
методы NClob
интерфейс может использоваться, чтобы добавить данные к NClob
.NClob
интерфейсSQLException
- если объект, который реализует NClob
интерфейс не может быть создан, этот метод вызывают на закрытом соединении, или ошибка доступа к базе данных происходит.SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот тип данныхSQLXML createSQLXML() throws SQLException
SQLXML
интерфейс. Объект, возвращенный первоначально, не содержит данных. createXmlStreamWriter
объект и setString
метод SQLXML
интерфейс может использоваться, чтобы добавить данные к SQLXML
объект.SQLXML
интерфейсSQLException
- если объект, который реализует SQLXML
интерфейс не может быть создан, этот метод вызывают на закрытом соединении, или ошибка доступа к базе данных происходит.SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот тип данныхboolean isValid(int timeout) throws SQLException
Запрос, представленный драйвером, чтобы проверить соединения, должен выполняться в контексте текущей транзакции.
timeout
- Время в секундах, чтобы ожидать работы базы данных, используемой, чтобы проверить соединения, чтобы завершиться. Если период тайм-аута истекает прежде, чем работа завершается, этот метод возвращает false. Значение 0 указывает, что тайм-аут не применяется к работе базы данных. SQLException
- если значение, предоставленное для timeout
менее тогда 0DatabaseMetaData.getClientInfoProperties()
void setClientInfo(String name, String value) throws SQLClientInfoException
Приложения могут использовать DatabaseMetaData.getClientInfoProperties
метод, чтобы определить клиентские свойства информации, поддерживаемые драйвером и максимальной длиной, которая может быть определена для каждого свойства.
Драйвер хранит значение, определенное в подходящем расположении в базе данных. Например в специальном регистре, параметре сеанса, или столбце системной таблицы. Для эффективности драйвер может задержать установку значения в базе данных до следующего раза, когда оператор выполняется или готовится. Кроме того, чтобы хранить клиентскую информацию в соответствующем месте в базе данных, эти методы не должны изменять поведение соединения в так или иначе. Значения, предоставленные этим методам, используются для учета, диагностики и отладки целей только.
Драйвер должен генерировать предупреждение, если клиентское определенное имя информации не будет распознано драйвером.
Если значение, определенное к этому методу, больше чем максимальная длина для свойства, драйвер может или усечь значение и генерировать предупреждение или генерировать a SQLClientInfoException
. Если драйвер генерирует a SQLClientInfoException
, определенное значение не было установлено на соединении.
Следующее является стандартными клиентскими свойствами информации. Драйверы не обязаны поддерживать эти свойства однако, если драйвер поддерживает клиентское свойство информации, которое может быть описано одним из стандартных свойств, стандартное имя свойства должно использоваться.
name
- Имя клиентского свойства информации, чтобы установитьvalue
- Значение, чтобы установить клиентское свойство информации в. Если значение является нулем, текущая стоимость указанного свойства очищается. SQLClientInfoException
- если сервер базы данных возвращает ошибку, устанавливая клиентское значение информации на сервере базы данных, или этот метод вызывают на закрытом соединении void setClientInfo(Properties properties) throws SQLClientInfoException
Properties
объект содержит имена и значения клиентских свойств информации, которые будут установлены. Набор клиентских свойств информации, содержавшихся в списке свойств, заменяет текущий набор клиентских свойств информации на соединении. Если свойство, которое в настоящий момент устанавливается на соединении, не присутствует в списке свойств, то свойство очищается. Определение пустого списка свойств очистит все свойства на соединении. См. setClientInfo (String, String)
для получения дополнительной информации. Если ошибка происходит в установке какого-либо из клиентских свойств информации, a SQLClientInfoException
бросается. SQLClientInfoException
содержит информацию, указывающую, какие клиентские свойства информации не были установлены. Состояние информации о клиенте неизвестно, потому что некоторые базы данных не позволяют многократным клиентским свойствам информации быть установленными атомарно. Для тех баз данных, возможно, были установлены одно или более свойств прежде, чем ошибка произошла.
properties
- список клиентских свойств информации, чтобы установить SQLClientInfoException
- если сервер базы данных возвращает ошибку, устанавливая значения clientInfo на сервере базы данных, или этот метод вызывают на закрытом соединении setClientInfo(String, String)
String getClientInfo(String name) throws SQLException
Приложения могут использовать DatabaseMetaData.getClientInfoProperties
метод, чтобы определить клиентские свойства информации, поддерживаемые драйвером.
name
- Имя клиентского свойства информации, чтобы получить SQLException
- если сервер базы данных возвращает ошибку, выбирая клиентское значение информации от базы данных, или этот метод вызывают на закрытом соединении DatabaseMetaData.getClientInfoProperties()
Properties getClientInfo() throws SQLException
Properties
объект, который содержит имя и текущую стоимость каждого из клиентских свойств информации, поддерживаемых драйвером. SQLException
- если сервер базы данных возвращает ошибку, выбирая клиентские значения информации от базы данных, или этот метод вызывают на закрытом соединении Array createArrayOf(String typeName, Object[] elements) throws SQLException
Отметьте: Когда createArrayOf
используется, чтобы создать объект массива, что карты к примитивному типу данных, тогда он определяется с помощью реализации ли Array
объект является массивом того примитивного типа данных или массивом Object
.
Отметьте: драйвер JDBC ответственен за отображение элементов Object
выстройте к типу SQL JDBC по умолчанию, определенному в java.sql. Типы для данного класса Object
. Отображение по умолчанию определяется в Приложении B спецификации JDBC. Если получающийся тип JDBC не является соответствующим типом для данного имени типа тогда, это - реализация, определенная ли SQLException
бросается или драйвер поддерживает получающееся преобразование.
typeName
- имя SQL типа элементы массива отображается на. Имя типа является специфичным для базы данных именем, которое может быть именем встроенного типа, определяемого пользователем типа или стандартного типа SQL, поддерживаемого этой базой данных. Это - значение, возвращенное Array.getBaseTypeName
elements
- элементы, которые заполняют возвращенный объектSQLException
- если ошибка базы данных происходит, тип JDBC не является подходящим для имени типа, и преобразование не поддерживается, имя типа является нулем, или этот метод вызывают на закрытом соединенииSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот тип данныхStruct createStruct(String typeName, Object[] attributes) throws SQLException
typeName
- имя типа SQL SQL структурированный тип, что это Struct
возразите отображается на. Имя типа является именем определяемого пользователем типа, который был определен для этой базы данных. Это - значение, возвращенное Struct.getSQLTypeName
.attributes
- атрибуты, которые заполняют возвращенный объектSQLException
- если ошибка базы данных происходит, имя типа является нулем, или этот метод вызывают на закрытом соединенииSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот тип данныхvoid setSchema(String schema) throws SQLException
Если драйвер не будет поддерживать схемы, то он тихо проигнорирует этот запрос.
Вызов setSchema
не имеет никакого эффекта на ранее создаваемый или готовом Statement
объекты. Это - реализация, определенная, готовится ли DBMS, работа сразу имеет место когда Connection
метод prepareStatement
или prepareCall
вызывается. Для максимальной мобильности, setSchema
должен быть вызван прежде a Statement
создается или готовится.
schema
- имя схемы, в которой можно работатьSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединенииgetSchema()
String getSchema() throws SQLException
Connection
текущее имя схемы объекта.null
если нет ни одногоSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом соединении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
SecurityManager.checkPermission(java.security.Permission)
, Executor
void setNetworkTimeout(Executor executor, int milliseconds) throws SQLException
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 не поддерживает этот методSecurityManager.checkPermission(java.security.Permission)
, Statement.setQueryTimeout(int)
, getNetworkTimeout()
, abort(java.util.concurrent.Executor)
, Executor
int getNetworkTimeout() throws SQLException
SQLException
бросается.SQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом Connection
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методsetNetworkTimeout(java.util.concurrent.Executor, int)
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.