本文作者介紹了透過Java如何去呼叫SQL Server的預存過程,詳解了5種不同的儲存。詳細請看下文
1.使用不帶參數的預存程序
使用JDBC 驅動程式呼叫不帶參數的預存程序時,必須使用call SQL 轉義序列。不帶參數的call 轉義序列的語法如下:
複製代碼代碼如下:
{call procedure-name}
作為實例,在SQL Server 2005 AdventureWorks 範例資料庫中建立下列預存程序:
複製代碼代碼如下:
CREATE PROCEDURE GetContactFormalNames
AS
BEGIN
SELECT TOP 10 Title + ' ' + FirstName + ' ' + LastName AS FormalName
FROM Person.Contact
END
此預存程序傳回單一結果集,其中包含一列資料(由Person.Contact 表中前十個聯絡人的稱呼、名稱和姓氏組成)。
在下面的實例中,將向此函數傳遞AdventureWorks 範例資料庫的開啟連接,然後使用executeQuery 方法呼叫GetContactFormalNames 預存程序。
複製代碼代碼如下:
public static void executeSprocNoParams(Connection con) ...{
try ...{
Statement stmt = con.createStatement();
ResultSet rs = stmt.executeQuery("{call dbo.GetContactFormalNames}");
while (rs.next()) ...{
System.out.println(rs.getString("FormalName"));
}
rs.close();
stmt.close();
}
catch (Exception e) ...{
e.printStackTrace();
}
}
2、使用有輸入參數的預存程序
使用JDBC 驅動程式呼叫帶參數的預存程序時,必須結合SQLServerConnection 類別的prepareCall 方法使用call SQL 轉義序列。帶有IN 參數的call 轉義序列的語法如下所示:
複製代碼代碼如下:
{call procedure-name[([parameter][,[parameter]]...)]}
建構call 轉義序列時,請使用?(問號)字元來指定IN 參數。此字元充當要傳遞給該預存程序的參數值的佔位符。可以使用SQLServerPreparedStatement 類別的setter 方法之一為參數指定值。可使用的setter 方法由IN 參數的資料型態決定。
向setter 方法傳遞值時,不僅需要指定要在參數中使用的實際值,還必須指定參數在預存程序中的序數位置。例如,如果預存程序包含單一IN 參數,則其序數值為1。如果預存程序包含兩個參數,則第一個序數值為1,第二個序數值為2。
作為如何呼叫包含IN 參數的預存程序的實例,使用SQL Server 2005 AdventureWorks 範例資料庫中的uspGetEmployeeManagers 預存程序。此預存程序接受名為EmployeeID 的單一輸入參數(它是整數值),然後基於指定的EmployeeID 傳回員工及其經理的遞歸清單。下面是呼叫此預存程序的Java 程式碼:
複製代碼代碼如下:
public static void executeSprocInParams(Connection con) ...{
try ...{
PreparedStatement pstmt = con.prepareStatement("{call dbo.uspGetEmployeeManagers(?)}");
pstmt.setInt(1, 50);
ResultSet rs = pstmt.executeQuery();
while (rs.next()) ...{
System.out.println("EMPLOYEE:");
System.out.println(rs.getString("LastName") + ", " + rs.getString("FirstName"));
System.out.println("MANAGER:");
System.out.println(rs.getString("ManagerLastName") + ", " + rs.getString("ManagerFirstName"));
System.out.println();
}
rs.close();
pstmt.close();
}
catch (Exception e) ...{
e.printStackTrace();
}
}
3.使用帶有輸出參數的預存程序
使用JDBC 驅動程式呼叫此類預存程序時,必須結合SQLServerConnection 類別的prepareCall 方法使用call SQL 轉義序列。帶有OUT 參數的call 轉義序列的語法如下所示:
複製代碼代碼如下:
{call procedure-name[([parameter][,[parameter]]...)]}
建構call 轉義序列時,請使用?(問號)字元來指定OUT 參數。此字元可作為要從該預存程序傳回的參數值的佔位符。若要為OUT 參數指定值,必須在執行預存程序前使用SQLServerCallableStatement 類別的registerOutParameter 方法指定各參數的資料類型。
使用registerOutParameter 方法為OUT 參數指定的值必須是java.sql.Types 所包含的JDBC 資料型別之一,而它又會被對應成本地SQL Server 資料型別之一。有關JDBC 和SQL Server 資料類型的詳細信息,請參閱了解JDBC 驅動程式資料類型。
當您對於OUT 參數向registerOutParameter 方法傳遞一個值時,您不僅必須指定要用於此參數的資料類型,而且必須在預存程序中指定此參數的序號位置或此參數的名稱。例如,如果預存程序包含單一OUT 參數,則其序數值為1;如果預存程序包含兩個參數,則第一個序數值為1,第二個序數值為2。
作為實例,在SQL Server 2005 AdventureWorks 範例資料庫中建立下列預存程序: 根據指定的整數IN 參數(employeeID),此預存程序也會傳回單一整數OUT 參數(managerID)。根據HumanResources.Employee 表中包含的EmployeeID,OUT 參數中傳回的值為ManagerID。
在下面的實例中,將向此函數傳遞AdventureWorks 範例資料庫的開啟連接,然後使用execute 方法呼叫GetImmediateManager 預存程序:
複製代碼代碼如下:
public static void executeStoredProcedure(Connection con) ...{
try ...{
CallableStatement cstmt = con.prepareCall("{call dbo.GetImmediateManager(?, ?)}");
cstmt.setInt(1, 5);
cstmt.registerOutParameter(2, java.sql.Types.INTEGER);
cstmt.execute();
System.out.println("MANAGER ID: " + cstmt.getInt(2));
}
catch (Exception e) ...{
e.printStackTrace();
}
}
本範例使用序號位置來標識參數。或者,也可以使用參數的名稱(而非其序號位置)來識別此參數。下面的程式碼範例修改了上一個範例,以說明如何在Java 應用程式中使用命名參數。請注意,這些參數名稱對應於預存程序的定義中的參數名稱: 11x16CREATE PROCEDURE GetImmediateManager
複製代碼代碼如下:
@employeeID INT,
@managerID INT OUTPUT
AS
BEGIN
SELECT @managerID = ManagerID
FROM HumanResources.Employee
WHERE EmployeeID = @employeeID
END
預存程序可能會傳回更新計數和多個結果集。 Microsoft SQL Server 2005 JDBC Driver 遵循JDBC 3.0 規範,此規範規定在檢索OUT 參數之前應檢索多個結果集和更新計數。也就是說,應用程式應先檢索所有ResultSet 物件和更新計數,然後使用CallableStatement.getter 方法檢索OUT 參數。否則,當檢索OUT 參數時,尚未檢索的ResultSet 物件和更新計數將會遺失。
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();