Statement

用于执行静态SQL并返回结果对象。
默认情况下，每个Statement对象只能有一个ResultSet对象同时打开。如果打开ResultSet则会隐式关闭当前ResultSet对象。

属性

// ResultSet能返回的最大行数，超过则丢弃
// 0表示无限制
int getMaxRows();
void setMaxRows(int max);

// ResultSet行被处理的方向
// 可为
//     ResultSet.FETCH_FORWARD（默认，1000）
//     ResultSet.FETCH_REVERSE（1001）
//     ResultSet.FETCH_UNKNOWN（1002）
int getFetchDirection();
void setFetchDirection(int direction);

// 一次查询返回的行数
// 0表示无限制，默认为0
int getFetchSize();
void setFetchSize(int rows);

// ResultSet类型
// 可为
//     ResultSet.TYPE_FORWARD_ONLY（1003）
//     ResultSet.TYPE_SCROLL_INSENSITIVE（1004）
//     ResultSet.TYPE_SCROLL_SENSITIVE（1005）
int getResultSetType();

// ResultSet并发类型
// 可为
//     ResultSet.CONCUR_READ_ONLY（1007）
//     ResultSet.CONCUR_UPDATABLE（1008）
int getResultSetConcurrency();

// ResultSet保持类型
// 可为
//     ResultSet.HOLD_CURSORS_OVER_COMMIT（1）
//     ResultSet.CLOSE_CURSORS_AT_COMMIT（2）
int getResultSetHoldability();

// 超时秒数
// 0表示无限制，默认为0
int getQueryTimeout();
void setQueryTimeout(int seconds);

// 当所有ResultSet关闭时是否自动关闭Statement
boolean isCloseOnCompletion();
void closeOnCompletion();

查询

ResultSet executeQuery(String sql);

例：

// executeQuery
ResultSet resultSet = statement.executeQuery("select *, id as userId from user");
while (resultSet.next()) {
    // 列标
    long userId = resultSet.getLong("userId");
    String userName = resultSet.getString("userName");
    System.out.println(userId + " " + userName);
}
resultSet.close();

更新

// 返回影响行数
int executeUpdate(String sql);

多结果

// 执行给定SQL，可能返回多个结果（一般是调用存储过程）
// 先使用getResultSet()或getUpdateCount()获取第一个结果（已移动到第一个结果）
// 然后再使用getMoreResults()判断下一个结果类型
// 返回：
//     true：第一个结果是ResultSet
//     false：第一个结果是更新数，或没有更多结果
boolean execute(String sql);

// 移动到下一个结果
// 返回：
//     true：下个结果是ResultSet
//     false：下个结果是更新数，或没有更多结果
boolean getMoreResults();

// 移动到下一个结果，并处理当前ResultSet
// current：
//     Statement.CLOSE_CURRENT_RESULT（1）
//     Statement.KEEP_CURRENT_RESULT（2）
//     Statement.CLOSE_ALL_RESULTS（3）
boolean getMoreResults(int current);

// 返回更新数
//      -1：当前结果是ResultSet，或没有更多结果
int getUpdateCount();

// 返回ResultSet
//      null：当前结果是更新数，或没有更多结果
ResultSet getResultSet();

例：

// 存储过程
// mysql> delimiter $$ // 临时将结束符由;改为$$
// mysql> create procedure getTwoUsers()
//     -> begin
//     -> select * from user where id = 1;
//     -> select * from user where id = 2;
//     -> update user set status = 3 where id = 3;
//     -> end$$
// mysql> delimiter ;
// mysql> call getTwoUsers();

// 多结果
String sql = "call getTwoUsers()";
// 已经移动到下一个结果
boolean isResultSet = statement.execute(sql);

int resultIndex = 0;
while (true) {
    if (isResultSet) {
        System.out.println("结果" + (++resultIndex) + "：");
        ResultSet resultSet = statement.getResultSet();
        while (resultSet.next()) {
            long id = resultSet.getLong("id");
            String userName = resultSet.getString("userName");
            System.out.println(id + " " + userName);
        }
        resultSet.close();

    } else {
        int updateCount = statement.getUpdateCount();
        if (updateCount == -1) {
            // 结果遍历结束：getMoreResults()==false && getUpdateCount()==-1
            break;
        } else {
            System.out.println("结果" + (++resultIndex) + "：");
            System.out.println("更新数：" + updateCount);
        }
    }
    System.out.println();

    isResultSet = statement.getMoreResults();
}

批量更新

void addBatch(String sql);
void clearBatch();

// 批量执行SQL，返回更新数数组
// 更新数 >=0，表示影响行数
// 更新数 = Statement.SUCCESS_NO_INFO（-2），表示影响行数未知
// 如果其中一个SQL出错，抛出BatchUpdateException
int[] executeBatch();

BatchUpdateException

// 批量更新时各SQL的更新数结果
// 更新数 = Statement.EXECUTE_FAILED（-3），表示执行失败
int[] getUpdateCounts();

例：

String[] sqlList = new String[]{
    "update user set status = 1 where id = 1",
    "update user set status = 2 where id = a",
    "update user set status = 3 where id = 3"
};

Consumer<int[]> updateCountsConsumer = new Consumer<int[]>() {
    @Override
    public void accept(int[] updateCounts) {
        for (int i = 0; i < sqlList.length; i++) {
            String sql = sqlList[i];
            int updateCount = updateCounts[i];

            if (updateCount == Statement.SUCCESS_NO_INFO) {
                System.out.println(sql + "：未知");
            } else if (updateCount == Statement.EXECUTE_FAILED) {
                System.out.println(sql + "：失败");
            } else {
                System.out.println(sql + "：" + updateCount);
            }
        }
    }
};

try {
    for (String sql : sqlList) {
        statement.addBatch(sql);
    }

    int[] updateCounts = statement.executeBatch();
    updateCountsConsumer.accept(updateCounts);

} catch (BatchUpdateException bue) {
    updateCountsConsumer.accept(bue.getUpdateCounts());
    bue.printStackTrace();

} catch (SQLException e) {
    e.printStackTrace();
}

生成键

// 执行SQL，并指定是否返回自动生成的键
// autoGeneratedKeys：
//     Statement.RETURN_GENERATED_KEYS（1）
//     Statement.NO_GENERATED_KEYS（2）
int executeUpdate(String sql, int autoGeneratedKeys);

// columnIndexes指定返回的自动生成键
int executeUpdate(String sql, int columnIndexes[]);

// columnNames指定返回的自动生成键
int executeUpdate(String sql, String columnNames[]);

// 返回：
//     true，第一个结果是ResultSet
boolean execute(String sql, int autoGeneratedKeys);
boolean execute(String sql, int columnIndexes[]);
boolean execute(String sql, String columnNames[]);

ResultSet getGeneratedKeys();

例：

String sql = "INSERT INTO user(userName, nickName, status, createTime, updateTime)VALUES" +
        "('[email protected]', '测试', 0, unix_timestamp()*1000, unix_timestamp()*1000)";
int updateCount = statement.executeUpdate(sql, Statement.RETURN_GENERATED_KEYS);
System.out.println("更新：" + updateCount);

ResultSet resultSet = statement.getGeneratedKeys();
while (resultSet.next()) {
    // 列名为GENERATED_KEY
    long id = resultSet.getLong(1);
    System.out.println("键：" + id);
}
resultSet.close();

关闭

void close();

PreparedStatement

预编译SQL语句，可以动态设置参数，多次执行。继承Statement。

参数，参数序号1起

// 设置null
// sqlType：java.sql.Types
void setNull(int parameterIndex, int sqlType);
void setBoolean(int parameterIndex, boolean x);
void setInt(int parameterIndex, int x);
void setObject(int parameterIndex, Object x);
void setObject(int parameterIndex, Object x, int targetSqlType);
...

// 清除参数
void clearParameters();

// 查询参数信息
ParameterMetaData getParameterMetaData();

查询

ResultSet executeQuery();

例：

String sql = "select * from user where userName = ?";

PreparedStatement preparedStatement = connection.prepareStatement(sql);

preparedStatement.setString(1, "[email protected]");

ResultSet resultSet = preparedStatement.executeQuery();
while (resultSet.next()) {
    // 列标
    long userId = resultSet.getLong("id");
    String userName = resultSet.getString("userName");
    String nickName = resultSet.getString("nickName");
    System.out.println(userId + " " + userName + " " + nickName);
}
resultSet.close();

preparedStatement.close();

更新

int executeUpdate();

多结果（同Statement）

// 执行任何类型SQL
boolean execute();

批量更新

void addBatch()；

ParameterMetaData

对于某些驱动，需要在PreparedStatement执行后才能获取参数信息。

// 参数数量
int getParameterCount();

// 参数类型，参数序号1起
int getParameterType(int param);

// 参数类型名称
String getParameterTypeName(int param);

// 参数类型对应的Java类名
String getParameterClassName(int param);

// 参数模式
// 返回：
//     ParameterMetaData.parameterModeIn
//     ParameterMetaData.parameterModeOut
//     ParameterMetaData.parameterModeInOut
//     ParameterMetaData.parameterModeUnknown
int getParameterMode(int param);

CallableStatement

用于执行SQL存储过程。继承PreparedStatement。
IN参数值使用set方法设置，OUT参数registerOut方法注册。参数序号1起。
ResultSet按Statement方式获取。

设置IN参数

void setString(String parameterName, String x);
void setBoolean(String parameterName, boolean x);
...

注册OUT参数

// sqlType: java.sql.Types
void registerOutParameter(int parameterIndex, int sqlType);
void registerOutParameter(int parameterIndex, int sqlType, int scale);

void registerOutParameter(String parameterName, int sqlType);
void registerOutParameter(String parameterName, int sqlType, int scale);
void registerOutParameter (String parameterName, int sqlType, String typeName);

获取OUT结果

String getString(int parameterIndex);
boolean getBoolean(int parameterIndex);
...

例子

存储过程

// 改结束符,为$$
mysql> delimiter $$

// 创建存储过程
mysql> create procedure getUser(INOUT p_u varchar(128), IN p_s tinyint(4), OUT p_i bigint(20))
begin
// 赋值给OUT变量p_i，p_u
SELECT id, nickName INTO p_i, p_u
FROM user
WHERE userName = p_u AND status = p_s;
end$$

调用存储过程

// 赋值系统变量
mysql> set p_userName='[email protected]'$$

// 调用存储过程，将OUT变量赋值给系统变量
mysql> call getUser(@p_userName, 0, @p_id)$$

// 查询系统变量
mysql> select @p_userName$$

// 查询系统变量
mysql> select @p_id$$

Java Code

// 存储过程getUser(INOUT, IN, OUT)
String sql = "call getUser(?, ?, ?)";

CallableStatement callableStatement = connection.prepareCall(sql);

// 设置IN参数p_u
callableStatement.setString(1, "[email protected]");

// 设置IN参数p_s
callableStatement.setInt(2, 0);

// 注册OUT参数p_u
callableStatement.registerOutParameter(1, Types.VARCHAR);

// 注册OUT参数p_i
callableStatement.registerOutParameter(3, Types.BIGINT);

// 执行
callableStatement.execute();

// 获取OUT结果p_u
String nickName = callableStatement.getString(1);

// 获取OUT结果p_i
long userId = callableStatement.getLong(3);

System.out.println("userId = " + userId + ", nickName = " + nickName);

callableStatement.close();

Java JDBC 3

Statement

PreparedStatement

ParameterMetaData

CallableStatement

猜你喜欢