Интерфейс 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 структурированного типа, на который ссылаются
Бросает:: 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

См. также:

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