6.7 参数符号转义

命令本身含有 ?、: 或 &，又不希望它们被识别为参数时，可以在前面加反斜杠。dbVisitor 解析后移除这个反斜杠，输出符号本身，不占用绑定参数。

原生命令中的问号

例如 Elasticsearch 请求地址中的 ?refresh=true 是 URL 参数，不是 JDBC 绑定参数。使用位置参数时：

jdbcTemplate.executeUpdate(
    "PUT /users/_doc/1\\?refresh=true {\"id\":?,\"name\":?}",
    new Object[] { 1, "Alice" });

驱动收到的命令如下，只有 JSON 中的两个 ? 需要绑定值：

PUT /users/_doc/1?refresh=true {"id":?,"name":?}

同样支持名称参数：

jdbcTemplate.executeUpdate(
    "PUT /users/_doc/1\\?refresh=true {\"id\":#{id},\"name\":#{name}}",
    Map.of("id", 1, "name", "Alice"));

多个 URL 参数之间的 & 也可以转义，例如 Java 字符串中的 "\\?op_type=create\\&refresh=true"。

冒号后紧贴 ? 或 #{...} 时，不需要为冒号加转义或空格：

{"id":?,"name":?}
{"id":#{id},"name":#{name}}

使用 :name 时，字段冒号与参数冒号之间用空格分隔：

{"id": :id,"name": :name}

如果命令中的 :name 本来就是普通文本，则写为 \:name；普通文本 &name 同理写为 \&name。