Класс 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

Методы, объявленные в интерфейсе 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. Перед возвратом в базу данных драйвер преобразует его в сериализуемое значение 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.sql.rowset/javax/sql/rowset/serial/SQLOutputImpl.html