Класс SQLOutputImpl

Все реализованные интерфейсы:
SQLOutput
public class SQLOutputImpl
extends Object
implements SQLOutput

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

Когда приложение вызывает метод PreparedStatement.setObject, драйвер проверяет, является ли записываемое значение UDT с пользовательским отображением. Если это так, то в карте типов будет запись, содержащая объект Class для класса, который реализует SQLData для этого UDT. Если записываемое значение является экземпляром SQLData, драйвер создаст экземпляр SQLOutputImpl и передаст его методу SQLData.writeSQL. Метод writeSQL в свою очередь вызывает соответствующие методы SQLOutputImpl.writeXXX для записи данных из объекта SQLData в выходной поток SQLOutputImpl в качестве представления определяемого пользователем типа SQL.

С версии:
1.5

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

Конструктор Описание
SQLOutputImpl​(Vector<?> attributes, Map<String,​?> map)

Создает новый объект SQLOutputImpl, инициализированный заданным вектором атрибутов и картой типов.

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

Модификатор и тип Метод Описание
void writeArray​(Array x)

Записывает объект Array на языке программирования Java в этот объект SQLOutputImpl.

void writeAsciiStream​(InputStream x)

Записывает поток символов ASCII в этот объект SQLOutputImpl.

void writeBigDecimal​(BigDecimal x)

Записывает объект java.math.BigDecimal на языке программирования Java в этот объект SQLOutputImpl.

void writeBinaryStream​(InputStream x)

Записывает поток неинтерпретируемых байтов в этот объект SQLOutputImpl.

void writeBlob​(Blob x)

Записывает объект Blob на языке программирования Java в этот объект SQLOutputImpl.

void writeBoolean​(boolean x)

Записывает boolean на языке программирования Java в этот объект SQLOutputImpl.

void writeByte​(byte x)

Записывает byte на языке программирования Java в этот объект SQLOutputImpl.

void writeBytes​(byte[] x)

Записывает массив bytes на языке программирования Java в этот объект SQLOutputImpl.

void writeCharacterStream​(Reader x)

Записывает поток символов Unicode в этот объект SQLOutputImpl.

void writeClob​(Clob x)

Записывает объект Clob на языке программирования Java в этот объект SQLOutputImpl.

void writeDate​(Date x)

Записывает объект java.sql.Date на языке программирования Java в этот объект SQLOutputImpl.

void writeDouble​(double x)

Записывает double на языке программирования Java в этот объект SQLOutputImpl.

void writeFloat​(float x)

Записывает float на языке программирования Java в этот объект SQLOutputImpl.

void writeInt​(int x)

Записывает int на языке программирования Java в этот объект SQLOutputImpl.

void writeLong​(long x)

Записывает long на языке программирования Java в этот объект SQLOutputImpl.

void writeNClob​(NClob x)

Записывает значение SQL NCLOB в поток.
void writeNString​(String x)

Записывает следующий атрибут в поток как String на языке программирования Java.
void writeObject​(SQLData x)

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

void writeRef​(Ref x)

Записывает объект Ref на языке программирования Java в этот объект SQLOutputImpl.

void writeRowId​(RowId x)

Записывает значение SQL ROWID в поток.
void writeShort​(short x)

Записывает short на языке программирования Java в этот объект SQLOutputImpl.

void writeSQLXML​(SQLXML x)

Записывает значение SQL XML в поток.
void writeString​(String x)

Записывает String на языке программирования Java в этот объект SQLOutputImpl.

void writeStruct​(Struct x)

Записывает объект Struct на языке программирования Java в этот объект SQLOutputImpl.

void writeTime​(Time x)

Записывает объект java.sql.Time на языке программирования Java в этот объект SQLOutputImpl.

void writeTimestamp​(Timestamp x)

Записывает объект java.sql.Timestamp на языке программирования Java в этот объект SQLOutputImpl.

void writeURL​(URL url)

Записывает объект java.sql.Type.DATALINK на языке программирования Java в этот объект SQLOutputImpl.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе java.sql.SQLOutput

writeObject

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

SQLOutputImpl

public SQLOutputImpl(Vector<?> attributes,
                     Map<String,​?> map)
              throws SQLException

Создает новый объект SQLOutputImpl, инициализированный заданным вектором атрибутов и картой типов. Драйвер будет использовать карту типов для определения того, какой метод SQLData.writeSQL следует вызывать. Затем этот метод вызовет соответствующие методы записи SQLOutputImpl по порядку и тем самым запишет атрибуты в новый выходной поток.

Параметры:
attributes - объект Vector, содержащий атрибуты UDT, которые необходимо отобразить на один или несколько объектов на языке программирования Java
map - объект java.util.Map, содержащий ноль или более записей, причем каждая запись состоит из 1) String, указывающего полное имя UDT, и 2) объекта Class для реализации SQLData, определяющей, как следует отображать UDT
Исключения:
SQLException - если attributes или map является значением null

Методы

writeString

public void writeString(String x)
                 throws SQLException

Записывает строку String на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует её в SQL CHAR, VARCHAR, или LONGVARCHAR перед возвращением в базу данных.

Определено в:
writeString в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeBoolean

public void writeBoolean(boolean x)
                  throws SQLException

Записывает булево значение boolean на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL BIT перед возвращением в базу данных.

Определено в:
writeBoolean в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeByte

public void writeByte(byte x)
               throws SQLException

Записывает байтовое значение byte на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL BIT перед возвращением в базу данных.

Определено в:
writeByte в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeShort

public void writeShort(short x)
                throws SQLException

Записывает короткое целое значение short на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL SMALLINT перед возвращением в базу данных.

Определено в:
writeShort в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeInt

public void writeInt(int x)
              throws SQLException

Записывает целое число int на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL INTEGER перед возвращением в базу данных.

Определено в:
writeInt в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeLong

public void writeLong(long x)
               throws SQLException

Записывает длинное целое число long на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL BIGINT перед возвращением в базу данных.

Определено в:
writeLong в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeFloat

public void writeFloat(float x)
                throws SQLException

Записывает число с плавающей точкой float на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL REAL перед возвращением в базу данных.

Определено в:
writeFloat в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeDouble

public void writeDouble(double x)
                 throws SQLException

Записывает двойное число с плавающей точкой double на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL DOUBLE перед возвращением в базу данных.

Определено в:
writeDouble в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeBigDecimal

public void writeBigDecimal(BigDecimal x)
                     throws SQLException

Записывает объект java.math.BigDecimal на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL NUMERIC перед возвращением в базу данных.

Определено в:
writeBigDecimal в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeBytes

public void writeBytes(byte[] x)
                throws SQLException

Записывает массив байтов bytes на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL VARBINARY или LONGVARBINARY перед возвращением в базу данных.

Определено в:
writeBytes в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeDate

public void writeDate(Date x)
               throws SQLException

Записывает объект java.sql.Date на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL DATE перед возвращением в базу данных.

Определено в:
writeDate в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeTime

public void writeTime(Time x)
               throws SQLException

Записывает объект java.sql.Time на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL TIME перед возвращением в базу данных.

Определено в:
writeTime в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeTimestamp

public void writeTimestamp(Timestamp x)
                    throws SQLException

Записывает объект java.sql.Timestamp на языке программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в SQL TIMESTAMP перед возвращением в базу данных.

Определено в:
writeTimestamp в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeCharacterStream

public void writeCharacterStream(Reader x)
                          throws SQLException

Записывает поток Unicode-символов в этот объект SQLOutputImpl. Драйвер выполнит необходимое преобразование из Unicode в формат базы данных CHAR.

Определено в:
writeCharacterStream в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeAsciiStream

public void writeAsciiStream(InputStream x)
                      throws SQLException

Записывает поток ASCII-символов в этот объект SQLOutputImpl. Драйвер выполнит необходимое преобразование из ASCII в формат базы данных CHAR.

Определено в:
writeAsciiStream в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeBinaryStream

public void writeBinaryStream(InputStream x)
                       throws SQLException

Записывает поток байтов без интерпретации в этот объект SQLOutputImpl.

Определено в:
writeBinaryStream в интерфейсе SQLOutput
Параметры:
x - значение для передачи в базу данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов UDT в базу данных.

writeObject

public void writeObject(SQLData x)
                 throws SQLException

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

Реализация метода SQLData.writeSQ вызывает соответствующие методы SQLOutputImpl.writeXXX для записи каждого из атрибутов объекта в порядке. Атрибуты должны быть считаны из SQLInput входного потока и записаны в SQLOutputImpl выходной поток в том же порядке, в котором они были перечислены в SQL определении пользовательского типа.

Определено в:
writeObject в интерфейсе SQLOutput
Параметры:
x - объект, представляющий данные SQL структурированного или отдельного типа
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeRef

public void writeRef(Ref x)
              throws SQLException

Записывает объект Ref языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в сериализуемое SerialRef SQL REF значение перед возвращением его в базу данных.

Определено в:
writeRef в интерфейсе SQLOutput
Параметры:
x - объект, представляющий значение SQL REF
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeBlob

public void writeBlob(Blob x)
               throws SQLException

Записывает объект Blob языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в сериализуемое SerialBlob SQL BLOB значение перед возвращением его в базу данных.

Определено в:
writeBlob в интерфейсе SQLOutput
Параметры:
x - объект, представляющий значение SQL BLOB
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeClob

public void writeClob(Clob x)
               throws SQLException

Записывает объект Clob языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует его в сериализуемое SerialClob SQL CLOB значение перед возвращением его в базу данных.

Определено в:
writeClob в интерфейсе SQLOutput
Параметры:
x - объект, представляющий значение SQL CLOB
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeStruct

public void writeStruct(Struct x)
                 throws SQLException

Записывает объект Struct языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует это значение в тип SQL структурированных данных перед возвращением его в базу данных.

Этот метод следует использовать, когда тип SQL структурированных данных был сопоставлен с объектом Struct языка программирования Java (стандартное отображение). Метод writeObject следует использовать, если тип SQL структурированных данных был настроен на отображение на класс языка программирования Java.

Определено в:
writeStruct в интерфейсе SQLOutput
Параметры:
x - объект, представляющий атрибуты типа SQL структурированных данных
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeArray

public void writeArray(Array x)
                throws SQLException

Записывает объект Array языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует это значение в сериализуемое SerialArray SQL ARRAY значение перед возвращением его в базу данных.

Определено в:
writeArray в интерфейсе SQLOutput
Параметры:
x - объект, представляющий значение SQL ARRAY
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeURL

public void writeURL(URL url)
              throws SQLException

Записывает объект java.sql.Type.DATALINK языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует это значение в сериализуемое SerialDatalink SQL DATALINK значение перед возвращением его в базу данных.

Определено в:
writeURL в интерфейсе SQLOutput
Параметры:
url - объект, представляющий значение SQL DATALINK
Исключения:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeNString

public void writeNString(String x)
                  throws SQLException

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

Определено в:
writeNString в интерфейсе SQLOutput
Параметры:
x - значение, передаваемое в базу данных
Исключения:
SQLException - если произошла ошибка доступа к базе данных
С:
1.6

writeNClob

public void writeNClob(NClob x)
                throws SQLException

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

Определено в:
writeNClob в интерфейсе SQLOutput
Параметры:
x - объект NClob представляющий данные значения SQL NCLOB
Исключения:
SQLException - если произошла ошибка доступа к базе данных
С:
1.6

writeRowId

public void writeRowId(RowId x)
                throws SQLException

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

Определено в:
writeRowId в интерфейсе SQLOutput
Параметры:
x - объект RowId представляющий данные значения SQL ROWID
Исключения:
SQLException - если произошла ошибка доступа к базе данных
С:
1.6

writeSQLXML

public void writeSQLXML(SQLXML x)
                 throws SQLException

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

Определено в:
writeSQLXML в интерфейсе SQLOutput
Параметры:
x - объект SQLXML представляющий данные значения SQL XML
Исключения:
SQLException - если произошла ошибка доступа к базе данных
С:
1.6

© 1993, 2020, 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/11/docs/api/java.sql.rowset/javax/sql/rowset/serial/SQLOutputImpl.html

Spec-Zone .ru
спецификации, руководства, описания, API