unwrap Method (SQLServerXADataSource)

Article
11/18/2022

Returns an object that implements the specified interface to allow access to the Microsoft JDBC Driver for SQL Server-specific methods.

Syntax

  
public <T> T unwrap(Class<T> iface)

Parameters

iface

A class of type T defining an interface.

Return Value

An object that implements the specified interface.

Exceptions

SQLServerException

Remarks

The unwrap method is defined by the java.sql.Wrapper interface, which is introduced in the JDBC 4.0 Spec.

Applications might need to access extensions to the JDBC API that are specific to the Microsoft JDBC Driver for SQL Server. The unwrap method supports unwrapping to public classes that this object extends, if the classes expose vendor extensions.

The SQLServerXADataSource class extends the SQLServerConnectionPoolDataSource class, which is extended from the SQLServerDataSource class. When this method is called, the object unwraps to the following classes: SQLServerDataSource, SQLServerConnectionPoolDataSource, and SQLServerXADataSource.

For more information, see Wrappers and Interfaces.