Класс SQLOutputImpl
- Все реализованные интерфейсы:
SQLOutput
public class SQLOutputImpl extends Object implements SQLOutput
Когда приложение вызывает метод PreparedStatement.setObject, драйвер проверяет, является ли значение, подлежащее записи, UDT с пользовательским отображением. Если это так, в таблице типов будет запись, содержащая объект Class для класса, реализующего SQLData для этого UDT. Если значение, подлежащее записи, является экземпляром SQLData, драйвер создаст экземпляр SQLOutputImpl и передаст его методу SQLData.writeSQL. Метод writeSQL в свою очередь вызовет соответствующие методы SQLOutputImpl.writeXXX для записи данных из объекта SQLData в поток вывода SQLOutputImpl в качестве представления SQL пользовательского типа данных.
- С:
- 1.5
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
SQLOutputImpl |
Создает новый объект SQLOutputImpl, инициализированный заданным вектором атрибутов и таблицей типов. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
writeArray |
Записывает объект Array в языке Java в этот объект SQLOutputImpl. |
void |
writeAsciiStream |
Записывает последовательность символов ASCII в этот объект SQLOutputImpl. |
void |
writeBigDecimal |
Записывает объект java.math.BigDecimal в языке Java в этот объект SQLOutputImpl. |
void |
writeBinaryStream |
Записывает поток неинтерпретируемых байтов в этот объект SQLOutputImpl. |
void |
writeBlob |
Записывает объект Blob в языке Java в этот объект SQLOutputImpl. |
void |
writeBoolean |
Записывает boolean в языке Java в этот объект SQLOutputImpl. |
void |
writeByte |
Записывает byte в языке Java в этот объект SQLOutputImpl. |
void |
writeBytes |
Записывает массив bytes в языке Java в этот объект SQLOutputImpl. |
void |
writeCharacterStream |
Записывает поток Unicode-символов в этот объект SQLOutputImpl. |
void |
writeClob |
Записывает объект Clob в языке Java в этот объект SQLOutputImpl. |
void |
writeDate |
Записывает объект java.sql.Date в языке Java в этот объект SQLOutputImpl. |
void |
writeDouble |
Записывает double в языке Java в этот объект SQLOutputImpl. |
void |
writeFloat |
Записывает float в языке Java в этот объект SQLOutputImpl. |
void |
writeInt |
Записывает int в языке Java в этот объект SQLOutputImpl. |
void |
writeLong |
Записывает long в языке Java в этот объект SQLOutputImpl. |
void |
writeNClob |
Записывает значение SQL NCLOB в поток. |
void |
writeNString |
Записывает следующий атрибут в поток как String в языке Java. |
void |
writeObject |
Записывает в поток данные, содержащиеся в данном объекте SQLData. |
void |
writeRef |
Записывает объект Ref в языке Java в этот объект SQLOutputImpl. |
void |
writeRowId |
Записывает значение SQL ROWID в поток. |
void |
writeShort |
Записывает short в языке Java в этот объект SQLOutputImpl. |
void |
writeSQLXML |
Записывает значение SQL XML в поток. |
void |
writeString |
Записывает String в языке Java в этот объект SQLOutputImpl. |
void |
writeStruct |
Записывает объект Struct в языке Java в этот объект SQLOutputImpl. |
void |
writeTime |
Записывает объект java.sql.Time в языке Java в этот объект SQLOutputImpl. |
void |
writeTimestamp |
Записывает объект java.sql.Timestamp в языке Java в этот объект SQLOutputImpl. |
void |
writeURL |
Записывает объект 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
SQLOutputImpl объект. Драйвер выполнит необходимое преобразование из Юникода в формат базы данных CHAR. - Specified by:
-
writeCharacterStreamв интерфейсеSQLOutput - Parameters:
-
x- значение, которое нужно передать в базу данных - Throws:
-
SQLException- если объектSQLOutputImplиспользуется объектомSQLData, пытающимся записать значения атрибутов UDT в базу данных.
writeAsciiStream
public void writeAsciiStream(InputStream x) throws SQLException
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- объект, представляющий SQLREFзначение - 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- объект, представляющий SQLBLOBзначение - 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- объект, представляющий SQLCLOBзначение - 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- объект, представляющий SQLARRAYзначение - 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- объект, представляющий SQLDATALINKзначение - 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
NCLOB в поток.- Specified by:
-
writeNClobв интерфейсеSQLOutput - Parameters:
-
x- объектNClob, представляющий данные SQLNCLOBзначения - Throws:
-
SQLException- если произошла ошибка доступа к базе данных - Since:
- 1.6
writeRowId
public void writeRowId(RowId x) throws SQLException
ROWID в поток.- Specified by:
-
writeRowIdв интерфейсеSQLOutput - Parameters:
-
x- объектRowId, представляющий данные SQLROWIDзначения - Throws:
-
SQLException- если произошла ошибка доступа к базе данных - Since:
- 1.6
writeSQLXML
public void writeSQLXML(SQLXML x) throws SQLException
XML в поток.- Specified by:
-
writeSQLXMLв интерфейсеSQLOutput - Parameters:
-
x- объектSQLXML, представляющий данные SQLXMLзначения - 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