JFrame - A Java Integration Framework

JFrame - SpringBoot & Cloud Project v5.9.4

made by @jackson-rick

本架构是对技术框架的整合及开发的规范，适合多端项目和微服务

模块

• jframe 文档/配置/部署脚本
• jframe-core 实体对象/服务类/系统相关
• jframe-utils 工具类
• jframe-web-api Api端
• jframe-web-manage 后台管理端
• jframe-mservice 微服务
• jframe-srv-oauth SSO模块
• jframe-srv-gateway 网关模块
• jframe-demos 集成案例

集成

• Spring/SpringMVC/MyBatis/SpringBoot/SpringCloud
• Spring Redis/Redis Session/Redisson/FastDFS
• 拦截器/AppToken/自定义权限/SpringSecurity/SSO单点登录
• 后台管理功能：权限管理、模块管理、地址、文件、工具、日志、UI等
• 线程池、日志服务、分布式日志ELK、异常处理、多数据源、分布式锁、分布式Session
• PageHelper分页、封装分页组件、Freemarker模板、封装函数和指令
• Quartz(单点/集群)、图形化管理、异步任务
• 第三方：微信SDK/支付宝SDK/推送/高德/阿里云/短信/邮件
• 日志可视化管理、Actuator健康监控、数据源监控
• 工具包：字符、时间、数字转换/JSON/Http/POI/PDF/分页/文件/对象/验证器/加密等
• JS插件：Ajax/DataTables/CityPicker/Layer/DatePicker/Ztree/Select2/Upload等
• 子模块及微服务：quartz、cache、rabbitmq、websocket、fdfs、eureka、oauth2、zuul、nacos、zookeeper等
• Nginx&Docker&Jenkins自动化部署
• 测试示例：消息队列RabbitMQ、Nacos分布式配置、服务发现、Quartz管理器、Websocket单点和MQ集群、Elastic全文搜索、dubbo服务
• IM即时聊天模块

环境与配置

• Jdk 1.8
• MySQL 5.6 +
• Postgresql 9 +
• Maven 3.3.9
• Redis 2.8.9
• Linux CentOS 7
• IDEA 2018.1
• Docker CE 18+
• 其他：RabbitMQ3.6、Jenkins、Dubbo2.7.1、ElasticSearch6.4.3、Zookeeper3.4.13

---

运行

打包到服务器运行

• 修改生产环境配置
• 安装依赖到本地仓库
  • cd jframe -> clean install
  • cd jframe-utils -> clean install -e
  • cd jframe-core -> clean install -e
• 在各个端下运行
  • clean package -Dmaven.test.skip=true -e
• 将target目录下的打包文件上传到服务器目录
• 运行jframe/build/run命令或直接运行java -jar命令
• 注意：运行脚本前，请先查看注释，需要按照指定的命名方式

Docker

• 直接运行打包命令，将上传到服务器目录，如:/home/docker/web
• 将项目jframe/build/docker/docker-compose.yml文件拷贝到项目根目录
• 运行docker-compose up -d | docker-compose start web
• 可搭配Jenkins发布

其他

• 使用maven下载Jar包时，请先在Maven中添加阿里的镜像源
• 数据库脚本：jframe/doc/mysql/database.sql
• 操作手册说明：jframe/doc/框架使用手册.docx
• 默认为MySQL数据库，如使用Postgresql，将数据库脚本替换为jframe/doc/postgresql/public.sql
• jframe-demos模块代码仅供参考

声明

本框架不能直接用于生产环境，需要根据业务做一定量调整

---

更新日志：

• v5.9.4 20200904
  • 1.5x最后版本优化
• v5.9.3 20200812
  • 1.聊天功能优化
  • 2.其他优化
• v5.9.2 20200806
  • 1.新增即时聊天模块 前往
• v5.9.1 20200624
  • 1.优化utils工具包
  • 2.新增KafKa示例
• v5.9 20200617
  • 1.集成Nacos配置管理和服务发现
  • 2.升级springcloud及相关依赖的版本
  • 3.常规优化~_~
• v5.8.4 20200611
  • 1.新增SpringSecurity示例
  • 2.优化SSO客户端在前后端分离开发的场景
• v5.8.3 20200609
  • 1.优化请求日志打印，支持ReqestBody注解
  • 2.新增支持获取指定挂载目录容量的方法
  • 3.修复POI转换CSV格式问题
• v5.8.2 20200605
  • 1.优化支持session redis存储序列化和@Cacheable注解
  • 2.优化SSO客户端
• v5.8.1 20200602
  • 1.完善influxdb示例
  • 2.优化OAuth服务端
  • 3.新增SSO客户端多个场景示例
  • 4.修复Excel转CSV问题
• v5.8 20200512
  • 1.新增activiti、influxdb、storm示例代码
  • 2.整合mservice微服务模块
  • 3.其他优化
• v5.7.6 20200323
  • 1.新增ZIP解压缩和Shell执行工具
  • 2.其他优化
• v5.7.5 20191213
  • 1.支持发布到maven私服
  • 2.优化maven dependencyManagement
  • 3.MyBatis Generate更新
• v5.7.4 20191118
  • 1.新增ShardingJDBC组件
  • 2.修复升级Springcloud版本导致的问题
  • 3.优化及修复SSO服务端
  • 4.整理各模块Maven依赖关系
• v5.7.3 20191030
  • 1.SpringBoot升级到2.2
  • 2.优化配置文件
  • 3.新增注解开关
  • 4.优化Redis缓存配置
• v5.7.2 20190929
  • 1.优化SSO及客户端
• v5.7.1 20190918
  • 1.重新设计表字段[后台管理模块]
  • 2.优化SSO单点登陆
  • 3.优化代码规范
  • 注：此版本需要重新导入数据库
• v5.7 20190828
  • 1.新增Springboot应用监控测试模块
  • 2.优化打包方式
  • 3.优化websocket
  • 4.优化POI导入导出
• v5.6.4 20190726
  • 1.优化SSO单点登陆
  • 2.优化POI配置式导入
  • 3.新增阿里云OSS工具类
• v5.6.3 20190718
  • 1.优化数据库逆向工程工具
  • 2.新增ElasticSearch模块，支持分词、拼音、高亮查询
• v5.6.1 20190710
  • 1.升级springcloud版本[2.1.2.RELEASE]
  • 2.maven依赖优化
  • 3.新增zookeeper注册和配置中心
  • 4.新增多个utils
• v5.6 20190703
  • 1.新增zookeeper注册和配置中心DEMO
  • 2.新增多个辅助类
  • 3.新增声明式事务
  • 4.优化后台页面
  • 5.其他优化
• v5.5.6 20190627
  • 1.修复POI导入BUG，支持大批量导入
  • 2.移除core模块entity包
• v5.5.5 20190624
  • 1.常规更新
  • 2.utils模块版本号升级为3.0
• v5.5.4 20190613
  • 1.系统优化，BUG修复
• v5.5.3 20190515
  • 1.新增一些APP端示例接口
  • 2.更新Pom文件,优化依赖
  • 3.其他优化👻
• v5.5.2 20190403
  • 1.更新Token前缀，新增数据库token支持
  • 2.配置优化，配置分离[推荐使用插件打包]
  • 3.工具类和WebSocket优化
• v5.5.1 20190321
  • 1.简化yml配置，合并成一个文件
  • 2.新增dubbo实例
  • 3.新增微信扫码登陆实例
  • 4.更新docker和nginx配置
• v5.5 20190308
  • 1.更新接口响应数据封装类ResMsg
  • 2.新增Nacos分布式配置服务
  • 3.优化测试模块，分离多个子模块
  • 4.新增RabbitMQ和WebSocket集成
  • 5.多个工具类优化
• v5.4.3 20190222
  • 1.优化异常处理和日志打印
  • 2.修复BUG
• v5.4.2 20190124
  • 1.后台管理系统UI更新[去除动画，按钮样式]
  • 2.PDF等工具类更新
  • 3.其他优化
• v5.4.1 20181218
  • 1.新增springmvc与itextpdf快速导出fm模板
  • 2.导入Excel支持注解
  • 3.其它报错、依赖问题解决
• v5.4 20181212
  • 1.Excel导出支持JSON配置、实体类注解
  • 2.Excel导入支持实体类注解
  • 3.新增Nacos分布式配置
• v5.3 20181203&20181203
  • 1.升级Springboot2.1.0
  • 2.生成数据字典现支持Postgresql
• v5.2.3 20181113
  • 1.更新utils包
  • 2.优化OAuth单点登录模块
  • 3.优化Redis&Session序列化
  • 4.优化APP Token
• v5.2.2 20181101
  • 1.升级WebSocket与OAuth模块配置，并优化注释
  • 2.优化其他配置
• v5.2.1 20181019
  • 1.新增服务器备份脚本，支持定时、Docker
  • 2.RabbitMQ支持延迟队列等特性
• v5.2 20180920
  • 1.升级Springboot2.0.5
  • 2.优化Oauth2服务
  • 3.优化错误日志跟踪显示
  • 4.工具类优化
• v5.1.1 20180903
  • 1.后台UI更新
  • 2.新增Excel通过配置读取数据工具类
• v5.1 20180827
  • 1.新增限流模块[RedisLimit]
  • 2.新增网关链路追踪、优化网关路由
• v5.0.8 beta 20180817
  • 1.添加LICENSE
  • 2.优化一些配置和JS
  • 3.修复Excel读取2003版本报错的问题
• v5.0.7 beta 20180809
  • 1.优化配置
  • 2.新增RabbitMQ的ACK机制
• v5.0.6 beta 20180727
  • 1.移除多数据源功能
  • 2.新增对额外yml配置的说明
  • 3.新增网关模块[待完善]
  • 4.新增对postgres的支持
  • 5.优化mybaits生成工具和其他工具类
  • 6.新增Quartz数据库支持和图形化界面、日志可视化
  • 7.其他日志、任务等配置优化
• v5.0.5 beta 20180706
  • 1.新增Quartz任务管理器及界面
  • 2.修改utils包名
• v5.0.4 beta 20180705
  • 1.将mybatis mapperxml移至resources目录
  • 2.修复BUG
• v5.0.3 beta 20180703
  • 1.监控接口更改为OAuth请求模式
  • 2.优化MyBatis对JSON类型的处理
  • 3.新增Excel导出工具、更换JSON处理包为fastxml
  • 4.修复多个异常错误的BUG
• v5.0.2 beta 20180619
  • 1.优化部分目录结构
  • 2.新增支持数据库JSON类型的支持
• v5.0.1 beta 20180612
  • 1.优化实体类和数据库及数据字典生成工具
  • 2.新增gateway模块，下个版本将集中开发网关功能
• v5.0.0 beta 20180611
  • 1.架构优化，轻量化服务
  • 2.优化测试模块，集成更多的服务测试
  • 3.新增OAuth授权服务及三种模式
  • 4.优化打包，集成Docker配置
  • 5.移除全部的拦截器，更换为AOP，包括请求日志、权限、统一的错误处理等
  • 6.解决部分依赖不兼容的问题，修复个别BUG
• v4.8 20180507
  • 1.优化Jar依赖关系
  • 2.新增AMPQ、ELK等组件
  • 3.移除model模块
• v4.7.1 20180423
  • 1.完善系统架构文档说明
  • 2.优化日志、Sys、Redisson等服务的配置
• v4.7 20180403
  • 1.修复BUG
  • 2.优化参数和部署脚本
• v4.6 beta2 20180327
  • 1.增强系统稳定性
  • 2.修复BUG
• v4.6 beta1 20180315
  • 1.升级核心框架：SpringBoot 2.0/SpringCloud Finchley.M7
  • 2.优化各种组件的兼容性问题
  • 3.优化并简化yml配置
  • 4.新增测试模块，测试DEMO
  • 5.其他优化：日志、配置、监控等
• v4.5.1 20180309
  • 1.优化日志输出、拦截器、支付、run脚本
  • 2.新增二维码生成工具
  • 3.新增JenkinsAPI管理，可自动部署
• v4.5 20180303
  • 1.服务组件条件化加载，可单独启用或关闭
  • 2.优化SpringBoot配置、监控服务端UI
  • 3.新增Quartz，可动态管理任务[原SpringSchedule]
  • 4.移除Jedis，使用Spring Template
• v4.4.4 20180227
  • 1.添加了服务消费示例[service-order]
  • 2.分离监控配置文件
  • 3.整合测试DEMO[web-front]
  • 4.下个版本将集中优化模块依赖、服务加载和配置
• v4.4.3 20180225
  • 1.优化服务端启动脚本
  • 2.删除支付宝SDK本地Jar，替换为Maven
  • 3.修复日志文件名称为undefined的问题
• v4.4.2 20180208
  • 1.服务监控中心和配置中心(cloud-server)
  • 2.优化日志、上传、定时任务配置
  • 3.修复Maven打包后程序出现文件找不到的问题
• v4.4.1 20180202
  • 1.新增模块删除和地址导出功能
  • 2.更新fa图标库，优化CSS效果
  • 3.服务监控中心[Test]
• v4.4 20180130
  • 1.更新springboot-druid-starter
  • 2.新增druid数据源监控
  • 3.多数据源配置和自动切换及事务
  • 4.修复了部分名称和变量引起的BUG
• v4.3.1 20180129
  • 1.修复若干问题
  • 2.新增对上传、富文本、Select2等插件的BS验证
  • 3.优化了js注释和参数命名
  • 4.优化Tomcat性能
• v4.3 20180126
  • 1.集成Openfire+Smack即时通信服务
  • 2.集成微信支付SDK，新增多个接口
• v4.2.2 20180119
  • 1.优化日志服务
  • 2.自动生成实体类工具现可以生成HTML
  • 3.优化支付宝微信接口
• v4.2.1 20180116
  • 1.集成Spring WebSocket并与Redis Session集成
  • 2.优化目录结构，暂时关闭不需要的组件服务
  • 3.通过ConfigurationProperties进行配置
• v4.2 20180109
  • 1.集成spring activemq
  • 2.集成boot-admin服务监控[front]
  • 3.优化代码和目录结构
• v4.1 20180104
  • 1.集成Spring Redisson分布式事务
  • 2.Spring Session Redis管理
  • 3.Spring Redis缓存管理
  • 4.FastDFS基于SpringBoot配置
  • 5.集成SpringCloud服务发现
  • 6.SpringBoot 监控[测试]
• v4.0 20171218
  • 1.基于SpringBoot构建
  • 2.集中文件配置
  • 3.更新为Logback日志管理
  • 4.优化多个核心组件的配置
  • 5.基于Maven的一键式打包
• v3.7.1 20171103
  • 1.修复BUG
• v3.7 20171022
  • 1.更新页面模板：Freemarker
  • 2.集成Flume日志
• v3.6.1 20171016
  • 1.新的分页插件：pageHelper
  • 2.优化dataTables
• v3.6 20171012
  • 1.新增Spring Data Session
  • 2.升级Spring至4.3.11
  • 3.优化日志服务
• v3.5.5 20170930
  • 1.新增Quartz管理器
  • 2.优化日志服务
  • 3.新增地址插件
  • 4.优化部分JS插件
• v3.5.4 20170921
  • 1.新增后台模块管理
  • 2.新增阿里云服务
  • 3.优化日志服务
• v3.5.3 20170825
  • 1.优化后台页面和部分JS插件
  • 2.优化支付接口和推送接口
• v3.5.2 20170801
  • 1.优化Redis服务
  • 2.优化AppToken服务
• v3.5.1 20170620
  • 1.优化SQL查询和实体类查询
  • 2.新增第三方验证码接口
  • 3.新增多个Util工具类
  • 4.新增和优化PC/APP上传插件和服务端
  • 5.新增Redis服务和AppToken
• v3.4.3 20170525
  • 1.更新部分SQL稳定性
  • 2.新增第三方支付和推送接口
• v3.4.2 20170424
  • 1.新增FastDFS文件存储
  • 2.模块分层，优化结构
  • 3.统一的异常处理
• v3.4.1 20170324
  • 1.新增地址和图片上传组件
  • 2.优化封装的JS插件
• v1.x 20160601
  • JFrame项目Start