jdbi 版本 3，stringtemplate 何时转义 <, > 字符？

Question

我将 jdbi3 与 StringTemplate 4 模板引擎一起使用，我有这个测试查询：

    @SqlQuery("select * from test "
        + "where field1 = 5"
        + "<if(cond1)> or field2 \\<= :value1<endif>"
        + "<if(cond2)> or field2 >= :value2<endif>"
        + "<if(cond3)> or field2 in (<values>)<endif>")
@RegisterBeanMapper(Test.class)
@UseStringTemplateEngine
public List<Test> selectTest(
        @Define("cond1") boolean cond1, @Bind("value1") int value2,
        @Define("cond2") boolean cond2, @Bind("value2") int value3,
        @Define("cond3") boolean cond3,
        @BindList(value="values", onEmpty=BindList.EmptyHandling.NULL_STRING ) List<Integer> values);

当我必须在查询中使用\字符<或>转义时使用 StringTemplate 引擎？ 测试我发现我必须像以前一样在查询中转义<= 。

在使用@BindList的 IN 子句中，我必须使用<values>但在这种情况下，我希望像\\<values>一样转义它，否则它将被 StringTemplate 用作属性，但如果我这样做，查询不会工作。

关于>= escaping 它在查询中似乎相同。

Answer 1

介绍

让我们考虑一下：

• 3.27.1 Jdbi 版本作为当前 Jdbi 版本。
• 4.3.1 StringTemplate 版本作为当前 StringTemplate 版本，因为当前 Jdbi 版本使用它。 请参阅： jdbi/pom.xml at v3.27.1 · jdbi/jdbi 。

回答

京东

文档：要转义的字符

请注意有关要转义哪些字符的警告：

由于 StringTemplate 默认使用<字符来标记 ST 表达式，您可能需要转义一些 SQL： String datePredSql = "<if(datePredicate)> <dateColumn> \\<:dateFilter <endif>"

— jdbi/index.adoc 在 v3.27.1 · jdbi/jdbi 。

单元测试：不要转义@BindList变量名

请参阅BindListTest.ifValueGivenWithNullValueOptionThenResultIsTruthy()测试方法： jdbi/BindListTest.java v3.27.1 · jdbi/jdbi 。

请注意，该测试涵盖了一个非常相似的注释方法：

@SqlQuery("select name from something <if(name)> where name in (<name>) <endif>")
@UseStringTemplateEngine
List<String> getForValue(@Nonnull @BindList(value = "name", onEmpty = NULL_VALUE) List<String> name);

请注意， @BindList变量名称未转义：

in (<name>)

字符串模板

文档：要转义的字符

请注意要转义的字符：

模板是一系列文本和表达式元素，可以选择穿插注释。 在最粗略的层面上，基本要素是：

 text <expr> <! comment !>

使用反斜杠字符转义分隔符： \<或\> 。

— stringtemplate4/templates.md 在 4.3.1 · antlr/stringtemplate4 。