Интерфейс 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)`	Записывает следующий атрибут в поток как последовательность символов Юникода.
`void`	`writeClob(Clob x)`	Записывает значение SQL `CLOB` в поток.
`void`	`writeDate(Date x)`	Записывает следующий атрибут в поток как объект java.sql.Date.
`void`	`writeDouble(double x)`	Записывает следующий атрибут в поток как Java double.
`void`	`writeFloat(float x)`	Записывает следующий атрибут в поток как Java float.
`void`	`writeInt(int x)`	Записывает следующий атрибут в поток как Java int.
`void`	`writeLong(long x)`	Записывает следующий атрибут в поток как Java long.
`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 short.
`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

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

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

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

writeInt

void writeInt(int x) throws SQLException

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

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

writeLong

void writeLong(long x) throws SQLException

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

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

writeFloat

void writeFloat(float x) throws SQLException

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

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

writeDouble

void writeDouble(double x) throws SQLException

Записывает следующий атрибут в поток как число с двойной точностью Java double. Записывает следующий атрибут в поток как 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-объект, указанный x, является объектом 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://download.java.net/java/early_access/jdk24/docs/api/java.sql/java/sql/SQLOutput.html