包装器和接口

下载 JDBC 驱动程序

Microsoft JDBC Driver for SQL Server 支持可用于创建类代理的接口,以及使你能够通过代理接口访问 Microsoft JDBC Driver for SQL Server 特有的 JDBC API 扩展的包装器。

包装器

Microsoft JDBC Driver for SQL Server 支持 java.sql.Wrapper 接口。 该接口提供一种机制,通过代理接口访问特定于 Microsoft JDBC Driver for SQL Server 的 JDBC API 扩展。

java.sql.Wrapper 接口定义两个方法:isWrapperFor 和 unwrap。 isWrapperFor 方法检查指定的输入对象是否实现此接口。 unwrap 方法返回一个实现此接口的对象,以便访问 Microsoft JDBC Driver for SQL Server 特有的方法。

isWrapperFor 和 unwrap 方法公开如下:

接口

从 SQL Server JDBC Driver 3.0 起,为应用程序服务器提供了接口,以便通过相关类访问驱动程序专用方法。 应用程序服务器可以通过创建代理来包装该类,并通过接口公开 Microsoft JDBC Driver for SQL Server 特有的功能。 Microsoft JDBC Driver for SQL Server 支持具有 Microsoft JDBC Driver for SQL Server 特定的方法和常量的接口,因此应用程序服务器可以创建类的代理。

这些接口继承自标准 Java 接口,因此,在对对象解除包装后,您仍可使用同一对象来访问驱动程序特有的功能或 Microsoft JDBC Driver for SQL Server 提供的通用功能。

新增了以下接口:

示例

说明

此示例说明如何从 DataSource 对象访问 Microsoft JDBC Driver for SQL Server 特定的函数。 此 DataSource 类可能已由应用程序服务器包装。 若要访问 JDBC 驱动程序特有的函数或常量,可以将数据源解包为 ISQLServerDataSource 接口,并使用此接口中声明的函数。

Code

import javax.sql.*;
import java.sql.*;
import com.microsoft.sqlserver.jdbc.*;

public class UnWrapTest {
   public static void main(String[] args) {
      // This is a test.  This DataSource object could be something from an appserver
      // which has wrapped the real SQLServerDataSource with its own wrapper
      SQLServerDataSource ds = new SQLServerDataSource();
      checkSendStringParametersAsUnicode(ds);
   }

   // Unwrap to the ISQLServerDataSource interface to access the getSendStringParametersAsUnicode function
   static void checkSendStringParametersAsUnicode(DataSource ds) {
      try {
         final ISQLServerDataSource sqlServerDataSource = ds.unwrap(ISQLServerDataSource.class);
         boolean sendStringParametersAsUnicode = sqlServerDataSource.getSendStringParametersAsUnicode();

         System.out.println("Send string as parameter value is:-" + sendStringParametersAsUnicode);

      } catch (SQLException sqlE) {
         System.out.println("Exception:-" + sqlE);
      }
   }
}