Интерфейс SQLOutput

Все известные реализующие классы:: SQLOutputImpl

public interface SQLOutput

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

Когда объект класса, реализующего интерфейс SQLData передается в качестве аргумента в SQL-запрос, драйвер JDBC вызывает метод SQLData.getSQLType для определения типа SQL-данных, передаваемых в базу данных. Затем драйвер создает экземпляр SQLOutput и передает его в метод SQLData.writeSQL. Метод writeSQL в свою очередь вызывает соответствующие методы записи SQLOutput (writeBoolean, writeCharacterStream, и так далее) для записи данных из объекта SQLData в поток вывода SQLOutput в качестве представления SQL-пользовательского типа.

С:: 1.2

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

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

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

writeString

void writeString(String x) throws SQLException

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

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeBoolean

void writeBoolean(boolean x) throws SQLException

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

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeByte

void writeByte(byte x) throws SQLException

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

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeShort

void writeShort(short x) throws SQLException

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

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeInt

void writeInt(int x) throws SQLException

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

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeLong

void writeLong(long x) throws SQLException

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

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeFloat

void writeFloat(float x) throws SQLException

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

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeDouble

void writeDouble(double x) throws SQLException

Записывает следующий атрибут в поток как число с двойной точностью Java. Записывает следующий атрибут в поток как String в языке программирования Java.

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeBigDecimal

void writeBigDecimal(BigDecimal x) throws SQLException

Записывает следующий атрибут в поток как объект java.math.BigDecimal. Записывает следующий атрибут в поток как String в языке программирования Java.

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeBytes

void writeBytes(byte[] x) throws SQLException

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

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeDate

void writeDate(Date x) throws SQLException

Записывает следующий атрибут в поток как объект java.sql.Date. Записывает следующий атрибут в поток как объект java.sql.Date в языке программирования Java.

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeTime

void writeTime(Time x) throws SQLException

Записывает следующий атрибут в поток как объект java.sql.Time. Записывает следующий атрибут в поток как объект java.sql.Date в языке программирования Java.

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeTimestamp

void writeTimestamp(Timestamp x) throws SQLException

Записывает следующий атрибут в поток как объект java.sql.Timestamp. Записывает следующий атрибут в поток как объект java.sql.Date в языке программирования Java.

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeCharacterStream

void writeCharacterStream(Reader x) throws SQLException

Записывает следующий атрибут в поток как поток Юникода.

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeAsciiStream

void writeAsciiStream(InputStream x) throws SQLException

Записывает следующий атрибут в поток как поток ASCII-символов.

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeBinaryStream

void writeBinaryStream(InputStream x) throws SQLException

Записывает следующий атрибут в поток как поток необработанных байтов.

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeObject

void writeObject(SQLData x) throws SQLException

Записывает в поток данные, содержащиеся в данном объекте SQLData. Когда объект SQLData является null, этот метод записывает SQL NULL в поток. В противном случае, он вызывает метод SQLData.writeSQL данного объекта, который записывает атрибуты объекта в поток. Реализация метода SQLData.writeSQL вызывает соответствующие методы записи SQLOutput для записи каждого атрибута объекта в порядке. Атрибуты должны быть прочитаны из потока ввода SQLInput и записаны в поток вывода SQLOutput в том же порядке, в котором они были перечислены в SQL-определении пользовательского типа.

Параметры:: x - объект, представляющий данные SQL-структурированного или отличительного типа
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

writeRef

void writeRef(Ref x) throws SQLException

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

Параметры:: x - объект Ref , представляющий данные значения SQL REF
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.2

END_OF_DOCUMENT_MARKER

writeBlob

void writeBlob(Blob x) throws SQLException

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

Параметры:: x - объект Blob, представляющий данные значения SQL BLOB
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:: 1.2

writeClob

void writeClob(Clob x) throws SQLException

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

Параметры:: x - объект Clob, представляющий данные значения SQL CLOB
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:: 1.2

writeStruct

void writeStruct(Struct x) throws SQLException

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

Параметры:: x - объект Struct, представляющий данные структурированного типа SQL
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:: 1.2

writeArray

void writeArray(Array x) throws SQLException

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

Параметры:: x - объект Array, представляющий данные типа SQL ARRAY
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:: 1.2

writeURL

void writeURL(URL x) throws SQLException

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

Параметры:: x - объект java.net.URL, представляющий данные типа SQL DATALINK
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:: 1.4

writeNString

void writeNString(String x) throws SQLException

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

Параметры:: x - значение, передаваемое в базу данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:: 1.6

writeNClob

void writeNClob(NClob x) throws SQLException

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

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

writeRowId

void writeRowId(RowId x) throws SQLException

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

Параметры:: x - объект RowId, представляющий данные значения SQL ROWID
Исключения:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:: 1.6

writeSQLXML

void writeSQLXML(SQLXML x) throws SQLException

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

Параметры:: x - объект SQLXML, представляющий данные значения SQL XML
Исключения:: SQLException - если произошла ошибка доступа к базе данных, java.xml.transform.Result, Writer или OutputStream не были закрыты для объекта SQLXML или если произошла ошибка обработки значения XML. Метод getCause исключения может предоставить более подробное исключение, например, если поток не содержит допустимого XML.; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:: 1.6

writeObject

default void writeObject(Object x, SQLType targetSqlType) throws SQLException

Записывает в поток данные, содержащиеся в указанном объекте. Объект будет преобразован в указанный targetSqlType перед отправкой в поток.

Когда object является null, этот метод записывает значение SQL NULL в поток.

Если у объекта есть пользовательское отображение (объект реализует интерфейс SQLData), драйвер JDBC должен вызвать метод SQLData.writeSQL для записи в поток данных SQL. Если же объект реализует Ref, Blob, Clob, NClob, Struct, java.net.URL или Array, драйвер должен передать его в базу данных как значение соответствующего типа SQL.

По умолчанию реализация будет выбрасывать SQLFeatureNotSupportedException

Параметры:

x - объект, содержащий значение входного параметра

targetSqlType - тип SQL, который будет отправлен в базу данных.

Исключения:

SQLException - если произошла ошибка доступа к базе данных или если Java объект, указанный x, является объектом InputStream или Reader, и значение параметра scale меньше нуля

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот тип данных

С:

1.8

См. также:

© 1993, 2023, 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/21/docs/api/java.sql/java/sql/SQLOutput.html