Класс SQLInputImpl

java.lang.Object

javax.sql.rowset.serial.SQLInputImpl

Все реализуемые интерфейсы:: SQLInput

public class SQLInputImpl extends Object implements SQLInput

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

Этот класс используется драйвером внутри при вызове метода getObject для структурированного или отличного 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

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

readObject

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

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 как поток символов Unicode.

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

readAsciiStream

public InputStream readAsciiStream() throws SQLException

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

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

readBinaryStream

public InputStream readBinaryStream() throws SQLException

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

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

readObject

public Object readObject() throws SQLException

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

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

Если значение в начале потока является SQL NULL, этот метод возвращает null. Если значение является структурированным или distinct-типом SQL с пользовательским сопоставлением, этот метод определяет 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.

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

readClob

public Clob readClob() throws SQLException

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

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

readArray

public Array readArray() throws SQLException

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

Определено в:: 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.

Определено в:: 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.sql.rowset/javax/sql/rowset/serial/SQLInputImpl.html