BEP 54: 注解内的 SQL 片段 支持 条件模板

[troyzhxu]

目的（BeanSearcher Enhancement Proposal）

弥补 拼接参数 的不足：

• 复杂情况下用法不太优雅
• 存在注入风险，需要用户自己控制

参考：https://bs.zhxu.cn/guide/latest/params.html#%E6%8B%BC%E6%8E%A5%E5%8F%82%E6%95%B0

特性（用法）

当逻辑表达式 expression 为 真值 时才 连接 yyy 表

@SearchBean(
    tables="xxx x <#[expression]> join yyy y on y.x_id = x.id </#>"       // 方式 1
    tables="xxx x <[expression]> join yyy y on y.x_id = x.id </>"         // 方式 2
    tables="xxx x #[expression] join yyy y on y.x_id = x.id #"            // 方式 3
    tables="xxx x #[expression] join yyy y on y.x_id = x.id [#]"          // 方式 4
    tables="xxx x <#[expression] join yyy y on y.x_id = x.id #>"          // 方式 5
    tables="xxx x <# expression ? join yyy y on y.x_id = x.id #>"         // 方式 6
)

方式 1、2、3、4、5、6，大家觉得 哪种 方式 更好一点呢？

表达式 expression 组成 与 真值 判断

• 检索参数（形如 :name，参与逻辑计算）
• 实体属性名（判断规则：是否在 select 列表 或 where 条件中存在）
• 关系运算符：== != < > <= >=
• 布尔运算符：或 | 且 & 非 !

例如：

• :useYyy - 当检索参数中有 useYyy 且值 非空 非null 非 0 时 为真
• :type == 1 - 当检索参数中有 type 且值 等于 1 或 "1" 时为真
• :foo == 'bar' - 当检索参数中有 foo 且值 等于 bar 时为真
• :foo > :bar - 当检索参数中有 foo 与 bar 且值 foo 大于 bar 时为真
• yId - 当 select 列表 或 where 条件中有 yId 为真
• yId | yName - 当 select 列表 或 where 条件中有 yId 或 yName 时 为真
• :useYyy & (yId | yName) - 当检索参数中有 useYyy 且值 非空 非null 非 0 且 当 select 列表 或 where 条件中有 yId 或 yName 时为真

欢迎讨论

大家觉得 哪种 方式 更简单 更可读一点呢（或者你是否有更好的语法），说说你的理由吧 ^_^

[aabbccddeeffgghhee]

方式5，相对简单且有明确的开始结束符，易理解

[duanguangchen]

可以参考mybatis里的各种动态标签，方便理解和替换

[troyzhxu]

@duanguangchen 这个也是从 mybatis 的 <if> 标签演变来的，你可以把自己希望的用法方式，用类似的实例代码表达出来，让我们都参考一下。

[tanzx]

请问这个功能有没有release出来？我有一点小想法。从JDK 15开始，支持文本块，方便在java代码里写复杂文本。类似下面这样。

@SearchBean(
    tables=
        """
        xxx x 
            <if test="expression">
             join yyy y on y.x_id = x.id 
            </if>
        """
)

这样写感觉贴近mybatis的写法，感觉贴近通常的开发。条件表达式在xml部分，不跟SQL片段混在一起。条件表达式可以用OGNL，或者用SpEL。xml部分目前有if标记，如果以后有需要，可以拓展其他标记。
以上是一点小想法，仅仅用于参考一下。

[troyzhxu]

为了降低学习成本，靠近其它框架的写法，并使得写法尽量简洁，最终采纳以下的标签方式：

<if [expression]> content </if>