Класс SQLOutputImpl

java.lang.Object

javax.sql.rowset.serial.SQLOutputImpl

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

public class SQLOutputImpl extends Object implements SQLOutput

Поток вывода для записи атрибутов пользовательского типа данных (UDT) с пользовательским отображением обратно в базу данных. Драйвер использует этот интерфейс внутри, и его методы никогда не вызываются программистом приложения напрямую.

Когда приложение вызывает метод PreparedStatement.setObject, драйвер проверяет, является ли значение, подлежащее записи, UDT с пользовательским отображением. Если это так, в карте типов будет запись, содержащая объект Class для класса, реализующего SQLData для данного UDT. Если значение, подлежащее записи, является экземпляром SQLData, драйвер создаст экземпляр SQLOutputImpl и передаст его методу SQLData.writeSQL. Метод writeSQL в свою очередь вызывает соответствующие методы SQLOutputImpl.writeXXX для записи данных из объекта SQLData в поток вывода SQLOutputImpl как представление SQL пользовательского типа данных.

С:: 1.5

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

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

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

Модификатор и тип	Метод	Описание
`void`	`writeArray(Array x)`	Записывает объект `Array` языка Java в этот объект `SQLOutputImpl`.
`void`	`writeAsciiStream(InputStream x)`	Записывает последовательность ASCII-символов в этот объект `SQLOutputImpl`.
`void`	`writeBigDecimal(BigDecimal x)`	Записывает объект `java.math.BigDecimal` языка Java в этот объект `SQLOutputImpl`.
`void`	`writeBinaryStream(InputStream x)`	Записывает последовательность неинтерпретируемых байтов в этот объект `SQLOutputImpl`.
`void`	`writeBlob(Blob x)`	Записывает объект `Blob` языка Java в этот объект `SQLOutputImpl`.
`void`	`writeBoolean(boolean x)`	Записывает `boolean` на языке Java в этот объект `SQLOutputImpl`.
`void`	`writeByte(byte x)`	Записывает `byte` на языке Java в этот объект `SQLOutputImpl`.
`void`	`writeBytes(byte[] x)`	Записывает массив `bytes` на языке Java в этот объект `SQLOutputImpl`.
`void`	`writeCharacterStream(Reader x)`	Записывает последовательность символов Юникода в этот объект `SQLOutputImpl`.
`void`	`writeClob(Clob x)`	Записывает объект `Clob` языка Java в этот объект `SQLOutputImpl`.
`void`	`writeDate(Date x)`	Записывает объект `java.sql.Date` языка Java в этот объект `SQLOutputImpl`.
`void`	`writeDouble(double x)`	Записывает `double` на языке Java в этот объект `SQLOutputImpl`.
`void`	`writeFloat(float x)`	Записывает `float` на языке Java в этот объект `SQLOutputImpl`.
`void`	`writeInt(int x)`	Записывает `int` на языке Java в этот объект `SQLOutputImpl`.
`void`	`writeLong(long x)`	Записывает `long` на языке Java в этот объект `SQLOutputImpl`.
`void`	`writeNClob(NClob x)`	Записывает значение SQL `NCLOB` в поток.
`void`	`writeNString(String x)`	Записывает следующий атрибут в поток как `String` на языке Java.
`void`	`writeObject(SQLData x)`	Записывает в поток данные, содержащиеся в заданном объекте `SQLData`.
`void`	`writeRef(Ref x)`	Записывает объект `Ref` языка Java в этот объект `SQLOutputImpl`.
`void`	`writeRowId(RowId x)`	Записывает значение SQL `ROWID` в поток.
`void`	`writeShort(short x)`	Записывает `short` на языке Java в этот объект `SQLOutputImpl`.
`void`	`writeSQLXML(SQLXML x)`	Записывает значение SQL `XML` в поток.
`void`	`writeString(String x)`	Записывает `String` на языке Java в этот объект `SQLOutputImpl`.
`void`	`writeStruct(Struct x)`	Записывает объект `Struct` языка Java в этот объект `SQLOutputImpl`.
`void`	`writeTime(Time x)`	Записывает объект `java.sql.Time` языка Java в этот объект `SQLOutputImpl`.
`void`	`writeTimestamp(Timestamp x)`	Записывает объект `java.sql.Timestamp` языка Java в этот объект `SQLOutputImpl`.
`void`	`writeURL(URL url)`	Записывает объект `java.sql.Type.DATALINK` языка Java в этот объект `SQLOutputImpl`.

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

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

Методы, объявленные в интерфейсе java.sql.SQLOutput

writeObject

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

SQLOutputImpl

public SQLOutputImpl(Vector<?> attributes, Map<String,?> map) throws SQLException

Создаёт новый объект SQLOutputImpl, инициализированный заданным вектором атрибутов и картой типов. Драйвер будет использовать карту типов для определения, какой метод SQLData.writeSQL вызвать. Затем этот метод последовательно вызовет соответствующие методы записи атрибутов SQLOutputImpl, тем самым записывая атрибуты в новый поток вывода.

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

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

writeString

public void writeString(String x) throws SQLException

Записывает строковое значение String языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL CHAR, VARCHAR или LONGVARCHAR перед возвращением в базу данных.

Определено в:: writeString в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeBoolean

public void writeBoolean(boolean x) throws SQLException

Записывает логическое значение boolean языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL BIT перед возвращением в базу данных.

Определено в:: writeBoolean в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeByte

public void writeByte(byte x) throws SQLException

Записывает байтовое значение byte языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL BIT перед возвращением в базу данных.

Определено в:: writeByte в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeShort

public void writeShort(short x) throws SQLException

Записывает короткое целое число short языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL SMALLINT перед возвращением в базу данных.

Определено в:: writeShort в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeInt

public void writeInt(int x) throws SQLException

Записывает целое число int языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL INTEGER перед возвращением в базу данных.

Определено в:: writeInt в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeLong

public void writeLong(long x) throws SQLException

Записывает длинное целое число long языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL BIGINT перед возвращением в базу данных.

Определено в:: writeLong в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeFloat

public void writeFloat(float x) throws SQLException

Записывает число с плавающей точкой float языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL REAL перед возвращением в базу данных.

Определено в:: writeFloat в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeDouble

public void writeDouble(double x) throws SQLException

Записывает число с двойной точностью double языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL DOUBLE перед возвращением в базу данных.

Определено в:: writeDouble в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeBigDecimal

public void writeBigDecimal(BigDecimal x) throws SQLException

Записывает объект java.math.BigDecimal языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL NUMERIC перед возвращением в базу данных.

Определено в:: writeBigDecimal в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeBytes

public void writeBytes(byte[] x) throws SQLException

Записывает массив байтов bytes языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL VARBINARY или LONGVARBINARY перед возвращением в базу данных.

Определено в:: writeBytes в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeDate

public void writeDate(Date x) throws SQLException

Записывает объект java.sql.Date языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL DATE перед возвращением в базу данных.

Определено в:: writeDate в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeTime

public void writeTime(Time x) throws SQLException

Записывает объект java.sql.Time языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL TIME перед возвращением в базу данных.

Определено в:: writeTime в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeTimestamp

public void writeTimestamp(Timestamp x) throws SQLException

Записывает объект java.sql.Timestamp языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL TIMESTAMP перед возвратом в базу данных.

Определено в:: writeTimestamp в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать атрибуты UDT в базу данных.

writeCharacterStream

public void writeCharacterStream(Reader x) throws SQLException

Записывает поток символов Unicode в этот объект SQLOutputImpl. Драйвер выполнит необходимое преобразование из Unicode в формат базы данных CHAR.

Определено в:: writeCharacterStream в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать атрибуты UDT в базу данных.

writeAsciiStream

public void writeAsciiStream(InputStream x) throws SQLException

Записывает поток ASCII-символов в этот объект SQLOutputImpl. Драйвер выполнит необходимое преобразование из ASCII в формат базы данных CHAR.

Определено в:: writeAsciiStream в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать атрибуты UDT в базу данных.

writeBinaryStream

public void writeBinaryStream(InputStream x) throws SQLException

Записывает поток неинтерпретированных байтов в этот объект SQLOutputImpl.

Определено в:: writeBinaryStream в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать атрибуты UDT в базу данных.

writeObject

public void writeObject(SQLData x) throws SQLException

Записывает в поток данные, содержащиеся в заданном объекте SQLData. Если объект SQLData является null, этот метод записывает в поток SQL NULL. В противном случае он вызывает метод SQLData.writeSQL заданного объекта, который записывает атрибуты объекта в поток.

Реализация метода SQLData.writeSQ вызывает соответствующие методы SQLOutputImpl.writeXXX для записи каждого атрибута объекта в порядке. Атрибуты должны быть прочитаны из потока ввода SQLInput и записаны в поток вывода SQLOutputImpl в том же порядке, в котором они были перечислены в SQL-определении пользовательского типа.

Определено в:: writeObject в интерфейсе SQLOutput
Параметры:: x - объект, представляющий данные SQL-структурированного или отдельных типов
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать атрибуты UDT в базу данных.

writeRef

public void writeRef(Ref x) throws SQLException

Записывает объект Ref языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в сериализуемое SerialRef SQL REF значение перед возвратом в базу данных.

Определено в:: writeRef в интерфейсе SQLOutput
Параметры:: x - объект, представляющий SQL REF значение
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать атрибуты UDT в базу данных.

writeBlob

public void writeBlob(Blob x) throws SQLException

Записывает объект Blob языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в сериализуемое SerialBlob SQL BLOB значение перед возвратом в базу данных.

Определено в:: writeBlob в интерфейсе SQLOutput
Параметры:: x - объект, представляющий SQL BLOB значение
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать атрибуты UDT в базу данных.

writeClob

public void writeClob(Clob x) throws SQLException

Записывает объект Clob языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в сериализуемое SerialClob SQL CLOB значение перед возвратом в базу данных.

Определено в:: writeClob в интерфейсе SQLOutput
Параметры:: x - объект, представляющий SQL CLOB значение
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать атрибуты UDT в базу данных.

writeStruct

public void writeStruct(Struct x) throws SQLException

Записывает объект Struct языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует это значение в структурированный SQL тип перед возвратом в базу данных.

Этот метод следует использовать, когда SQL структурированный тип был сопоставлен с объектом Struct языка программирования Java (стандартное отображение). Метод writeObject следует использовать, если SQL структурированный тип был настроен на отображение на класс языка программирования Java.

Определено в:: writeStruct в интерфейсе SQLOutput
Параметры:: x - объект, представляющий атрибуты SQL-структурированного типа
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать атрибуты UDT в базу данных.

writeArray

public void writeArray(Array x) throws SQLException

Записывает объект Array языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует это значение в сериализуемое SerialArray SQL ARRAY значение перед возвратом в базу данных.

Определено в:: writeArray в интерфейсе SQLOutput
Параметры:: x - объект, представляющий SQL ARRAY значение
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать атрибуты UDT в базу данных.

writeURL

public void writeURL(URL url) throws SQLException

Записывает объект java.sql.Type.DATALINK языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует это значение в сериализуемое SerialDatalink SQL DATALINK значение перед возвратом в базу данных.

Определено в:: writeURL в интерфейсе SQLOutput
Параметры:: url - объект, представляющий SQL DATALINK значение
Исключения:: SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать атрибуты UDT в базу данных.

writeNString

public void writeNString(String x) throws SQLException

Записывает следующий атрибут в поток как строку String языка программирования Java. Драйвер преобразует это в SQL NCHAR или NVARCHAR или LONGNVARCHAR значение (в зависимости от размера аргумента относительно ограничений драйвера на NVARCHAR значения) при отправке его в поток.

Определено в:: writeNString в интерфейсе SQLOutput
Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных
С:: 1.6

writeNClob

public void writeNClob(NClob x) throws SQLException

Записывает SQL NCLOB значение в поток.

Определено в:: writeNClob в интерфейсе SQLOutput
Параметры:: x - объект NClob, представляющий данные SQL NCLOB значения
Исключения:: SQLException - если произошла ошибка доступа к базе данных
С:: 1.6

END_OF_DOCUMENT_MARKER

writeRowId

public void writeRowId(RowId x) throws SQLException

Записывает значение SQL ROWID в поток.

Specified by:: writeRowId in interface SQLOutput
Parameters:: x - объект RowId, представляющий данные значения SQL ROWID
Throws:: SQLException - если произошла ошибка доступа к базе данных
Since:: 1.6

writeSQLXML

public void writeSQLXML(SQLXML x) throws SQLException

Записывает значение SQL XML в поток.

Specified by:: writeSQLXML in interface SQLOutput
Parameters:: x - объект SQLXML, представляющий данные значения SQL XML
Throws:: SQLException - если произошла ошибка доступа к базе данных
Since:: 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://download.java.net/java/early_access/jdk24/docs/api/java.sql.rowset/javax/sql/rowset/serial/SQLOutputImpl.html