Интерфейс оболочки

public interface Wrapper

Интерфейс для классов JDBC, которые обеспечивают возможность извлечения экземпляра делегата, когда рассматриваемый экземпляр на самом деле является классом-прокси.

Многие реализации драйверов JDBC используют паттерн оболочки для предоставления расширений стандартного API JDBC, специфичных для источника данных. Разработчики могут захотеть получить доступ к этим ресурсам, которые обернуты (делегаты), как экземпляры класса-прокси, представляющие фактические ресурсы. Этот интерфейс описывает стандартный механизм доступа к этим обернутым ресурсам, представленным их прокси, для обеспечения прямого доступа к делегатам ресурсов.

Методы

unwrap

<T> T unwrap(Class<T> iface)
      throws SQLException

Возвращает объект, реализующий данный интерфейс, чтобы обеспечить доступ к методам, не являющимся стандартными, или к стандартным методам, не экспонируемым прокси. Если получатель реализует интерфейс, то результатом является получатель или прокси для получателя. Если получатель является оболочкой, и обернутый объект реализует интерфейс, то результатом является обернутый объект или прокси для обернутого объекта. В противном случае возвращается результат вызова unwrap рекурсивно на обернутом объекте или прокси для этого результата. Если получатель не является оболочкой и не реализует интерфейс, то выбрасывается SQLException.

Параметры типа:

T - тип класса, моделируемого этим объектом Class

Параметры:

iface - Класс, определяющий интерфейс, который должен реализовывать результат.

Возвращает:

объект, реализующий интерфейс. Может быть прокси для фактического реализующего объекта.

Исключения:

SQLException - Если не найден объект, реализующий интерфейс

С момента:

1.6

isWrapperFor

boolean isWrapperFor(Class<?> iface)
              throws SQLException

Возвращает true, если этот объект либо реализует аргумент-интерфейс, либо является непосредственно или косвенно оболочкой для объекта, который это делает. В противном случае возвращает false. Если этот объект реализует интерфейс, то возвращает true, иначе, если это оболочка, то возвращает результат рекурсивного вызова isWrapperFor на обернутом объекте. Если этот объект не реализует интерфейс и не является оболочкой, то возвращает false. Этот метод должен быть реализован как операция с низкой стоимостью по сравнению с unwrap, чтобы вызывающие стороны могли использовать этот метод для избежания дорогостоящих вызовов unwrap, которые могут завершиться ошибкой. Если этот метод возвращает true, то вызов unwrap с тем же аргументом должен быть успешным.

Параметры:

iface - класс, определяющий интерфейс.

Возвращает:

true, если этот объект реализует интерфейс или непосредственно или косвенно оборачивает объект, который это делает.

Исключения:

SQLException - если произошла ошибка при определении, является ли этот объект оболочкой для объекта с заданным интерфейсом.

С момента:

1.6