Интерфейс оболочки
- Все известные подинтерфейсы:
-
CachedRowSet,CallableStatement,Connection,DatabaseMetaData,DataSource,FilteredRowSet,JdbcRowSet,JoinRowSet,ParameterMetaData,PreparedStatement,ResultSet,ResultSetMetaData,RowSet,RowSetMetaData,Statement,SyncResolver,WebRowSet
- Все известные реализующие классы:
RowSetMetaDataImpl
public interface Wrapper
Шаблон оболочки используется во многих реализациях драйверов JDBC для предоставления расширений, выходящих за рамки традиционного API JDBC, специфичных для источника данных. Разработчики могут захотеть получить доступ к этим ресурсам, которые обернуты (делегаты), как экземпляры класса-прокси, представляющие фактические ресурсы. Этот интерфейс описывает стандартный механизм доступа к этим обернутым ресурсам, представленным их прокси, для обеспечения прямого доступа к делегатам ресурсов.
- С тех пор:
- 1.6
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
isWrapperFor |
Возвращает true, если этот объект реализует переданный интерфейс или является прямой или косвенной оболочкой объекта, который это делает. |
<T> T |
unwrap |
Возвращает объект, реализующий заданный интерфейс, чтобы обеспечить доступ к методам, нестандартным или стандартным, но не показанным прокси. |
Подробное описание методов
unwrap
<T> T unwrap(Class<T> iface) throws SQLException
unwrap на обернутом объекте или прокси для этого результата. Если получатель не является оболочкой и не реализует интерфейс, то выбрасывается SQLException. - Параметры типа:
-
T- тип класса, моделируемого этим объектом класса - Параметры:
-
iface- класс, определяющий интерфейс, который должен реализовать результат. - Возвращает:
- объект, реализующий интерфейс. Может быть прокси для фактического реализующего объекта.
- Исключения:
-
SQLException- Если не найден объект, реализующий интерфейс - С тех пор:
- 1.6
isWrapperFor
boolean isWrapperFor(Class<?> iface) throws SQLException
isWrapperFor на обернутом объекте. Если этот объект не реализует интерфейс и не является оболочкой, то возвращает false. Этот метод должен быть реализован как операция с низкой стоимостью по сравнению с unwrap, чтобы вызывающие стороны могли использовать этот метод для избежания дорогостоящих вызовов unwrap, которые могут завершиться ошибкой. Если этот метод возвращает true, то вызов unwrap с тем же аргументом должен быть успешным.- Параметры:
-
iface- класс, определяющий интерфейс. - Возвращает:
- true, если этот объект реализует интерфейс или непосредственно или косвенно обёртывает объект, который это делает.
- Исключения:
-
SQLException- если произошла ошибка при определении, является ли этот объект оболочкой объекта с заданным интерфейсом. - С тех пор:
- 1.6
© 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/Wrapper.html