更新文档

diboot-docs/guide/diboot-core/Controller接口.md

@@ -112,6 +112,17 @@ String str = this.beforeDelete(entity);
 ```
 该方法主要用来处理删除数据之前的逻辑，如检验是否具有删除权限等，供子类重写实现。
 
+## 关于 /common/attachMore 接口
+attachMore是用于为前端select下拉框提供初始数据的通用接口，默认会初始化生成在DictionaryController中。
+当前端展现形式为Select下拉等数据量不大的场景下可调用该接口进行初始化。
+当数据量较大，不适合用Select展现等场景，请通过自定义接口实现。
+~~~java
+@PostMapping("/common/attachMore")
+public JsonResult attachMore(@Valid @RequestBody ValidList<AttachMoreDTO> attachMoreDTOList) {
+    ...
+}
+~~~
+
 ## 数据校验
 
 > 默认使用**hibernate-validator**进行后端数据校验。进行数据校验至少需要两步操作，在entity中设置每个字段的校验规则，以及在controller中对实体添加@Valid注解。

diboot-docs/guide/notes/faq.md

@@ -97,6 +97,13 @@ menus = BeanUtils.buildTree(menus);
 ~~~
 返回第一级子节点集合。
 
+## 查询Date类型日期范围，如何自动绑定？
+使用Comparison.BETWEEN进行绑定，BETWEEN支持数组、List、及逗号拼接的字符串。
+~~~java
+@BindQuery(comparison = Comparison.BETWEEN, field = "createTime")
+private List<Date> createDate;
+~~~
+
 ## 查询Date类型日期时间字段 = 某天，如何自动绑定？
 建议逻辑: datetime_field >= beginDate AND datetime_field < (beginDate+1) 。
 无函数处理，不涉及数据库类型转换。示例：
@@ -115,7 +122,3 @@ public void setBeginDate(Date beginDate){
 
 
 
-## 为何引入iam后启动报错？
-确保您配置了**@EnableTransactionManagement**注解，可参考 [IAM参数配置-注解配置](/guide/diboot-iam/开始使用.html#_2、参数配置：)
-
-

diboot-docs/guide/notes/upgrade.md

@@ -20,7 +20,7 @@ public JsonResult getDepartmentVOList(DepartmentDto departmentDto) throws Except
 }
 ~~~
 
-* v2.1.x 版本开始，BaseCrudRestController移除了VO泛型参数，便于子类区分不同VO，同时父类方法getViewObject*增加VO class参数用于指定VO。
+* v2.1.x 版本开始，BaseCrudRestController移除了VO泛型参数，便于子类灵活指定不同VO，同时父类方法getViewObject*增加VO class参数用于指定VO。
 修改示例：
 ~~~java
 public class DepartmentController extends BaseCustomCrudRestController<Department, DepartmentVO> {
@@ -35,6 +35,13 @@ public class DepartmentController extends BaseCustomCrudRestController<Departmen
     super.getViewObjectList(entity, pagination, DepartmentVO.class);
 “}
 ~~~
+
+* v2.1.x版本开始，新增了通用的/common/attachMore接口，用于统一提供key-value形式数据，用于select下拉框等组件。
+建议升级步骤：
+    * 备份DictionaryController及各Base基础代码
+    * 启动diboot-devtools，在组件初始化页面找到diboot-core，点击生成代码
+    * 将你改动过的Base基础代码合并至新生成的类
+
 * v2.1.x版本开始，core-starter中不再默认指定Date类型转json的默认格式，而是通过Date字段注解@JSONField(format=)去指定。
 如果Date日期格式非预期，您可以通过以下两种方式调整：
 1. 需要在Date字段上添加@JSONField(format=)注解。