知识卡片
聚合列表查询条件
DDDML 为 Car 聚合生成的 GET /Cars 列表接口接受排序、字段选择、起始位置、最大条数和过滤条件。简单过滤可以写成查询参数,例如 firstName=like(Yang%25)&age=gt(18);同一属性重复出现可表达类似 SQL IN 的集合条件。复杂条件可先将 Criterion 条件树序列化为 JSON,再经 URL 编码放进 filter 参数。服务端将两种输入转换为 Criterion,交给应用服务查询;返回状态再转为 DTO。这里的 like、gt 等语法是书中工具约定,并非通用 HTTP 语法。
书中的复杂条件示例先建立 filter = Restrictions.Or(conjunctionAll, c99_IsNotNull),最后却返回 conjunctionAll;随后展示的 JSON 根类型也是 conjunction。因此该样例不能证明外层 Or 会进入请求过滤条件,照用时应以实际返回的条件树为准。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《深入实践DDD:以DSL驱动复杂软件开发》第152章《13.2.1 GET》(源文件:_epub-src/OEBPS/Text/chapter154.xhtml)
- 结论依据:生成的 `getAll` 方法同时处理 `filter` 与其他查询参数,并转换为 Criterion;书中给出简单过滤与复杂条件 JSON 的例子。
- 原始内容:例1,可以发送HTTP GET请求到下面的URL,查询firstName以“Yang”开头,age大于18的“人们”: http://localhost:8080/people?firstName=like(Yang%25)&age=gt(18) 例2,在URL可以重复使用一个属性名作为查询参数名,此做法相当于在SQL中使用in子句
- 补充原文:我们可以将这个JSON字符串URL编码之后,作为获取资源列表的GET请求的filter查询参数的值。
- 实现摘录:var filter = Restrictions.Or(conjunctionAll, c99_IsNotNull); return conjunctionAll;