wheres 用于描述数据查询条件，数据结构为 Array<Object Where>。

Query DSL:

{
  "wheres": [
    { "field": "created_at", "op": ">=", "value": "2020-01-01" },
    { "field": "created_at", "op": "<=", "value": "{'2020-12-31'}" },
    { "field": "created_at", "op": "<=", "value": "{updated_at}" },
    {
      "wheres": [
        { "field": "type", "value": 1 },
        { "or": true, "field": "type", "value": 2 }
      ]
    },
    {
      "comment": "限定范围: 仅列出有效厂商",
      "field": "manu_id",
      "op": "in",
      "query": {
        "select": ["id"],
        "from": "$manu",
        "wheres": [{ "field": "status", "value": "enabled" }]
      }
    }
  ]
}

解析后的 SQL语句 为:

  WHERE `created_at` >=  '2020-01-01'
    AND `created_at` <=  '2020-12-31'
    AND `created_at` <=  `updated_at`
    AND (
      `type` = 1 OR `type` = 2
    )
    AND `manu_id` IN (SELECT `id` FROM `manu` WHERE `status` = 'enabled' )

select 用来描述选择字段列表，数据类型为字段表达式字符串数组 Array<Field Expression> ，支持数据表字段名称、常量和函数；可以使用 as 对字段设置别名，别名视为主表字段名称，可在 wheres, order, having 中直接使用。

{
  "select": [
    "name",
    "short_name as short",
    "*mobile",
    ":MAX(score) as high_score",
    "$extra",
    "$extra.sex as sex",
    "@prices",
    "@prices[0] as price",
    "@addresses[0].id as address_id",
    "t2.name as t2_name",
    "t2.short_name as t2_short",
    "0.618 as 黄金分割",
    "'enable' as 状态"
  ]
}

form 用来指定查询数据表名称或数据模型，数据类型为 String；

说明

• 可以使用 $ 标识符，指定数据模型绑定的数据表。
• 可以使用 as 对数据表设置别名，别名支持中文，在表连接、字段引用等场景可以使用别名代替数据表名称。
• 如设置子查询 query( 查看子查询文档)，解释器优先响应子查询逻辑，忽略 from 设定。 query和from 必填其一。

使用 limit, offset 或 page, pagesize 限定记录范围。page 和 pagesize 根据查询条件自动分页。

Gou Query DSL:

{
  "select": ["id", "name"],
  "from": "manu",
  "offset": 20,
  "limit": 50
}

解析后的 SQL语句 为(MySQL 示例):

  SELECT `id`, `name` FROM `manu` LIMIT 20,50

通过 page 和 pagesize 限定记录范围，QueryDSL 默认返回值包含分页信息, 可以通过设置 data-only 不返回分页信息。

Gou Query DSL:

{
  "select": ["id", "name"],
  "from": "manu",
  "page": 1,
  "pagesize": 50
}

解析后的 SQL语句 为(MySQL 示例):

  -- 执行第一次查询, 查询记录总数
  SELECT count(`id`) as `total` FROM `manu`
  -- 解析器根据 total, page 和 pagesize 计算 offset 和 limit
  -- 执行第二次查询
  SELECT `id`, `name` FROM `manu` LIMIT 50