跳到主要内容

参数传递

dbVisitor 提供多种参数传递方式,用于覆盖位置参数、名称参数、对象参数和规则参数等场景。

使用指引​

  • 位置参数,语句中使用 “?” 标记参数,按顺序传入值;Java 数组下标从 0 开始,JDBC PreparedStatement 的参数索引从 1 开始。
  • 名称参数,语句中使用如 :name、&name 或 #{...} 写法,可以将 SQL 中的参数名称化。
  • SQL 文本替换,语句中使用 ${...} 写法,可以对已名称化的参数进行取值,并将结果注入到 SQL 语句中。
  • 规则传参,语句中通过 @{...} 写法,可以借助 规则 机制,优雅的处理一些常见动态 SQL 场景。
  • 接口方式,通过接口实现方式让参数设置更加具有定制化,以满足一些特殊的场景。

补充说明​

  • 参数选项,当语句中使用 #{...} 写法或者利用 SqlArg 类型传递参数时可以为参数指定更多选项。
  • 参数符号转义,命令中的 ?、:、& 不是绑定参数时,如何按原样输出。