Интерфейс 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

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`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 структурированного типа
Выбрасывает:: 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

См. также:

getObject

Object getObject() throws SQLException

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

Возвращает:

объект Java Object, являющийся отображением для SQL структурированного типа, на который ссылается этот объект Ref

Выбрасывает:

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

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

С:

1.4

См. также:

setObject

void setObject(Object value) throws SQLException

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

Параметры:

value - объект Object, представляющий экземпляр SQL структурированного типа, на который будет ссылаться этот объект Ref

Выбрасывает:

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

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

С:

1.4

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.sql/java/sql/Ref.html