更新文档

diboot-docs/guide/diboot-core/简介.md

@@ -25,6 +25,13 @@
 MySQL、MariaDB、PostgreSQL、ORACLE、SQLServer
 
 ## diboot-core 使用
+参数配置：
+diboot-core-starter有以下一个配置项，用于设置是否检测初始化SQL
+配置参数:
+~~~properties
+# 是否初始化sql，默认true，初始化之后可以关闭
+diboot.core.init-sql=false
+~~~
 
 使用步骤请参考 [diboot-core README](https://github.com/dibo-software/diboot-v2/tree/master/diboot-core)
 

diboot-docs/guide/diboot-file/开始使用.md

@@ -26,9 +26,12 @@ diboot-file会自动依赖以下jar包，无需重复引入：
 > 如果使用diboot-devtools，还需要引入devtools相关依赖，可自动生成相关的上传下载controller。
 
 ## 2、参数配置：
-diboot-file组件有以下一个配置项，用于设置本地文件的存储起始目录（子目录会按分类与日期自动创建）
-配置参数: 文件的本地存储路径
-~~~
+diboot-file组件有以下配置项，用于初始化及设置本地文件的存储起始目录（子目录会按分类与日期自动创建）
+配置参数:
+~~~properties
+# 是否初始化sql，默认true，初始化之后可以关闭
+diboot.component.file.init-sql=false
+# 文件的本地存储路径
 files.storage.directory=/myfile
 ~~~
 

diboot-docs/guide/diboot-iam/开始使用.md

@@ -49,6 +49,9 @@ public class Application {
 * 配置文件配置项：
 
 ```
+#是否执行SQL初始化，默认true（非开发环境需关闭）
+diboot.iam.init-sql=true
+
 #当前应用程序，多个系统时配置，默认为MS（管理系统）
 diboot.iam.application=MS
 

diboot-docs/guide/notes/faq.md

@@ -4,6 +4,15 @@
 * diboot 2.0.x 支持 Spring boot 2.2.x
 * diboot 2.1.x 支持 Spring boot 2.3+
 
+## IAM的后端代码在哪里？
+IAM的后端基础代码由devtools自动生成
+* 配置好diboot组件依赖和devtools依赖
+* 启动项目，进入devtools的组件初始化页面，选择core及IAM等组件，执行初始化
+* devtools将生成IAM基础的代码到你配置的路径下
+
+注：[diboot-v2-example](https://github.com/dibo-software/diboot-v2-example) 中包含可供参考的后端示例：diboot-iam-example（IAM示例代码）
+及diboot-online-demo（线上演示项目）。
+
 ## 如何自定义fastjson配置
 diboot-core-starter中包含默认的HttpMessageConverters配置，启用fastjson并做了初始化配置。
 其中关键配置参数为：
@@ -76,24 +85,37 @@ sourceSets {
 ```
 
 ## 如何构建树形结构？
-> 树形结构对象约定：要有 parentId属性 和 List children 属性，便于自动构建。
-* 1. 先把需要构建树形结构的节点全部查出来，如:
+> 树形结构对象约定：要有 parentId属性（根节点为0） 和 List children 属性，便于自动构建。
+* 先把需要构建树形结构的节点全部查出来，如:
 ~~~java
 List<Menu> menus = menuService.getEntityList(wrapper);
 ~~~
-* 2. 调用BeanUtils.buildTree构建树形结构
+* 调用BeanUtils.buildTree构建树形结构
 ~~~java
 // 如果children属性在VO中，可以调用BeanUtils.convertList转换后再构建
 menus = BeanUtils.buildTree(menus);
 ~~~
+返回第一级子节点集合。
+
+## 查询Date类型日期时间字段 = 某天，如何自动绑定？
+建议逻辑: datetime_field >= beginDate AND datetime_field < (beginDate+1) 。
+无函数处理，不涉及数据库类型转换。示例：
+~~~java
+@BindQuery(comparison = Comparison.GE, field = "createTime")
+private Date beginDate;
+
+@BindQuery(comparison = Comparison.LT, field = "createTime")
+private Date endDate;
+
+public void setBeginDate(Date beginDate){
+    this.beginDate = beginDate;
+    this.endDate = D.addDays(beginDate, 1);
+}
+~~~
 
-## IAM的后端代码在哪里？
-IAM的后端基础代码由devtools自动生成
-* 配置好diboot组件依赖和devtools依赖
-* 启动项目，进入devtools的组件初始化页面，选择core及IAM等组件，执行初始化
 
-注：[diboot-v2-example](https://github.com/dibo-software/diboot-v2-example) 中包含可供参考的后端示例：diboot-iam-example（IAM示例代码）
-及diboot-online-demo（线上演示项目）。
 
 ## 为何引入iam后启动报错？
-确保您配置了**@EnableTransactionManagement**注解，可参考 [IAM参数配置-注解配置](/guide/diboot-iam/开始使用.html#_2、参数配置：)
+确保您配置了**@EnableTransactionManagement**注解，可参考 [IAM参数配置-注解配置](/guide/diboot-iam/开始使用.html#_2、参数配置：)
+
+

diboot-docs/guide/notes/upgrade.md

@@ -35,6 +35,20 @@ public class DepartmentController extends BaseCustomCrudRestController<Departmen
     super.getViewObjectList(entity, pagination, DepartmentVO.class);
 “}
 ~~~
+* v2.1.x版本开始，core-starter中不再默认指定Date类型转json的默认格式，而是通过Date字段注解@JSONField(format=)去指定。
+如果Date日期格式非预期，您可以通过以下两种方式调整：
+1. 需要在Date字段上添加@JSONField(format=)注解。
+或
+2. 重新定义HttpMessageConverters，统一指定Date类型默认格式。
+
+* v2.1.x版本core-starter自动初始化增加了String-Date转换的convertor至Spring FormatterRegistry。
+如果您不需要request查询参数的String转Date，可重写addFormatters，移除String-Date转换。
+~~~java
+@Override
+public void addFormatters(FormatterRegistry registry) {
+   registry.removeConvertible(String.class, Date.class);
+}
+~~~
 
 * v2.1.x版本开始，extdata扩展字段将不再推荐使用，该字段设计目的用于字段冗余的json存储，可以通过数据库的json数据类型实现。
 devtools从2.1版本开始不再支持extdata的特殊处理。