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

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

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

writeBoolean

void writeBoolean(boolean x) throws SQLException

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

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

writeByte

void writeByte(byte x) throws SQLException

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

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

writeShort

void writeShort(short x) throws SQLException

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

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

writeInt

void writeInt(int x) throws SQLException

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

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

writeLong

void writeLong(long x) throws SQLException

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

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

writeFloat

void writeFloat(float x) throws SQLException

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

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

writeDouble

void writeDouble(double x) throws SQLException

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

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

writeBigDecimal

void writeBigDecimal(BigDecimal x) throws SQLException

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

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

writeBytes

void writeBytes(byte[] x) throws SQLException

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

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

writeTimestamp

void writeTimestamp(Timestamp x) throws SQLException

Записывает следующий атрибут в поток как объект java.sql.Timestamp. Записывает следующий атрибут в поток как объект java.sql.Timestamp в языке программирования 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 в поток.

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

writeClob

void writeClob(Clob x) throws SQLException

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

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

writeStruct

void writeStruct(Struct x) throws SQLException

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

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

writeArray

void writeArray(Array x) throws SQLException

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

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

writeURL

void writeURL(URL x) throws SQLException

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

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

writeNString

void writeNString(String x) throws SQLException

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

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

writeNClob

void writeNClob(NClob x) throws SQLException

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

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

writeRowId

void writeRowId(RowId x) throws SQLException

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

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

writeSQLXML

void writeSQLXML(SQLXML x) throws SQLException

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

Parameters:: x - объект SQLXML, представляющий данные значения SQL XML
Throws:: SQLException - если произошла ошибка доступа к базе данных, java.xml.transform.Result, Writer или OutputStream не были закрыты для объекта SQLXML или если произошла ошибка при обработке XML-значения. Метод getCause исключения может предоставить более подробное исключение, например, если поток не содержит корректного XML.; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:: 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

Parameters:

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

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

Throws:

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

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

Since:

1.8

See Also:

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