Класс SQLInputImpl

java.lang.Object

javax.sql.rowset.serial.SQLInputImpl

Все реализованные интерфейсы:: SQLInput

public class SQLInputImpl extends Object implements SQLInput

Входной поток, используемый для пользовательского сопоставления типов, определяемых пользователем (UDT). Объект SQLInputImpl — это входной поток, содержащий последовательность значений, являющихся атрибутами UDT.

Этот класс используется драйвером в фоновом режиме при вызове метода getObject для структурированного или DISTINCT-типа SQL с пользовательским сопоставлением; программист никогда не вызывает методы SQLInputImpl напрямую. Они предоставлены здесь для удобства тех, кто пишет реализации RowSet.

Класс SQLInputImpl предоставляет набор методов чтения, аналогичных методам получения ResultSet. Эти методы позволяют считывать значения из объекта SQLInputImpl.

Метод wasNull используется для определения того, было ли последнее прочитанное значение значением SQL NULL.

Когда метод getObject вызывается с объектом класса, реализующего интерфейс SQLData, драйвер JDBC вызывает метод SQLData.getSQLType, чтобы определить тип SQL пользовательского типа UDT. Драйвер создает экземпляр SQLInputImpl и заполняет его атрибутами UDT. Затем драйвер передает входной поток методу SQLData.readSQL, который, в свою очередь, вызывает методы чтения SQLInputImpl для считывания атрибутов из входного потока.

Начиная с:

1.5

См. также:

Краткое описание конструкторов

Конструктор	Описание
`SQLInputImpl(Object[] attributes, Map<String,Class<?>> map)`	Создает объект `SQLInputImpl`, инициализированный заданным массивом атрибутов и заданной картой типов.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Array`	`readArray()`	Считывает из потока значение SQL `ARRAY` и возвращает его как объект `Array` в языке программирования Java.
`InputStream`	`readAsciiStream()`	Возвращает следующий атрибут этого объекта `SQLInputImpl` как поток символов ASCII.
`BigDecimal`	`readBigDecimal()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как `java.math.BigDecimal`.
`InputStream`	`readBinaryStream()`	Возвращает следующий атрибут этого объекта `SQLInputImpl` как поток необработанных байтов.
`Blob`	`readBlob()`	Извлекает значение `BLOB` в начале этого объекта `SQLInputImpl` как объект `Blob` в языке программирования Java.
`boolean`	`readBoolean()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как `boolean` в языке программирования Java.
`byte`	`readByte()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как `byte` в языке программирования Java.
`byte[]`	`readBytes()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как массив байтов.
`Reader`	`readCharacterStream()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как поток символов Unicode.
`Clob`	`readClob()`	Извлекает значение `CLOB` в начале этого объекта `SQLInputImpl` как объект `Clob` в языке программирования Java.
`Date`	`readDate()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как объект `java.sql.Date`.
`double`	`readDouble()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как `double` в языке программирования Java.
`float`	`readFloat()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как `float` в языке программирования Java.
`int`	`readInt()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как `int` в языке программирования Java.
`long`	`readLong()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как `long` в языке программирования Java.
`NClob`	`readNClob()`	Считывает из потока значение SQL `NCLOB` и возвращает его как объект `Clob` в языке программирования Java.
`String`	`readNString()`	Считывает следующий атрибут из потока и возвращает его как `String` в языке программирования Java.
`Object`	`readObject()`	Извлекает значение в начале этого объекта `SQLInputImpl` как `Object` в языке программирования Java.
`Ref`	`readRef()`	Извлекает значение в начале этого объекта `SQLInputImpl` как объект `Ref` в языке программирования Java.
`RowId`	`readRowId()`	Считывает из потока значение SQL `ROWID` и возвращает его как объект `RowId` в языке программирования Java.
`short`	`readShort()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как `short` в языке программирования Java.
`SQLXML`	`readSQLXML()`	Считывает из потока значение SQL `XML` и возвращает его как объект `SQLXML` в языке программирования Java.
`String`	`readString()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как `String` в языке программирования Java.
`Time`	`readTime()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как объект `java.sql.Time`.
`Timestamp`	`readTimestamp()`	Извлекает следующий атрибут этого объекта `SQLInputImpl` как объект `java.sql.Timestamp`.
`URL`	`readURL()`	Считывает из потока значение SQL `DATALINK` и возвращает его как объект `URL` в языке программирования Java.
`boolean`	`wasNull()`	Определяет, было ли последнее значение, считанное из этого объекта `SQLInputImpl`, значением `null`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного периода реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного периода реального времени.

Методы, объявленные в интерфейсе SQLInput

readObject

Модификатор и тип	Метод	Описание
`default <T> T`	`readObject(Class<T> type)`	Считывает следующий атрибут из потока и возвращает его как `Object` в языке программирования Java.

Подробное описание конструкторов

SQLInputImpl

public SQLInputImpl(Object[] attributes, Map<String,Class<?>> map) throws SQLException

Создает объект SQLInputImpl, инициализированный указанным массивом атрибутов и указанной картой типов. Если какой-либо из атрибутов является UDT, имя которого содержится в записи карты типов, атрибут будет сопоставлен в соответствии с соответствующей реализацией SQLData.

Параметры:: attributes — массив экземпляров Object, в котором каждый элемент является атрибутом UDT. Порядок атрибутов в массиве совпадает с порядком, в котором атрибуты были определены в описании UDT.; map — объект java.util.Map, содержащий ноль или более записей. Каждая запись состоит из 1) объекта String, задающего полное имя UDT, и 2) объекта Class для реализации SQLData, определяющей способ сопоставления UDT
Исключения:: SQLException — если attributes или map имеет значение null

Подробное описание методов

readString

public String readString() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl как String в языке программирования Java.

Этот метод не выполняет проверку безопасности типов, чтобы определить, соответствует ли возвращаемый тип ожидаемому; эта ответственность возлагается на сопоставление UDT, определяемое реализацией SQLData.

Определено в:: readString в интерфейсе SQLInput
Возвращает:: следующий атрибут в этом объекте SQLInputImpl; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readBoolean

public boolean readBoolean() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl как boolean в языке программирования Java.

Определено в:: readBoolean в интерфейсе SQLInput
Возвращает:: следующий атрибут в этом объекте SQLInputImpl; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readByte

public byte readByte() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl как byte в языке программирования Java.

Определено в:: readByte в интерфейсе SQLInput
Возвращает:: следующий атрибут в этом объекте SQLInputImpl; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений

readShort

public short readShort() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl как short в языке программирования Java.

Определено в:: readShort в интерфейсе SQLInput
Возвращает:: следующий атрибут в этом объекте SQLInputImpl; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений

readInt

public int readInt() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl как int в языке программирования Java.

Определено в:: readInt в интерфейсе SQLInput
Возвращает:: следующий атрибут в этом объекте SQLInputImpl; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений

readLong

public long readLong() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl как long в языке программирования Java.

Определено в:: readLong в интерфейсе SQLInput
Возвращает:: следующий атрибут в этом объекте SQLInputImpl; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений

readFloat

public float readFloat() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl как float в языке программирования Java.

Определено в:: readFloat в интерфейсе SQLInput
Возвращает:: следующий атрибут в этом объекте SQLInputImpl; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений

readDouble

public double readDouble() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl как double в языке программирования Java.

Определено в:: readDouble в интерфейсе SQLInput
Возвращает:: следующий атрибут в этом объекте SQLInputImpl; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений

readBigDecimal

public BigDecimal readBigDecimal() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl как java.math.BigDecimal.

Определено в:: readBigDecimal в интерфейсе SQLInput
Возвращает:: следующий атрибут в этом объекте SQLInputImpl; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений

readBytes

public byte[] readBytes() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl в виде массива байтов.

Определено в:: readBytes в интерфейсе SQLInput
Возвращает:: следующий атрибут в этом объекте SQLInputImpl; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений

readDate

public Date readDate() throws SQLException

Извлекает следующий атрибут из этого SQLInputImpl как объект java.sql.Date.

Определено в:: readDate в интерфейсе SQLInput
Возвращает:: следующий атрибут в этом объекте SQLInputImpl; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений

readTime

public Time readTime() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl как объект java.sql.Time.

Этот метод не выполняет проверку безопасности типов, чтобы определить, соответствует ли возвращаемый тип ожидаемому; эта ответственность возлагается на сопоставление UDT, реализованное с помощью реализации SQLData.

Определено в:: readTime в интерфейсе SQLInput
Возвращает:: атрибут; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readTimestamp

public Timestamp readTimestamp() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl как объект java.sql.Timestamp.

Определено в:: readTimestamp в интерфейсе SQLInput
Возвращает:: атрибут; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readCharacterStream

public Reader readCharacterStream() throws SQLException

Извлекает следующий атрибут из этого объекта SQLInputImpl в виде потока символов Юникода.

Этот метод не выполняет проверку безопасности типов, чтобы определить, соответствует ли возвращаемый тип ожидаемому; эта ответственность возлагается на сопоставление UDT, реализованное с помощью реализации SQLData.

Определено в:: readCharacterStream в интерфейсе SQLInput
Возвращает:: атрибут; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readAsciiStream

public InputStream readAsciiStream() throws SQLException

Возвращает следующий атрибут из этого объекта SQLInputImpl в виде потока символов ASCII.

Этот метод не выполняет проверку безопасности типов, чтобы определить, соответствует ли возвращаемый тип ожидаемому; эта ответственность возлагается на сопоставление UDT, реализованное с помощью реализации SQLData.

Определено в:: readAsciiStream в интерфейсе SQLInput
Возвращает:: атрибут; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readBinaryStream

public InputStream readBinaryStream() throws SQLException

Возвращает следующий атрибут из этого объекта SQLInputImpl в виде потока необработанных байтов.

Этот метод не выполняет проверку безопасности типов, чтобы определить, соответствует ли возвращаемый тип ожидаемому; эта ответственность возлагается на сопоставление UDT, реализованное с помощью реализации SQLData.

Определено в:: readBinaryStream в интерфейсе SQLInput
Возвращает:: атрибут; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readObject

public Object readObject() throws SQLException

Извлекает значение в начале этого объекта SQLInputImpl как Object в языке программирования Java. Фактический тип возвращаемого объекта определяется сопоставлением SQL-типов с типами языка программирования Java по умолчанию, если не используется пользовательское сопоставление; в этом случае тип возвращаемого объекта определяется картой типов этого потока.

Драйвер с поддержкой технологии JDBC регистрирует карту типов для потока перед передачей потока приложению.

Если элемент данных в начале потока является SQL NULL, этот метод возвращает null. Если элемент данных является структурированным SQL-типом или DISTINCT-типом с пользовательским сопоставлением, этот метод определяет SQL-тип элемента данных в начале потока, создает объект соответствующего класса и вызывает для этого объекта метод SQLData.readSQL. Затем метод readSQL вызывает соответствующие методы SQLInputImpl.readXXX для извлечения значений атрибутов из потока.

Определено в:: readObject в интерфейсе SQLInput
Возвращает:: значение в начале потока как Object в языке программирования Java; null, если значение имеет тип SQL NULL
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readRef

public Ref readRef() throws SQLException

Извлекает значение в начале этого объекта SQLInputImpl как объект Ref в языке программирования Java.

Определено в:: readRef в интерфейсе SQLInput
Возвращает:: объект Ref, представляющий значение SQL REF в начале потока; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readBlob

public Blob readBlob() throws SQLException

Извлекает значение BLOB в начале этого объекта SQLInputImpl как объект Blob в языке программирования Java.

Этот метод не выполняет проверку безопасности типов, чтобы определить, соответствует ли возвращаемый тип ожидаемому; эта ответственность возлагается на сопоставление UDT, реализованное с помощью реализации SQLData.

Определено в:: readBlob в интерфейсе SQLInput
Возвращает:: объект Blob, представляющий значение SQL BLOB в начале этого потока; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readClob

public Clob readClob() throws SQLException

Извлекает значение CLOB в начале этого объекта SQLInputImpl как объект Clob в языке программирования Java.

Этот метод не выполняет проверку безопасности типов, чтобы определить, соответствует ли возвращаемый тип ожидаемому; эта ответственность возлагается на сопоставление UDT, реализованное с помощью реализации SQLData.

Определено в:: readClob в интерфейсе SQLInput
Возвращает:: объект Clob, представляющий значение SQL CLOB в начале потока; если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readArray

public Array readArray() throws SQLException

Считывает из потока значение SQL ARRAY и возвращает его как объект Array в языке программирования Java.

Этот метод не выполняет проверку безопасности типов, чтобы определить, соответствует ли возвращаемый тип ожидаемому; эта ответственность возлагается на сопоставление UDT, реализованное с помощью реализации SQLData.

Определено в:: readArray в интерфейсе SQLInput
Возвращает:: объект Array, представляющий значение SQL ARRAY в начале потока; * если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

wasNull

public boolean wasNull() throws SQLException

Определяет, было ли последнее значение, считанное из этого объекта SQLInputImpl, равно null.

Определено в:: wasNull в интерфейсе SQLInput
Возвращает:: true, если последнее считанное значение SQL было равно null; в противном случае — false; по умолчанию возвращает false
Исключения:: SQLException — если при определении того, было ли последнее считанное значение значением null, произошла ошибка;

readURL

public URL readURL() throws SQLException

Считывает из потока значение SQL DATALINK и возвращает его как объект URL в языке программирования Java.

Этот метод не выполняет проверку безопасности типов, чтобы определить, соответствует ли возвращаемый тип ожидаемому; эта ответственность возлагается на сопоставление UDT, реализованное с помощью реализации SQLData.

Определено в:: readURL в интерфейсе SQLInput
Возвращает:: объект URL, представляющий значение SQL DATALINK в начале потока; * если значение равно SQL NULL, возвращает null
Исключения:: SQLException — если позиция чтения недопустима или в потоке больше нет значений.

readNClob

public NClob readNClob() throws SQLException

Считывает из потока значение SQL NCLOB и возвращает его как объект Clob в языке программирования Java.

Определено в:: readNClob в интерфейсе SQLInput
Возвращает:: объект NClob, представляющий данные значения SQL NCLOB в начале потока; null, если считанное значение имеет тип SQL NULL
Исключения:: SQLException — если произошла ошибка доступа к базе данных
Начиная с версии:: 1.6

readNString

public String readNString() throws SQLException

Считывает следующий атрибут из потока и возвращает его как String в языке программирования Java. Предназначен для использования при доступе к столбцам NCHAR, NVARCHAR и LONGNVARCHAR.

Определено в:: readNString в интерфейсе SQLInput
Возвращает:: атрибут; если значение имеет тип SQL NULL, возвращает null
Исключения:: SQLException — если произошла ошибка доступа к базе данных
Начиная с версии:: 1.6

readSQLXML

public SQLXML readSQLXML() throws SQLException

Считывает из потока значение SQL XML и возвращает его как объект SQLXML в языке программирования Java.

Определено в:: readSQLXML в интерфейсе SQLInput
Возвращает:: объект SQLXML, представляющий данные значения SQL XML в начале потока; null, если считанное значение имеет тип SQL NULL
Исключения:: SQLException — если произошла ошибка доступа к базе данных
Начиная с версии:: 1.6

readRowId

public RowId readRowId() throws SQLException

Считывает из потока значение SQL ROWID и возвращает его как объект RowId в языке программирования Java.

Определено в:: readRowId в интерфейсе SQLInput
Возвращает:: объект RowId, представляющий данные значения SQL ROWID в начале потока; null, если считанное значение имеет тип SQL NULL
Исключения:: SQLException — если произошла ошибка доступа к базе данных
Начиная с версии:: 1.6

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.