Интерфейс SQLOutput

Все известные классы-реализации:: SQLOutputImpl

public interface SQLOutput

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

Когда объект класса, реализующего интерфейс SQLData, передается в качестве аргумента SQL-оператору, драйвер JDBC вызывает метод SQLData.getSQLType, чтобы определить тип SQL-данных, передаваемых в базу данных. Затем драйвер создает экземпляр SQLOutput и передает его методу SQLData.writeSQL. Метод writeSQL, в свою очередь, вызывает соответствующие методы записи SQLOutput writer (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)`	Записывает следующий атрибут в поток как значение boolean в Java.
`void`	`writeByte(byte x)`	Записывает следующий атрибут в поток как значение byte в 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)`	Записывает следующий атрибут в поток как значение double в Java.
`void`	`writeFloat(float x)`	Записывает следующий атрибут в поток как значение float в Java.
`void`	`writeInt(int x)`	Записывает следующий атрибут в поток как значение int в Java.
`void`	`writeLong(long x)`	Записывает следующий атрибут в поток как значение long в 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)`	Записывает следующий атрибут в поток как значение short в 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

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

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

writeBoolean

void writeBoolean(boolean x) throws SQLException

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

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

writeByte

void writeByte(byte x) throws SQLException

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

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

writeShort

void writeShort(short x) throws SQLException

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

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

writeInt

void writeInt(int x) throws SQLException

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

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

writeLong

void writeLong(long x) throws SQLException

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

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

writeFloat

void writeFloat(float x) throws SQLException

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

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

writeDouble

void writeDouble(double x) throws SQLException

Записывает следующий атрибут в поток как значение double в 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

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

Параметры:: 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

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

Записывает следующий атрибут в поток как String в языке программирования 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 является объектом InputStream или Reader, а значение параметра scale меньше нуля

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

Начиная с версии:

1.8

См. также:

© 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/java/sql/SQLOutput.html