Интерфейс Ref

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

public interface Ref

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

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

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

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

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

Начиная с версии:

1.2

См. также:

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

Модификатор и тип	Метод	Описание
`String`	`getBaseTypeName()`	Возвращает полное имя SQL структурированного типа 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 структурированного типа SQL, на который ссылается этот объект Ref.

Возвращает:: полное имя SQL структурированного типа 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://docs.oracle.com/en/java/javase/25/docs/api/java.sql/java/sql/Ref.html