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

Параметры:

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

Исключение:

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

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

С:

1.4

См. также:

© 1993, 2023, 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/21/docs/api/java.sql/java/sql/Ref.html