Интерфейс Ref

Все известные реализующие классы:: SerialRef

public interface Ref

Сопоставление в языке программирования Java значения SQL REF, которое представляет ссылку на значение SQL структурированного типа в базе данных.

Значения SQL REF хранятся в таблице, содержащей экземпляры ссылаемого SQL структурированного типа, и каждое значение REF является уникальным идентификатором одного экземпляра в этой таблице. Значение SQL REF может использоваться вместо ссылаемого SQL структурированного типа, как значение столбца в таблице или значение атрибута в структурированном типе.

Поскольку значение SQL REF является логической ссылкой на SQL структурированный тип, объект Ref по умолчанию также является логической ссылкой. Таким образом, извлечение значения SQL REF как объекта Ref не приводит к материализации атрибутов структурированного типа на клиенте.

Объект Ref может быть сохранен в базе данных с помощью метода PreparedStatement.setRef.

Все методы интерфейса Ref должны быть полностью реализованы, если драйвер JDBC поддерживает тип данных.

С момента:: 1.2
См. также:: Struct

Методы

Модификатор и тип	Метод	Описание
`String`	`getBaseTypeName()`	Возвращает полностью квалифицированное имя SQL структурированного типа, на который ссылается этот объект `Ref`.
`Object`	`getObject()`	Возвращает экземпляр SQL структурированного типа, на который ссылается этот объект `Ref`.
`Object`	`getObject(Map<String,Class<?>> map)`	Возвращает сопоставленный объект и отображает его на тип Java с помощью заданной карты типов.
`void`	`setObject(Object value)`	Устанавливает значение структурированного типа, на который ссылается этот объект `Ref`, на указанный экземпляр `Object`.

Методы

getBaseTypeName()

String getBaseTypeName()
                throws SQLException

Возвращает полностью квалифицированное имя SQL структурированного типа, на который ссылается этот объект Ref.

Возвращает:: полностью квалифицированное имя SQL структурированного типа, на который ссылается SQL
Исключение:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С момента:: 1.2

getObject(java.util.Map)

Object getObject(Map<String,Class<?>> map)
          throws SQLException

Возвращает сопоставленный объект и отображает его на тип Java с помощью заданной карты типов.

Параметры:: map - объект java.util.Map, содержащий используемое сопоставление (полное квалифицированное имя ссылаемого SQL структурированного типа и объект класса для SQLData реализации, на которую будет сопоставлен SQL структурированный тип)
Возвращает:: Java Object, который является пользовательским сопоставлением SQL структурированного типа, на который ссылается этот объект Ref
Исключение:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С момента:: 1.4
См. также:: setObject(java.lang.Object)

getObject()

Object getObject()
          throws SQLException

Возвращает экземпляр SQL структурированного типа, на который ссылается этот объект Ref . Если в карте типов подключения есть запись для структурированного типа, экземпляр будет пользовательски сопоставлен с классом Java, указанным в карте типов. В противном случае экземпляр структурированного типа будет сопоставлен с объектом Struct.

Возвращает:: Java Object, который является сопоставлением SQL структурированного типа, на который ссылается этот объект Ref
Исключение:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С момента:: 1.4
См. также:: setObject(java.lang.Object)

setObject(java.lang.Object)

void setObject(Object value)
        throws SQLException

Устанавливает значение структурированного типа, на который ссылается этот объект Ref, на указанный экземпляр Object . Драйвер преобразует это в SQL структурированный тип при отправке в базу данных.

Параметры:: value - Object, представляющий экземпляр SQL структурированного типа, на который будет ссылаться этот объект Ref
Исключение:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С момента:: 1.4
См. также:: getObject(), getObject(Map), PreparedStatement.setObject(int, Object), CallableStatement.setObject(String, Object)