Класс SQLOutputImpl

public class SQLOutputImpl
extends Object
implements SQLOutput

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

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

Конструкторы

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.

Определено в:

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

Указано в:

writeObject в интерфейсе SQLOutput

Параметры:

x - объект, представляющий данные SQL-структурированного или отличительного типа

Исключения:

SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов типа UDT в базу данных.

writeRef

public void writeRef(Ref x)
              throws SQLException

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

Указано в:

writeRef в интерфейсе SQLOutput

Параметры:

x - объект, представляющий значение SQL REF

Исключения:

SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов типа UDT в базу данных.

writeBlob

public void writeBlob(Blob x)
               throws SQLException

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

Указано в:

writeBlob в интерфейсе SQLOutput

Параметры:

x - объект, представляющий значение SQL BLOB

Исключения:

SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов типа UDT в базу данных.

writeClob

public void writeClob(Clob x)
               throws SQLException

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

Указано в:

writeClob в интерфейсе SQLOutput

Параметры:

x - объект, представляющий значение SQL CLOB

Исключения:

SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов типа UDT в базу данных.

writeStruct

public void writeStruct(Struct x)
                 throws SQLException

Указано в:

writeStruct в интерфейсе SQLOutput

Параметры:

x - объект, представляющий атрибуты SQL-структурированного типа

Исключения:

SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов типа UDT в базу данных.

writeArray

public void writeArray(Array x)
                throws SQLException

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

Указано в:

writeArray в интерфейсе SQLOutput

Параметры:

x - объект, представляющий значение SQL ARRAY

Исключения:

SQLException - если объект SQLOutputImpl используется объектом SQLData для записи атрибутов типа UDT в базу данных.

writeURL

public void writeURL(URL url)
              throws SQLException

Записывает объект java.sql.Type.DATALINK языка программирования Java в этот объект SQLOutputImpl. Драйвер преобразует это значение в сериализуемое значение SQL SerialDatalink 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