com.dynamic.sql.core.dml.select

接口 JoinCondition

所有超级接口:

Fetchable

所有已知实现类:

TableRelation

public interface JoinCondition
extends Fetchable

定义用于构建 SQL JOIN 条件的接口。 提供了多种 JOIN 类型（如 INNER JOIN、LEFT JOIN、RIGHT JOIN、FULL JOIN、CROSS JOIN）的操作方法。 此接口支持动态生成 JOIN 条件和链式调用，用于构建复杂的 SQL 查询。

方法概要

限定符和类型	方法和说明
default JoinCondition	crossJoin(boolean isEffective, Class<?> clazz)
default JoinCondition	crossJoin(boolean isEffective, CteTable cte) 已过时。
JoinCondition	crossJoin(Class<?> clazz) 构建一个 CROSS JOIN 连接，用于将当前查询与另一个表关联。
JoinCondition	crossJoin(CteTable cte) 已过时。
default JoinCondition	fullJoin(boolean isEffective, Class<?> clazz, Consumer<GenericWhereCondition> onCondition)
default JoinCondition	fullJoin(boolean isEffective, Class<?> clazz, String alias, Consumer<GenericWhereCondition> onCondition)
default JoinCondition	fullJoin(boolean isEffective, CteTable cte, Consumer<GenericWhereCondition> onCondition) 已过时。
JoinCondition	fullJoin(Class<?> clazz, Consumer<GenericWhereCondition> onCondition) 构建一个 FULL JOIN 连接，用于将当前查询与另一个表关联。
JoinCondition	fullJoin(Class<?> clazz, String alias, Consumer<GenericWhereCondition> onCondition) 构建一个 FULL JOIN 连接，用于将当前查询与另一个表关联。
JoinCondition	fullJoin(CteTable cte, Consumer<GenericWhereCondition> onCondition) 已过时。
default JoinCondition	innerJoin(boolean isEffective, Class<?> clazz, Consumer<GenericWhereCondition> onCondition)
JoinCondition	innerJoin(Class<?> clazz, Consumer<GenericWhereCondition> onCondition) 构建一个 INNER JOIN 连接，用于将当前查询与另一个表关联。
JoinCondition	innerJoin(Class<?> clazz, String alias, Consumer<GenericWhereCondition> onCondition) 构建一个 INNER JOIN 连接，用于将当前查询与另一个表关联。
JoinCondition	innerJoin(CteTable cte, Consumer<GenericWhereCondition> onCondition) 已过时。
JoinCondition	innerJoin(SelectDsl nestedSelect, String alias, Consumer<GenericWhereCondition> onCondition) 构建一个 INNER JOIN 连接，用于将当前查询与子查询结果关联。
JoinCondition	innerJoin(Supplier<TableFunction> tableFunction, String alias, Consumer<GenericWhereCondition> onCondition) 构建一个 INNER JOIN 连接，用于将当前查询与表函数的结果关联。
default JoinCondition	innerJoinUnion(boolean isEffective, SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) 条件式 INNER JOIN UNION。
JoinCondition	innerJoinUnion(SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) INNER JOIN UNION 的核心实现。
default JoinCondition	innerJoinUnionAll(boolean isEffective, SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) 条件式 INNER JOIN UNION ALL。
JoinCondition	innerJoinUnionAll(SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) INNER JOIN UNION ALL 的核心实现。
default JoinCondition	join(boolean isEffective, Class<?> clazz, Consumer<GenericWhereCondition> onCondition)
default JoinCondition	join(boolean isEffective, Class<?> clazz, String alias, Consumer<GenericWhereCondition> onCondition)
default JoinCondition	join(boolean isEffective, CteTable cte, Consumer<GenericWhereCondition> onCondition) 已过时。
default JoinCondition	join(boolean isEffective, SelectDsl nestedSelect, String alias, Consumer<GenericWhereCondition> onCondition)
default JoinCondition	join(boolean isEffective, Supplier<TableFunction> tableFunction, String alias)
default JoinCondition	join(boolean isEffective, Supplier<TableFunction> tableFunction, String alias, Consumer<GenericWhereCondition> onCondition) 条件式 JOIN：当 isEffective 为 true 时执行 JOIN，否则忽略该 JOIN。
default JoinCondition	join(Class<?> clazz, Consumer<GenericWhereCondition> onCondition) INNER JOIN 的别名方法。
default JoinCondition	join(Class<?> clazz, String alias, Consumer<GenericWhereCondition> onCondition) INNER JOIN 的别名方法，允许指定表别名。
default JoinCondition	join(CteTable cte, Consumer<GenericWhereCondition> onCondition) 已过时。
default JoinCondition	join(SelectDsl nestedSelect, String alias, Consumer<GenericWhereCondition> onCondition) 使用嵌套查询的 INNER JOIN 方法。
default JoinCondition	join(Supplier<TableFunction> tableFunction, String alias) 使用表函数进行 INNER JOIN。
default JoinCondition	join(Supplier<TableFunction> tableFunction, String alias, Consumer<GenericWhereCondition> onCondition) 使用表函数和条件进行 INNER JOIN。
default JoinCondition	joinUnion(boolean isEffective, SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) 条件式 INNER JOIN UNION。
default JoinCondition	joinUnion(SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) INNER JOIN UNION。
default JoinCondition	joinUnionAll(boolean isEffective, SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) 条件式 INNER JOIN UNION ALL。
default JoinCondition	joinUnionAll(SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) INNER JOIN UNION ALL。
default JoinCondition	leftJoin(boolean isEffective, Class<?> clazz, Consumer<GenericWhereCondition> onCondition)
default JoinCondition	leftJoin(boolean isEffective, Class<?> clazz, String alias, Consumer<GenericWhereCondition> onCondition)
default JoinCondition	leftJoin(boolean isEffective, CteTable cte, Consumer<GenericWhereCondition> onCondition) 已过时。
default JoinCondition	leftJoin(boolean isEffective, SelectDsl nestedSelect, String alias, Consumer<GenericWhereCondition> onCondition)
default JoinCondition	leftJoin(boolean isEffective, Supplier<TableFunction> tableFunction, String alias, Consumer<GenericWhereCondition> onCondition)
JoinCondition	leftJoin(Class<?> clazz, Consumer<GenericWhereCondition> onCondition) 构建一个 LEFT JOIN 连接，用于将当前查询与另一个表关联。
JoinCondition	leftJoin(Class<?> clazz, String alias, Consumer<GenericWhereCondition> onCondition) 构建一个 LEFT JOIN 连接，用于将当前查询与另一个表关联。
JoinCondition	leftJoin(CteTable cte, Consumer<GenericWhereCondition> onCondition) 已过时。
JoinCondition	leftJoin(SelectDsl nestedSelect, String alias, Consumer<GenericWhereCondition> onCondition) 构建一个 LEFT JOIN 连接，用于将当前查询与子查询结果关联。
JoinCondition	leftJoin(Supplier<TableFunction> tableFunction, String alias, Consumer<GenericWhereCondition> onCondition) 构建一个 LEFT JOIN 连接，用于将当前查询与表函数的结果关联。
default JoinCondition	leftJoinUnion(boolean isEffective, SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) 条件式 LEFT JOIN UNION。
JoinCondition	leftJoinUnion(SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) LEFT JOIN UNION 的核心实现。
default JoinCondition	leftJoinUnionAll(boolean isEffective, SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) 条件式 LEFT JOIN UNION ALL。
JoinCondition	leftJoinUnionAll(SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) LEFT JOIN UNION ALL 的核心实现。
Fetchable	limit(boolean isEffective, int limit)
Fetchable	limit(boolean isEffective, int offset, int limit)
Fetchable	limit(int limit) 限制查询返回的行数。
Fetchable	limit(int offset, int limit) 限制查询返回的行数。
default JoinCondition	rightJoin(boolean isEffective, Class<?> clazz, Consumer<GenericWhereCondition> onCondition)
default JoinCondition	rightJoin(boolean isEffective, Class<?> clazz, String alias, Consumer<GenericWhereCondition> onCondition)
default JoinCondition	rightJoin(boolean isEffective, CteTable cte, Consumer<GenericWhereCondition> onCondition) 已过时。
default JoinCondition	rightJoin(boolean isEffective, SelectDsl nestedSelect, String alias, Consumer<GenericWhereCondition> onCondition)
default JoinCondition	rightJoin(boolean isEffective, Supplier<TableFunction> tableFunction, String alias, Consumer<GenericWhereCondition> onCondition)
JoinCondition	rightJoin(Class<?> clazz, Consumer<GenericWhereCondition> onCondition) 构建一个 RIGHT JOIN 连接，用于将当前查询与另一个表关联。
JoinCondition	rightJoin(Class<?> clazz, String alias, Consumer<GenericWhereCondition> onCondition) 构建一个 RIGHT JOIN 连接，用于将当前查询与另一个表关联。
JoinCondition	rightJoin(CteTable cte, Consumer<GenericWhereCondition> onCondition) 已过时。
JoinCondition	rightJoin(SelectDsl nestedSelect, String alias, Consumer<GenericWhereCondition> onCondition) 构建一个 RIGHT JOIN 连接，用于将当前查询与子查询结果关联。
JoinCondition	rightJoin(Supplier<TableFunction> tableFunction, String alias, Consumer<GenericWhereCondition> onCondition) 构建一个 RIGHT JOIN 连接，用于将当前查询与表函数的结果关联。
default JoinCondition	rightJoinUnion(boolean isEffective, SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) 条件式 RIGHT JOIN UNION。
JoinCondition	rightJoinUnion(SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) RIGHT JOIN UNION 的核心实现。
default JoinCondition	rightJoinUnionAll(boolean isEffective, SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) 条件式 RIGHT JOIN UNION ALL。
JoinCondition	rightJoinUnionAll(SelectDsl[] selectDsls, String alias, Consumer<GenericWhereCondition> onCondition) RIGHT JOIN UNION ALL 的核心实现。
TableRelation<?>	where() 空条件 WHERE，返回无条件的查询上下文。
TableRelation<?>	where(boolean isEffective, Consumer<GenericWhereCondition> condition)
TableRelation<?>	where(Consumer<GenericWhereCondition> condition) 追加 WHERE 条件。

从接口继承的方法 com.dynamic.sql.core.dml.select.Fetchable

fetch, fetch, fetchOriginalMap

方法详细资料

join

default JoinCondition join(Class<?> clazz,
                           Consumer<GenericWhereCondition> onCondition)

INNER JOIN 的别名方法。

参数:

clazz - 需要连接的表对应的实体类

onCondition - 用于构建 ON 条件的 Consumer 对象

返回:

当前 JoinCondition 实例，用于链式调用

join

default JoinCondition join(boolean isEffective,
                           Class<?> clazz,
                           Consumer<GenericWhereCondition> onCondition)

join

default JoinCondition join(Class<?> clazz,
                           String alias,
                           Consumer<GenericWhereCondition> onCondition)

INNER JOIN 的别名方法，允许指定表别名。

参数:

clazz - 需要连接的表对应的实体类

alias - 表的别名

onCondition - 用于构建 ON 条件的 Consumer 对象

返回:

当前 JoinCondition 实例

join

default JoinCondition join(boolean isEffective,
                           Class<?> clazz,
                           String alias,
                           Consumer<GenericWhereCondition> onCondition)

join

default JoinCondition join(SelectDsl nestedSelect,
                           String alias,
                           Consumer<GenericWhereCondition> onCondition)

使用嵌套查询的 INNER JOIN 方法。

参数:

nestedSelect - 嵌套查询的列构造器

alias - 嵌套查询的别名

onCondition - 用于构建 ON 条件的 Consumer 对象

返回:

当前 JoinCondition 实例

join

default JoinCondition join(boolean isEffective,
                           SelectDsl nestedSelect,
                           String alias,
                           Consumer<GenericWhereCondition> onCondition)

join

default JoinCondition join(Supplier<TableFunction> tableFunction,
                           String alias)

使用表函数进行 INNER JOIN。

参数:

tableFunction - 表函数供应者

alias - 表的别名

返回:

当前 JoinCondition 实例

join

default JoinCondition join(boolean isEffective,
                           Supplier<TableFunction> tableFunction,
                           String alias)

join

default JoinCondition join(Supplier<TableFunction> tableFunction,
                           String alias,
                           Consumer<GenericWhereCondition> onCondition)

使用表函数和条件进行 INNER JOIN。

参数:

tableFunction - 表函数供应者

alias - 表的别名

onCondition - 用于构建 ON 条件的 Consumer 对象

返回:

当前 JoinCondition 实例

join

default JoinCondition join(boolean isEffective,
                           Supplier<TableFunction> tableFunction,
                           String alias,
                           Consumer<GenericWhereCondition> onCondition)

条件式 JOIN：当 isEffective 为 true 时执行 JOIN，否则忽略该 JOIN。

参数:

isEffective - 是否生效（false 时直接返回当前 JoinCondition，不执行 JOIN）

tableFunction - 表级函数（TableFunction），作为 JOIN 的右表

alias - 右表别名

onCondition - JOIN 的 ON 条件构造器

返回:

JoinCondition，用于继续构建查询

joinUnion

default JoinCondition joinUnion(boolean isEffective,
                                SelectDsl[] selectDsls,
                                String alias,
                                Consumer<GenericWhereCondition> onCondition)

条件式 INNER JOIN UNION。

当 isEffective 为 true 时执行 JOIN，否则忽略。

joinUnion

default JoinCondition joinUnion(SelectDsl[] selectDsls,
                                String alias,
                                Consumer<GenericWhereCondition> onCondition)

INNER JOIN UNION。

始终执行 UNION JOIN。

innerJoinUnion

default JoinCondition innerJoinUnion(boolean isEffective,
                                     SelectDsl[] selectDsls,
                                     String alias,
                                     Consumer<GenericWhereCondition> onCondition)

条件式 INNER JOIN UNION。

根据 isEffective 决定是否执行 JOIN。

innerJoinUnion

JoinCondition innerJoinUnion(SelectDsl[] selectDsls,
                             String alias,
                             Consumer<GenericWhereCondition> onCondition)

INNER JOIN UNION 的核心实现。

将多个 SelectDsl 通过 UNION 组合成一个子查询，并以 alias 作为虚拟表名参与 INNER JOIN。 该方法是 joinUnion 系列方法的最终执行入口，负责生成完整的 JOIN + UNION SQL 结构。

生成的 SQL 结构示例：

 SELECT ...
 FROM user u
 INNER JOIN (
      (SELECT ... FROM user WHERE user_id = 1)
      UNION
      (SELECT ... FROM user WHERE user_id = 2)
 ) AS t
 ON u.user_id = t.user_id
 

使用场景：

• 在 JOIN 中使用 UNION 结果作为虚拟表
• 动态构建多条件、多来源的子查询并参与关联
• 支持链式 where/orderBy/fetch 等后续操作

参数:

selectDsls - 多个 SELECT DSL，将通过 UNION 组合成虚拟表

alias - 虚拟表别名

onCondition - JOIN 的 ON 条件构造器

返回:

JoinCondition，用于继续构建查询

leftJoinUnion

default JoinCondition leftJoinUnion(boolean isEffective,
                                    SelectDsl[] selectDsls,
                                    String alias,
                                    Consumer<GenericWhereCondition> onCondition)

条件式 LEFT JOIN UNION。

isEffective 为 true 时执行 LEFT JOIN，否则忽略。

leftJoinUnion

JoinCondition leftJoinUnion(SelectDsl[] selectDsls,
                            String alias,
                            Consumer<GenericWhereCondition> onCondition)

LEFT JOIN UNION 的核心实现。

将多个 SelectDsl 通过 UNION 组合成一个子查询，并以 alias 作为虚拟表名参与 LEFT JOIN。 这是 leftJoinUnion 系列方法的最终执行入口，负责生成完整的 LEFT JOIN (subquery UNION subquery ...) AS alias 结构。

生成的 SQL 结构示例：

 SELECT t.*
 FROM users u
 LEFT JOIN (
      (SELECT ... FROM users WHERE user_id = 1)
      UNION
      (SELECT ... FROM users WHERE user_id = 2)
 ) AS t
 ON u.user_id = t.user_id
 WHERE t.gender = 'Male'
   AND u.user_id = 2;
 

使用场景：

• 需要将多个查询结果合并后作为虚拟表参与 LEFT JOIN
• 需要保留左表全部记录（即使 UNION 子查询无匹配）
• 支持链式 where/orderBy/fetch 等后续操作

参数:

selectDsls - 多个 SELECT DSL，将通过 UNION 组合成虚拟表

alias - 虚拟表别名

onCondition - LEFT JOIN 的 ON 条件构造器

返回:

JoinCondition，用于继续构建查询

rightJoinUnion

default JoinCondition rightJoinUnion(boolean isEffective,
                                     SelectDsl[] selectDsls,
                                     String alias,
                                     Consumer<GenericWhereCondition> onCondition)

条件式 RIGHT JOIN UNION。

isEffective 为 true 时执行 RIGHT JOIN，否则忽略。

rightJoinUnion

JoinCondition rightJoinUnion(SelectDsl[] selectDsls,
                             String alias,
                             Consumer<GenericWhereCondition> onCondition)

RIGHT JOIN UNION 的核心实现。

将多个 SelectDsl 通过 UNION 组合成一个子查询，并以 alias 作为虚拟表名参与 RIGHT JOIN。 这是 rightJoinUnion 系列方法的最终执行入口，负责生成完整的 RIGHT JOIN (subquery UNION subquery ...) AS alias 结构。

生成的 SQL 结构示例：

 SELECT ...
 FROM users u
 RIGHT JOIN (
      (SELECT ... FROM users WHERE user_id = 1)
      UNION
      (SELECT ... FROM users WHERE user_id = 2)
 ) AS t
 ON u.user_id = t.user_id
 WHERE ...
 

使用场景：

• 需要保留 UNION 子查询的全部记录（右表优先）
• 需要将多个查询结果合并后作为虚拟表参与 RIGHT JOIN
• 支持链式 where/orderBy/fetch 等后续操作

参数:

selectDsls - 多个 SELECT DSL，将通过 UNION 组合成虚拟表

alias - 虚拟表别名

onCondition - RIGHT JOIN 的 ON 条件构造器

返回:

JoinCondition，用于继续构建查询

joinUnionAll

default JoinCondition joinUnionAll(boolean isEffective,
                                   SelectDsl[] selectDsls,
                                   String alias,
                                   Consumer<GenericWhereCondition> onCondition)

条件式 INNER JOIN UNION ALL。

isEffective 为 true 时执行 JOIN，否则忽略。

joinUnionAll

default JoinCondition joinUnionAll(SelectDsl[] selectDsls,
                                   String alias,
                                   Consumer<GenericWhereCondition> onCondition)

INNER JOIN UNION ALL。

始终执行 UNION ALL JOIN。

innerJoinUnionAll

default JoinCondition innerJoinUnionAll(boolean isEffective,
                                        SelectDsl[] selectDsls,
                                        String alias,
                                        Consumer<GenericWhereCondition> onCondition)

条件式 INNER JOIN UNION ALL。

根据 isEffective 决定是否执行 JOIN。

innerJoinUnionAll

JoinCondition innerJoinUnionAll(SelectDsl[] selectDsls,
                                String alias,
                                Consumer<GenericWhereCondition> onCondition)

INNER JOIN UNION ALL 的核心实现。

将多个 SelectDsl 通过 UNION ALL 组合成一个子查询，并以 alias 作为虚拟表名参与 INNER JOIN。 这是 joinUnionAll 系列方法的最终执行入口，负责生成完整的 INNER JOIN (subquery UNION ALL subquery ...) AS alias 结构。

生成的 SQL 结构示例：

 SELECT ...
 FROM users u
 INNER JOIN (
      (SELECT ... FROM users WHERE user_id = 1)
      UNION ALL
      (SELECT ... FROM users WHERE user_id = 2)
 ) AS t
 ON u.user_id = t.user_id
 WHERE t.gender = 'Male'
   AND u.user_id = 2;
 

使用场景：

• 需要将多个查询结果合并（不去重）后作为虚拟表参与 INNER JOIN
• 需要保留所有记录（UNION ALL 性质）
• 支持链式 where/orderBy/fetch 等后续操作

参数:

selectDsls - 多个 SELECT DSL，将通过 UNION ALL 组合成虚拟表

alias - 虚拟表别名

onCondition - INNER JOIN 的 ON 条件构造器

返回:

JoinCondition，用于继续构建查询

leftJoinUnionAll

default JoinCondition leftJoinUnionAll(boolean isEffective,
                                       SelectDsl[] selectDsls,
                                       String alias,
                                       Consumer<GenericWhereCondition> onCondition)

条件式 LEFT JOIN UNION ALL。

isEffective 为 true 时执行 LEFT JOIN，否则忽略。

leftJoinUnionAll

JoinCondition leftJoinUnionAll(SelectDsl[] selectDsls,
                               String alias,
                               Consumer<GenericWhereCondition> onCondition)

LEFT JOIN UNION ALL 的核心实现。

将多个 SelectDsl 通过 UNION ALL 组合成一个子查询，并以 alias 作为虚拟表名参与 LEFT JOIN。 这是 leftJoinUnionAll 系列方法的最终执行入口，负责生成完整的 LEFT JOIN (subquery UNION ALL subquery ...) AS alias 结构。

生成的 SQL 结构示例（参考测试用例 leftJoinUnionAll）：

 SELECT ...
 FROM users u
 LEFT JOIN (
      (SELECT ... FROM users WHERE user_id = 1)
      UNION ALL
      (SELECT ... FROM users WHERE user_id = 2)
 ) AS t
 ON u.user_id = t.user_id
 WHERE t.gender = 'Male'
   AND u.user_id = 2;
 

使用场景：

• 需要将多个查询结果合并（不去重）后作为虚拟表参与 LEFT JOIN
• 需要保留左表全部记录（即使 UNION ALL 子查询无匹配）
• 支持链式 where/orderBy/fetch 等后续操作

参数:

selectDsls - 多个 SELECT DSL，将通过 UNION ALL 组合成虚拟表

alias - 虚拟表别名

onCondition - LEFT JOIN 的 ON 条件构造器

返回:

JoinCondition，用于继续构建查询

rightJoinUnionAll

default JoinCondition rightJoinUnionAll(boolean isEffective,
                                        SelectDsl[] selectDsls,
                                        String alias,
                                        Consumer<GenericWhereCondition> onCondition)

条件式 RIGHT JOIN UNION ALL。

isEffective 为 true 时执行 RIGHT JOIN，否则忽略。

rightJoinUnionAll

JoinCondition rightJoinUnionAll(SelectDsl[] selectDsls,
                                String alias,
                                Consumer<GenericWhereCondition> onCondition)

RIGHT JOIN UNION ALL 的核心实现。

将多个 SelectDsl 通过 UNION ALL 组合成一个子查询，并以 alias 作为虚拟表名参与 RIGHT JOIN。 这是 rightJoinUnionAll 系列方法的最终执行入口，负责生成完整的 RIGHT JOIN (subquery UNION ALL subquery ...) AS alias 结构。

生成的 SQL 结构示例（参考测试用例 rightJoinUnionAll）：

 SELECT ...
 FROM users u
 RIGHT JOIN (
      (SELECT ... FROM users WHERE user_id = 1)
      UNION ALL
      (SELECT ... FROM users WHERE user_id = 2)
 ) AS t
 ON u.user_id = t.user_id
 WHERE t.gender = 'Male'
   AND u.user_id = 2;
 

使用场景：

• 需要保留 UNION ALL 子查询的全部记录（右表优先）
• 需要将多个查询结果合并后作为虚拟表参与 RIGHT JOIN
• 适用于右表为主、左表为辅的关联场景
• 支持链式 where/orderBy/fetch 等后续操作

参数:

selectDsls - 多个 SELECT DSL，将通过 UNION ALL 组合成虚拟表

alias - 虚拟表别名

onCondition - RIGHT JOIN 的 ON 条件构造器

返回:

JoinCondition，用于继续构建查询

join

@Deprecated
default JoinCondition join(CteTable cte,
                                       Consumer<GenericWhereCondition> onCondition)

已过时。

使用 CTE 表进行 INNER JOIN。

参数:

cte - 公共表表达式（CTE）实例

onCondition - 用于构建 ON 条件的 Consumer 对象

返回:

当前 JoinCondition 实例

join

@Deprecated
default JoinCondition join(boolean isEffective,
                                       CteTable cte,
                                       Consumer<GenericWhereCondition> onCondition)

已过时。

innerJoin

default JoinCondition innerJoin(boolean isEffective,
                                Class<?> clazz,
                                Consumer<GenericWhereCondition> onCondition)

innerJoin

JoinCondition innerJoin(Class<?> clazz,
                        Consumer<GenericWhereCondition> onCondition)

构建一个 INNER JOIN 连接，用于将当前查询与另一个表关联。

INNER JOIN 返回两个表中满足连接条件的所有记录。如果没有匹配的记录，则不会出现在结果集中。

参数:

clazz - 需要连接的表对应的实体类

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

innerJoin

JoinCondition innerJoin(Class<?> clazz,
                        String alias,
                        Consumer<GenericWhereCondition> onCondition)

构建一个 INNER JOIN 连接，用于将当前查询与另一个表关联。

INNER JOIN 返回两个表中满足连接条件的所有记录。如果没有匹配的记录，则不会出现在结果集中。 此方法支持指定表别名。

参数:

clazz - 需要连接的表对应的实体类

alias - 表的别名，用于在查询中标识该表

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

innerJoin

JoinCondition innerJoin(SelectDsl nestedSelect,
                        String alias,
                        Consumer<GenericWhereCondition> onCondition)

构建一个 INNER JOIN 连接，用于将当前查询与子查询结果关联。

子查询返回的结果集会作为临时表参与连接，支持指定别名和 ON 条件。

参数:

nestedSelect - 子查询构建器，用于生成临时表

alias - 子查询结果的别名

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

innerJoin

JoinCondition innerJoin(Supplier<TableFunction> tableFunction,
                        String alias,
                        Consumer<GenericWhereCondition> onCondition)

构建一个 INNER JOIN 连接，用于将当前查询与表函数的结果关联。

表函数的返回值作为临时表参与连接，支持指定别名和 ON 条件。

参数:

tableFunction - 表函数构建器，用于生成临时表

alias - 表函数结果的别名

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

innerJoin

@Deprecated
JoinCondition innerJoin(CteTable cte,
                                    Consumer<GenericWhereCondition> onCondition)

已过时。

构建一个 INNER JOIN 连接，用于将当前查询与公共表表达式 (CTE) 结果关联。

CTE 的返回值作为临时表参与连接，支持 ON 条件。

参数:

cte - 公共表表达式实例

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

leftJoin

JoinCondition leftJoin(Class<?> clazz,
                       Consumer<GenericWhereCondition> onCondition)

构建一个 LEFT JOIN 连接，用于将当前查询与另一个表关联。

LEFT JOIN 返回左表中的所有记录，以及右表中满足连接条件的记录。如果右表中没有匹配的记录， 则结果集中该部分字段的值为 NULL。

参数:

clazz - 需要连接的表对应的实体类

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

leftJoin

default JoinCondition leftJoin(boolean isEffective,
                               Class<?> clazz,
                               Consumer<GenericWhereCondition> onCondition)

leftJoin

JoinCondition leftJoin(Class<?> clazz,
                       String alias,
                       Consumer<GenericWhereCondition> onCondition)

构建一个 LEFT JOIN 连接，用于将当前查询与另一个表关联。

LEFT JOIN 返回左表中的所有记录，以及右表中满足连接条件的记录。如果右表中没有匹配的记录， 则结果集中该部分字段的值为 NULL。此方法支持指定表别名。

参数:

clazz - 需要连接的表对应的实体类

alias - 表的别名，用于在查询中标识该表

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

leftJoin

default JoinCondition leftJoin(boolean isEffective,
                               Class<?> clazz,
                               String alias,
                               Consumer<GenericWhereCondition> onCondition)

leftJoin

JoinCondition leftJoin(SelectDsl nestedSelect,
                       String alias,
                       Consumer<GenericWhereCondition> onCondition)

构建一个 LEFT JOIN 连接，用于将当前查询与子查询结果关联。

子查询返回的结果集会作为临时表参与连接，支持指定别名和 ON 条件。

参数:

nestedSelect - 子查询构建器，用于生成临时表

alias - 子查询结果的别名

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

leftJoin

default JoinCondition leftJoin(boolean isEffective,
                               SelectDsl nestedSelect,
                               String alias,
                               Consumer<GenericWhereCondition> onCondition)

leftJoin

JoinCondition leftJoin(Supplier<TableFunction> tableFunction,
                       String alias,
                       Consumer<GenericWhereCondition> onCondition)

构建一个 LEFT JOIN 连接，用于将当前查询与表函数的结果关联。

表函数的返回值作为临时表参与连接，支持指定别名和 ON 条件。

参数:

tableFunction - 表函数构建器，用于生成临时表

alias - 表函数结果的别名

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

leftJoin

default JoinCondition leftJoin(boolean isEffective,
                               Supplier<TableFunction> tableFunction,
                               String alias,
                               Consumer<GenericWhereCondition> onCondition)

leftJoin

@Deprecated
JoinCondition leftJoin(CteTable cte,
                                   Consumer<GenericWhereCondition> onCondition)

已过时。

构建一个 LEFT JOIN 连接，用于将当前查询与公共表表达式 (CTE) 结果关联。

CTE 的返回值作为临时表参与连接，支持 ON 条件。

参数:

cte - 公共表表达式实例

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

leftJoin

@Deprecated
default JoinCondition leftJoin(boolean isEffective,
                                           CteTable cte,
                                           Consumer<GenericWhereCondition> onCondition)

已过时。

rightJoin

JoinCondition rightJoin(Class<?> clazz,
                        Consumer<GenericWhereCondition> onCondition)

构建一个 RIGHT JOIN 连接，用于将当前查询与另一个表关联。

RIGHT JOIN 返回右表中的所有记录，以及左表中满足连接条件的记录。如果左表中没有匹配的记录， 则结果集中该部分字段的值为 NULL。

参数:

clazz - 需要连接的表对应的实体类

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

rightJoin

default JoinCondition rightJoin(boolean isEffective,
                                Class<?> clazz,
                                Consumer<GenericWhereCondition> onCondition)

rightJoin

JoinCondition rightJoin(Class<?> clazz,
                        String alias,
                        Consumer<GenericWhereCondition> onCondition)

构建一个 RIGHT JOIN 连接，用于将当前查询与另一个表关联。

RIGHT JOIN 返回右表中的所有记录，以及左表中满足连接条件的记录。如果左表中没有匹配的记录， 则结果集中该部分字段的值为 NULL。此方法支持指定表别名。

参数:

clazz - 需要连接的表对应的实体类

alias - 表的别名，用于在查询中标识该表

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

rightJoin

default JoinCondition rightJoin(boolean isEffective,
                                Class<?> clazz,
                                String alias,
                                Consumer<GenericWhereCondition> onCondition)

rightJoin

JoinCondition rightJoin(SelectDsl nestedSelect,
                        String alias,
                        Consumer<GenericWhereCondition> onCondition)

构建一个 RIGHT JOIN 连接，用于将当前查询与子查询结果关联。

子查询返回的结果集会作为临时表参与连接，支持指定别名和 ON 条件。

参数:

nestedSelect - 子查询构建器，用于生成临时表

alias - 子查询结果的别名

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

rightJoin

default JoinCondition rightJoin(boolean isEffective,
                                SelectDsl nestedSelect,
                                String alias,
                                Consumer<GenericWhereCondition> onCondition)

rightJoin

JoinCondition rightJoin(Supplier<TableFunction> tableFunction,
                        String alias,
                        Consumer<GenericWhereCondition> onCondition)

构建一个 RIGHT JOIN 连接，用于将当前查询与表函数的结果关联。

表函数的返回值作为临时表参与连接，支持指定别名和 ON 条件。

参数:

tableFunction - 表函数构建器，用于生成临时表

alias - 表函数结果的别名

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

rightJoin

default JoinCondition rightJoin(boolean isEffective,
                                Supplier<TableFunction> tableFunction,
                                String alias,
                                Consumer<GenericWhereCondition> onCondition)

rightJoin

@Deprecated
JoinCondition rightJoin(CteTable cte,
                                    Consumer<GenericWhereCondition> onCondition)

已过时。

构建一个 RIGHT JOIN 连接，用于将当前查询与公共表表达式 (CTE) 结果关联。

CTE 的返回值作为临时表参与连接，支持 ON 条件。

参数:

cte - 公共表表达式实例

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链 由于CTE会使代码结构复杂化，且变得冗长。暂时不计划实现该接口

rightJoin

@Deprecated
default JoinCondition rightJoin(boolean isEffective,
                                            CteTable cte,
                                            Consumer<GenericWhereCondition> onCondition)

已过时。

fullJoin

default JoinCondition fullJoin(boolean isEffective,
                               Class<?> clazz,
                               Consumer<GenericWhereCondition> onCondition)

fullJoin

JoinCondition fullJoin(Class<?> clazz,
                       Consumer<GenericWhereCondition> onCondition)

构建一个 FULL JOIN 连接，用于将当前查询与另一个表关联。

FULL JOIN 返回左右表中所有记录，以及满足连接条件的记录。如果任一表中没有匹配的记录， 则结果集中该部分字段的值为 NULL。

参数:

clazz - 需要连接的表对应的实体类

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

fullJoin

JoinCondition fullJoin(Class<?> clazz,
                       String alias,
                       Consumer<GenericWhereCondition> onCondition)

构建一个 FULL JOIN 连接，用于将当前查询与另一个表关联。

FULL JOIN 返回左右表中所有记录，以及满足连接条件的记录。如果任一表中没有匹配的记录， 则结果集中该部分字段的值为 NULL。此方法支持指定表别名。

参数:

clazz - 需要连接的表对应的实体类

alias - 表的别名，用于在查询中标识该表

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

fullJoin

default JoinCondition fullJoin(boolean isEffective,
                               Class<?> clazz,
                               String alias,
                               Consumer<GenericWhereCondition> onCondition)

fullJoin

@Deprecated
JoinCondition fullJoin(CteTable cte,
                                   Consumer<GenericWhereCondition> onCondition)

已过时。

构建一个 FULL JOIN 连接，用于将当前查询与公共表表达式 (CTE) 的结果关联。

FULL JOIN 返回左右表中所有记录，以及满足连接条件的记录。如果任一表中没有匹配的记录， 则结果集中该部分字段的值为 NULL。此方法用于支持 CTE 作为临时表参与连接。

参数:

cte - 公共表表达式实例

onCondition - 用于构建 ON 条件的 Consumer 对象，通过 GenericWhereCondition 接口定义连接条件

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

fullJoin

@Deprecated
default JoinCondition fullJoin(boolean isEffective,
                                           CteTable cte,
                                           Consumer<GenericWhereCondition> onCondition)

已过时。

crossJoin

JoinCondition crossJoin(Class<?> clazz)

构建一个 CROSS JOIN 连接，用于将当前查询与另一个表关联。

CROSS JOIN 返回笛卡尔积，即左表和右表中每一条记录的所有组合。 通常在没有显式连接条件时使用 CROSS JOIN，或者用于生成测试数据。

参数:

clazz - 需要连接的表对应的实体类

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

crossJoin

default JoinCondition crossJoin(boolean isEffective,
                                Class<?> clazz)

crossJoin

@Deprecated
JoinCondition crossJoin(CteTable cte)

已过时。

构建一个 CROSS JOIN 连接，用于将当前查询与公共表表达式 (CTE) 的结果关联。

CROSS JOIN 返回笛卡尔积，即左表和右表中每一条记录的所有组合。 此方法适用于使用公共表表达式作为数据源参与笛卡尔积操作的场景。

参数:

cte - 公共表表达式实例

返回:

当前查询上下文的 JoinCondition 实例，用于继续构建查询链

crossJoin

@Deprecated
default JoinCondition crossJoin(boolean isEffective,
                                            CteTable cte)

已过时。

where

TableRelation<?> where(Consumer<GenericWhereCondition> condition)

追加 WHERE 条件。

参数:

condition - 用于构建 WHERE 条件的 Consumer 对象

返回:

返回表连接实例

where

TableRelation<?> where(boolean isEffective,
                       Consumer<GenericWhereCondition> condition)

where

TableRelation<?> where()

空条件 WHERE，返回无条件的查询上下文。 有时可能需要衔接使用，比如在直接调用分组时。

返回:

返回表连接实例

limit

Fetchable limit(int offset,
                int limit)

限制查询返回的行数。

参数:

offset - 跳过的行数

limit - 返回的最大行数

返回:

当前查询构建器的实例

limit

Fetchable limit(boolean isEffective,
                int offset,
                int limit)

limit

Fetchable limit(int limit)

限制查询返回的行数。

参数:

limit - 返回的最大行数

返回:

当前查询构建器的实例

limit

Fetchable limit(boolean isEffective,
                int limit)