JDBC之CallableStatement

前言：在按部就班的学习JDBC的过程中，来到了这里来——CallableStetement。怀着不情愿的心情花了一下午学习了相关知识，不情愿是因为感觉像鸡肋，学了没什么用。也许是我能力有限，目光短浅吧。总之，既学之 ，则记之。以防忘记，又要遭受那不情愿之苦而重新学一次
注：本文基于mysql数据库

一、存储过程

    存储过程是为了完成特定功能的SQL语句集，经编译创建并保存在数据库中，用户可通过指定存储过程的名字并给定参数(需要时)来调用执行。

二、mysql语法

创建存储过程：

create procedure sp_name (params)
begin
// sql 代码
end

其中params常用类型有两种：in 表示输入参数；out表示输入参数（可理解为函数的返回结果）

调用存储过程：

call sp_name(params)

三、CallableStatement的使用

    CallableStatement是用来执行调用存储过程的sql语句的类

1、准备工作

新建数据库表，语句如下：

create table user(
  id int auto_increment primary key,
  username varchar(50),
  password int(11)
)

数据库连接工具

 public class DBUtils {
    private static final String driver = "com.mysql.jdbc.Driver";
    private static final String url = "jdbc:mysql://localhost:3306/imooc";
    private static final Properties props = new Properties();
    static {
        props.setProperty("user", "root");
        props.setProperty("password", "root");
        props.setProperty("useUnicode", "true");
        props.setProperty("characterEncoding", "UTF-8");
    }
    public static Connection getConnection() {
        Connection conn = null;
        try {
            Class.forName(driver);
            conn = DriverManager.getConnection(url, props);
        } catch (ClassNotFoundException | SQLException e) {
            e.printStackTrace();
        }
        return conn;
    }
}

2、无参存储过程

存储过程命名：sp表示存储过程；select代表功能是查询；nofilter表示无参数

CREATE  PROCEDURE sp_select_nofilter()
BEGIN
select username, `password` from user;
END

java 操作代码如下：

public static void selectAll() throws SQLException {

        try(Connection conn = DBUtils.getConnection();
            // caution: call 调用存储过程括号可选，
            CallableStatement cstat = conn.prepareCall("call sp_select_nofilter()")) {
            cstat.execute();
            ResultSet rs = cstat.getResultSet();
            while(rs.next()) {
               System.out.println(rs.getString(1) + "\t" + rs.getInt(2));
            }
        }
    }

值得注意的是：
1、prepareCall方法参数的书写形式：call sp_name(params),即在mysql数据库中调用存储过程的语句。
2、当存储过程执行后的结果是结果集时，可以通过getResultSet方法获取此结果集

执行结果：

2、包含输入参数的存储过程

功能：输入参数是null或者为空字符串，则查询全部用户；否则根据条件模糊查询

CREATE PROCEDURE `sp_select_filter`(IN `u` varchar(10))
BEGIN
	if u is null or u = '' then  select username,`password` from user;
	else 
		select username, `password` from user where username like concat('%', u, '%');
		end if;
END;

java操作代码如下：

  public static void select (String username) throws  SQLException{
        try(Connection conn = DBUtils.getConnection();
            CallableStatement cstat = conn.prepareCall("call sp_select_filter(?)")) {
            cstat.setString(1,username);
            cstat.execute();
            ResultSet rs = cstat.getResultSet();
            while(rs.next()) {
                System.out.println(rs.getString(1) + "\t" + rs.getInt(2));
            }
        }
    }

值得注意的是：
调用存储过程的sql语句，使用?作为输入参数的占位符，之后像预编译语句PreparedStatement通过setXxx方法设置占位符的值。

执行结果：
（1）输入null或者“”

（2）输入“中国”

包含输出参数的存储过程

功能：统计数据库表中的总行数

CREATE PROCEDURE sp_select_count(OUT rowCount int)
BEGIN
	select count(*) into rowCount from user;
END

java操作代码：

 public static int count() throws SQLException{
        int result = -1;
        try(Connection conn = DBUtils.getConnection();
            CallableStatement cstat = conn.prepareCall("call sp_select_count(?)")) {
            cstat.registerOutParameter(1, Types.INTEGER);
            cstat.execute();
            result = cstat.getInt(1);
            }
        return result;
    }

值得注意的是：
占位符表示输出参数的值，要通知CallableStatement需要一个空间去保存输出参数的值，并要声明所保存值的类型，调用CallableStatement#registerOUtParameter方法实行此目的。通过调用CallableStatement#getXxx方法，获得在CallableStatement中注册的输出参数的值。

执行结果：