Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class BaseRowSet extends Object implements Serializable, Cloneable
RowSet
объект с его основной функциональностью. Основные функции включают свойства наличия и отправку уведомлений о событии, которые должны реализовать все компоненты JavaBeansTM.
BaseRowSet
класс обеспечивает базовую функциональность для всех RowSet
реализации, и все стандартные реализации могут использовать этот класс в комбинации с один или больше RowSet
интерфейсы, чтобы обеспечить стандартную специфичную для поставщика реализацию. Чтобы разъясниться, все реализации должны реализовать по крайней мере один из RowSet
интерфейсы (JdbcRowSet
, CachedRowSet
, JoinRowSet
, FilteredRowSet
, или WebRowSet
). Это означает, что любая реализация, которая расширяется BaseRowSet
класс должен также реализовать один из RowSet
интерфейсы. BaseRowSet
класс обеспечивает следующее:
RowSet
команда объекта
RowSet
реализация делает и как это получает свои данные. Например, наборы строк, которые получают их данные от a ResultSet
возразите должен установить свойства, которые требуются для того, чтобы сделать соединение с базой данных. Если a RowSet
возразите использует DriverManager
средство, чтобы сделать соединение, это должно установить свойство для URL JDBC, который идентифицирует соответствующий драйвер, и это должно установить свойства, которые дают имя пользователя и пароль. Если с другой стороны набор строк использует a DataSource
объект сделать соединение, которое является привилегированным методом, он не должен установить свойство для URL JDBC. Вместо этого это должно установить свойство для логического имени источника данных наряду со свойствами для имени пользователя и пароля. ОТМЕТЬТЕ: Чтобы использовать a DataSource
объект для того, чтобы сделать соединение, DataSource
объект, должно быть, был зарегистрирован в службе именования, которая использует Именование Java и Каталог InterfaceTM (JNDI) API. Эта регистрация обычно делается человеком, действующим от лица системного администратора.
ResultSet
объект. Этот запрос является командой, которая устанавливается для RowSet
свойство команды объекта. Набор строк заполняет себя с данными, читая данные из ResultSet
объект в себя. Если запрос содержит заполнителей для значений, которые будут установлены, BaseRowSet
методы метода set используются, чтобы установить эти значения. Все методы метода set позволяют этим значениям быть установленными в null
если требующийся. Следующий фрагмент кода иллюстрирует как CachedRowSet
Объект ТМ crs
мог бы иметь его набор свойств команды. Отметьте, что, если бы инструмент используется, чтобы установить свойства, это - код, который использовал бы инструмент.
crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" + "WHERE CREDIT_LIMIT > ? AND REGION = ?");
В этом примере, значениях для CREDIT_LIMIT
и REGION
параметры заполнителя, которые обозначаются с вопросительным знаком (?). Первый вопросительный знак является числом параметра заполнителя 1
, второй вопросительный знак является числом параметра заполнителя 2
, и так далее. Любые параметры заполнителя должны быть установлены со значениями прежде, чем запрос сможет быть выполнен. Устанавливать эти параметры заполнителя, BaseRowSet
класс обеспечивает ряд методов метода set, подобных обеспеченным PreparedStatement
интерфейс, для того, чтобы установить значения каждого типа данных. A RowSet
объектно-ориентированные памяти параметр оценивают внутренне, и execute
метод использует их внутренне, чтобы установить значения для параметров заполнителя прежде, чем он отправит команду DBMS, который будет выполняться.
Следующий фрагмент кода демонстрирует, как устанавливать эти два параметров в запросе от предыдущего примера.
crs.setInt(1, 5000); crs.setString(2, "West");Если
execute
метод вызывают в этой точке, запрос, отправленный DBMS, будет: "SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" + "WHERE CREDIT_LIMIT > 5000 AND REGION = 'West'"ОТМЕТЬТЕ: Установка
Array
, Clob
, Blob
и Ref
объекты как параметр команды, хранит эти значения как SerialArray
, SerialClob
, SerialBlob
и SerialRef
объекты соответственно. BaseRowSet
класс обеспечивает два вида методов метода set, те, которые устанавливают свойства и тех, которые устанавливают параметры заполнителя. Методы метода set, обсужденные в этом разделе, являются теми, которые устанавливают параметры заполнителя. Набор параметров заполнителя с BaseRowSet
методы метода set сохранены как объекты во внутреннем Hashtable
объект. Примитивы сохранены как их Object
ввести. Например, byte
сохранен как Byte
объект, и int
сохранен как Integer
объект. Когда метод execute
вызывается, значения в Hashtable
объектом заменяют соответствующие параметры заполнителя в команде.
Звонок в метод getParams
возвращает значения, сохраненные в Hashtable
возразите как массив Object
экземпляры. Элемент в этом массиве может быть простым Object
экземпляр или массив (который является типом Object
). Определенный используемый метод метода set определяет, является ли элемент в этом массиве Object
или массив.
Большинство методов для того, чтобы установить параметры заполнителя берет два параметра с первым параметром, указывающим, какие параметры заполнителя должны быть установлены, и второй параметр, дающий значение, которое будет установлено. Методы такой как setInt
, setString
, setBoolean
, и setLong
попадите в эту категорию. После того, как эти методы вызвали, звонок в метод getParams
возвратит массив со значениями, которые были установлены. Каждый элемент в массиве Object
экземпляр, представляющий значения, которые были установлены. Порядок этих значений в массиве определяется int
(первый параметр), передал к методу метода set. Значения в массиве являются значениями (второй параметр) передал к методу метода set. Другими словами первый элемент в массиве является значением, которое будет установлено для первого параметра заполнителя в RowSet
команда объекта. Второй элемент является значением, которое будет установлено для второго параметра заполнителя и так далее.
Несколько методов метода set отправляют драйвер и информацию о DBMS вне значения, которое будет установлено. Когда метод getParams
вызывается после того, как один из этих методов метода set использовался, элементы в массиве самостоятельно будут массивами, чтобы разместить дополнительную информацию. В этой категории, методе setNull
особый случай, потому что одна версия берет только два параметра (setNull(int parameterIndex, int SqlType)
). Однако, это требует, чтобы массив содержал информацию, которую передадут к драйверу и DBMS. Первый элемент в этом массиве является значением, которое будет установлено, который является null
, и второй элемент int
предоставленный для sqlType, который указывает на тип значения SQL, которое устанавливается в null
. Эта информация необходима некоторому DBMSs и поэтому запрашивается, чтобы гарантировать, что приложения переносимы. Другая версия предназначается, чтобы использоваться когда значение, которое будет установлено в null
определяемый пользователем тип. Требуется три параметра (setNull(int parameterIndex, int sqlType, String typeName)
) и также требует, чтобы массив содержал информацию, которую передадут к драйверу и DBMS. Первые два элемента в этом массиве являются тем же самым что касается первой версии setNull
. Третий элемент, имя типа, дает имя SQL определяемого пользователем типа. Как истина с другими методами метода set, число параметра заполнителя, который будет установлен, обозначается позицией элемента в массиве, возвращенном getParams
. Так, например, если параметр, предоставленный setNull
2
, второй элемент в массиве, возвращенном getParams
будет массив двух или трех элементов.
Некоторые методы, такой как setObject
и setDate
имейте версии, которые берут больше чем два параметра с дополнительными параметрами, дающими информацию драйверу или DBMS. Например, методы setDate
, setTime
, и setTimestamp
может взять a Calendar
возразите как их третий параметр. Если DBMS не хранит информацию часового пояса, drivern использует Calendar
возразите, чтобы создать Date
, Time
, или Timestamp
устанавливаемый объект. Как истина с другими методами, которые обеспечивают дополнительную информацию, элемент в массиве, возвращенном getParams
массив вместо простого Object
экземпляр.
Методы setAsciiStream
, setBinaryStream
, setCharacterStream
, и setUnicodeStream
(который осуждается, таким образом, приложения должны использовать getCharacterStream
вместо этого), берут три параметра, таким образом, для них, элемента в массиве, возвращенном getParams
также массив. То, что является особенным в этих методах метода set, - то, что в дополнение к информации, предоставленной параметрами, массив содержит один из BaseRowSet
константы, указывающие на тип устанавливаемого потока.
ОТМЕТЬТЕ: метод getParams
вызывают внутренне RowSet
реализации, расширяющие этот класс; это обычно не вызывает прикладной программист непосредственно.
BaseRowSet
класс обеспечивает механизм уведомления о событии для наборов строк. Это содержит поле listeners
, методы для добавления и удаления слушателей, и методов для того, чтобы уведомить слушателей изменений. Слушатель является объектом, который реализовал RowSetListener
интерфейс. Если это было добавлено к a RowSet
список объекта слушателей, это будет уведомлено, когда событие будет иметь место на этом RowSet
объект. Реализация каждого слушателя RowSetListener
методы определяют то, что сделает тот объект, когда он будет уведомлен, что событие имело место.
Есть три возможных события для a RowSet
объект:
RowSet
объект изменяется BaseRowSet
метод, используемый для уведомления, указывает на тип события, которое произошло. Например, метод notifyRowChanged
указывает, что строка была обновлена, удалена, или вставлена. Каждый из методов уведомления создает a RowSetEvent
объект, который предоставляется слушателю, чтобы идентифицировать RowSet
объект, на котором событие имело место. То, что слушатель делает с этой информацией, которая может быть ничем, зависит от того, как она была реализована.
BaseRowSet
объект инициализируется со многими начальными значениями. Следующее верно для значения по умолчанию RowSet
экземпляр, который расширяется BaseRowSet
класс: RowSet
команда объекта. BINARY
, VARBINARY
, LONGVARBINARY
, CHAR
, VARCHAR
, и LONGVARCHAR
. null
. Vector
объект для того, чтобы сохранить набор значений для параметров заполнителя в RowSet
команда объекта. Если другие значения требуются, приложение должно установить значения свойств явно. Например, следующая строка кодовых наборов максимальное количество строк для CachedRowSet
возразите crs против 500.
crs.setMaxRows(500);Методы реализуются в расширениях этого
BaseRowSet
класс должен бросить SQLException
объект для любого нарушения определенных утверждений. Кроме того, если расширяющийся класс переопределяет и повторно реализует кого-либо BaseRowSet
метод и встречается со связью или базовыми проблемами источника данных, тот метод может, кроме того, бросить SQLException
объект по этой причине.Модификатор и Тип | Поле и Описание |
---|---|
static int |
ASCII_STREAM_PARAM
Постоянное указание к a
RowSetReaderImpl возразите, что данный параметр является потоком ASCII. |
protected InputStream |
asciiStream
InputStream объект, который будет возвращен методом getAsciiStream , который определяется в ResultSet интерфейс. |
static int |
BINARY_STREAM_PARAM
Постоянное указание к a
RowSetReaderImpl возразите, что данный параметр является двоичным потоком. |
protected InputStream |
binaryStream
InputStream объект, который будет возвращен методом getBinaryStream , который определяется в ResultSet интерфейс. |
protected Reader |
charStream
Reader объект, который будет возвращен методом getCharacterStream , который определяется в ResultSet интерфейс. |
static int |
UNICODE_STREAM_PARAM
Постоянное указание к a
RowSetReaderImpl возразите, что данный параметр является потоком Unicode. |
protected InputStream |
unicodeStream
InputStream объект, который будет возвращен методом getUnicodeStream , который определяется в ResultSet интерфейс. |
Конструктор и Описание |
---|
BaseRowSet()
Создает новое
BaseRowSet объект инициализируется со значением по умолчанию Vector объект для listeners поле. |
Модификатор и Тип | Метод и Описание |
---|---|
void |
addRowSetListener(RowSetListener listener)
Слушатель будет уведомлен всякий раз, когда событие имеет место на этом
RowSet объект. |
void |
clearParameters()
Очищает все текущие значения параметра в этом
RowSet внутреннее представление объекта параметров, которые будут установлены в этом RowSet команда объекта, когда это выполняется. |
Строка |
getCommand()
Получает SQL-запрос, который является командой для этого
RowSet объект. |
int |
getConcurrency()
Возвращает параллелизм для этого
RowSet объект. |
Строка |
getDataSourceName()
Возвращает логическое имя, которое когда предоставлено к службе именования, которая использует Интерфейс Именования и Каталога Java (JNDI) API, получит a
javax.sql.DataSource объект. |
boolean |
getEscapeProcessing()
Устанавливает, включается ли обработка escape для этого
RowSet объект. |
int |
getFetchDirection()
Получает это
RowSet ток объекта, устанавливающий для направления выборки. |
int |
getFetchSize()
Возвращает размер выборки для этого
RowSet объект. |
int |
getMaxFieldSize()
Получает максимальное количество байтов, которые могут использоваться для значения столбца в этом
RowSet объект. |
int |
getMaxRows()
Получает максимальное количество строк что это
RowSet объект может содержать. |
Объект[] |
getParams()
Получает массив, содержащий значения параметра (и Объекты и примитивы), которые были установлены для этого
RowSet команда объекта и броски SQLException возразите, не были ли все параметры установлены. |
Строка |
getPassword()
Возвращает пароль, используемый, чтобы создать соединение с базой данных для этого
RowSet объект. |
int |
getQueryTimeout()
Получает максимальное количество секунд, которые драйвер будет ожидать запроса, чтобы выполнить.
|
boolean |
getShowDeleted()
Получает a
boolean указание, появляются ли строки, отмеченные для удаления, в наборе текущих строк. |
int |
getTransactionIsolation()
Возвращает свойство изоляции транзакции для этого
RowSet соединение объекта. |
int |
getType()
Возвращает тип этого
RowSet объект. |
Map<String,Class<?>> |
getTypeMap()
Получает карту типа, связанную с
Connection объект для этого RowSet объект. |
Строка |
getUrl()
Получает URL JDBC что это
RowSet объект javax.sql.Reader возразите использованию, чтобы сделать соединение с реляционной базой данных, используя поддерживающий технологию драйвер JDBC. |
Строка |
getUsername()
Возвращает имя пользователя, используемое, чтобы создать соединение с базой данных.
|
protected void |
initParams()
Выполняет необходимые внутренние конфигурации и инициализации, чтобы позволить любой JDBC
RowSet реализация, чтобы начать использовать стандартные услуги, предоставленные a BaseRowSet экземпляр. |
boolean |
isReadOnly()
Возвраты a
boolean указание, ли это RowSet объект только для чтения. |
protected void |
notifyCursorMoved()
Уведомляет всех слушателей, зарегистрированных в этом
RowSet возразите, что его курсор переместился. |
protected void |
notifyRowChanged()
Уведомляет всех слушателей, зарегистрированных в этом
RowSet возразите, что одна из его строк изменилась. |
protected void |
notifyRowSetChanged()
Уведомляет всех слушателей, зарегистрированных в этом
RowSet возразите, что его все содержание изменилось. |
void |
removeRowSetListener(RowSetListener listener)
Удаляет определяемый объект из этого
RowSet список объекта слушателей. |
void |
setArray(int parameterIndex, Array array)
Устанавливает определяемые параметры к
Array объект в языке программирования Java. |
void |
setAsciiStream(int parameterIndex, InputStream x)
Устанавливает определяемые параметры в этом
RowSet команда объекта к данному входному потоку. |
void |
setAsciiStream(int parameterIndex, InputStream x, int length)
Устанавливает определяемые параметры к данному
java.io.InputStream объект, у которого будет конкретное количество байтов. |
void |
setAsciiStream(String parameterName, InputStream x)
Устанавливает определяемые параметры к данному входному потоку.
|
void |
setAsciiStream(String parameterName, InputStream x, int length)
Устанавливает определяемые параметры к данному входному потоку, у которого будет конкретное количество байтов.
|
void |
setBigDecimal(int parameterIndex, BigDecimal x)
Устанавливает определяемые параметры к данному
java.lang.BigDecimal значение. |
void |
setBigDecimal(String parameterName, BigDecimal x)
Устанавливает определяемые параметры к данному
java.math.BigDecimal значение. |
void |
setBinaryStream(int parameterIndex, InputStream x)
Устанавливает определяемые параметры в этом
RowSet команда объекта к данному входному потоку. |
void |
setBinaryStream(int parameterIndex, InputStream x, int length)
Устанавливает определяемые параметры к данному
java.io.InputStream объект, у которого будет конкретное количество байтов. |
void |
setBinaryStream(String parameterName, InputStream x)
Устанавливает определяемые параметры к данному входному потоку.
|
void |
setBinaryStream(String parameterName, InputStream x, int length)
Устанавливает определяемые параметры к данному входному потоку, у которого будет конкретное количество байтов.
|
void |
setBlob(int parameterIndex, Blob x)
Устанавливает определяемые параметры к данному
Blob объект в языке программирования Java. |
void |
setBlob(int parameterIndex, InputStream inputStream)
Устанавливает определяемые параметры к a
InputStream объект. |
void |
setBlob(int parameterIndex, InputStream inputStream, long length)
Устанавливает определяемые параметры к a
InputStream объект. |
void |
setBlob(String parameterName, Blob x)
Устанавливает определяемые параметры к данному
java.sql.Blob объект. |
void |
setBlob(String parameterName, InputStream inputStream)
Устанавливает определяемые параметры к a
InputStream объект. |
void |
setBlob(String parameterName, InputStream inputStream, long length)
Устанавливает определяемые параметры к a
InputStream объект. |
void |
setBoolean(int parameterIndex, boolean x)
Устанавливает определяемые параметры к данному
boolean в языке программирования Java. |
void |
setBoolean(String parameterName, boolean x)
Устанавливает определяемые параметры к данному Java
boolean значение. |
void |
setByte(int parameterIndex, byte x)
Устанавливает определяемые параметры к данному
byte в языке программирования Java. |
void |
setByte(String parameterName, byte x)
Устанавливает определяемые параметры к данному Java
byte значение. |
void |
setBytes(int parameterIndex, byte[] x)
Устанавливает определяемые параметры данному массиву байтов.
|
void |
setBytes(String parameterName, byte[] x)
Устанавливает определяемые параметры данному массиву Java байтов.
|
void |
setCharacterStream(int parameterIndex, Reader reader)
Устанавливает определяемые параметры в этом
RowSet команда объекта к данному Reader объект. |
void |
setCharacterStream(int parameterIndex, Reader reader, int length)
Устанавливает определяемые параметры к данному
java.io.Reader объект, у которого будет конкретное количество символов. |
void |
setCharacterStream(String parameterName, Reader reader)
Устанавливает определяемые параметры к данному
Reader объект. |
void |
setCharacterStream(String parameterName, Reader reader, int length)
Устанавливает определяемые параметры к данному
Reader объект, который является данным числом символов долго. |
void |
setClob(int parameterIndex, Clob x)
Устанавливает определяемые параметры к данному
Clob объект в языке программирования Java. |
void |
setClob(int parameterIndex, Reader reader)
Устанавливает определяемые параметры к a
Reader объект. |
void |
setClob(int parameterIndex, Reader reader, long length)
Устанавливает определяемые параметры к a
Reader объект. |
void |
setClob(String parameterName, Clob x)
Устанавливает определяемые параметры к данному
java.sql.Clob объект. |
void |
setClob(String parameterName, Reader reader)
Устанавливает определяемые параметры к a
Reader объект. |
void |
setClob(String parameterName, Reader reader, long length)
Устанавливает определяемые параметры к a
Reader объект. |
void |
setCommand(String cmd)
Наборы это
RowSet объект command свойство к данному String возразите и очищает параметры, если таковые вообще имеются, которые были установлены для предыдущей команды. |
void |
setConcurrency(int concurrency)
Устанавливает параллелизм для этого
RowSet возразите против указанного параллелизма. |
void |
setDataSourceName(String name)
Наборы
DataSource свойство имени для этого RowSet возразите против данного логического имени и наборов этому RowSet свойство Url объекта к null . |
void |
setDate(int parameterIndex, Date x)
Устанавливает определяемые параметры к данному
java.sql.Date значение. |
void |
setDate(int parameterIndex, Date x, Calendar cal)
Устанавливает определяемые параметры к данному
java.sql.Date объект. |
void |
setDate(String parameterName, Date x)
Устанавливает определяемые параметры к данному
java.sql.Date значение используя часовой пояс по умолчанию виртуальной машины, которая запускает приложение. |
void |
setDate(String parameterName, Date x, Calendar cal)
Устанавливает определяемые параметры к данному
java.sql.Date значение, используя данный Calendar объект. |
void |
setDouble(int parameterIndex, double x)
Устанавливает определяемые параметры к данному
double в языке программирования Java. |
void |
setDouble(String parameterName, double x)
Устанавливает определяемые параметры к данному Java
double значение. |
void |
setEscapeProcessing(boolean enable)
Наборы к данному
boolean отсканирует ли драйвер для синтаксиса escape и действительно выходит из замены прежде, чем отправить SQL-операторы базе данных. |
void |
setFetchDirection(int direction)
Дает драйверу подсказку производительности относительно направления в который строки в этом
RowSet объект будет обработан. |
void |
setFetchSize(int rows)
Устанавливает размер выборки для этого
RowSet возразите против данного числа строк. |
void |
setFloat(int parameterIndex, float x)
Устанавливает определяемые параметры к данному
float в языке программирования Java. |
void |
setFloat(String parameterName, float x)
Устанавливает определяемые параметры к данному Java
float значение. |
void |
setInt(int parameterIndex, int x)
Устанавливает определяемые параметры к
int в языке программирования Java. |
void |
setInt(String parameterName, int x)
Устанавливает определяемые параметры к данному Java
int значение. |
void |
setLong(int parameterIndex, long x)
Устанавливает определяемые параметры к данному
long в языке программирования Java. |
void |
setLong(String parameterName, long x)
Устанавливает определяемые параметры к данному Java
long значение. |
void |
setMaxFieldSize(int max)
Устанавливает максимальное количество байтов, которые могут использоваться для значения столбца в этом
RowSet возразите против данного числа. |
void |
setMaxRows(int max)
Устанавливает максимальное количество строк что это
RowSet объект может содержать к данному числу. |
void |
setNCharacterStream(int parameterIndex, Reader value)
Устанавливает определяемые параметры в этом
RowSet команда объекта к a Reader объект. |
void |
setNCharacterStream(int parameterIndex, Reader value, long length)
Устанавливает определяемые параметры к a
Reader объект. |
void |
setNCharacterStream(String parameterName, Reader value)
Устанавливает определяемые параметры к a
Reader объект. |
void |
setNCharacterStream(String parameterName, Reader value, long length)
Устанавливает определяемые параметры к a
Reader объект. |
void |
setNClob(int parameterIndex, NClob value)
Устанавливает определяемые параметры к a
java.sql.NClob объект. |
void |
setNClob(int parameterIndex, Reader reader)
Устанавливает определяемые параметры к a
Reader объект. |
void |
setNClob(int parameterIndex, Reader reader, long length)
Устанавливает определяемые параметры к a
Reader объект. |
void |
setNClob(String parameterName, NClob value)
Устанавливает определяемые параметры к a
java.sql.NClob объект. |
void |
setNClob(String parameterName, Reader reader)
Устанавливает определяемые параметры к a
Reader объект. |
void |
setNClob(String parameterName, Reader reader, long length)
Устанавливает определяемые параметры к a
Reader объект. |
void |
setNString(int parameterIndex, String value)
Устанавливает определяемый paramter в данный
String объект. |
void |
setNString(String parameterName, String value)
Устанавливает определяемый paramter в данный
String объект. |
void |
setNull(int parameterIndex, int sqlType)
Устанавливает определяемые параметры к SQL
NULL . |
void |
setNull(int parameterIndex, int sqlType, String typeName)
Устанавливает определяемые параметры к SQL
NULL . |
void |
setNull(String parameterName, int sqlType)
Устанавливает определяемые параметры к SQL
NULL . |
void |
setNull(String parameterName, int sqlType, String typeName)
Устанавливает определяемые параметры к SQL
NULL . |
void |
setObject(int parameterIndex, Object x)
Устанавливает определяемые параметры к
Object в языке программирования Java. |
void |
setObject(int parameterIndex, Object x, int targetSqlType)
Устанавливает значение определяемого параметра с данным
Object значение. |
void |
setObject(int parameterIndex, Object x, int targetSqlType, int scale)
Устанавливает определяемые параметры к
Object в языке программирования Java. |
void |
setObject(String parameterName, Object x)
Устанавливает значение определяемого параметра с данным объектом.
|
void |
setObject(String parameterName, Object x, int targetSqlType)
Устанавливает значение определяемого параметра с данным объектом.
|
void |
setObject(String parameterName, Object x, int targetSqlType, int scale)
Устанавливает значение определяемого параметра с данным объектом.
|
void |
setPassword(String pass)
Устанавливает пароль, используемый, чтобы создать соединение с базой данных для этого
RowSet возразите против данного String объект. |
void |
setQueryTimeout(int seconds)
Наборы к данному нумеруют максимальное количество секунд, которые драйвер будет ожидать запроса, чтобы выполнить.
|
void |
setReadOnly(boolean value)
Наборы это
RowSet свойство объекта только для чтения к данному boolean . |
void |
setRef(int parameterIndex, Ref ref)
Устанавливает определяемые параметры к данному
Ref объект в языке программирования Java. |
void |
setRowId(int parameterIndex, RowId x)
Устанавливает определяемые параметры к данному
java.sql.RowId объект. |
void |
setRowId(String parameterName, RowId x)
Устанавливает определяемые параметры к данному
java.sql.RowId объект. |
void |
setShort(int parameterIndex, short x)
Устанавливает определяемые параметры к данному
short в языке программирования Java. |
void |
setShort(String parameterName, short x)
Устанавливает определяемые параметры к данному Java
short значение. |
void |
setShowDeleted(boolean value)
Устанавливает свойство
showDeleted к данному boolean значение, которое определяет, появляются ли строки, отмеченные для удаления, в наборе текущих строк. |
void |
setSQLXML(int parameterIndex, SQLXML xmlObject)
Устанавливает определяемые параметры к данному
java.sql.SQLXML объект. |
void |
setSQLXML(String parameterName, SQLXML xmlObject)
Устанавливает определяемые параметры к данному
java.sql.SQLXML объект. |
void |
setString(int parameterIndex, String x)
Устанавливает определяемые параметры к данному
String значение. |
void |
setString(String parameterName, String x)
Устанавливает определяемые параметры к данному Java
String значение. |
void |
setTime(int parameterIndex, Time x)
Устанавливает определяемые параметры к данному
java.sql.Time значение. |
void |
setTime(int parameterIndex, Time x, Calendar cal)
Устанавливает определяемые параметры к данному
java.sql.Time объект. |
void |
setTime(String parameterName, Time x)
Устанавливает определяемые параметры к данному
java.sql.Time значение. |
void |
setTime(String parameterName, Time x, Calendar cal)
Устанавливает определяемые параметры к данному
java.sql.Time значение, используя данный Calendar объект. |
void |
setTimestamp(int parameterIndex, Timestamp x)
Устанавливает определяемые параметры к данному
java.sql.Timestamp значение. |
void |
setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
Устанавливает определяемые параметры к данному
java.sql.Timestamp объект. |
void |
setTimestamp(String parameterName, Timestamp x)
Устанавливает определяемые параметры к данному
java.sql.Timestamp значение. |
void |
setTimestamp(String parameterName, Timestamp x, Calendar cal)
Устанавливает определяемые параметры к данному
java.sql.Timestamp значение, используя данный Calendar объект. |
void |
setTransactionIsolation(int level)
Устанавливает свойство изоляции транзакции для этого JDBC
RowSet возразите против данной константы. |
void |
setType(int type)
Устанавливает тип для этого
RowSet возразите против указанного типа. |
void |
setTypeMap(Map<String,Class<?>> map)
Устанавливает данный
java.util.Map возразите как карта типа, связанная с Connection объект для этого RowSet объект. |
void |
setUnicodeStream(int parameterIndex, InputStream x, int length)
Осуждаемый.
getCharacterStream должен использоваться в его месте
|
void |
setURL(int parameterIndex, URL x)
Устанавливает определяемые параметры к данному
java.net.URL значение. |
void |
setUrl(String url)
Устанавливает свойство Url для этого
RowSet возразите против данного String объект и наборы свойство имени источника данных к null . |
void |
setUsername(String name)
Устанавливает свойство имени пользователя для этого
RowSet возразите против данного имени пользователя. |
public static final int UNICODE_STREAM_PARAM
RowSetReaderImpl
возразите, что данный параметр является потоком Unicode. Это RowSetReaderImpl
объект обеспечивается как расширение SyncProvider
абстрактный класс, определенный в SyncFactory
статический механизм SPI фабрики.public static final int BINARY_STREAM_PARAM
RowSetReaderImpl
возразите, что данный параметр является двоичным потоком. A RowSetReaderImpl
объект обеспечивается как расширение SyncProvider
абстрактный класс, определенный в SyncFactory
статический механизм SPI фабрики.public static final int ASCII_STREAM_PARAM
RowSetReaderImpl
возразите, что данный параметр является потоком ASCII. A RowSetReaderImpl
объект обеспечивается как расширение SyncProvider
абстрактный класс, определенный в SyncFactory
статический механизм SPI фабрики.protected InputStream binaryStream
InputStream
объект, который будет возвращен методом getBinaryStream
, который определяется в ResultSet
интерфейс.protected InputStream unicodeStream
InputStream
объект, который будет возвращен методом getUnicodeStream
, который определяется в ResultSet
интерфейс.protected InputStream asciiStream
InputStream
объект, который будет возвращен методом getAsciiStream
, который определяется в ResultSet
интерфейс.protected Reader charStream
Reader
объект, который будет возвращен методом getCharacterStream
, который определяется в ResultSet
интерфейс.public BaseRowSet()
BaseRowSet
объект инициализируется со значением по умолчанию Vector
объект для listeners
поле. Другие значения по умолчанию, с которыми это инициализируется, перечисляются в Разделе 6.0 из комментария класса для этого класса.protected void initParams()
RowSet
реализация, чтобы начать использовать стандартные услуги, предоставленные a BaseRowSet
экземпляр. Этот метод нужно вызвать после RowSet
объект инстанцировали, чтобы правильно инициализировать все параметры. Этот метод никогда не должно вызывать приложение, но вызывается от с a RowSet
реализация, расширяющая этот класс.public void addRowSetListener(RowSetListener listener)
RowSet
объект. Слушатель мог бы, например, быть таблицей или графиком, который должен быть обновлен, чтобы точно отразить текущее состояние RowSet
объект.
Отметьте: если RowSetListener
объект null
, этот метод тихо отбрасывает null
оцените и не добавляйте нулевую ссылку на группу слушателей.
Отметьте: если слушатель уже устанавливается, и новое RowSetListerner
экземпляр добавляется к группе слушателей, уже зарегистрированных, чтобы получить уведомления о событии от этого RowSet
.
listener
- объект, который реализовал javax.sql.RowSetListener
взаимодействуйте через интерфейс и хочет быть уведомленным относительно любых событий, которые происходят на этом RowSet
объект; Может быть нуль.removeRowSetListener(javax.sql.RowSetListener)
public void removeRowSetListener(RowSetListener listener)
RowSet
список объекта слушателей. Если данным параметром не является зарегистрированный слушатель, этот метод ничего не делает. Отметьте: если RowSetListener
объект null
, этот метод тихо отбрасывает null
значение.listener
- a RowSetListener
объект, который находится в списке слушателей для этого RowSet
объектaddRowSetListener(javax.sql.RowSetListener)
protected void notifyCursorMoved() throws SQLException
RowSet
возразите, что его курсор переместился. Когда приложение вызывает метод, чтобы переместить курсор, тот метод перемещает курсор и затем вызывает этот метод внутренне. Приложение никогда не должно вызывать этот метод непосредственно.
SQLException
- если класс, расширяющийся BaseRowSet
абстрактный класс не реализует RowSet
взаимодействуйте через интерфейс или одно из, этого - подинтерфейсы.protected void notifyRowChanged() throws SQLException
RowSet
возразите, что одна из его строк изменилась. Когда приложение вызывает метод, который изменяет строку, такой как CachedRowSet
методы insertRow
, updateRow
, или deleteRow
, то, что вызовы метода notifyRowChanged
внутренне. Приложение никогда не должно вызывать этот метод непосредственно.
SQLException
- если класс, расширяющийся BaseRowSet
абстрактный класс не реализует RowSet
взаимодействуйте через интерфейс или одно из, этого - подинтерфейсы.protected void notifyRowSetChanged() throws SQLException
RowSet
возразите, что его все содержание изменилось. Когда приложение вызывает методы, которые изменяют все содержание RowSet
объект, такой как CachedRowSet
методы execute
, populate
, restoreOriginal
, или release
, то, что вызовы метода notifyRowSetChanged
внутренне (любой прямо или косвенно). Приложение никогда не должно вызывать этот метод непосредственно.
SQLException
- если класс, расширяющийся BaseRowSet
абстрактный класс не реализует RowSet
взаимодействуйте через интерфейс или одно из, этого - подинтерфейсы.public String getCommand()
RowSet
объект. Свойство команды содержит запрос, который будет выполняться, чтобы заполнить это RowSet
объект. SQL-запрос, возвращенный этим методом, используется RowSet
методы такой как execute
и populate
, который может быть реализован любым классом, который расширяется BaseRowSet
абстрактный класс и реализации один или больше стандартного JSR-114 RowSet
интерфейсы.
Команда используется RowSet
читатель объекта, чтобы получить a ResultSet
объект. Читатель тогда читает данные из ResultSet
объект и использование это к заполнить это RowSet
объект.
Значение по умолчанию для command
свойство null
.
String
это - значение для этого RowSet
объект command
свойство; может быть null
setCommand(java.lang.String)
public void setCommand(String cmd) throws SQLException
RowSet
объект command
свойство к данному String
возразите и очищает параметры, если таковые вообще имеются, которые были установлены для предыдущей команды. command
свойство не может быть необходимо если RowSet
объект получает свои данные от источника, который не поддерживает команды, такие как электронная таблица или другой табличный файл. Таким образом это свойство является дополнительным и может быть null
.
cmd
- a String
объект, содержащий SQL-запрос, который будет установлен как это RowSet
свойство команды объекта; может быть null
но, возможно, не пустая строкаSQLException
- если пустая строка обеспечивается как значение командыgetCommand()
public String getUrl() throws SQLException
RowSet
объект javax.sql.Reader
возразите использованию, чтобы сделать соединение с реляционной базой данных, используя поддерживающий технологию драйвер JDBC. Url
свойство будет null
если базовый источник данных является источником данных не-SQL, таким как электронная таблица или источник данных XML.
String
объект, который содержит URL JDBC, используемый, чтобы установить соединение для этого RowSet
объект; может быть null
(значение по умолчанию), если не наборSQLException
- если ошибка происходит, получая значение URLsetUrl(java.lang.String)
public void setUrl(String url) throws SQLException
RowSet
возразите против данного String
объект и наборы свойство имени источника данных к null
. Свойством Url является URL JDBC, который используется, когда соединение создается, используя поддерживающий технологию драйвер JDBC ("драйвер JDBC") и DriverManager
. Корректный URL JDBC для определенного драйвера, который будет использоваться, может быть найден в документации драйвера. Хотя есть инструкции для для того, как URL JDBC формируется, поставщик драйвера может определить любого String
объект кроме одного с длиной 0
(пустая строка). Установка свойства Url является дополнительной, если соединения устанавливаются, используя a DataSource
объект вместо DriverManager
. Драйвер будет использовать или свойство URL или dataSourceName свойство, чтобы создать соединение, какой бы ни был определен последний раз. Если приложение использует URL JDBC, оно должно загрузить драйвер JDBC, который принимает URL JDBC прежде, чем оно будет использовать RowSet
возразите, чтобы соединиться с базой данных. RowSet
объект будет использовать URL внутренне, чтобы создать соединение с базой данных, чтобы считать или записать данные.
url
- a String
объект, который содержит URL JDBC, который будет использоваться, чтобы установить соединение с базой данных для этого RowSet
объект; может быть null
но не должна быть пустая строкаSQLException
- если ошибка происходит, устанавливая свойство Url, или предоставленный параметр является строкой с длиной 0
(пустая строка)getUrl()
public String getDataSourceName()
javax.sql.DataSource
объект. Это DataSource
объект может использоваться, чтобы установить соединение с источником данных, который он представляет. Пользователи должны установить или url или свойство имени источника данных. Драйвер будет использовать набор свойств последний раз, чтобы установить соединение.
String
объект, который идентифицирует DataSource
объект, который будет использоваться для того, чтобы сделать соединение; если никакое логическое имя не было установлено, null
возвращается.setDataSourceName(java.lang.String)
public void setDataSourceName(String name) throws SQLException
DataSource
свойство имени для этого RowSet
возразите против данного логического имени и наборов этому RowSet
свойство Url объекта к null
. Имя, должно быть, было связано с a DataSource
объект в JNDI именование службы так, чтобы приложение могло сделать поиск, используя то имя, чтобы получить DataSource
объект, связанный с этим. DataSource
объект может тогда использоваться, чтобы установить соединение с источником данных, который он представляет. Пользователи должны установить или свойство Url или dataSourceName свойство. Если оба свойства будут установлены, то драйвер будет использовать набор свойств последний раз.
name
- a String
объект с именем, которое может быть предоставлено службе именования, основанной на технологии JNDI, чтобы получить DataSource
объект, который может использоваться, чтобы получить соединение; может быть null
но не должна быть пустая строкаSQLException
- если пустая строка обеспечивается как DataSource
имяgetDataSourceName()
public String getUsername()
execute
.String
объект, содержащий имя пользователя, которое предоставляется источнику данных, чтобы создать соединение; может быть null
(значение по умолчанию), если не наборsetUsername(java.lang.String)
public void setUsername(String name)
RowSet
возразите против данного имени пользователя. Поскольку это не сериализируется, свойство имени пользователя устанавливается во время выполнения прежде, чем вызвать метод execute
.name
- String
объект, содержащий имя пользователя, которое предоставляется источнику данных, чтобы создать соединение. Это может быть нуль.getUsername()
public String getPassword()
RowSet
объект. Поскольку свойство пароля не сериализируется, оно устанавливается во время выполнения прежде, чем вызвать метод execute
. Значение по умолчанию null
String
объект, который представляет пароль, который должен быть предоставлен базе данных, чтобы создать соединениеsetPassword(java.lang.String)
public void setPassword(String pass)
RowSet
возразите против данного String
объект. Поскольку свойство пароля не сериализируется, оно устанавливается во время выполнения прежде, чем вызвать метод execute
.pass
- String
объект, который представляет пароль, который предоставляется базе данных, чтобы создать соединение. Это может быть нуль.getPassword()
public void setType(int type) throws SQLException
RowSet
возразите против указанного типа. Тип по умолчанию ResultSet.TYPE_SCROLL_INSENSITIVE
.type
- одна из следующих констант: ResultSet.TYPE_FORWARD_ONLY
, ResultSet.TYPE_SCROLL_INSENSITIVE
, или ResultSet.TYPE_SCROLL_SENSITIVE
SQLException
- если предоставленный параметр не является одной из следующих констант: ResultSet.TYPE_FORWARD_ONLY
или ResultSet.TYPE_SCROLL_INSENSITIVE
ResultSet.TYPE_SCROLL_SENSITIVE
getConcurrency()
, getType()
public int getType() throws SQLException
RowSet
объект. Тип первоначально определяется оператором, который создал RowSet
объект. RowSet
объект может вызвать метод setType
в любое время изменить его тип. Значение по умолчанию TYPE_SCROLL_INSENSITIVE
.RowSet
объект, который должен быть одним из следующего: ResultSet.TYPE_FORWARD_ONLY
, ResultSet.TYPE_SCROLL_INSENSITIVE
, или ResultSet.TYPE_SCROLL_SENSITIVE
SQLException
- если ошибка происходит, получая тип этого RowSet
объектsetType(int)
public void setConcurrency(int concurrency) throws SQLException
RowSet
возразите против указанного параллелизма. Параллелизм по умолчанию для любого RowSet
объект (соединенный или разъединенный) ResultSet.CONCUR_UPDATABLE
, но этот метод можно вызвать в любое время, чтобы изменить параллелизм. concurrency
- одна из следующих констант: ResultSet.CONCUR_READ_ONLY
или ResultSet.CONCUR_UPDATABLE
SQLException
- если предоставленный параметр не является одной из следующих констант: ResultSet.CONCUR_UPDATABLE
или ResultSet.CONCUR_READ_ONLY
getConcurrency()
, isReadOnly()
public boolean isReadOnly()
boolean
указание, ли это RowSet
объект только для чтения. Любые попытки обновить только для чтения RowSet
объект приведет к SQLException
брошенный. По умолчанию наборы строк обновляемы, если обновления возможны.true
если это RowSet
объект не может быть обновлен; false
иначеsetConcurrency(int)
, setReadOnly(boolean)
public void setReadOnly(boolean value)
RowSet
свойство объекта только для чтения к данному boolean
.value
- true
указать что это RowSet
объект только для чтения; false
указать, что это обновляемоpublic int getTransactionIsolation()
RowSet
соединение объекта. Это свойство представляет уровень изоляции транзакции, который требуют на использование в транзакциях. Для RowSet
реализации такой как CachedRowSet
это работает в разъединенной среде, SyncProvider
возразите предлагает дополнительную блокировку и опции целостности данных. Опции, описанные ниже, являются подходящими только для соединенного RowSet
объекты (JdbcRowSet
объекты).
Connection.TRANSACTION_NONE
, Connection.TRANSACTION_READ_UNCOMMITTED
, Connection.TRANSACTION_READ_COMMITTED
, Connection.TRANSACTION_REPEATABLE_READ
, или Connection.TRANSACTION_SERIALIZABLE
SyncFactory
, SyncProvider
, setTransactionIsolation(int)
public void setTransactionIsolation(int level) throws SQLException
RowSet
возразите против данной константы. DBMS будет использовать этот уровень изоляции транзакции для транзакций, если это может. Для RowSet
реализации такой как CachedRowSet
это работает в разъединенной среде, SyncProvider
объект, используемый предложения дополнительная блокировка и опции целостности данных. Опции, описанные ниже, являются подходящими только для соединенного RowSet
объекты (JdbcRowSet
объекты).
level
- одна из следующих констант, перечисленных в порядке возрастания: Connection.TRANSACTION_NONE
, Connection.TRANSACTION_READ_UNCOMMITTED
, Connection.TRANSACTION_READ_COMMITTED
, Connection.TRANSACTION_REPEATABLE_READ
, или Connection.TRANSACTION_SERIALIZABLE
SQLException
- если данный параметр не является одной из констант СоединенияSyncFactory
, SyncProvider
, getTransactionIsolation()
public Map<String,Class<?>> getTypeMap()
Connection
объект для этого RowSet
объект. Драйверы, которые поддерживают JDBC 3.0 API, создадут Connection
объекты со связанной картой типа. Эта карта типа, которая первоначально пуста, может содержать один или более полностью определенные имена SQL и Class
объекты, указывающие на класс, на который будет отображено именованное значение SQL. Отображение типа, определенное в карте типа соединения, используется для пользовательского отображения типа, когда никакая другая карта типа не заменяет это.
Если карта типа явно предоставляется методу, который может выполнить пользовательское отображение, та карта типа заменяет карту типа соединения.
java.util.Map
объект, который является картой типа для этого RowSet
соединение объектаpublic void setTypeMap(Map<String,Class<?>> map)
java.util.Map
возразите как карта типа, связанная с Connection
объект для этого RowSet
объект. Пользовательское отображение, обозначенное в этой карте типа, будет использоваться, если различная карта типа не будет явно предоставлена методу, когда предоставленная карта типа будет использоваться.map
- a java.util.Map
объект, который содержит отображение от имен типов SQL для определяемых пользователем типов (UDT) к классам в языке программирования Java. Каждая запись в Map
объект состоит из полностью определенного имени SQL UDT и Class
объект для SQLData
реализация этого UDT. Может быть null
.public int getMaxFieldSize() throws SQLException
RowSet
объект. Этот предел применяется только к столбцам, которые содержат значения следующих типов: BINARY
, VARBINARY
, LONGVARBINARY
, CHAR
, VARCHAR
, и LONGVARCHAR
. Если предел превышается, избыточные данные тихо отбрасываются.int
указание на текущий максимальный предел размера столбца; обнулите означает, что нет никакого пределаSQLException
- если ошибка происходит, внутренне определяя максимальный предел размера столбцаpublic void setMaxFieldSize(int max) throws SQLException
RowSet
возразите против данного числа. Этот предел применяется только к столбцам, которые содержат значения следующих типов: BINARY
, VARBINARY
, LONGVARBINARY
, CHAR
, VARCHAR
, и LONGVARCHAR
. Если предел превышается, избыточные данные тихо отбрасываются. Для максимальной мобильности желательно использовать значения, больше чем 256.max
- int
указание на новый максимальный предел размера столбца; обнулите означает, что нет никакого пределаSQLException
- если (1) ошибка происходит, внутренне устанавливая максимальный предел размера столбца или (2), размер меньше чем 0 устанавливаетсяpublic int getMaxRows() throws SQLException
RowSet
объект может содержать. Если этот предел превышается, избыточные строки тихо отбрасываются.int
указание на текущее максимальное количество строк; обнулите означает, что нет никакого пределаSQLException
- если ошибка происходит, внутренне определяя максимальный предел строк это a Rowset
объект может содержатьpublic void setMaxRows(int max) throws SQLException
RowSet
объект может содержать к данному числу. Если этот предел превышается, избыточные строки тихо отбрасываются.max
- int
указание на текущее максимальное количество строк; обнулите означает, что нет никакого пределаSQLException
- если ошибка происходит, внутренне устанавливая максимальный предел для числа строк что JDBC RowSet
объект может содержать; или если максимальный меньше чем 0
; или если максимальный меньше чем fetchSize
из RowSet
public void setEscapeProcessing(boolean enable) throws SQLException
boolean
отсканирует ли драйвер для синтаксиса escape и действительно выходит из замены прежде, чем отправить SQL-операторы базе данных. Значение по умолчанию для драйвера, чтобы сделать обработку escape. Отметьте: С тех пор PreparedStatement
объекты обычно анализировались до выполнения этого вызова, отключая обработку escape для готовых операторов не будет, вероятно, иметь никакого эффекта.
enable
- true
включать обработке escape; false
отключить этоSQLException
- если ошибка происходит, устанавливая базовый поддерживающий технологию драйвер JDBC, чтобы обработать синтаксис escapepublic int getQueryTimeout() throws SQLException
SQLException
бросается.SQLException
- если ошибка происходит в определении значения тайм-аута запросаpublic void setQueryTimeout(int seconds) throws SQLException
SQLException
бросается.seconds
- в секундах новый тайм-аут запроса ограничивает; обнулите означает, что нет никакого предела; не должны быть меньше чем нульSQLException
- если ошибка происходит, устанавливая тайм-аут запроса или если значение тайм-аута запроса - меньше чем 0public boolean getShowDeleted() throws SQLException
boolean
указание, появляются ли строки, отмеченные для удаления, в наборе текущих строк. Значение по умолчанию false
. Отметьте: Разрешение удаленных строк остаться видимый усложняет поведение некоторых из методов. Однако, больше всего RowSet
объектные пользователи могут просто проигнорировать эту дополнительную деталь, потому что только сложные приложения будут, вероятно, хотеть использовать в своих интересах эту функцию.
true
если удаленные строки видимы; false
иначеSQLException
- если ошибка происходит, определяя, видимы ли удаленные строки или нетsetShowDeleted(boolean)
public void setShowDeleted(boolean value) throws SQLException
showDeleted
к данному boolean
значение, которое определяет, появляются ли строки, отмеченные для удаления, в наборе текущих строк.value
- true
если удаленные строки нужно показать; false
иначеSQLException
- если ошибка происходит, устанавливая, видимы ли удаленные строки или нетgetShowDeleted()
public boolean getEscapeProcessing() throws SQLException
RowSet
объект.true
если обработка escape включается; false
иначеSQLException
- если ошибка происходит, определяя, включается ли обработка escape или не или если внутренний триггер обработки escape не был включенpublic void setFetchDirection(int direction) throws SQLException
RowSet
объект будет обработан. Драйвер может проигнорировать эту подсказку. A RowSet
объект наследовал свойства по умолчанию ResultSet
объект, от которого это получило свои данные. Это ResultSet
направление выборки объекта по умолчанию устанавливается Statement
возразите, что создал это.
Этот метод применяется к a RowSet
возразите только, в то время как это соединяется с базой данных, используя драйвер JDBC.
A RowSet
объект может использовать этот метод в любое время, чтобы изменить его настройки для направления выборки.
direction
- один из ResultSet.FETCH_FORWARD
, ResultSet.FETCH_REVERSE
, или ResultSet.FETCH_UNKNOWN
SQLException
- если (1) RowSet
тип TYPE_FORWARD_ONLY
и данное направление выборки не FETCH_FORWARD
или (2) данное направление выборки не является одним из следующего: ResultSet. FETCH_FORWARD, ResultSet. FETCH_REVERSE, или ResultSet. FETCH_UNKNOWNgetFetchDirection()
public int getFetchDirection() throws SQLException
RowSet
ток объекта, устанавливающий для направления выборки. Тип по умолчанию ResultSet.FETCH_FORWARD
ResultSet.FETCH_FORWARD
, ResultSet.FETCH_REVERSE
, или ResultSet.FETCH_UNKNOWN
SQLException
- если ошибка происходит в определении текущего направления выборки для того, чтобы выбрать строкиsetFetchDirection(int)
public void setFetchSize(int rows) throws SQLException
RowSet
возразите против данного числа строк. Размер выборки дает поддерживающий технологию драйвер JDBC ("драйвер JDBC") подсказка относительно числа строк, которые должны быть выбраны от базы данных, когда больше строк необходимо для этого RowSet
объект. Если определенный размер выборки является нулем, драйвер игнорирует значение и является бесплатным высказать его собственное лучшее предположение относительно того, каков размер выборки должен быть. A RowSet
объект наследовал свойства по умолчанию ResultSet
объект, от которого это получило свои данные. Это ResultSet
размер выборки объекта по умолчанию устанавливается Statement
возразите, что создал это.
Этот метод применяется к a RowSet
возразите только, в то время как это соединяется с базой данных, используя драйвер JDBC. Для соединенного RowSet
реализации такой как JdbcRowSet
, этот метод имеет прямой и непосредственный эффект на базовый драйвер JDBC.
A RowSet
объект может использовать этот метод в любое время, чтобы изменить его настройки для размера выборки.
Для RowSet
реализации такой как CachedRowSet
, которые работают в разъединенной среде, SyncProvider
используемый объект может усилить размер выборки, чтобы опросить источник данных и получить много строк, которые не превышают размер выборки, и это может сформировать подмножество фактических строк, возвращенных исходным запросом. Это - различие реализации, определенное определенным SyncProvider
объект используется разъединенным RowSet
объект.
rows
- число строк, чтобы выбрать; 0
позволять драйверу решать, каков лучший размер выборки; не должны быть меньше чем 0
или больше чем максимальное количество строк, учтенных это RowSet
объект (число, возвращенное звонком в метод getMaxRows()
)SQLException
- если указанный размер выборки является меньше чем 0
или больше чем предел для максимального количества строкgetFetchSize()
public int getFetchSize() throws SQLException
RowSet
объект. Значение по умолчанию является нулем.RowSet
возразите нуждается в большем количестве строк от базы данныхSQLException
- если ошибка происходит, определяя число строк в текущем размере выборкиsetFetchSize(int)
public int getConcurrency() throws SQLException
RowSet
объект. Значение по умолчанию CONCUR_UPDATABLE
и для соединенного и для разъединенного RowSet
объекты. Приложение может вызвать метод setConcurrency
в любое время изменить a RowSet
параллелизм объекта.
RowSet
объект, который должен быть одним из следующего: ResultSet.CONCUR_READ_ONLY
или ResultSet.CONCUR_UPDATABLE
SQLException
- если ошибка происходит, получая параллелизм этого RowSet
объектsetConcurrency(int)
, isReadOnly()
public void setNull(int parameterIndex, int sqlType) throws SQLException
NULL
. Отметьте, что тип SQL параметра должен быть определен, используя один из кодов типа, определенных в java.sql.Types
. Этот тип SQL определяется во втором параметре. Отметьте, что второй параметр говорит DBMS тип данных значения, устанавливаемого в NULL
. Некоторые DBMSs запрашивают эту информацию, таким образом, она требуется, чтобы сделать код более переносимым.
Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после этой версии setNull
был вызван возвратится Object
массив, содержащий значения параметра, которые были установлены. В том массиве элемент, который представляет набор значений с этим методом, самостоятельно будет массивом. Первый элемент того массива null
. Второй элемент является набором значений для sqlType. Число параметра обозначается позицией элемента в массиве, возвращенном методом getParams
, с первым элементом, являющимся значением для первого параметра заполнителя, второй элемент, являющийся значением для второго параметра заполнителя, и так далее. Другими словами, если вторые параметры заполнителя устанавливаются к null
, массив, содержащий это, будет вторым элементом в массиве, возвращенном getParams
.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеsqlType
- int
это - один из кодов типа SQL, определенных в классе Types
. Если нестандартный sqlType будет предоставлен, то этот метод не будет бросать a SQLException
. Это позволяет неявную поддержку нестандартных типов SQL.SQLException
- если ошибка доступа к базе данных происходит, или данный индекс параметра за пределыgetParams()
public void setNull(int parameterIndex, int sqlType, String typeName) throws SQLException
NULL
. Хотя эта версия метода setNull
предназначается для определяемого пользователем и REF
параметры, этот метод может использоваться, чтобы установить нулевые параметры для любого типа JDBC. Следующее является определяемыми пользователем типами: STRUCT
, DISTINCT
, и JAVA_OBJECT
, и названные типы массива. Отметьте: Чтобы быть переносимыми, приложения должны дать код типа SQL и полностью определенное имя типа SQL, определяя a NULL
определяемый пользователем или REF
параметр. В случае определяемого пользователем типа имя является именем типа параметра непосредственно. Для a REF
параметр, имя является именем типа типа, на который ссылаются. Если поддерживающий технологию драйвер JDBC не нуждается в кодовом названии типа или информации об имени типа, это может проигнорировать это.
Если у параметра нет определяемого пользователем или REF
введите, данный typeName
параметр игнорируется.
Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после этой версии setNull
был вызван возвратится Object
массив, содержащий значения параметра, которые были установлены. В том массиве элемент, который представляет набор значений с этим методом, самостоятельно будет массивом. Первый элемент того массива null
. Второй элемент является набором значений для sqlType, и третий элемент является набором значений для имени типа. Число параметра обозначается позицией элемента в массиве, возвращенном методом getParams
, с первым элементом, являющимся значением для первого параметра заполнителя, второй элемент, являющийся значением для второго параметра заполнителя, и так далее. Другими словами, если вторые параметры заполнителя устанавливаются к null
, массив, содержащий это, будет вторым элементом в массиве, возвращенном getParams
.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеsqlType
- значение от java.sql.Types
typeName
- полностью определенное имя SQL определяемый пользователем тип, который игнорируется, если параметр не является определяемым пользователем типом или REF
значениеSQLException
- если ошибка происходит, или данный индекс параметра за пределыgetParams()
public void setBoolean(int parameterIndex, boolean x) throws SQLException
boolean
в языке программирования Java. Драйвер преобразовывает это в SQL BIT
оцените, когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
, populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- значение параметраSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setByte(int parameterIndex, byte x) throws SQLException
byte
в языке программирования Java. Драйвер преобразовывает это в SQL TINYINT
оцените, когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- значение параметраSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setShort(int parameterIndex, short x) throws SQLException
short
в языке программирования Java. Драйвер преобразовывает это в SQL SMALLINT
оцените, когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- значение параметраSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setInt(int parameterIndex, int x) throws SQLException
int
в языке программирования Java. Драйвер преобразовывает это в SQL INTEGER
оцените, когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- значение параметраSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setLong(int parameterIndex, long x) throws SQLException
long
в языке программирования Java. Драйвер преобразовывает это в SQL BIGINT
оцените, когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- значение параметраSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setFloat(int parameterIndex, float x) throws SQLException
float
в языке программирования Java. Драйвер преобразовывает это в SQL FLOAT
оцените, когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- значение параметраSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setDouble(int parameterIndex, double x) throws SQLException
double
в языке программирования Java. Драйвер преобразовывает это в SQL DOUBLE
оцените, когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе. S
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- значение параметраSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException
java.lang.BigDecimal
значение. Драйвер преобразовывает это в SQL NUMERIC
оцените, когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
Отметьте: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- значение параметраSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setString(int parameterIndex, String x) throws SQLException
String
значение. Драйвер преобразовывает это в SQL VARCHAR
или LONGVARCHAR
значение (в зависимости от размера параметра относительно пределов драйвера на VARCHAR
значения), когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- значение параметраSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setBytes(int parameterIndex, byte[] x) throws SQLException
VARBINARY
или LONGVARBINARY
значение (в зависимости от размера параметра относительно пределов драйвера на VARBINARY
значения), когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- значение параметраSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setDate(int parameterIndex, Date x) throws SQLException
java.sql.Date
значение. Драйвер преобразовывает это в SQL DATE
оцените, когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после этой версии setDate
был вызван возвратит массив со значением, которое будет установлено для числа параметра заполнителя parameterIndex быть Date
объект, предоставленный как второй параметр. Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- значение параметраSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setTime(int parameterIndex, Time x) throws SQLException
java.sql.Time
значение. Драйвер преобразовывает это в SQL TIME
оцените, когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после этой версии метода setTime
был вызван возвратит массив параметров, которые были установлены. Параметр, который будет установлен для числа заполнителя параметра parameterIndex, будет Time
объект, который был установлен как второй параметр в этот метод.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- a java.sql.Time
объект, который должен быть установлен как значение для параметра заполнителя parameterIndexSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setTimestamp(int parameterIndex, Timestamp x) throws SQLException
java.sql.Timestamp
значение. Драйвер преобразовывает это в SQL TIMESTAMP
оцените, когда это отправляет это базе данных. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после этой версии setTimestamp
был вызван возвратит массив со значением для числа заполнителя параметра parameterIndex быть Timestamp
объект, который был предоставлен как второй параметр этому методу. Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- a java.sql.Timestamp
объектSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException
java.io.InputStream
объект, у которого будет конкретное количество байтов. Содержание потока будет считано и отправлено базе данных. Этот метод бросает SQLException
возразите, читало ли число байтов, и отправленный базе данных не равно длине. Когда очень большое значение ASCII вводится к a LONGVARCHAR
параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream
объект. Поддерживающий технологию драйвер JDBC считает данные из потока как необходимый, пока это не достигнет конца файла. Драйвер сделает любое необходимое преобразование от ASCII до базы данных CHAR
формат.
Отметьте: Этот потоковый объект может быть или стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
Отметьте: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после setAsciiStream
был вызван возвратит массив, содержащий значения параметра, которые были установлены. Элемент в массиве, который представляет набор значений с этим методом, самостоятельно будет массивом. Первый элемент того массива является данным java.io.InputStream
объект. Второй элемент является набором значений для длины. Третий элемент является внутренним BaseRowSet
постоянное определение, что поток, который передают к этому методу, является потоком ASCII. Число параметра обозначается позицией элемента в массиве, возвращенном методом getParams
, с первым элементом, являющимся значением для первого параметра заполнителя, второй элемент, являющийся значением для второго параметра заполнителя, и так далее. Другими словами, если входной устанавливаемый поток будет значением для второго параметра заполнителя, то массив, содержащий это, будет вторым элементом в массиве, возвращенном getParams
.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является числом элемента parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- входной поток Java, который содержит значение параметра ASCIIlength
- число байтов в потоке. Это - число байтов, которые драйвер отправит DBMS; длины 0 или меньше, неопределены, но заставит недопустимое исключение длины быть брошенным в базовый драйвер JDBC.SQLException
- если ошибка происходит, индекс параметра за пределы, или когда соединено с источником данных, число байтов драйвер читает и передается к базе данных, не равно числу байтов, определенных в длинеgetParams()
public void setAsciiStream(int parameterIndex, InputStream x) throws SQLException
RowSet
команда объекта к данному входному потоку. Когда очень большое значение ASCII вводится к a LONGVARCHAR
параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream
. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от ASCII до формата случайной работы базы данных. Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setAsciiStream
который берет параметр длины.
parameterIndex
- первый параметр 1, второе 2...x
- входной поток Java, который содержит значение параметра ASCIISQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException
java.io.InputStream
объект, у которого будет конкретное количество байтов. Содержание потока будет считано и отправлено базе данных. Этот метод бросает SQLException
возразите, читало ли число байтов, и отправленный базе данных не равно длине. Когда очень большое двоичное значение вводится к a LONGVARBINARY
параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream
объект. Поддерживающий технологию драйвер JDBC считает данные из потока как необходимый, пока это не достигнет конца файла.
Отметьте: Этот потоковый объект может быть или стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после setBinaryStream
был вызван возвратит массив, содержащий значения параметра, которые были установлены. В том массиве элемент, который представляет набор значений с этим методом, самостоятельно будет массивом. Первый элемент того массива является данным java.io.InputStream
объект. Второй элемент является набором значений для длины. Третий элемент является внутренним BaseRowSet
постоянное определение, что поток, который передают к этому методу, является двоичным потоком. Число параметра обозначается позицией элемента в массиве, возвращенном методом getParams
, с первым элементом, являющимся значением для первого параметра заполнителя, второй элемент, являющийся значением для второго параметра заполнителя, и так далее. Другими словами, если входной устанавливаемый поток будет значением для второго параметра заполнителя, то массив, содержащий это, будет вторым элементом в массиве, возвращенном getParams
.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является числом элемента parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- входной поток, который содержит двоичное значение, которое будет установленоlength
- число байтов в потоке; длины 0 или меньше, неопределены, но заставит недопустимое исключение длины быть брошенным в базовый драйвер JDBC.SQLException
- если ошибка происходит, индекс параметра за пределы, или когда соединено с источником данных, число байтов драйвер читает и передается к базе данных, не равно числу байтов, определенных в длинеgetParams()
public void setBinaryStream(int parameterIndex, InputStream x) throws SQLException
RowSet
команда объекта к данному входному потоку. Когда очень большое двоичное значение вводится к a LONGVARBINARY
параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream
объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setBinaryStream
который берет параметр длины.
parameterIndex
- первый параметр 1, второе 2...x
- входной поток java, который содержит двоичное значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException
java.io.InputStream
объект, у которого будет конкретное количество байтов. Содержание потока будет считано и отправлено базе данных. Этот метод бросает SQLException
если число байтов читало, и отправленный базе данных не равно длине. Когда очень большое значение Unicode вводится к a LONGVARCHAR
параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream
объект. Поддерживающий технологию драйвер JDBC считает данные из потока как необходимый, пока это не достигнет конца файла. Драйвер сделает любое необходимое преобразование от Unicode до базы данных CHAR
формат. Формат байта потока Unicode должен быть Java UTF-8, как определено в Спецификации виртуальной машины Java.
Отметьте: Этот потоковый объект может быть или стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Этот метод осуждается; метод getCharacterStream
должен использоваться в его месте.
Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Вызовы, выполненные к методу getParams
после setUnicodeStream
был вызван возвратит массив, содержащий значения параметра, которые были установлены. В том массиве элемент, который представляет набор значений с этим методом, самостоятельно будет массивом. Первый элемент того массива является данным java.io.InputStream
объект. Второй элемент является набором значений для длины. Третий элемент является внутренним BaseRowSet
постоянное определение, что поток, который передают к этому методу, является потоком Unicode. Число параметра обозначается позицией элемента в массиве, возвращенном методом getParams
, с первым элементом, являющимся значением для первого параметра заполнителя, второй элемент, являющийся значением для второго параметра заполнителя, и так далее. Другими словами, если входной устанавливаемый поток будет значением для второго параметра заполнителя, то массив, содержащий это, будет вторым элементом в массиве, возвращенном getParams
.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является числом элемента parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- java.io.InputStream
объект, который содержит значение параметра UNICODElength
- число байтов во входном потокеSQLException
- если ошибка происходит, индекс параметра за пределы, или число байтов, которые драйвер читает и отправляет базе данных, не равно числу байтов, определенных в длинеgetParams()
public void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException
java.io.Reader
объект, у которого будет конкретное количество символов. Содержание читателя будет считано и отправлено базе данных. Этот метод бросает SQLException
если число байтов читало, и отправленный базе данных не равно длине. Когда очень большое значение Unicode вводится к a LONGVARCHAR
параметр, это может быть более практично, чтобы отправить это через a Reader
объект. Поддерживающий технологию драйвер JDBC считает данные из потока как необходимый, пока это не достигнет конца файла. Драйвер сделает любое необходимое преобразование от Unicode до базы данных CHAR
формат. Формат байта потока Unicode должен быть Java UTF-8, как определено в Спецификации виртуальной машины Java.
Отметьте: Этот потоковый объект может быть или стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после setCharacterStream
был вызван возвратит массив, содержащий значения параметра, которые были установлены. В том массиве элемент, который представляет набор значений с этим методом, самостоятельно будет массивом. Первый элемент того массива является данным java.io.Reader
объект. Второй элемент является набором значений для длины. Число параметра обозначается позицией элемента в массиве, возвращенном методом getParams
, с первым элементом, являющимся значением для первого параметра заполнителя, второй элемент, являющийся значением для второго параметра заполнителя, и так далее. Другими словами, если устанавливаемый читатель будет значением для второго параметра заполнителя, то массив, содержащий это, будет вторым элементом в массиве, возвращенном getParams
.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является числом элемента parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеreader
- Reader
объект, который содержит данные Unicodelength
- число символов в потоке; длины 0 или меньше неопределены, но заставят недопустимое исключение длины быть брошенным в базовый драйвер JDBC.SQLException
- если ошибка происходит, индекс параметра за пределы, или когда соединено с источником данных, число байтов драйвер читает и передается к базе данных, не равно числу байтов, определенных в длинеgetParams()
public void setCharacterStream(int parameterIndex, Reader reader) throws SQLException
RowSet
команда объекта к данному Reader
объект. Когда очень большое значение UNICODE вводится к a LONGVARCHAR
параметр, это может быть более практично, чтобы отправить это через a java.io.Reader
объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от UNICODE до формата случайной работы базы данных. Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setCharacterStream
который берет параметр длины.
parameterIndex
- первый параметр 1, второе 2...reader
- java.io.Reader
объект, который содержит данные UnicodeSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setObject(int parameterIndex, Object x, int targetSqlType, int scale) throws SQLException
Object
в языке программирования Java. Второй параметр должен быть Object
ввести. Для интегральных значений, java.lang
должны использоваться эквивалентные объекты. Например, используйте класс Integer
для int
. Драйвер преобразовывает этот объект в указанный целевой тип SQL прежде, чем отправить это базе данных. Если у объекта есть пользовательское отображение (имеет реализацию класса SQLData
), драйвер должен вызвать метод SQLData.writeSQL
записать объект в поток данных SQL. Если с другой стороны объект имеет реализацию класса Ref
, Blob
, Clob
, Struct
, или Array
, драйвер должен передать это к базе данных как значение соответствующего типа SQL.
Отметьте, что этот метод может использоваться, чтобы передать базу данных - определенные абстрактные типы данных.
Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
выполниться вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после этой версии setObject
был вызван возвратит массив, содержащий значения параметра, которые были установлены. В том массиве элемент, который представляет набор значений с этим методом, самостоятельно будет массивом. Первый элемент того массива является данным Object
экземпляр, и второй элемент являются набором значений для targetSqlType. Третий элемент является набором значений для масштаба, который проигнорирует драйвер, если тип устанавливаемого объекта не будет java.sql.Types.NUMERIC
или java.sql.Types.DECIMAL
. Число параметра обозначается позицией элемента в массиве, возвращенном методом getParams
, с первым элементом, являющимся значением для первого параметра заполнителя, второй элемент, являющийся значением для второго параметра заполнителя, и так далее. Другими словами, если устанавливаемый объект будет значением для второго параметра заполнителя, то массив, содержащий это, будет вторым элементом в массиве, возвращенном getParams
.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является числом элемента parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- Object
содержа входное значение параметра; должен быть Object
ввестиtargetSqlType
- тип SQL (как определено в java.sql.Types
) быть отправленным базе данных. scale
параметр может далее квалифицировать этот тип. Если нестандартный targetSqlType будет предоставлен, то этот метод не будет бросать a SQLException
. Это позволяет неявную поддержку нестандартных типов SQL.scale
- для типов java.sql.Types.DECIMAL
и java.sql.Types.NUMERIC
, это - число цифр после десятичной точки. Для всех других типов будет проигнорировано это значение.SQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException
Object
значение. Этот метод походит setObject(int parameterIndex, Object x, int targetSqlType, int scale)
за исключением того, что это принимает масштаб нуля. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после этой версии setObject
был вызван возвратит массив, содержащий значения параметра, которые были установлены. В том массиве элемент, который представляет набор значений с этим методом, самостоятельно будет массивом. Первый элемент того массива является данным Object
экземпляр. Второй элемент является набором значений для targetSqlType. Число параметра обозначается позицией элемента в массиве, возвращенном методом getParams
, с первым элементом, являющимся значением для первого параметра заполнителя, второй элемент, являющийся значением для второго параметра заполнителя, и так далее. Другими словами, если устанавливаемый объект будет значением для второго параметра заполнителя, то массив, содержащий это, будет вторым элементом в массиве, возвращенном getParams
.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является числом элемента parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- Object
содержа входное значение параметра; должен быть Object
ввестиtargetSqlType
- тип SQL (как определено в java.sql.Types
) быть отправленным базе данных. Если нестандартный targetSqlType будет предоставлен, то этот метод не будет бросать a SQLException
. Это позволяет неявную поддержку нестандартных типов SQL.SQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setObject(int parameterIndex, Object x) throws SQLException
Object
в языке программирования Java. Второй параметр должен быть Object
ввести. Для интегральных значений, java.lang
должны использоваться эквивалентные объекты. Например, используйте класс Integer
для int
. Спецификация JDBC определяет стандартное отображение от Java Object
типы к типам SQL. Драйвер будет использовать этот стандарт, отображающийся, чтобы преобразовать данный объект в его соответствующий тип SQL прежде, чем отправить это базе данных. Если у объекта есть пользовательское отображение (имеет реализацию класса SQLData
), драйвер должен вызвать метод SQLData.writeSQL
записать объект в поток данных SQL.
Если с другой стороны объект имеет реализацию класса Ref
, Blob
, Clob
, Struct
, или Array
, драйвер должен передать это к базе данных как значение соответствующего типа SQL.
Этот метод выдает исключение, если есть неоднозначность, например, если объект имеет класс, реализовывая больше чем один интерфейс.
Отметьте, что этот метод может использоваться, чтобы передать специфичные для базы данных абстрактные типы данных.
Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
После того, как этот метод вызвали, звонок в метод getParams
возвратит объектный массив текущих параметров команды, которые будут включать Object
набор для числа параметра заполнителя parameterIndex
. Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является числом элемента parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- объект, содержащий входное значение параметраSQLException
- если ошибка происходит, индекс параметра за пределы, или есть неоднозначность в реализации устанавливаемого объектаgetParams()
public void setRef(int parameterIndex, Ref ref) throws SQLException
Ref
объект в языке программирования Java. Драйвер преобразовывает это в SQL REF
оцените, когда это отправляет это базе данных. Внутренне, Ref
представляется как a SerialRef
гарантировать сериализуемость. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
После того, как этот метод вызвали, звонок в метод getParams
возвратит объектный массив текущих параметров команды, которые будут включать Ref
объектный набор для числа параметра заполнителя parameterIndex
. Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является числом элемента parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеref
- a Ref
объект, представляющий SQL REF
значение; не может быть нульSQLException
- если ошибка происходит; индекс параметра за пределы или Ref
объект null
; или Ref
возразите возвращает a null
имя базового типа.getParams()
, SerialRef
public void setBlob(int parameterIndex, Blob x) throws SQLException
Blob
объект в языке программирования Java. Драйвер преобразовывает это в SQL BLOB
оцените, когда это отправляет это базе данных. Внутренне, Blob
представляется как a SerialBlob
гарантировать сериализуемость. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы. ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
После того, как этот метод вызвали, звонок в метод getParams
возвратит объектный массив текущих параметров команды, которые будут включать Blob
объектный набор для числа параметра заполнителя parameterIndex
. Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является числом элемента parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- a Blob
объект, представляющий SQL BLOB
значениеSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
, SerialBlob
public void setClob(int parameterIndex, Clob x) throws SQLException
Clob
объект в языке программирования Java. Драйвер преобразовывает это в SQL CLOB
оцените, когда это отправляет это базе данных. Внутренне, Clob
представляется как a SerialClob
гарантировать сериализуемость. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
После того, как этот метод вызвали, звонок в метод getParams
возвратит объектный массив текущих параметров команды, которые будут включать Clob
объектный набор для числа параметра заполнителя parameterIndex
. Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является числом элемента parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- a Clob
объект, представляющий SQL CLOB
значение; не может быть нульSQLException
- если ошибка происходит; индекс параметра за пределы или Clob
нульgetParams()
, SerialBlob
public void setArray(int parameterIndex, Array array) throws SQLException
Array
объект в языке программирования Java. Драйвер преобразовывает это в SQL ARRAY
оцените, когда это отправляет это базе данных. Внутренне, Array
представляется как a SerialArray
гарантировать сериализуемость. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
Отметьте: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
После того, как этот метод вызвали, звонок в метод getParams
возвратит объектный массив текущих параметров команды, которые будут включать Array
объектный набор для числа параметра заполнителя parameterIndex
. Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является числом элемента parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеarray
- Array
объект, представляющий SQL ARRAY
значение; не может быть нуль. Array
объект, который передают к этому методу, должен возвратить ненулевой Объект для всех getArray()
вызовы метода. Нулевое значение вызовет a SQLException
быть брошенным.SQLException
- если ошибка происходит; индекс параметра за пределы или ARRAY
нульgetParams()
, SerialArray
public void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException
java.sql.Date
объект. Когда DBMS не будет хранить информацию часового пояса, драйвер будет использовать данный Calendar
возразите, чтобы создать SQL DATE
значение, чтобы передаться к базе данных. С a Calendar
объект, драйвер может вычислить дату, принимающую во внимание пользовательский часовой пояс. Если нет Calendar
объект определяется, драйвер использует часовой пояс Виртуальной машины, которая запускает приложение. Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после этой версии setDate
был вызван возвратит массив, содержащий значения параметра, которые были установлены. В том массиве элемент, который представляет набор значений с этим методом, самостоятельно будет массивом. Первый элемент того массива является данным java.sql.Date
объект. Второй элемент является набором значений для cal. Число параметра обозначается позицией элемента в массиве, возвращенном методом getParams
, с первым элементом, являющимся значением для первого параметра заполнителя, второй элемент, являющийся значением для второго параметра заполнителя, и так далее. Другими словами, если назначенная дата будет значением для второго параметра заполнителя, то массив, содержащий это, будет вторым элементом в массиве, возвращенном getParams
.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- a java.sql.Date
объект, представляющий SQL DATE
значениеcal
- a java.util.Calendar
возразите, чтобы использовать когда, создавая датуSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException
java.sql.Time
объект. Драйвер преобразовывает это в SQL TIME
оцените, когда это отправляет это базе данных. Когда DBMS не будет хранить информацию часового пояса, драйвер будет использовать данный Calendar
возразите, чтобы создать SQL TIME
значение, чтобы передаться к базе данных. С a Calendar
объект, драйвер может вычислить дату, принимающую во внимание пользовательский часовой пояс. Если нет Calendar
объект определяется, драйвер использует часовой пояс Виртуальной машины, которая запускает приложение.
Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после этой версии setTime
был вызван возвратит массив, содержащий значения параметра, которые были установлены. В том массиве элемент, который представляет набор значений с этим методом, самостоятельно будет массивом. Первый элемент того массива является данным java.sql.Time
объект. Второй элемент является набором значений для cal. Число параметра обозначается позицией элемента в массиве, возвращенном методом getParams
, с первым элементом, являющимся значением для первого параметра заполнителя, второй элемент, являющийся значением для второго параметра заполнителя, и так далее. Другими словами, если устанавливаемое время будет значением для второго параметра заполнителя, то массив, содержащий это, будет вторым элементом в массиве, возвращенном getParams
.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- a java.sql.Time
объектcal
- java.util.Calendar
возразите, что драйвер может использовать, чтобы создать времяSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException
java.sql.Timestamp
объект. Драйвер преобразовывает это в SQL TIMESTAMP
оцените, когда это отправляет это базе данных. Когда DBMS не будет хранить информацию часового пояса, драйвер будет использовать данный Calendar
возразите, чтобы создать SQL TIMESTAMP
значение, чтобы передаться к базе данных. С a Calendar
объект, драйвер может вычислить метку времени, принимающую во внимание пользовательский часовой пояс. Если нет Calendar
объект определяется, драйвер использует часовой пояс Виртуальной машины, которая запускает приложение.
Набор значений параметра этим методом сохранен внутренне и будет предоставлен как соответствующий параметр в этом RowSet
команда объекта, когда метод execute
вызывается. Методы такой как execute
и populate
должен быть обеспечен в любом классе, который расширяет этот класс и реализует один или больше стандартного JSR-114 RowSet
интерфейсы.
ОТМЕТЬТЕ: JdbcRowSet
не требует populate
метод, поскольку это неопределено в этом классе.
Вызовы, выполненные к методу getParams
после этой версии setTimestamp
был вызван возвратит массив, содержащий значения параметра, которые были установлены. В том массиве элемент, который представляет набор значений с этим методом, самостоятельно будет массивом. Первый элемент того массива является данным java.sql.Timestamp
объект. Второй элемент является набором значений для cal. Число параметра обозначается позицией элемента в массиве, возвращенном методом getParams
, с первым элементом, являющимся значением для первого параметра заполнителя, второй элемент, являющийся значением для второго параметра заполнителя, и так далее. Другими словами, если устанавливаемая метка времени будет значением для второго параметра заполнителя, то массив, содержащий это, будет вторым элементом в массиве, возвращенном getParams
.
Отметьте, что, потому что нумерация элементов в массиве запускается в нуле, элемент массива, который соответствует числу параметра заполнителя parameterIndex, является parameterIndex-1.
parameterIndex
- порядковое число параметра заполнителя в этом RowSet
команда объекта, которая должна быть установлена. Первый параметр 1, второе 2 и так далее; должен быть 1
или большеx
- a java.sql.Timestamp
объектcal
- java.util.Calendar
возразите, что драйвер может использовать, чтобы создать метку времениSQLException
- если ошибка происходит, или индекс параметра за пределыgetParams()
public void clearParameters() throws SQLException
RowSet
внутреннее представление объекта параметров, которые будут установлены в этом RowSet
команда объекта, когда это выполняется. Вообще, значения параметра остаются в силе для повторного использования в этом RowSet
команда объекта. Установка значения параметра с методами метода set автоматически очищает значение определяемого параметра и заменяет это новым указанным значением.
Этот метод вызывают внутренне setCommand
метод, чтобы очистить весь набор параметров для предыдущей команды.
Кроме того этот метод отличается от initParams
метод в этом это поддерживает схему RowSet
объект.
SQLException
- если ошибка происходит, очищая параметрыpublic Object[] getParams() throws SQLException
RowSet
команда объекта и броски SQLException
возразите, не были ли все параметры установлены. Прежде, чем команда отправляется DBMS, который будет выполняться, этими параметрами заменят параметры заполнителя в PreparedStatement
объект, который является командой для a RowSet
реализация, расширяющаяся BaseRowSet
класс. Каждый элемент в массиве, который возвращается, Object
экземпляр, который содержит значения параметров, предоставленных методу метода set. Порядок элементов определяется значением, предоставленным для parameterIndex. Если метод метода set возьмет только индекс параметра и значение, которое будет установлено (возможно нуль), то элемент массива будет содержать значение, которое будет установлено (который будет выражен как Object
). Если будут дополнительные параметры, то элемент массива самостоятельно будет массивом, содержащим значение, которое будет установлено плюс любые дополнительные значения параметра, предоставленные методу метода set. Если метод устанавливает поток, элемент массива включает тип потока, предоставляемого методу. Эти дополнительные параметры для использования драйвера или DBMS, и можете, или, возможно, не используется.
ОТМЕТЬТЕ: Сохраненные значения параметра типов Array
, Blob
, Clob
и Ref
возвращаются как SerialArray
, SerialBlob
, SerialClob
и SerialRef
соответственно.
Object
экземпляры, который включает значения параметра, которые могут быть установлены в этом RowSet
команда объекта; пустой массив, если никакие параметры не были установленыSQLException
- если ошибка происходит retrieveing объектный массив параметров этого RowSet
возразите или если не все параметры были установленыpublic void setNull(String parameterName, int sqlType) throws SQLException
NULL
. Отметьте: следует определить тип SQL параметра.
parameterName
- имя параметраsqlType
- код типа SQL, определенный в java.sql.Types
SQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setNull(String parameterName, int sqlType, String typeName) throws SQLException
NULL
. Эта версия метода setNull
должен использоваться для определяемых пользователем типов и КАСАТЕЛЬНО параметров типа. Примеры определяемых пользователем типов включают: STRUCT, ОТЛИЧНЫЙ, JAVA_OBJECT, и названные типы массива. Отметьте: Чтобы быть переносимыми, приложения должны дать код типа SQL и полностью определенное имя типа SQL, определяя определяемый пользователем НУЛЬ или КАСАТЕЛЬНО параметра. В случае определяемого пользователем типа имя является именем типа параметра непосредственно. Для КАСАТЕЛЬНО параметра, имя является именем типа типа, на который ссылаются. Если драйвер JDBC не нуждается в кодовом названии типа или информации об имени типа, это может проигнорировать это. Хотя это предназначается для определяемого пользователем и Касательно параметров, этот метод может использоваться, чтобы установить нулевые параметры любого типа JDBC. Если у параметра нет определяемого пользователем или КАСАТЕЛЬНО типа, данное имя типа игнорируется.
parameterName
- имя параметраsqlType
- значение от java.sql.Types
typeName
- полностью определенное имя SQL определяемый пользователем тип; проигнорированный, если параметр не является определяемым пользователем типом или SQL REF
значениеSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setBoolean(String parameterName, boolean x) throws SQLException
boolean
значение. Драйвер преобразовывает это в SQL BIT
или BOOLEAN
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setByte(String parameterName, byte x) throws SQLException
byte
значение. Драйвер преобразовывает это в SQL TINYINT
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setShort(String parameterName, short x) throws SQLException
short
значение. Драйвер преобразовывает это в SQL SMALLINT
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setInt(String parameterName, int x) throws SQLException
int
значение. Драйвер преобразовывает это в SQL INTEGER
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setLong(String parameterName, long x) throws SQLException
long
значение. Драйвер преобразовывает это в SQL BIGINT
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setFloat(String parameterName, float x) throws SQLException
float
значение. Драйвер преобразовывает это в SQL FLOAT
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setDouble(String parameterName, double x) throws SQLException
double
значение. Драйвер преобразовывает это в SQL DOUBLE
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
java.math.BigDecimal
значение. Драйвер преобразовывает это в SQL NUMERIC
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setString(String parameterName, String x) throws SQLException
String
значение. Драйвер преобразовывает это в SQL VARCHAR
или LONGVARCHAR
значение (в зависимости от размера параметра относительно пределов драйвера на VARCHAR
значения), когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setBytes(String parameterName, byte[] x) throws SQLException
VARBINARY
или LONGVARBINARY
(в зависимости от размера параметра относительно пределов драйвера на VARBINARY
значения), когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setTimestamp(String parameterName, Timestamp x) throws SQLException
java.sql.Timestamp
значение. Драйвер преобразовывает это в SQL TIMESTAMP
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException
LONGVARCHAR
параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream
. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от ASCII до формата случайной работы базы данных. Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
parameterName
- имя параметраx
- входной поток Java, который содержит значение параметра ASCIIlength
- число байтов в потокеSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
LONGVARBINARY
параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream
объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
parameterName
- имя параметраx
- входной поток java, который содержит двоичное значение параметраlength
- число байтов в потокеSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException
Reader
объект, который является данным числом символов долго. Когда очень большое значение UNICODE вводится к a LONGVARCHAR
параметр, это может быть более практично, чтобы отправить это через a java.io.Reader
объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от UNICODE до формата случайной работы базы данных. Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
parameterName
- имя параметраreader
- java.io.Reader
объект, который содержит данные UNICODE, используемые в качестве определяемого параметраlength
- число символов в потокеSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setAsciiStream(String parameterName, InputStream x) throws SQLException
LONGVARCHAR
параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream
. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от ASCII до формата случайной работы базы данных. Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setAsciiStream
который берет параметр длины.
parameterName
- имя параметраx
- входной поток Java, который содержит значение параметра ASCIISQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setBinaryStream(String parameterName, InputStream x) throws SQLException
LONGVARBINARY
параметр, это может быть более практично, чтобы отправить это через a java.io.InputStream
объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setBinaryStream
который берет параметр длины.
parameterName
- имя параметраx
- входной поток java, который содержит двоичное значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setCharacterStream(String parameterName, Reader reader) throws SQLException
Reader
объект. Когда очень большое значение UNICODE вводится к a LONGVARCHAR
параметр, это может быть более практично, чтобы отправить это через a java.io.Reader
объект. Данные будут считаны из потока как необходимый, пока конец файла не будет достигнут. Драйвер JDBC сделает любое необходимое преобразование от UNICODE до формата случайной работы базы данных. Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setCharacterStream
который берет параметр длины.
parameterName
- имя параметраreader
- java.io.Reader
объект, который содержит данные UnicodeSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setNCharacterStream(int parameterIndex, Reader value) throws SQLException
RowSet
команда объекта к a Reader
объект. Reader
читает данные, пока конец файла не достигается. Драйвер делает необходимое преобразование от символьного формата Java до набора национального характера в базе данных. Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setNCharacterStream
который берет параметр длины.
parameterIndex
- из первого параметра 1, второе 2...value
- значение параметраSQLException
- если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; если ошибка доступа к базе данных происходит; или этот метод вызывают на закрытом PreparedStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException
java.lang
должны использоваться эквивалентные объекты. Данный объект Java будет преобразован в данный targetSqlType прежде, чем быть отправленным базе данных. Если у объекта есть пользовательское отображение (имеет класс, реализовывая интерфейс SQLData
), драйвер JDBC должен вызвать метод SQLData.writeSQL
записать это в поток данных SQL. Если с другой стороны объект имеет реализацию класса Ref
, Blob
, Clob
, NClob
, Struct
, java.net.URL
, или Array
, драйвер должен передать это к базе данных как значение соответствующего типа SQL.
Отметьте, что этот метод может использоваться, чтобы передать datatabase-определенные абстрактные типы данных.
parameterName
- имя параметраx
- объект, содержащий входное значение параметраtargetSqlType
- тип SQL (как определено в java.sql. Типы), чтобы быть отправленным базе данных. Параметр масштаба может далее квалифицировать этот тип.scale
- для java.sql. Типы. ДЕСЯТИЧНОЕ ЧИСЛО или java.sql. Типы. ЧИСЛОВЫЕ типы, это - число цифр после десятичной точки. Для всех других типов будет проигнорировано это значение.SQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если targetSqlType
a ARRAY
, BLOB
, CLOB
, DATALINK
, JAVA_OBJECT
, NCHAR
, NCLOB
, NVARCHAR
, LONGNVARCHAR
, REF
, ROWID
, SQLXML
или STRUCT
тип данных и драйвер JDBC не поддерживают этот тип данныхTypes
, getParams()
public void setObject(String parameterName, Object x, int targetSqlType) throws SQLException
setObject
выше, за исключением того, что это принимает масштаб нуля.parameterName
- имя параметраx
- объект, содержащий входное значение параметраtargetSqlType
- тип SQL (как определено в java.sql. Типы), чтобы быть отправленным базе данныхSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если targetSqlType
a ARRAY
, BLOB
, CLOB
, DATALINK
, JAVA_OBJECT
, NCHAR
, NCLOB
, NVARCHAR
, LONGNVARCHAR
, REF
, ROWID
, SQLXML
или STRUCT
тип данных и драйвер JDBC не поддерживают этот тип данныхgetParams()
public void setObject(String parameterName, Object x) throws SQLException
Object
; поэтому, java.lang
эквивалентные объекты должны использоваться для встроенных типов. Спецификация JDBC определяет стандартное отображение от Java Object
типы к типам SQL. Данный параметр будет преобразован в соответствующий тип SQL прежде, чем быть отправленным базе данных.
Отметьте, что этот метод может использоваться, чтобы передать datatabase-определенные абстрактные типы данных, при использовании специфичного для драйвера типа Java. Если объект имеет класс, реализовывая интерфейс SQLData
, драйвер JDBC должен вызвать метод SQLData.writeSQL
записать это в поток данных SQL. Если с другой стороны объект имеет реализацию класса Ref
, Blob
, Clob
, NClob
, Struct
, java.net.URL
, или Array
, драйвер должен передать это к базе данных как значение соответствующего типа SQL.
Этот метод выдает исключение, если есть неоднозначность, например, если объект имеет класс, реализовывая больше чем один из ранее названных интерфейсов.
parameterName
- имя параметраx
- объект, содержащий входное значение параметраSQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом CallableStatement
или если данный Object
параметр неоднозначенSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException
InputStream
объект. inputstream должен содержать число символов, определенных длиной иначе a SQLException
будет сгенерирован когда PreparedStatement
выполняется. Этот метод отличается от setBinaryStream (int, InputStream, int)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a BLOB
. Когда setBinaryStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGVARBINARY
или a BLOB
parameterIndex
- индекс первого параметра 1, второе 2...inputStream
- Объект, который содержит данные, чтобы установить значение параметра в.length
- число байтов в данных параметра.SQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом PreparedStatement
, если parameterIndex не соответствует маркеру параметра в SQL-операторе, если определенная длина является меньше чем нуль или если число байтов в inputstream не соответствует specfied длину.SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setBlob(int parameterIndex, InputStream inputStream) throws SQLException
InputStream
объект. Этот метод отличается от setBinaryStream (int, InputStream)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a BLOB
. Когда setBinaryStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGVARBINARY
или a BLOB
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setBlob
который берет параметр длины.
parameterIndex
- индекс первого параметра 1, второе 2...inputStream
- Объект, который содержит данные, чтобы установить значение параметра в.SQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом PreparedStatement
или если parameterIndex не соответствует маркеру параметра в SQL-операторе,SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
InputStream
объект. inputstream
должен содержать число символов, определенных длиной, иначе a SQLException
будет сгенерирован когда CallableStatement
выполняется. Этот метод отличается от setBinaryStream (int, InputStream, int)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a BLOB
. Когда setBinaryStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGVARBINARY
или a BLOB
parameterName
- имя параметра, который будет установлен второе, 2...inputStream
- Объект, который содержит данные, чтобы установить значение параметра в.length
- число байтов в данных параметра.SQLException
- если parameterIndex не соответствует маркеру параметра в SQL-операторе, или если определенная длина является меньше чем нуль; если число байтов в inputstream не соответствует specfied длину; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setBlob(String parameterName, Blob x) throws SQLException
java.sql.Blob
объект. Драйвер преобразовывает это в SQL BLOB
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- a Blob
возразите, что отображает SQL BLOB
значениеSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setBlob(String parameterName, InputStream inputStream) throws SQLException
InputStream
объект. Этот метод отличается от setBinaryStream (int, InputStream)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a BLOB
. Когда setBinaryStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть, передаются к серверу как a LONGVARBINARY
или a BLOB
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setBlob
который берет параметр длины.
parameterName
- имя параметраinputStream
- Объект, который содержит данные, чтобы установить значение параметра в.SQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setClob(int parameterIndex, Reader reader, long length) throws SQLException
Reader
объект. Читатель должен содержать число символов, определенных длиной иначе a SQLException
будет сгенерирован когда PreparedStatement
выполняется. Этот метод отличается от setCharacterStream (int, Reader, int)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a CLOB
. Когда setCharacterStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGVARCHAR
или a CLOB
parameterIndex
- индекс первого параметра 1, второе 2...reader
- Объект, который содержит данные, чтобы установить значение параметра в.length
- число символов в данных параметра.SQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом PreparedStatement
, если parameterIndex не соответствует маркеру параметра в SQL-операторе, или если определенная длина является меньше чем нуль.SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setClob(int parameterIndex, Reader reader) throws SQLException
Reader
объект. Этот метод отличается от setCharacterStream (int, Reader)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a CLOB
. Когда setCharacterStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGVARCHAR
или a CLOB
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setClob
который берет параметр длины.
parameterIndex
- индекс первого параметра 1, второе 2...reader
- Объект, который содержит данные, чтобы установить значение параметра в.SQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом PreparedStatement
или если parameterIndex не соответствует маркеру параметра в SQL-оператореSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setClob(String parameterName, Reader reader, long length) throws SQLException
Reader
объект. reader
должен содержать число символов, определенных длиной иначе a SQLException
будет сгенерирован когда CallableStatement
выполняется. Этот метод отличается от setCharacterStream (int, Reader, int)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a CLOB
. Когда setCharacterStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть, передаются к серверу как a LONGVARCHAR
или a CLOB
parameterName
- имя параметра, который будет установленreader
- Объект, который содержит данные, чтобы установить значение параметра в.length
- число символов в данных параметра.SQLException
- если parameterIndex не соответствует маркеру параметра в SQL-операторе; если определенная длина является меньше чем нуль; ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setClob(String parameterName, Clob x) throws SQLException
java.sql.Clob
объект. Драйвер преобразовывает это в SQL CLOB
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- a Clob
возразите, что отображает SQL CLOB
значениеSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setClob(String parameterName, Reader reader) throws SQLException
Reader
объект. Этот метод отличается от setCharacterStream (int, Reader)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a CLOB
. Когда setCharacterStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть, передаются к серверу как a LONGVARCHAR
или a CLOB
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setClob
который берет параметр длины.
parameterName
- имя параметраreader
- Объект, который содержит данные, чтобы установить значение параметра в.SQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setDate(String parameterName, Date x) throws SQLException
java.sql.Date
значение используя часовой пояс по умолчанию виртуальной машины, которая запускает приложение. Драйвер преобразовывает это в SQL DATE
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setDate(String parameterName, Date x, Calendar cal) throws SQLException
java.sql.Date
значение, используя данный Calendar
объект. Драйвер использует Calendar
возразите, чтобы создать SQL DATE
значение, которое драйвер тогда отправляет базе данных. С a Calendar
объект, драйвер может вычислить дату, принимающую во внимание пользовательский часовой пояс. Если нет Calendar
объект определяется, драйвер использует часовой пояс по умолчанию, который является часовым поясом виртуальной машины, запускающей приложение.parameterName
- имя параметраx
- значение параметраcal
- Calendar
возразите, что драйвер будет использовать, чтобы создать датуSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setTime(String parameterName, Time x) throws SQLException
java.sql.Time
значение. Драйвер преобразовывает это в SQL TIME
оцените, когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setTime(String parameterName, Time x, Calendar cal) throws SQLException
java.sql.Time
значение, используя данный Calendar
объект. Драйвер использует Calendar
возразите, чтобы создать SQL TIME
значение, которое драйвер тогда отправляет базе данных. С a Calendar
объект, драйвер может вычислить время, принимая во внимание пользовательский часовой пояс. Если нет Calendar
объект определяется, драйвер использует часовой пояс по умолчанию, который является часовым поясом виртуальной машины, запускающей приложение.parameterName
- имя параметраx
- значение параметраcal
- Calendar
возразите, что драйвер будет использовать, чтобы создать времяSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException
java.sql.Timestamp
значение, используя данный Calendar
объект. Драйвер использует Calendar
возразите, чтобы создать SQL TIMESTAMP
значение, которое драйвер тогда отправляет базе данных. С a Calendar
объект, драйвер может вычислить метку времени, принимающую во внимание пользовательский часовой пояс. Если нет Calendar
объект определяется, драйвер использует часовой пояс по умолчанию, который является часовым поясом виртуальной машины, запускающей приложение.parameterName
- имя параметраx
- значение параметраcal
- Calendar
возразите, что драйвер будет использовать, чтобы создать метку времениSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методgetParams()
public void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException
java.sql.SQLXML
объект. Драйвер преобразовывает это в SQL XML
оцените, когда это отправляет это базе данных.parameterIndex
- индекс первого параметра 1, второе 2...xmlObject
- a SQLXML
возразите, что отображает SQL XML
значениеSQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом наборе результатов, java.xml.transform.Result
, Writer
или OutputStream
не был закрыт для SQLXML
возразите или если есть ошибка, обрабатывая значение XML. getCause
метод исключения может обеспечить более подробное исключение, например, если поток не содержит допустимый XML.public void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException
java.sql.SQLXML
объект. Драйвер преобразовывает это в SQL XML
оцените, когда это отправляет это базе данных.parameterName
- имя параметраxmlObject
- a SQLXML
возразите что карты SQL XML
значениеSQLException
- если ошибка доступа к базе данных происходит, этот метод вызывают на закрытом наборе результатов, java.xml.transform.Result
, Writer
или OutputStream
не был закрыт для SQLXML
возразите или если есть ошибка, обрабатывая значение XML. getCause
метод исключения может обеспечить более подробное исключение, например, если поток не содержит допустимый XML.public void setRowId(int parameterIndex, RowId x) throws SQLException
java.sql.RowId
объект. Драйвер преобразовывает это в SQL ROWID
оцените, когда это отправляет это базе данныхparameterIndex
- первый параметр 1, второе 2...x
- значение параметраSQLException
- если ошибка доступа к базе данных происходитpublic void setRowId(String parameterName, RowId x) throws SQLException
java.sql.RowId
объект. Драйвер преобразовывает это в SQL ROWID
когда это отправляет это базе данных.parameterName
- имя параметраx
- значение параметраSQLException
- если ошибка доступа к базе данных происходитpublic void setNString(int parameterIndex, String value) throws SQLException
String
объект. Драйвер преобразовывает это в SQL NCHAR
или NVARCHAR
или LONGNVARCHAR
значение (в зависимости от размера параметра относительно пределов драйвера на NVARCHAR
значения), когда это отправляет это базе данных.parameterIndex
- из первого параметра 1, второе 2...value
- значение параметраSQLException
- если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; или если ошибка доступа к базе данных происходитpublic void setNString(String parameterName, String value) throws SQLException
String
объект. Драйвер преобразовывает это в SQL NCHAR
или NVARCHAR
или LONGNVARCHAR
parameterName
- имя столбца, который будет установленvalue
- значение параметраSQLException
- если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; или если ошибка доступа к базе данных происходитpublic void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException
Reader
объект. Reader
читает данные, пока конец файла не достигается. Драйвер делает необходимое преобразование от символьного формата Java до набора национального характера в базе данных.parameterIndex
- из первого параметра 1, второе 2...value
- значение параметраlength
- число символов в данных параметра.SQLException
- если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; или если ошибка доступа к базе данных происходитpublic void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
Reader
объект. Reader
читает данные, пока конец файла не достигается. Драйвер делает необходимое преобразование от символьного формата Java до набора национального характера в базе данных.parameterName
- имя столбца, который будет установленvalue
- значение параметраlength
- число символов в данных параметра.SQLException
- если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; или если ошибка доступа к базе данных происходитpublic void setNCharacterStream(String parameterName, Reader value) throws SQLException
Reader
объект. Reader
читает данные, пока конец файла не достигается. Драйвер делает необходимое преобразование от символьного формата Java до набора национального характера в базе данных. Отметьте: Этот потоковый объект может или быть стандартным потоковым объектом Java или Вашим собственным подклассом, который реализует стандартный интерфейс.
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setNCharacterStream
который берет параметр длины.
parameterName
- имя параметраvalue
- значение параметраSQLException
- если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; если ошибка доступа к базе данных происходит; или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setNClob(String parameterName, NClob value) throws SQLException
java.sql.NClob
объект. Объект реализует java.sql.NClob
интерфейс. Это NClob
возразите отображается на SQL NCLOB
.parameterName
- имя столбца, который будет установленvalue
- значение параметраSQLException
- если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; или если ошибка доступа к базе данных происходитpublic void setNClob(String parameterName, Reader reader, long length) throws SQLException
Reader
объект. reader
должен содержать * число символов, определенных длиной иначе a SQLException
будет сгенерирован когда CallableStatement
выполняется. Этот метод отличается от setCharacterStream (int, Reader, int)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a NCLOB
. Когда setCharacterStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть, передаются к серверу как a LONGNVARCHAR
или a NCLOB
parameterName
- имя параметра, который будет установленreader
- Объект, который содержит данные, чтобы установить значение параметра в.length
- число символов в данных параметра.SQLException
- если parameterIndex не соответствует маркеру параметра в SQL-операторе; если определенная длина является меньше чем нуль; если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setNClob(String parameterName, Reader reader) throws SQLException
Reader
объект. Этот метод отличается от setCharacterStream (int, Reader)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a NCLOB
. Когда setCharacterStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть, передаются к серверу как a LONGNVARCHAR
или a NCLOB
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setNClob
который берет параметр длины.
parameterName
- имя параметраreader
- Объект, который содержит данные, чтобы установить значение параметра в.SQLException
- если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом CallableStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setNClob(int parameterIndex, Reader reader, long length) throws SQLException
Reader
объект. Читатель должен содержать число символов, определенных длиной иначе a SQLException
будет сгенерирован когда PreparedStatement
выполняется. Этот метод отличается от setCharacterStream (int, Reader, int)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a NCLOB
. Когда setCharacterStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGNVARCHAR
или a NCLOB
parameterIndex
- индекс первого параметра 1, второе 2...reader
- Объект, который содержит данные, чтобы установить значение параметра в.length
- число символов в данных параметра.SQLException
- если parameterIndex не соответствует маркеру параметра в SQL-операторе; если определенная длина является меньше чем нуль; если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setNClob(int parameterIndex, NClob value) throws SQLException
java.sql.NClob
объект. Драйвер преобразовывает этот полный SQL NCLOB
оцените, когда это отправляет это базе данных.parameterIndex
- из первого параметра 1, второе 2...value
- значение параметраSQLException
- если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; или если ошибка доступа к базе данных происходитpublic void setNClob(int parameterIndex, Reader reader) throws SQLException
Reader
объект. Этот метод отличается от setCharacterStream (int, Reader)
метод, потому что это сообщает драйверу, что значение параметра должно быть отправлено серверу как a NCLOB
. Когда setCharacterStream
метод используется, драйверу, вероятно, придется сделать дополнительную работу, чтобы определить, должны ли данные параметра быть отправлены серверу как a LONGNVARCHAR
или a NCLOB
Отметьте: Консультируйтесь со своей документацией драйвера JDBC, чтобы определить, могло ли бы быть более эффективно использовать версию setNClob
который берет параметр длины.
parameterIndex
- индекс первого параметра 1, второе 2...reader
- Объект, который содержит данные, чтобы установить значение параметра в.SQLException
- если parameterIndex не соответствует маркеру параметра в SQL-операторе; если драйвер не поддерживает наборы национального характера; если драйвер может обнаружить, что ошибка преобразования данных могла произойти; если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методpublic void setURL(int parameterIndex, URL x) throws SQLException
java.net.URL
значение. Драйвер преобразовывает это в SQL DATALINK
оцените, когда это отправляет это базе данных.parameterIndex
- первый параметр 1, второе 2...x
- java.net.URL
объект, который будет установленSQLException
- если ошибка доступа к базе данных происходит, или этот метод вызывают на закрытом PreparedStatement
SQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот метод
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.