跳到主要内容

6.1 位置参数

在 SQL 中使用 ? 标记参数，dbVisitor 按数组或 List 的顺序绑定值。容器下标及 arg0、arg1 名称从 0 开始；直接调用 JDBC PreparedStatement.setXxx(index, value) 时，索引从 1 开始。

select * from users where id > ? and status = ?

基本用法​

例1：使用数组传递参数
Object[] args = new Object[] { 2, "Dave"};
jdbcTemplate.queryForList("select * from users where id > ? and name = ?", args);
例2：List 类型的集合传参数
List<?> args = Arrays.asList(2, "Dave");
jdbcTemplate.queryForList("select * from users where id > ? and name = ?", args);
例3：当只有一个参数时可省略数组
jdbcTemplate.queryForList("select * from users where id > ?", 2);

命令中需要输出字面的 ? 时，使用 \?。规则与示例见参数符号转义。

名称化​

每一个 “?” 位置参数都隐含了一个对应的名称。名称规则为 “arg + <位置编号>”，例如：arg0、arg1。

例1：使用名称化位置参数
Object[] args = new Object[] { 2, "Dave"};
jdbcTemplate.queryForList("select * from users where id > :arg0 and name = :arg1", args);
  • 有关名称化参数的其它写法可以参考 名称参数。

参数选项​

通过 SqlArg 类可以在参数设置时提供更多控制，如：指定 TypeHandler、Java 类型或 JDBC 类型。

例1：使用 SqlArg 指定 TypeHandler
SqlArg[] args = new SqlArg[] {
      SqlArg.valueOf(2L, new LongTypeHandler()),     // LongTypeHandler，设置 Long 类型参数
      SqlArg.valueOf("Dave", new StringTypeHandler())// StringTypeHandler，设置 String 类型参数
};
jdbcTemplate.queryForList("select * from users where id > ? and name = ?", args);

SqlArg 提供了多个工厂方法用于创建不同类型的参数：

方法说明
SqlArg.valueOf(Object)创建 IN 参数
SqlArg.valueOf(Object, Class<?>)创建带 javaType 的 IN 参数
SqlArg.valueOf(Object, TypeHandler<?>)创建带 TypeHandler 的 IN 参数
SqlArg.valueOf(Object, int)创建带 jdbcType 的 IN 参数
SqlArg.asOut(String, int)创建 OUT 参数（指定 jdbcType）
SqlArg.asOut(String, int, TypeHandler<?>)创建 OUT 参数（指定 jdbcType + TypeHandler）
SqlArg.asInOut(String, Object, int)创建 INOUT 参数（指定 jdbcType）
SqlArg.asInOut(String, Object, int, TypeHandler<?>)创建 INOUT 参数（指定 jdbcType + TypeHandler）

SqlArg 对象也可以直接放入 Map 中作为命名参数的值，框架会自动识别并使用其中的类型信息。

例2：Map 中混合使用 SqlArg 和普通值
Map<String, Object> args = new HashMap<>();
args.put("id", SqlArg.valueOf(2L, new LongTypeHandler()));
args.put("name", "Dave");
jdbcTemplate.queryForList("select * from users where id > :id and name = :name", args);
有关更多参数选项的信息请到：