Java調(diào)用SQL Server的存儲(chǔ)過(guò)程詳解
1使用不帶參數(shù)的存儲(chǔ)過(guò)程
使用 JDBC 驅(qū)動(dòng)程序調(diào)用不帶參數(shù)的存儲(chǔ)過(guò)程時(shí),必須使用 call SQL 轉(zhuǎn)義序列。不帶參數(shù)的 call 轉(zhuǎn)義序列的語(yǔ)法如下所示:
- {call procedure-name}
作為實(shí)例,在 SQL Server 2005 AdventureWorks 示例數(shù)據(jù)庫(kù)中創(chuàng)建以下存儲(chǔ)過(guò)程:
- CREATE PROCEDURE GetContactFormalNames
- AS
- BEGIN
- SELECT TOP 10 Title + ' ' + FirstName + ' ' + LastName AS FormalName
- FROM Person.Contact
- END
此存儲(chǔ)過(guò)程返回單個(gè)結(jié)果集,其中包含一列數(shù)據(jù)(由 Person.Contact 表中前十個(gè)聯(lián)系人的稱呼、名稱和姓氏組成)。
在下面的實(shí)例中,將向此函數(shù)傳遞 AdventureWorks 示例數(shù)據(jù)庫(kù)的打開(kāi)連接,然后使用 executeQuery 方法調(diào)用 GetContactFormalNames 存儲(chǔ)過(guò)程。
- 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使用帶有輸入?yún)?shù)的存儲(chǔ)過(guò)程
使用 JDBC 驅(qū)動(dòng)程序調(diào)用帶參數(shù)的存儲(chǔ)過(guò)程時(shí),必須結(jié)合 SQLServerConnection 類的 prepareCall 方法使用 call SQL 轉(zhuǎn)義序列。帶有 IN 參數(shù)的 call 轉(zhuǎn)義序列的語(yǔ)法如下所示:
- {call procedure-name[([parameter][,[parameter]]...)]}
構(gòu)造 call 轉(zhuǎn)義序列時(shí),請(qǐng)使用 ?(問(wèn)號(hào))字符來(lái)指定 IN 參數(shù)。此字符充當(dāng)要傳遞給該存儲(chǔ)過(guò)程的參數(shù)值的占位符??梢允褂?SQLServerPreparedStatement 類的 setter 方法之一為參數(shù)指定值??墒褂玫?setter 方法由 IN 參數(shù)的數(shù)據(jù)類型決定。
向 setter 方法傳遞值時(shí),不僅需要指定要在參數(shù)中使用的實(shí)際值,還必須指定參數(shù)在存儲(chǔ)過(guò)程中的序數(shù)位置。例如,如果存儲(chǔ)過(guò)程包含單個(gè) IN 參數(shù),則其序數(shù)值為 1。如果存儲(chǔ)過(guò)程包含兩個(gè)參數(shù),則第一個(gè)序數(shù)值為 1,第二個(gè)序數(shù)值為 2。
作為如何調(diào)用包含 IN 參數(shù)的存儲(chǔ)過(guò)程的實(shí)例,使用 SQL Server 2005 AdventureWorks 示例數(shù)據(jù)庫(kù)中的 uspGetEmployeeManagers 存儲(chǔ)過(guò)程。此存儲(chǔ)過(guò)程接受名為 EmployeeID 的單個(gè)輸入?yún)?shù)(它是一個(gè)整數(shù)值),然后基于指定的 EmployeeID 返回雇員及其經(jīng)理的遞歸列表。下面是調(diào)用此存儲(chǔ)過(guò)程的 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使用帶有輸出參數(shù)的存儲(chǔ)過(guò)程
使用 JDBC 驅(qū)動(dòng)程序調(diào)用此類存儲(chǔ)過(guò)程時(shí),必須結(jié)合 SQLServerConnection 類的 prepareCall 方法使用 call SQL 轉(zhuǎn)義序列。帶有 OUT 參數(shù)的 call 轉(zhuǎn)義序列的語(yǔ)法如下所示:
- {call procedure-name[([parameter][,[parameter]]...)]}
構(gòu)造 call 轉(zhuǎn)義序列時(shí),請(qǐng)使用 ?(問(wèn)號(hào))字符來(lái)指定 OUT 參數(shù)。此字符充當(dāng)要從該存儲(chǔ)過(guò)程返回的參數(shù)值的占位符。要為 OUT 參數(shù)指定值,必須在運(yùn)行存儲(chǔ)過(guò)程前使用 SQLServerCallableStatement 類的 registerOutParameter 方法指定各參數(shù)的數(shù)據(jù)類型。
使用 registerOutParameter 方法為 OUT 參數(shù)指定的值必須是 java.sql.Types 所包含的 JDBC 數(shù)據(jù)類型之一,而它又被映射成本地 SQL Server 數(shù)據(jù)類型之一。有關(guān) JDBC 和 SQL Server 數(shù)據(jù)類型的詳細(xì)信息,請(qǐng)參閱了解 JDBC 驅(qū)動(dòng)程序數(shù)據(jù)類型。
當(dāng)您對(duì)于 OUT 參數(shù)向 registerOutParameter 方法傳遞一個(gè)值時(shí),不僅必須指定要用于此參數(shù)的數(shù)據(jù)類型,而且必須在存儲(chǔ)過(guò)程中指定此參數(shù)的序號(hào)位置或此參數(shù)的名稱。例如,如果存儲(chǔ)過(guò)程包含單個(gè) OUT 參數(shù),則其序數(shù)值為 1;如果存儲(chǔ)過(guò)程包含兩個(gè)參數(shù),則第一個(gè)序數(shù)值為 1,第二個(gè)序數(shù)值為 2。
作為實(shí)例,在 SQL Server 2005 AdventureWorks 示例數(shù)據(jù)庫(kù)中創(chuàng)建以下存儲(chǔ)過(guò)程: 根據(jù)指定的整數(shù) IN 參數(shù) (employeeID),該存儲(chǔ)過(guò)程也返回單個(gè)整數(shù) OUT 參數(shù) (managerID)。根據(jù) HumanResources.Employee 表中包含的 EmployeeID,OUT 參數(shù)中返回的值為 ManagerID。
在下面的實(shí)例中,將向此函數(shù)傳遞 AdventureWorks 示例數(shù)據(jù)庫(kù)的打開(kāi)連接,然后使用 execute 方法調(diào)用 GetImmediateManager 存儲(chǔ)過(guò)程:
- 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();
- }
- }
本示例使用序號(hào)位置來(lái)標(biāo)識(shí)參數(shù)?;蛘?,也可以使用參數(shù)的名稱(而非其序號(hào)位置)來(lái)標(biāo)識(shí)此參數(shù)。下面的代碼示例修改了上一個(gè)示例,以說(shuō)明如何在 Java 應(yīng)用程序中使用命名參數(shù)。請(qǐng)注意,這些參數(shù)名稱對(duì)應(yīng)于存儲(chǔ)過(guò)程的定義中的參數(shù)名稱: 11x16CREATE PROCEDURE GetImmediateManager
- @employeeID INT,
- @managerID INT OUTPUT
- AS
- BEGIN
- SELECT @managerID = ManagerID
- FROM HumanResources.Employee
- WHERE EmployeeID = @employeeID
- END
存儲(chǔ)過(guò)程可能返回更新計(jì)數(shù)和多個(gè)結(jié)果集。Microsoft SQL Server 2005 JDBC Driver 遵循 JDBC 3.0 規(guī)范,此規(guī)范規(guī)定在檢索 OUT 參數(shù)之前應(yīng)檢索多個(gè)結(jié)果集和更新計(jì)數(shù)。也就是說(shuō),應(yīng)用程序應(yīng)先檢索所有 ResultSet 對(duì)象和更新計(jì)數(shù),然后使用 CallableStatement.getter 方法檢索 OUT 參數(shù)。否則,當(dāng)檢索 OUT 參數(shù)時(shí),尚未檢索的 ResultSet 對(duì)象和更新計(jì)數(shù)將丟失。
#p#
4 使用帶有返回狀態(tài)的存儲(chǔ)過(guò)程
使用 JDBC 驅(qū)動(dòng)程序調(diào)用這種存儲(chǔ)過(guò)程時(shí),必須結(jié)合 SQLServerConnection 類的 prepareCall 方法使用 call SQL 轉(zhuǎn)義序列。返回狀態(tài)參數(shù)的 call 轉(zhuǎn)義序列的語(yǔ)法如下所示:
- {[?=]call procedure-name[([parameter][,[parameter]]...)]}
構(gòu)造 call 轉(zhuǎn)義序列時(shí),請(qǐng)使用 ?(問(wèn)號(hào))字符來(lái)指定返回狀態(tài)參數(shù)。此字符充當(dāng)要從該存儲(chǔ)過(guò)程返回的參數(shù)值的占位符。要為返回狀態(tài)參數(shù)指定值,必須在執(zhí)行存儲(chǔ)過(guò)程前使用 SQLServerCallableStatement 類的 registerOutParameter 方法指定參數(shù)的數(shù)據(jù)類型。
此外,向 registerOutParameter 方法傳遞返回狀態(tài)參數(shù)值時(shí),不僅需要指定要使用的參數(shù)的數(shù)據(jù)類型,還必須指定參數(shù)在存儲(chǔ)過(guò)程中的序數(shù)位置。對(duì)于返回狀態(tài)參數(shù),其序數(shù)位置始終為 1,這是因?yàn)樗冀K是調(diào)用存儲(chǔ)過(guò)程時(shí)的第一個(gè)參數(shù)。盡管 SQLServerCallableStatement 類支持使用參數(shù)的名稱來(lái)指示特定參數(shù),但您只能對(duì)返回狀態(tài)參數(shù)使用參數(shù)的序號(hào)位置編號(hào)。
作為實(shí)例,在 SQL Server 2005 AdventureWorks 示例數(shù)據(jù)庫(kù)中創(chuàng)建以下存儲(chǔ)過(guò)程:
- CREATE PROCEDURE CheckContactCity
- (@cityName CHAR(50))
- AS
- BEGIN
- IF ((SELECT COUNT(*)
- FROM Person.Address
- WHERE City = @cityName) > 1)
- RETURN 1
- ELSE
- RETURN 0
- END
該存儲(chǔ)過(guò)程返回狀態(tài)值 1 或 0,這取決于是否能在表 Person.Address 中找到 cityName 參數(shù)指定的城市。
在下面的實(shí)例中,將向此函數(shù)傳遞 AdventureWorks 示例數(shù)據(jù)庫(kù)的打開(kāi)連接,然后使用 execute 方法調(diào)用 CheckContactCity 存儲(chǔ)過(guò)程:
- 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 使用帶有更新計(jì)數(shù)的存儲(chǔ)過(guò)程
使用 SQLServerCallableStatement 類構(gòu)建對(duì)存儲(chǔ)過(guò)程的調(diào)用之后,可以使用 execute 或 executeUpdate 方法中的任意一個(gè)來(lái)調(diào)用此存儲(chǔ)過(guò)程。executeUpdate 方法將返回一個(gè) int 值,該值包含受此存儲(chǔ)過(guò)程影響的行數(shù),但 execute 方法不返回此值。如果使用 execute 方法,并且希望獲得受影響的行數(shù)計(jì)數(shù),則可以在運(yùn)行存儲(chǔ)過(guò)程后調(diào)用 getUpdateCount 方法。
作為實(shí)例,在 SQL Server 2005 AdventureWorks 示例數(shù)據(jù)庫(kù)中創(chuàng)建以下表和存儲(chǔ)過(guò)程:
- 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;
在下面的實(shí)例中,將向此函數(shù)傳遞 AdventureWorks 示例數(shù)據(jù)庫(kù)的打開(kāi)連接,并使用 execute 方法調(diào)用 UpdateTestTable 存儲(chǔ)過(guò)程,然后使用 getUpdateCount 方法返回受存儲(chǔ)過(guò)程影響的行計(jì)數(shù)。
- 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();
原文鏈接:http://www.cnblogs.com/dayday-study/archive/2012/05/09/2492651.html
【編輯推薦】