Интерфейс обёртки
- Все известные подинтерфейсы:
-
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- тип класса, моделируемого этим объектом Class- Параметры:
-
iface- Класс, определяющий интерфейс, который должен реализовывать результат. - Возвращаемое значение:
- объект, реализующий интерфейс. Может быть прокси для фактического реализующего объекта.
- Исключения:
-
SQLException- Если объект, реализующий интерфейс, не найден - С момента:
- 1.6
isWrapperFor
boolean isWrapperFor(Class<?> iface) throws SQLException
isWrapperFor на обернутом объекте. Если этот объект не реализует интерфейс и не является обёрткой, возвращает false. Этот метод должен реализовываться как операция с низкой стоимостью по сравнению с unwrap, чтобы вызывающие стороны могли использовать этот метод для избежания дорогостоящих вызовов unwrap, которые могут завершиться неудачей. Если этот метод возвращает true, то вызов unwrap с тем же аргументом должен быть успешным.- Параметры:
-
iface- класс, определяющий интерфейс. - Возвращаемое значение:
- true, если данный объект реализует интерфейс или непосредственно или косвенно оборачивает объект, который это делает.
- Исключения:
-
SQLException- если произошла ошибка при определении, является ли данный объект обёрткой для объекта с заданным интерфейсом. - С момента:
- 1.6
© 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://download.java.net/java/early_access/jdk24/docs/api/java.sql/java/sql/Wrapper.html
