Spec-Zone.ru › OpenJDK 21

Класс SQLOutputImpl

java.lang.Object
javax.sql.rowset.serial.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 в базу данных.
END_OF_DOCUMENT_MARKER

writeCharacterStream

public void writeCharacterStream(Reader x) throws SQLException
Записывает поток символов Юникода в этот SQLOutputImpl объект. Драйвер выполнит необходимое преобразование из Юникода в формат базы данных CHAR.
Specified by:
writeCharacterStream в интерфейсе SQLOutput
Parameters:
x - значение, которое нужно передать в базу данных
Throws:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeAsciiStream

public void writeAsciiStream(InputStream x) throws SQLException
Записывает поток символов ASCII в этот SQLOutputImpl объект. Драйвер выполнит необходимое преобразование из ASCII в формат базы данных CHAR.
Specified by:
writeAsciiStream в интерфейсе SQLOutput
Parameters:
x - значение, которое нужно передать в базу данных
Throws:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeBinaryStream

public void writeBinaryStream(InputStream x) throws SQLException
Записывает поток неинтерпретированных байтов в этот SQLOutputImpl объект.
Specified by:
writeBinaryStream в интерфейсе SQLOutput
Parameters:
x - значение, которое нужно передать в базу данных
Throws:
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 определении пользовательского типа.

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

writeRef

public void writeRef(Ref x) throws SQLException
Записывает объект Ref языка программирования Java в этот SQLOutputImpl объект. Драйвер преобразует его в сериализуемое SerialRef SQL REF значение перед возвращением его в базу данных.
Specified by:
writeRef в интерфейсе SQLOutput
Parameters:
x - объект, представляющий SQL REF значение
Throws:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeBlob

public void writeBlob(Blob x) throws SQLException
Записывает объект Blob языка программирования Java в этот SQLOutputImpl объект. Драйвер преобразует его в сериализуемое SerialBlob SQL BLOB значение перед возвращением его в базу данных.
Specified by:
writeBlob в интерфейсе SQLOutput
Parameters:
x - объект, представляющий SQL BLOB значение
Throws:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeClob

public void writeClob(Clob x) throws SQLException
Записывает объект Clob языка программирования Java в этот SQLOutputImpl объект. Драйвер преобразует его в сериализуемое SerialClob SQL CLOB значение перед возвращением его в базу данных.
Specified by:
writeClob в интерфейсе SQLOutput
Parameters:
x - объект, представляющий SQL CLOB значение
Throws:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeStruct

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

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

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

writeArray

public void writeArray(Array x) throws SQLException
Записывает объект Array языка программирования Java в этот SQLOutputImpl объект. Драйвер преобразует это значение в сериализуемое SerialArray SQL ARRAY значение перед возвращением его в базу данных.
Specified by:
writeArray в интерфейсе SQLOutput
Parameters:
x - объект, представляющий SQL ARRAY значение
Throws:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeURL

public void writeURL(URL url) throws SQLException
Записывает объект java.sql.Type.DATALINK языка программирования Java в этот SQLOutputImpl объект. Драйвер преобразует это значение в сериализуемое SerialDatalink SQL DATALINK значение перед возвращением его в базу данных.
Specified by:
writeURL в интерфейсе SQLOutput
Parameters:
url - объект, представляющий SQL DATALINK значение
Throws:
SQLException - если объект SQLOutputImpl используется объектом SQLData, пытающимся записать значения атрибутов UDT в базу данных.

writeNString

public void writeNString(String x) throws SQLException
Записывает следующий атрибут в поток как String на языке программирования Java. Драйвер преобразует его в SQL NCHAR или NVARCHAR или LONGNVARCHAR значение (в зависимости от размера аргумента по отношению к ограничениям драйвера на значения NVARCHAR) при отправке его в поток.
Specified by:
writeNString в интерфейсе SQLOutput
Parameters:
x - значение, которое нужно передать в базу данных
Throws:
SQLException - если произошла ошибка доступа к базе данных
Since:
1.6

writeNClob

public void writeNClob(NClob x) throws SQLException
Записывает значение SQL NCLOB в поток.
Specified by:
writeNClob в интерфейсе SQLOutput
Parameters:
x - объект NClob , представляющий данные SQL NCLOB значения
Throws:
SQLException - если произошла ошибка доступа к базе данных
Since:
1.6

writeRowId

public void writeRowId(RowId x) throws SQLException
Записывает значение SQL ROWID в поток.
Specified by:
writeRowId в интерфейсе SQLOutput
Parameters:
x - объект RowId , представляющий данные SQL ROWID значения
Throws:
SQLException - если произошла ошибка доступа к базе данных
Since:
1.6

writeSQLXML

public void writeSQLXML(SQLXML x) throws SQLException
Записывает значение SQL XML в поток.
Specified by:
writeSQLXML в интерфейсе SQLOutput
Parameters:
x - объект SQLXML , представляющий данные SQL XML значения
Throws:
SQLException - если произошла ошибка доступа к базе данных
Since:
1.6

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API