Java调用SQL Server的存储过程详解

　1、使用不带参数的存储过程

{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方法，并且希望获得受影响的行数计数，则可以在运行存储过程后调用etUpdateCount方法。

　　作为实例，在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();