Jeecg Boot 2.2.1 版本发布，低代码平台

e6bb5eb0 · JEECG低代码平台 · 109a95a9 · e6bb5eb0 · e6bb5eb0 · e6bb5eb0
6 changed file
--- a/README.md
+++ b/README.md
@@ -7,7 +7,7 @@
 JEECG BOOT 低代码开发平台（前后端分离版本）
 ===============

-当前最新版本： 2.2.1（发布日期：2020-07-11）
+当前最新版本： 2.2.1（发布日期：2020-07-13）


 [![AUR](https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg)](https://github.com/zhangdaiscott/jeecg-boot/blob/master/LICENSE)

--- a/ant-design-vue-jeecg/README.md
+++ b/ant-design-vue-jeecg/README.md
 Ant Design Jeecg Vue
 ====

-当前最新版本： 2.2.1（发布日期：20200711）
+当前最新版本： 2.2.1（发布日期：20200713）

 Overview
 ----

--- a/jeecg-boot/.gitattributes
+++ b/jeecg-boot/.gitattributes
+*.js linguist-language=Java
+*.css linguist-language=Java
+*.html linguist-language=Java
+*.vue linguist-language=Java
--- a/jeecg-boot/.gitignore
+++ b/jeecg-boot/.gitignore
+/target/
+/.idea/
+*.iml
+jeecg-boot-module-demo
+rebel.xml
\ No newline at end of file
--- a/jeecg-boot/LICENSE
+++ b/jeecg-boot/LICENSE
+MIT License
+
+Copyright (c) 2019 jeecg-boot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
\ No newline at end of file
--- a/jeecg-boot/README.md
+++ b/jeecg-boot/README.md
-Jeecg-Boot 低代码开发平台
+Jeecg-Boot 快速开发平台
 ===============

-当前最新版本： 2.2.0（发布日期：20200506）
+当前最新版本： 2.2.1（发布日期：20200713）


 ## 后端技术架构
 - 基础框架：Spring Boot 2.1.3.RELEASE

- 持久层框架：Mybatis-plus_3.1.2
+- 持久层框架：Mybatis-plus_3.1.1

 - 安全框架：Apache Shiro 1.4.0，Jwt_3.7.0

- 数据库连接池：阿里巴巴Druid 1.1.10
+- 数据库连接池：阿里巴巴Druid 1.1.17

 - 缓存框架：redis

@@ -34,21 +34,9 @@ Jeecg-Boot 低代码开发平台
 - 缓存：Redis

 
-## 技术文档
+## 开发文档

-
- 在线演示 ：  [http://boot.jeecg.com](http://boot.jeecg.com)
-
- 在线文档：  [http://doc.jeecg.com/1273753](http://doc.jeecg.com/1273753)
-
- 常见问题：  [入门常见问题大全](http://bbs.jeecg.com/forum.php?mod=viewthread&tid=7816&extra=page%3D1)
-
- QQ交流群 ：  ①284271917、②769925425
-
-
-## 专项文档
-
-#### 一、查询过滤器用法
+- 查询过滤器用法

 ```
 QueryWrapper<?> queryWrapper = QueryGenerator.initQueryWrapper(?, req.getParameterMap());
@@ -89,22 +77,133 @@ QueryWrapper<?> queryWrapper = QueryGenerator.initQueryWrapper(?, req.getParamet
 | 多选字段模糊查询     | 上述4 有一个特例，若某一查询字段前后都带逗号 则会将其视为走这种查询方式 ,该查询方式是将查询条件以逗号分割再遍历数组 将每个元素作like查询 用or拼接,例如 现在name传入值 ,a,b,c, 那么结果sql就是 name like '%a%' or name like '%b%' or name like '%c%' |    |


-#### 二、AutoPoi(EXCEL工具类-EasyPOI衍变升级重构版本）
+- Autopoi使用文档（EXCEL工具类 -  EasyPOI衍变升级重构版本）
 
  [在线文档](https://github.com/zhangdaiscott/autopoi)
  


-#### 三、代码生成器

-> 功能说明：   一键生成的代码（包括：controller、service、dao、mapper、entity、vue）
+- **代码生成器**
+
+** 功能说明**：   一键生成的代码（包括：controller、service、dao、mapper、entity、vue）
+ 
+ **模板位置**： src/main/resources/jeecg/code-template  
+
+**使用方法**： 
+ 
+ 【**一对一模板**】  
+  
+**1.**先找到**jeecg-boot/src/resources/jeecg**下的  
+**jeecg_config.properties**和**jeecg_database.properties**两个文件。  
+**jeecg_config.properties:** 用来配置文件生成的路径，  
+    
+**jeecg_database.properties:** 用来配置数据库相关配置.  
+         
+         
+**2.**配置好这些配置之后，我们需要找到**jeecg-boot/src/main/java/org/jeecg/JeecgOneGUI.java**类，也就是启动一对一代码生成器的入口；
+  
+    
+**3.**右键运行该类，紧接着会弹出一个窗口，如下图:  
+        ![](https://static.oschina.net/uploads/img/201904/14222638_Svth.png)  
+          
+          
+**4.**然后根据窗口左侧的提示，在右侧填写对应的信息即可.
+     
+ 【**一对多模板**】  
+   
+   
+**1.**先找到**jeecg-boot/src/resources/jeecg**下的
+    
+**jeecg_config.properties**和**jeecg_database.properties**两个文件。  
+  
+**jeecg_config.properties:** 是配置文件生成路径的，  
+  
+  
+**jeecg_database.properties:** 是配置数据库相关配置的文件。  
+       
+       
+**2.**接着我们需要找到**jeecg-boot/src/main/java/org/jeecg/JeecgOneToMainUtil.java**这个类。
+     该类是生成一对多模板的启动入口。  
+       
+       
+**3.**该类中需要三个步骤来配置一对多表的信息。  
+  
+    
+  (1) 第一步: 配置主表信息,代码如下:
  
- - 模板位置： src/main/resources/jeecg/code-template
- - 技术文档： http://doc.jeecg.com
+```
+		//第一步：设置主表配置
+		MainTableVo mainTable = new MainTableVo();
+		mainTable.setTableName("jeecg_order_main");//表名
+		mainTable.setEntityName("TestOrderMain");	 //实体名
+		mainTable.setEntityPackage("test2");	 //包名
+		mainTable.setFtlDescription("订单");	 //描述
+		
+```
+  (2) 第二步: 配置子表信息，**有多个则配置多个**, 代码如下: 
+     
+  ①比如: 配置子表 1:
+  
+  ```
+		//第二步：设置子表集合配置
+		List<SubTableVo> subTables = new ArrayList<SubTableVo>();
+		//[1].子表一
+		SubTableVo po = new SubTableVo();
+		po.setTableName("jeecg_order_customer");//表名
+		po.setEntityName("TestOrderCustom");	    //实体名
+		po.setEntityPackage("test2");	        //包名
+		po.setFtlDescription("客户明细");       //描述
+		//子表外键参数配置
+		/*说明: 
+		 * a) 子表引用主表主键ID作为外键，外键字段必须以_ID结尾;
+		 * b) 主表和子表的外键字段名字，必须相同（除主键ID外）;
+		 * c) 多个外键字段，采用逗号分隔;
+		*/
+		po.setForeignKeys(new String[]{"order_id"});
+		subTables.add(po);
+  ```
+  ②比如: 配置子表 2:  
+  
+```
+		//[2].子表二
+		SubTableVo po2 = new SubTableVo();
+		po2.setTableName("jeecg_order_ticket");		//表名
+		po2.setEntityName("TestOrderTicket");			//实体名
+		po2.setEntityPackage("test2"); 				//包名
+		po2.setFtlDescription("产品明细");			//描述
+		//子表外键参数配置
+		/*说明: 
+		 * a) 子表引用主表主键ID作为外键，外键字段必须以_ID结尾;
+		 * b) 主表和子表的外键字段名字，必须相同（除主键ID外）;
+		 * c) 多个外键字段，采用逗号分隔;
+		*/
+		po2.setForeignKeys(new String[]{"order_id"});
+		subTables.add(po2);  
+  ```
+  ③将整合了子表VO的subTables添加到主表对象当中去: 
+
+```
+  mainTable.setSubTables(subTables);
+  ```
+  ④需要注意如下代码,该代码的作用是,为子表设置主外键关联,当添加数据时,  
+主表的主键将会添加到子表的"order_id"中:  
+  
+```
+  		po2.setForeignKeys(new String[]{"order_id"});
+  ```
    
+  (3) 第三步: 启动(run)程序，生成代码, 代码如下:
+  
+  ```
+  		//第三步：一对多(父子表)数据模型,代码生成
+		new CodeGenerateOneToMany(mainTable,subTables).generateCodeFile();
+  ```
+ 
+[在线文档](https://github.com/zhangdaiscott/autopoi)  
  

-#### 四、编码排重使用示例
+- **编码排重使用示例**   

 重复校验效果：
 ![输入图片说明](https://static.oschina.net/uploads/img/201904/19191836_eGkQ.png "在这里输入图片标题")
@@ -156,3 +255,34 @@ code: {
        }
      },
 ```
+
+
+## docker镜像用法
+ ``` 
+注意： 如果本地安装了mysql和redis,启动容器前先停掉本地服务，不然会端口冲突。
+       net stop redis
+       net stop mysql
+ 
+# 1.修改项目配置文件 application.yml
+    active: docker
+
+# 2.先进JAVA项目根路径 maven打包
+    mvn clean package
+ 
+
+# 3.构建镜像__容器组（当你改变本地代码，也可重新构建镜像）
+    docker-compose build
+
+# 4.配置host
+
+    # jeecgboot
+    127.0.0.1   jeecg-boot-redis
+    127.0.0.1   jeecg-boot-mysql
+    127.0.0.1   jeecg-boot-system
+
+# 5.启动镜像__容器组（也可取代运行中的镜像）
+    docker-compose up -d
+
+# 6.访问后台项目（注意要开启swagger）
+    http://localhost:8080/jeecg-boot/doc.html
+``` 
\ No newline at end of file