简介
framework 是一个基于 Spring Boot 2.2.0.RELEASE 和 MyBatis 构建的快速开发的种子项目，适用广大的中小型公司构建API、Restful API的脚手架。该项目从众多实际项目中剥离出来，简单、易用、易拓展，加快我们开发的速度，减少我们苦逼的加班。官方唯一直属链接：地址
框架特性
- 简单的项目结构、明确的业内技术规范
- 集成常见RBAC权限控制模型，做到方法级别的细粒度权限控制
- 统一的相应结果封装，便于前后端调试
- 异常统一处理，开发模式下返回详细异常信息，生产环境屏蔽后台错误
- 对多线程开发进行封装，简化企业级的线程开发的难度
- 集成Druid连接池和监控技术
- 使用Mybatis-Plus来简化Dao层开发，做到单表业务无SQL。屏蔽复杂的PageHelper分页插件，使用内置的IPage进行分页，简单便捷
- 拦截常见CSRF攻击和SQL注入，保护Web安全
- 使用JWT保护token安全，并使用拦截器弥补token的有效期的缺点
- 特别适合前后端后分离的项目开发(无缝与Vue、Flutter、Android、IOS)衔接
- 基于当前最新的Spring Boot 2.2.0.RELEASE稳定版，尝鲜最新特性
环境要求
- JDK 8+
- Maven 3.3+
- Redis 3.0+
- MySQL 5.5+
快速上手
clone项目- 在数据库初始化
init.sql脚本，并修改相应的数据库连接信息 - 安装Redis(单机版Redis和Redis Cluster均支持)，启动后在配置文件中修改相应的连接信息
- 项目启动成功
- 注册一个接口的调用端，获取accessKey。默认客户端为
901935449cea420d910643b5582cb13d - 默认的初始化用户名和密码是admin（123456）
- 使用Restful工具进行接口测试。注意所有非
/interface开头的接口均需在头部或请求体中携带access-key,token,csrf这三个参数，用于用户身份校验及其他功能实现
开发建议
- Java代码规范建议参考《阿里巴巴Java开发手册》（最新版下载)
- 不建议使用
@autowired进行注入，建议使用CHERRY.SPRING_CONTEXT.getBean(xxx.class)获取Spring容器中的bean - 建议系统接口以
/api开头，给第三方暴露的接口,不需要认证的接口以/interface开头 - 建议所有业务代码均按照JavaDoc的方式编写注释，尤其当你参与到一些比较大的项目时，你就知道我为啥把规范放到技术的前面
- 数据库设计：表名命名规范
业务模块_tableName;列名命名规范namelogin_name多个单词使用下划线，切勿使用关键字 - 工具类：建议先从
apache-commons-*和guava里面找，避免重复造轮子 - 接口文档：建议使用SwaggerUI、ShowDoc等
调用示例
- 登录接口
保存csrf和token.用于后续的需要鉴权的接口使用。
- 注册接口
- 系统接口(拥有权限)
以/api/example接口为例。通过rbac的关系我们可以看出admin用户拥有操作其接口的权限。
返回200，去数据库查看example发现多一条新纪录。而在传递头部参数的时候，如果csrf、token、ak有任意一个不传和传递错误的，后台都会报出相应的错误提示。
- 系统接口(没有权限)
以/api/paths接口为例。通过rbac的关系我们可以看出admin用户不拥有操作其接口的权限。
返回403，提示权限不足。此时头部传递三个头部参数。
- 第三方接口
以/interface/props接口为例。
通过结果发现调用成功。而此时头部并没有传递任何参数。
技术文档
- Spring Boot （查看Spring Boot学习&使用指南）
- MyBatis（查看官方中文文档）
- MyBatis-Plus（查看官方中文文档）
- Druid Spring Boot Starter（查看官方中文文档）
- FastJSON（查看官方中文文档）
- …
License
