Класс 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)`	Записывает поток символов Unicode в этот объект `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`.

Методы, объявленные в классе 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, либо до истечения заданного промежутка реального времени.

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

writeObject

Модификатор и тип	Метод	Описание
`default void`	`writeObject(Object x, SQLType targetSqlType)`	Записывает в поток данные, содержащиеся в заданном объекте.

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

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. Перед возвратом значения в базу данных драйвер преобразует его в сериализуемое значение SQL SerialRef REF.

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

writeBlob

public void writeBlob(Blob x) throws SQLException

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

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

writeClob

public void writeClob(Clob x) throws SQLException

Записывает объект Clob языка программирования Java в этот объект SQLOutputImpl. Перед возвратом значения в базу данных драйвер преобразует его в сериализуемое значение SQL SerialClob 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. Перед возвратом значения в базу данных драйвер преобразует его в сериализуемое значение SQL SerialArray ARRAY.

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

writeURL

public void writeURL(URL url) throws SQLException

Записывает объект java.sql.Type.DATALINK языка программирования Java в этот объект SQLOutputImpl. Перед возвратом значения в базу данных драйвер преобразует его в сериализуемое значение SQL SerialDatalink 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

writeRowId

public void writeRowId(RowId x) throws SQLException

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

Определено в:: writeRowId в интерфейсе SQLOutput
Параметры:: x — объект RowId, представляющий данные значения SQL ROWID
Выбрасывает:: SQLException — если произошла ошибка доступа к базе данных
Начиная с:: 1.6

writeSQLXML

public void writeSQLXML(SQLXML x) throws SQLException

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

Определено в:: writeSQLXML в интерфейсе SQLOutput
Параметры:: x — объект SQLXML, представляющий данные значения SQL XML
Выбрасывает:: 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.