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