Java Mysql 简明教程
Java & MySQL - CallableStatement
CallableStatement 接口用于执行对数据库存储过程的调用。
假设您需要在 TUTORIALSPOINT 数据库中执行以下存储过程：
DELIMITER $$
DROP PROCEDURE IF EXISTS `TUTORIALSPOINT`.`getEmpName` $$
CREATE PROCEDURE `TUTORIALSPOINT`.`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 对象可以使用这三种类型。
以下是对每种类型的定义：
Parameter |
Description |
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 {
. . .
}String 变量 SQL 表示存储过程，其中包含参数占位符。
使用 CallableStatement 对象非常类似于使用 PreparedStatement 对象。您必须在执行语句之前向所有参数绑定值，否则您将收到 SQLException。
如果您有 IN 参数，只需遵循适用于 PreparedStatement 对象的相同规则和技术；使用与您绑定的 Java 数据类型对应的 setXXX() 方法。
当您使用 OUT 和 INOUT 参数时，您必须使用一个附加的 CallableStatement 方法 registerOutParameter()。registerOutParameter() 方法将 JDBC 数据类型绑定到存储过程预期返回的数据类型。
在调用存储过程后，使用适当的 getXXX() 方法从 OUT 参数中检索值。此方法将检索到的 SQL 类型值强制转换为 Java 数据类型。
Closing CallableStatement Object
正如您关闭其它 Statement 对象一样，出于相同的原因，您还应当关闭 CallableStatement 对象。
对 close() 方法进行简单调用即可完成此工作。如果您首先关闭 Connection 对象，它也将关闭 CallableStatement 对象。但是，您应当始终显式关闭 CallableStatement 对象以确保适当清理。
CallableStatement cstmt = null;
try {
String SQL = "{call getEmpName (?, ?)}";
cstmt = conn.prepareCall (SQL);
. . .
}
catch (SQLException e) {
. . .
}
finally {
cstmt.close();
}我们使用 try 和 resources（它会自动处理资源关闭）。下面的示例演示了所有上述概念。
这段代码是根据前一章完成的环境和数据库设置编写的。
将以下示例复制并粘贴到 TestApplication.java 中，如下进行编译和运行：
import java.sql.CallableStatement;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
public class TestApplication {
static final String DB_URL = "jdbc:mysql://localhost/TUTORIALSPOINT";
static final String USER = "guest";
static final String PASS = "guest123";
static final String QUERY = "{call getEmpName (?, ?)}";
public static void main(String[] args) {
// Open a connection
try(Connection conn = DriverManager.getConnection(DB_URL, USER, PASS);
CallableStatement stmt = conn.prepareCall(QUERY);
) {
// Bind values into the parameters.
stmt.setInt(1, 102); // This would set ID
// Because second parameter is OUT so register it
stmt.registerOutParameter(2, java.sql.Types.VARCHAR);
//Use execute method to run stored procedure.
System.out.println("Executing stored procedure..." );
stmt.execute();
//Retrieve employee name with getXXX method
String empName = stmt.getString(2);
System.out.println("Emp Name with ID: 102 is " + empName);
} catch (SQLException e) {
e.printStackTrace();
}
}
}现在让我们如下编译上述示例：
C:\>javac TestApplication.java
C:\>运行 TestApplication 时，它会生成以下结果：
C:\>java TestApplication
Executing stored procedure...
Emp Name with ID: 102 is Zaid
C:\>JDBC SQL Escape Syntax
转义语法使您可以灵活地使用 JDBC 标准方法和属性无法为您提供的数据库特定功能。
SQL 转义语法格式如下 −
{keyword 'parameters'}下面是执行 JDBC 编程时非常有用的转义序列 −
d, t, ts Keywords
它们有助于识别日期、时间和时间戳文本。众所周知，没有两个 DBMS 以相同的方式表示时间和日期。此转义语法告诉驱动程序以目标数据库的格式呈现日期或时间。例如 −
{d 'yyyy-mm-dd'}其中 yyyy = 年份，mm = 月份；dd = 日期。使用此语法 {d '2009-09-03'} 是 2009 年 3 月 9 日。
以下是一个简单的示例，演示如何在表中 INSERT 日期 −
//Create a Statement object
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。
{ts 'yyyy-mm-dd hh:mm:ss'}这是用于表示时间戳的上述两个语法“d”和“t”的组合语法。
escape Keyword
此关键字标识 LIKE 子句中使用的转义字符。在使用 SQL 通配符 %（匹配零个或多个字符）时很有用。例如 −
String sql = "SELECT symbol FROM MathSymbols WHERE symbol LIKE '\%' {escape '\'}";
stmt.execute(sql);如果您使用反斜杠字符 (\) 作为转义字符，还必须在 Java 字符串文本中使用两个反斜杠字符，因为反斜杠也是 Java 转义字符。
fn Keyword
该关键字表示 DBMS 中使用的标量函数。例如，您可以使用 SQL 函数 length 获取字符串的长度 −
{fn length('Hello World')}它返回 11，即字符字符串“Hello World”的长度。