Интерфейс Ref

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 поддерживает тип данных.

Методы

getBaseTypeName

String getBaseTypeName()
                throws SQLException

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

Возвращает:

полное квалифицированное имя SQL структурированного типа, на который имеется ссылка

Исключение:

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

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

С:

1.2

getObject

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

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)