4 使用帶有返回狀態的存儲過程
使用 JDBC 驅動程序調用這種存儲過程時,必須結合 SQLServerConnection 類的 prepareCall 方法使用 call SQL 轉義序列。返回狀態參數的 call 轉義序列的語法如下所示:
- {[?=]call procedure-name[([parameter][,[parameter]]...)]}
構造 call 轉義序列時,請使用 ?(問號)字符來指定返回狀態參數。此字符充當要從該存儲過程返回的參數值的占位符。要為返回狀態參數指定值,必須在執行存儲過程前使用 SQLServerCallableStatement 類的 registerOutParameter 方法指定參數的數據類型。
此外,向 registerOutParameter 方法傳遞返回狀態參數值時,不僅需要指定要使用的參數的數據類型,還必須指定參數在存儲過程中的序數位置。對於返回狀態參數,其序數位置始終為 1,這是因為它始終是調用存儲過程時的第一個參數。盡管 SQLServerCallableStatement 類支持使用參數的名稱來指示特定參數,但您只能對返回狀態參數使用參數的序號位置編號。
作為實例,在 SQL Server 2005 AdventureWorks 示例數據庫中創建以下存儲過程:
- CREATE PROCEDURE CheckContactCity
- (@cityName CHAR(50))
- AS
- BEGIN
- IF ((SELECT COUNT(*)
- FROM Person.Address
- WHERE City = @cityName) > 1)
- RETURN 1
- ELSE
- RETURN 0
- END
該存儲過程返回狀態值 1 或 0,這取決於是否能在表 Person.Address 中找到 cityName 參數指定的城市。
在下面的實例中,將向此函數傳遞 AdventureWorks 示例數據庫的打開連接,然後使用 execute 方法調用 CheckContactCity 存儲過程:
- public static void executeStoredProcedure(Connection con) ...{
- try ...{
- CallableStatement cstmt = con.prepareCall("{? = call dbo.CheckContactCity(?)}");
- cstmt.registerOutParameter(1, Java.sql.Types.INTEGER);
- cstmt.setString(2, "Atlanta");
- cstmt.execute();
- System.out.println("RETURN STATUS: " + cstmt.getInt(1));
- }
- cstmt.close();
- catch (Exception e) ...{
- e.printStackTrace();
- }
- }
5 使用帶有更新計數的存儲過程
使用 SQLServerCallableStatement 類構建對存儲過程的調用之後,可以使用 execute 或 executeUpdate 方法中的任意一個來調用此存儲過程。executeUpdate 方法將返回一個 int 值,該值包含受此存儲過程影響的行數,但 execute 方法不返回此值。如果使用 execute 方法,並且希望獲得受影響的行數計數,則可以在運行存儲過程後調用 getUpdateCount 方法。
作為實例,在 SQL Server 2005 AdventureWorks 示例數據庫中創建以下表和存儲過程:
- CREATE TABLE TestTable
- (Col1 int IDENTITY,
- Col2 varchar(50),
- Col3 int);
- CREATE PROCEDURE UpdateTestTable
- @Col2 varchar(50),
- @Col3 int
- AS
- BEGIN
- UPDATE TestTable
- SET Col2 = @Col2, Col3 = @Col3
- END;
在下面的實例中,將向此函數傳遞 AdventureWorks 示例數據庫的打開連接,並使用 execute 方法調用 UpdateTestTable 存儲過程,然後使用 getUpdateCount 方法返回受存儲過程影響的行計數。
- public static void executeUpdateStoredProcedure(Connection con) ...{
- try ...{
- CallableStatement cstmt = con.prepareCall("{call dbo.UpdateTestTable(?, ?)}");
- cstmt.setString(1, "A");
- cstmt.setInt(2, 100);
- cstmt.execute();
- int count = cstmt.getUpdateCount();
- cstmt.close();
- System.out.println("ROWS AFFECTED: " + count);
- }
- catch (Exception e) ...{
- e.printStackTrace();