java.sql

Интерфейсный SQLData

public interface SQLData

Интерфейс, используемый для пользовательского отображения SQL определяемый пользователем тип (UDT) к классу в языке программирования Java. Объект класса для класса, реализовывая SQLData интерфейс будет вводиться в соответствующее Connection тип объекта отображается наряду с именем SQL UDT, для которого это - пользовательское отображение.

Как правило, a SQLData реализация определит поле для каждого атрибута SQL структурированный тип или единственное поле для SQL DISTINCT ввести. Когда UDT получается от источника данных с ResultSet.getObject метод, это будет отображено как экземпляр этого класса. Программист может работать на этом экземпляре класса так же, как на любом другом объекте в языке программирования Java и затем сохранить любые изменения, произведенные в этом, вызывая PreparedStatement.setObject метод, который отобразит это назад на тип SQL.

Ожидается, что реализация класса для пользовательского отображения будет сделана инструментом. В типичной реализации программист просто предоставил бы имя SQL UDT, имя класса, на который это отображается, и имена полей, на которые должен быть отображен каждый из атрибутов UDT. Инструмент будет использовать эту информацию, чтобы реализовать SQLData.readSQL и SQLData.writeSQL методы. readSQL вызовы метода соответствующее SQLInput методы, чтобы считать каждый атрибут из SQLInput объект, и writeSQL вызовы метода SQLOutput методы, чтобы записать каждый атрибут обратно к источнику данных через SQLOutput объект.

Прикладной программист не будет обычно вызывать SQLData методы непосредственно, и SQLInput и SQLOutput методами вызывают внутренне SQLData методы, не кодом программы.

С тех пор:

1.2

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Строка	getSQLTypeName() Возвращает полностью определенное имя SQL определяемый пользователем тип, который представляет этот объект.
void	readSQL(SQLInput stream, String typeName) Заполняет этот объект с данными, считанными из базы данных.
void	writeSQL(SQLOutput stream) Записи этот объект к данному потоку данных SQL, преобразовывая это назад в его SQL оценивают в источнике данных.

Деталь метода

getSQLTypeName

String getSQLTypeName()
                      throws SQLException

Возвращает полностью определенное имя SQL определяемый пользователем тип, который представляет этот объект. Этот метод вызывает драйвер JDBC, чтобы получить имя экземпляра UDT, который отображается на этот экземпляр SQLData.

Возвраты:

имя типа, которое передали к методу readSQL когда этот объект был создан и заполнен

Броски:

SQLException - если есть ошибка доступа к базе данных

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

С тех пор:

1.2

readSQL

void readSQL(SQLInput stream,
           String typeName)
             throws SQLException

Заполняет этот объект с данными, считанными из базы данных. Реализация метода должна следовать за этим протоколом:

• Это должно считать каждый из атрибутов или элементы типа SQL от данного входного потока. Это делается, вызывая метод входного потока, чтобы считать каждый элемент в порядке, что они появляются в определении SQL типа.
• Метод readSQL тогда присваивает данные, чтобы приспособить поля или элементы (этого или других объектов). Определенно, это должно вызвать соответствующий метод читателя (SQLInput.readString, SQLInput.readBigDecimal, и так далее) метод (ы), чтобы сделать следующее: для отличного типа считайте его единственный элемент данных; для структурированного типа считайте значение для каждого атрибута типа SQL.

Драйвер JDBC инициализирует входной поток с картой типа прежде, чем вызвать этот метод, который используется соответствующим SQLInput метод читателя на потоке.

Параметры:

stream - SQLInput объект, из которого можно считать данные для значения, которое является пользовательское отображенный

typeName - имя типа SQL значения на потоке данных

Броски:

SQLException - если есть ошибка доступа к базе данных

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

С тех пор:

1.2

См. Также:

SQLInput

writeSQL

void writeSQL(SQLOutput stream)
              throws SQLException

Записи этот объект к данному потоку данных SQL, преобразовывая это назад в его SQL оценивают в источнике данных. Реализация метода должна следовать за этим протоколом:
Это должно записать каждый из атрибутов типа SQL к данному потоку вывода. Это делается, вызывая метод потока вывода, чтобы записать каждый элемент в порядке, что они появляются в определении SQL типа. Определенно, это должно вызвать соответствующее SQLOutput метод (ы) писателя (writeInt, writeString, и так далее), чтобы сделать следующее: для Отличного Типа запишите его единственный элемент данных; для Структурированного Типа запишите значение для каждого атрибута типа SQL.

Параметры:

stream - SQLOutput возразите, в который можно записать данные для значения, которое было пользовательское отображенный

Броски:

SQLException - если есть ошибка доступа к базе данных

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

С тех пор:

1.2

См. Также:

SQLOutput