Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface SQLData
SQLData
интерфейс будет вводиться в соответствующее Connection
тип объекта отображается наряду с именем SQL UDT, для которого это - пользовательское отображение. Как правило, a SQLData
реализация определит поле для каждого атрибута SQL структурированный тип или единственное поле для SQL DISTINCT
ввести. Когда UDT получается от источника данных с ResultSet.getObject
метод, это будет отображено как экземпляр этого class. Программист может работать на этом экземпляре class так же, как на любом другом объекте в языке программирования Java и затем сохранить любые изменения, произведенные в этом, вызывая PreparedStatement.setObject
метод, который отобразит это назад на тип SQL.
Ожидается, что реализация class для пользовательского отображения будет сделана инструментом. В типичной реализации программист просто предоставил бы имя SQL UDT, имя class, на который это отображается, и имена полей, на которые должен быть отображен каждый из атрибутов UDT. Инструмент будет использовать эту информацию, чтобы реализовать SQLData.readSQL
и SQLData.writeSQL
методы. readSQL
вызовы метода соответствующее SQLInput
методы, чтобы считать каждый атрибут из SQLInput
объект, и writeSQL
вызовы метода SQLOutput
методы, чтобы записать каждый атрибут обратно к источнику данных через SQLOutput
объект.
Прикладной программист не будет обычно вызывать SQLData
методы непосредственно, и SQLInput
и SQLOutput
методами вызывают внутренне SQLData
методы, не кодом программы.
Модификатор и Тип | Метод и Описание |
---|---|
Строка |
getSQLTypeName()
Возвращает полностью определенное имя SQL определяемый пользователем тип, который представляет этот объект.
|
void |
readSQL(SQLInput stream, String typeName)
Заполняет этот объект с данными, считанными из базы данных.
|
void |
writeSQL(SQLOutput stream)
Записи этот объект к данному потоку данных SQL, преобразовывая это назад в его SQL оценивают в источнике данных.
|
String getSQLTypeName() throws SQLException
SQLData
.readSQL
когда этот объект был создан и заполненSQLException
- если есть ошибка доступа к базе данныхSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методvoid readSQL(SQLInput stream, String typeName) throws SQLException
readSQL
тогда присваивает данные, чтобы приспособить поля или элементы (этого или других объектов). Определенно, это должно вызвать соответствующий метод читателя (SQLInput.readString
, SQLInput.readBigDecimal
, и так далее) метод (ы), чтобы сделать следующее: для отличного типа считайте его единственный элемент данных; для структурированного типа считайте значение для каждого атрибута типа SQL. SQLInput
метод читателя на потоке.stream
- SQLInput
объект, из которого можно считать данные для значения, которое является пользовательское отображенныйtypeName
- имя типа SQL значения на потоке данныхSQLException
- если есть ошибка доступа к базе данныхSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методSQLInput
void writeSQL(SQLOutput stream) throws SQLException
SQLOutput
метод (ы) писателя (writeInt
, writeString
, и так далее), чтобы сделать следующее: для Отличного Типа запишите его единственный элемент данных; для Структурированного Типа запишите значение для каждого атрибута типа SQL.stream
- SQLOutput
возразите, в который можно записать данные для значения, которое было пользовательское отображенныйSQLException
- если есть ошибка доступа к базе данныхSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методSQLOutput
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92