Método unwrap (SQLServerCallableStatement)

Baixar Driver JDBC

Retorna um objeto que implementa a interface especificada para permitir o acesso aos métodos específicos do Microsoft JDBC Driver para SQL Server.

Sintaxe

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

Parâmetros

iface

Uma classe do tipo T que define uma interface.

Valor de retorno

Um objeto que implementa a interface especificada.

Exceções

SQLServerException

Comentários

O método unwrap é definido pela interface java.sql.Wrapper introduzida no JDBC 4.0 Spec.

Os aplicativos talvez precisem acessar extensões para a API do JDBC específicas do Microsoft JDBC Driver para SQL Server. O método unwrap é compatível com o desencapsulamento para classes públicas estendidas por esse objeto, caso as classes exponham extensões do fornecedor.

O SQLServerCallableStatement implementa ISQLServerPreparedStatement, que é estendido do ISQLServerStatement. Quando esse método é chamado, o objeto é desencapsulado nas classes seguintes: SQLServerStatement, SQLServerPreparedStatement e SQLServerCallableStatement.

Para obter mais informações, confira Wrappers e Interfaces.

O exemplo de código a seguir demonstra como usar os métodos isWrapperFor e unwrap para verificar as extensões de driver e chamar os métodos específicos do fornecedor, como setResponseBuffering e getResponseBuffering.

public static void executeStoredProcedure(Connection con) {  
   try {  
    CallableStatement cstmt =   
       con.prepareCall("{call dbo.stored_proc_name(?, ?)}");  
  
    // The recommended way to access the JDBC   
    // Driver-specific methods is to use the JDBC 4.0 Wrapper   
    // functionality.   
    // The following code statements demonstrates how to use the   
    // isWrapperFor and unwrap methods  
    // to access the driver-specific response buffering methods.  
  
    if (cstmt.isWrapperFor(  
      com.microsoft.sqlserver.jdbc.SQLServerCallableStatement.class)) {  
     // The CallableStatement object can unwrap to   
     // SQLServerCallableStatement.  
     SQLServerCallableStatement SQLcstmt =   
     cstmt.unwrap(  
        com.microsoft.sqlserver.jdbc.SQLServerCallableStatement.class);  
     SQLcstmt.setResponseBuffering("adaptive");  
     System.out.println("Response buffering mode has been set to " +  
         SQLcstmt.getResponseBuffering());  
     }  
  
    if (cstmt.isWrapperFor(  
      com.microsoft.sqlserver.jdbc.SQLServerPreparedStatement.class)) {  
      // The CallableStatement object can unwrap to   
      // SQLServerPreparedStatement.                    
      SQLServerPreparedStatement SQLpstmt =   
       cstmt.unwrap(  
       com.microsoft.sqlserver.jdbc.SQLServerPreparedStatement.class);  
      SQLpstmt.setResponseBuffering("adaptive");  
      System.out.println("Response buffering mode has been set to " +  
          SQLpstmt.getResponseBuffering());  
    }  
    if (cstmt.isWrapperFor(  
      com.microsoft.sqlserver.jdbc.SQLServerStatement.class)) {  
  
      // The CallableStatement object can unwrap to SQLServerStatement.   
      SQLServerStatement SQLstmt =   
        cstmt.unwrap(  
        com.microsoft.sqlserver.jdbc.SQLServerStatement.class);  
      SQLstmt.setResponseBuffering("adaptive");  
      System.out.println("Response buffering mode has been set to " +  
      SQLstmt.getResponseBuffering());  
    }  
  }  
  catch (Exception e) {  
     e.printStackTrace();  
  }  
}   

Consulte Também

Método isWrapperFor (SQLServerCallableStatement)
Membros SQLServerCallableStatement
Classe SQLServerCallableStatement