Browse Source

更改框架说明文档文件名,防止跟项目自身的README冲突

tuonina 6 years ago
parent
commit
26f7259b52
1 changed files with 133 additions and 133 deletions
  1. 133 133
      FRAMEWORK.md

+ 133 - 133
README.md → FRAMEWORK.md

@@ -1,134 +1,134 @@
-### 项目自定义规范
-
-只是一些建议性的东西,大家有什么好的想法,都可以提出来。
-
-- 现在暂时定义为v1版本,所有的api以 /v1/模块/功能
-- 采用restFul风格的URL
-- 返回数据的格式,全部采用ResponseDto ,data字段为传递的数据
-- 前后端分离,采用json格式进行数据传输
-- 根据 ResponseDto 的code字段判断请求操作是否成功。如果失败,返回非200的请求码
-- *最好将系统的代码和自己的区分开来,自己的代码写在cn.gygxzc.envir.biz 目录下*
-
-- *一键生成数据库相关代码配置在cn.gygxzc.envir.config.orm 包下,请自行配置相关参数*
-
-### 项目说明
-
-项目采用Spring Cloud分布式解决方案。
-目前系统中涉及到的知识点有 :
-- Eureka服务发现与注册中心,
-- Spring Cloud Config Server 微服务配置中心;
-- Spring Cloud Gateway 网关
-- Spring Cloud Bus 消息总线(结合rabbitmq)
-- Spring Session 结合Redis 做分布式权限认证
-- Mybatis-Plus 3.0
-
-需要的可以去了解一下。
-
-项目中缓存可以分成三类:
-- 系统Spring session缓存,shiro缓存
-
--  获取当前登录用户信息 SessionUtils 工具类
-
-
-### 框架项目升级日志
-#### 2018/9/27
-升级框架的安全认证方式,改成jwt 和Spring session分布式方式认证。权限由网关统一认证。
-
-#### 2018/9/28
-已初步完成Spring session的分布式认证,下一步将移除shiro 依赖即权限认证。
-
-- 将数据库 DAO类文件卸载 zen-api 下的 cn.gygxzc.envir.biz.dao 路径下
-- 如果需要写 mapper.xml 请写在  resources/mapper 文件夹下,可以在有目录比如;resources/mapper/biz
-- 项目包名统一为 cn.gygxzc.envir.**
-- 项目对mybatis plus进行了升级,使用的是mybatis-plus 3.0,与之前有一定区别,具体可见[文档](http://mp.baomidou.com/guide/wrapper.html#querywrapper)
-
-#### 2018/9/29
-##### 1、添加配置中心,将配置中心与即时通信消息系统结合起来
-##### 2、 添加Spring bus。服务间的消息通知。
-
-        这一点举一点应用:业务系统需要向前端或者用户发送消息,
-        只需要调用发送消息的sender即可。由消息中心把消息发送给前端用户。
-
-##### 3、 删除shiro配置。
-        
-        但是因为授权中心使用shiro,导致客户端不能完全移除shiro依赖,但是只引用了shiro的核心包。
-        具体原因是:授权中心shiro在生成的session中放入了shiro包中的类实体对象,jdk序列化之后,在各自的业务系统中反序列化,如果不引入shiro核心包,将
-        导致jdk反序列化失败,导致各自业务系统无法获取到当前登录的用户信息。
-##### 4、 精简大量yml 文件配置,只保留必要的部分。
- 有了配置中心的存在,可以将所有项目的公有和私有配置放到配置中心,而无需大量放到本地。
- 
-##### 5、移除Tomcat依赖,添加jetty依赖
-Jetty 更加轻量化,更符合Spring Cloud 分布式部署;当然,这个还需要验证和考量。
-
-#### 2018/9/30
- - 这次项目更新主要是去掉shiro的权限认证,但是保留了shiro的核心包,原因见上昨天更新日志。
- - 删除了很多配置文件,集中到配置中心配置。
- - 保留的配置文件 bootstrap.yml 为配置注册中心,配置中心相关信息,application.yml内只有数据库连接相关配置。
- application-cache.yml为项目的一个内存缓存配置。里面需要修改的有备注,但是暂时可以不修改。
- - 完成了mybatis-plus 的物理删除功能,具体见zen-api 下的test 包。
- 
- 到目前为止,框架这部分基本上不会有太多更新。目前业务中需要的即时通信相关服务,会单独写一个即时通信服务。
- 业务系统通过rabbitmq 消息总线发送消息到 消息推送系统完成这方面的需求。后期会提供相关的接口包。
-
-### 后期我的工作计划
-
-- 将继续精简shiro相关配置,直至完全移除;(已完成)
-- 消息总线 (已完成)
-- 日志记录
-- 即时通信(估计会另外建一个项目来做即时通信)
-- 网关的权限管理。
-- 阿里云对象存储,前后端文件上传功能。
-
-
-## Docker 相关介绍
-### 打包
-运行任务 : task dockerBuilder。
-特别注意在打包之前需要在idea 的命令行中登陆到镜像中心。
-登陆命令为:docker login --username=gxzcalyqy registry.cn-qingdao.aliyuncs.com
-密码为:docker20181018
-
-
-如果一切没有问题,打包成功之后会自动上传到镜像中心。等待上传完成。出现如下提示说明上传完成:
-
-        
-    BUILD SUCCESSFUL in 4m 10s
-    26 actionable tasks: 5 executed, 21 up-to-date
-    17:40:25: Task execution finished 'dockerBuilder'.
-
-
-### 关键参数
-- IP 宿主机的ip
-- PORT 服务部署的端口号
-- NAME 容器名称,这个自定义
-- IMAGE_NAME 镜像名称或者镜像的ID
-
-### 运行命令
-
-docker run -t  --name `NAME` --expose=`PORT`  -p `PORT`:`PORT` -e "EUREKA_INSTANCE_IP-ADDRESS=`IP`" -e "SERVER_PORT=`PORT`"  IMAGE_NAME
-
-### 注意事项
-
-- 修改zen-web下的zen-web.gradle 中 task dockerBuilder applicationName为项目自己的内容
-
-以下片段位于zen-web.gradle ,修改其中的applicationName
-
-
-        task dockerBuilder(type: Docker) {
-            registry='registry.cn-qingdao.aliyuncs.com/gxzc-envir'
-            applicationName = 'fw'
-            tagVersion = jar.version
-            addFile("./build/libs/${jar.baseName}-${jar.version}.jar","app.jar")
-            entryPoint(["java","-Djava.security.egd=file:/dev/./urandom","-jar",'app.jar'])
-            exposePort(11000)
-            doFirst {
-                copy {
-                    from jar
-                    into stageDir
-                }
-            }
-            push = true
-        }
-        
-        
-        
+### 项目自定义规范
+
+只是一些建议性的东西,大家有什么好的想法,都可以提出来。
+
+- 现在暂时定义为v1版本,所有的api以 /v1/模块/功能
+- 采用restFul风格的URL
+- 返回数据的格式,全部采用ResponseDto ,data字段为传递的数据
+- 前后端分离,采用json格式进行数据传输
+- 根据 ResponseDto 的code字段判断请求操作是否成功。如果失败,返回非200的请求码
+- *最好将系统的代码和自己的区分开来,自己的代码写在cn.gygxzc.envir.biz 目录下*
+
+- *一键生成数据库相关代码配置在cn.gygxzc.envir.config.orm 包下,请自行配置相关参数*
+
+### 项目说明
+
+项目采用Spring Cloud分布式解决方案。
+目前系统中涉及到的知识点有 :
+- Eureka服务发现与注册中心,
+- Spring Cloud Config Server 微服务配置中心;
+- Spring Cloud Gateway 网关
+- Spring Cloud Bus 消息总线(结合rabbitmq)
+- Spring Session 结合Redis 做分布式权限认证
+- Mybatis-Plus 3.0
+
+需要的可以去了解一下。
+
+项目中缓存可以分成三类:
+- 系统Spring session缓存,shiro缓存
+
+-  获取当前登录用户信息 SessionUtils 工具类
+
+
+### 框架项目升级日志
+#### 2018/9/27
+升级框架的安全认证方式,改成jwt 和Spring session分布式方式认证。权限由网关统一认证。
+
+#### 2018/9/28
+已初步完成Spring session的分布式认证,下一步将移除shiro 依赖即权限认证。
+
+- 将数据库 DAO类文件卸载 zen-api 下的 cn.gygxzc.envir.biz.dao 路径下
+- 如果需要写 mapper.xml 请写在  resources/mapper 文件夹下,可以在有目录比如;resources/mapper/biz
+- 项目包名统一为 cn.gygxzc.envir.**
+- 项目对mybatis plus进行了升级,使用的是mybatis-plus 3.0,与之前有一定区别,具体可见[文档](http://mp.baomidou.com/guide/wrapper.html#querywrapper)
+
+#### 2018/9/29
+##### 1、添加配置中心,将配置中心与即时通信消息系统结合起来
+##### 2、 添加Spring bus。服务间的消息通知。
+
+        这一点举一点应用:业务系统需要向前端或者用户发送消息,
+        只需要调用发送消息的sender即可。由消息中心把消息发送给前端用户。
+
+##### 3、 删除shiro配置。
+        
+        但是因为授权中心使用shiro,导致客户端不能完全移除shiro依赖,但是只引用了shiro的核心包。
+        具体原因是:授权中心shiro在生成的session中放入了shiro包中的类实体对象,jdk序列化之后,在各自的业务系统中反序列化,如果不引入shiro核心包,将
+        导致jdk反序列化失败,导致各自业务系统无法获取到当前登录的用户信息。
+##### 4、 精简大量yml 文件配置,只保留必要的部分。
+ 有了配置中心的存在,可以将所有项目的公有和私有配置放到配置中心,而无需大量放到本地。
+ 
+##### 5、移除Tomcat依赖,添加jetty依赖
+Jetty 更加轻量化,更符合Spring Cloud 分布式部署;当然,这个还需要验证和考量。
+
+#### 2018/9/30
+ - 这次项目更新主要是去掉shiro的权限认证,但是保留了shiro的核心包,原因见上昨天更新日志。
+ - 删除了很多配置文件,集中到配置中心配置。
+ - 保留的配置文件 bootstrap.yml 为配置注册中心,配置中心相关信息,application.yml内只有数据库连接相关配置。
+ application-cache.yml为项目的一个内存缓存配置。里面需要修改的有备注,但是暂时可以不修改。
+ - 完成了mybatis-plus 的物理删除功能,具体见zen-api 下的test 包。
+ 
+ 到目前为止,框架这部分基本上不会有太多更新。目前业务中需要的即时通信相关服务,会单独写一个即时通信服务。
+ 业务系统通过rabbitmq 消息总线发送消息到 消息推送系统完成这方面的需求。后期会提供相关的接口包。
+
+### 后期我的工作计划
+
+- 将继续精简shiro相关配置,直至完全移除;(已完成)
+- 消息总线 (已完成)
+- 日志记录
+- 即时通信(估计会另外建一个项目来做即时通信)
+- 网关的权限管理。
+- 阿里云对象存储,前后端文件上传功能。
+
+
+## Docker 相关介绍
+### 打包
+运行任务 : task dockerBuilder。
+特别注意在打包之前需要在idea 的命令行中登陆到镜像中心。
+登陆命令为:docker login --username=gxzcalyqy registry.cn-qingdao.aliyuncs.com
+密码为:docker20181018
+
+
+如果一切没有问题,打包成功之后会自动上传到镜像中心。等待上传完成。出现如下提示说明上传完成:
+
+        
+    BUILD SUCCESSFUL in 4m 10s
+    26 actionable tasks: 5 executed, 21 up-to-date
+    17:40:25: Task execution finished 'dockerBuilder'.
+
+
+### 关键参数
+- IP 宿主机的ip
+- PORT 服务部署的端口号
+- NAME 容器名称,这个自定义
+- IMAGE_NAME 镜像名称或者镜像的ID
+
+### 运行命令
+
+docker run -t  --name `NAME` --expose=`PORT`  -p `PORT`:`PORT` -e "EUREKA_INSTANCE_IP-ADDRESS=`IP`" -e "SERVER_PORT=`PORT`"  IMAGE_NAME
+
+### 注意事项
+
+- 修改zen-web下的zen-web.gradle 中 task dockerBuilder applicationName为项目自己的内容
+
+以下片段位于zen-web.gradle ,修改其中的applicationName
+
+
+        task dockerBuilder(type: Docker) {
+            registry='registry.cn-qingdao.aliyuncs.com/gxzc-envir'
+            applicationName = 'fw'
+            tagVersion = jar.version
+            addFile("./build/libs/${jar.baseName}-${jar.version}.jar","app.jar")
+            entryPoint(["java","-Djava.security.egd=file:/dev/./urandom","-jar",'app.jar'])
+            exposePort(11000)
+            doFirst {
+                copy {
+                    from jar
+                    into stageDir
+                }
+            }
+            push = true
+        }
+        
+        
+        
 ## 其他说明