SpringCloudBase/FRAMEWORK.md

项目自定义规范

只是一些建议性的东西，大家有什么好的想法，都可以提出来。

• 现在暂时定义为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,与之前有一定区别，具体可见文档

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
    }

其他说明