JDBC 存储过程

在学习JDBC-语句一章的同时，我们学习了如何在JDBC中使用存储过程。本章与该部分相似，但是它将为您提供有关JDBC SQL转义语法的更多信息。

就像 Connection 对象创建 Statement 和 PreparedStatement 对象一样，它也创建 CallableStatement 对象，该对象将用于执行对数据库存储过程的调用。

创建CallableStatement对象

假设您需要执行以下Oracle存储过程-

CREATE OR REPLACE PROCEDURE getEmpName 
   (EMP_ID IN NUMBER, EMP_FIRST OUT VARCHAR) AS
BEGIN
   SELECT first INTO EMP_FIRST
   FROM Employees
   WHERE ID = EMP_ID;
END;

NOTE: 上面的存储过程已经为Oracle编写，但是我们正在使用MySQL数据库，因此，让我们为MySQL编写相同的存储过程，如下所示，以便在EMP数据库中创建它-

DELIMITER $$

DROP PROCEDURE IF EXISTS `EMP`.`getEmpName` $$
CREATE PROCEDURE `EMP`.`getEmpName` 
   (IN EMP_ID INT, OUT EMP_FIRST VARCHAR(255))
BEGIN
   SELECT first INTO EMP_FIRST
   FROM Employees
   WHERE ID = EMP_ID;
END $$

DELIMITER ;

存在三种类型的参数：IN，OUT和INOUT。PreparedStatement对象仅使用IN参数。CallableStatement对象可以使用所有这三个对象。

这是每个的定义-

范围	描述
IN	创建SQL语句时其值未知的参数。使用setXXX()方法将值绑定到IN参数。
OUT	其值由返回的SQL语句提供的参数。使用getXXX()方法从OUT参数中检索值。
INOUT	同时提供输入和输出值的参数。可以使用 setXXX ()方法绑定变量，并使用 getXXX ()方法检索值。

以下代码片段显示了如何基于前面的存储过程使用该方法实例化对象-Connection.prepareCall()CallableStatement

CallableStatement cstmt = null;
try {
   String SQL = "{call getEmpName (?, ?)}";
   cstmt =conn.prepareCall(SQL);
   . . .
}
catch (SQLException e) {
   . . .
}
finally {
   . . .
}

字符串变量SQL代表带有参数占位符的存储过程。

使用CallableStatement对象与使用PreparedStatement对象非常相似。您必须在执行该语句之前将值绑定到所有参数，否则您将收到一个SQLException。

如果有 IN 参数，只需遵循应用于 PreparedStatement 对象的相同规则和技术; 使用与绑定的 Java 数据类型对应的 setXXX ()方法。

当使用 OUT 和 INOUT 参数时，必须使用附加的 CallableStatement 方法 registerOutParameter ()。registerOutParameter ()方法将 JDBC 数据类型绑定到预期存储过程返回的数据类型。

调用存储过程后，可以使用适当的getXXX()方法从OUT参数中检索值。此方法将检索到的SQL类型的值转换为Java数据类型。

关闭 CallableStatement 对象

就像关闭其他Statement对象一样，出于同样的原因，您也应该关闭CallableStatement对象。

简单的调用close()方法就可以了。如果先关闭Connection对象，它也会关闭CallableStatement对象。但是，您应该始终显式关闭CallableStatement对象，以确保正确清理。

CallableStatement cstmt = null;
try {
   String SQL = "{call getEmpName (?, ?)}";
   cstmt =conn.prepareCall(SQL);
   . . .
}
catch (SQLException e) {
   . . .
}
finally {
   cstmt.close();
}

研究我们在可调用示例代码中研究了更多的细节。

JDBC SQL转义语法

Escape 语法使您能够灵活地使用标准 JDBC 方法和属性所不能使用的数据库特定特性。
通用的SQL转义语法格式如下-

{keyword 'parameters'}

以下是以下转义序列，在执行JDBC编程时您会发现它们非常有用-

d，t，ts关键字

它们可以帮助标识日期、时间和时间戳的文本。如您所知，没有两个 dbms 以相同的方式表示时间和日期。这种转义语法告诉驱动程序以目标数据库的格式呈现日期或时间。例如：

{d 'yyyy-mm-dd'}

其中yyyy =年，mm =月；dd =日。使用此语法{d'2009-09-03'}是2009年3月9日。

这是一个简单的示例，显示如何在表中插入日期-

//创建一个Statement对象
stmt = conn.createStatement();
//Insert data ==> ID, First Name, Last Name, DOB
String sql="INSERT INTO STUDENTS VALUES" +
             "(100,'Zara','Ali', {d '2001-12-16'})";

stmt.executeUpdate(sql);

同样，您可以使用以下两种语法之一，t或者ts：

{t 'hh:mm:ss'}

其中hh =小时；mm=分钟; ss =秒。使用此语法{t '13：30：29'}是1:30:29 PM。

{ts 'yyyy-mm-dd hh:mm:ss'}

这是上面两种语法的组合语法，其中'd'和't'代表时间戳。

escape关键字

此关键字标识 LIKE 子句中使用的转义字符。使用 SQL 通配符% 时非常有用，该通配符匹配零个或多个字符。例如：

String sql = "SELECT symbol FROM MathSymbols
              WHERE symbol LIKE '\%' {escape '\'}";
stmt.execute(sql);

如果将反斜杠字符（\）用作转义字符，则还必须在Java String字面量中使用两个反斜杠字符，因为反斜杠也是Java转义字符。

fn关键字

此关键字表示DBMS中使用的标量函数。例如，您可以使用SQL函数length来获取字符串的长度-

{fn length('Hello World')}

这将返回11，即字符串“ Hello World”的长度。

call 关键字

此关键字用于调用存储过程。例如，对于需要IN参数的存储过程，请使用以下语法-

{call my_procedure(?)};

对于需要IN参数并返回OUT参数的存储过程，请使用以下语法-

{? = call my_procedure(?)};

oj关键字

此关键字用于表示外部联接。语法如下-

{oj outer-join}

其中，外部联接=表{LEFT | RIGHT | FULL} OUTERJOIN {table | 搜索条件。例如-

String sql = "SELECT Employees 
              FROM {oj ThisTable RIGHT
              OUTER JOIN ThatTable on id = '100'}";
stmt.execute(sql);