Интерфейс SQLOutput

public interface SQLOutput

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

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

Методы

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

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

Параметры:

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

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

Исключения:

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

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

С:

1.8

См. также:

JDBCType, SQLType