跳到主要内容

4.5 构造器 API

构造器 API 基于 LambdaTemplate，用链式方法描述 INSERT、UPDATE、DELETE、QUERY 等操作，由对应方言生成 SQL 或目标命令，再通过 JDBC 驱动执行。这是应用适配层统一不同数据源访问方式的入口之一。

例如，相同的条件构造写法可以由关系型方言生成 SQL，由 MongoDB 方言生成文档命令，或由 Elasticsearch 方言生成 Query DSL。可用操作与条件以各数据源的构造器能力为准。

适合场景​

  • 希望减少手写 SQL 或数据源专有命令。
  • 查询条件组合较多，不想手工拼接 WHERE。
  • 希望同一套 API 适配不同数据库方言。
  • 需要在 BaseMapper 的预设 CRUD 之外表达更复杂条件。

不适合场景​

  • SQL 或 DSL 已经固定且很复杂，直接维护命令更清楚。
  • 需要大量数据库专有语法、窗口函数、复杂 JOIN。
  • 希望 SQL/DSL 完全由 DBA 或独立 XML 文件维护。

这些场景可使用 JdbcTemplate 或 文件 Mapper。

三种模式​

模式是否需要对象映射适合场景
Entity 模式需要有实体类，使用 User::getName 这类方法引用操作列。
Map 模式需要有表映射，但数据载体使用 Map。
Freedom 模式不需要没有实体映射，直接使用表名和字符串列名。

最小示例​

已有 DataSource
DataSource dataSource = ...;
LambdaTemplate lambda = new LambdaTemplate(dataSource);

List<User> users = lambda.query(User.class)
        .eq(User::getStatus, "ACTIVE")
        .ge(User::getAge, 18)
        .queryForList();
已有 Connection
Connection conn = ...;
LambdaTemplate lambda = new LambdaTemplate(conn);

List<User> users = lambda.query(User.class)
        .eq(User::getStatus, "ACTIVE")
        .ge(User::getAge, 18)
        .queryForList();
Freedom 模式
Map<String, Object> row = lambda.queryFreedom("users")
        .eq("id", 1)
        .queryForObject();

深入阅读​