Spring Speed 是一个基于Spring Boot & MyBatis的种子项目

简介

Spring Speed 是一个基于Spring Boot & MyBatis的种子项目，用于快速构建中小型API、RESTful API项目，该种子项目已经有过多个真实项目的实践，稳定、简单、快速，使我们摆脱那些重复劳动，专注于业务代码的编写，减少加班。下面是一个简单的使用演示，看如何基于本项目在短短几十秒钟内实现一套简单的API，并运行提供服务。

特征&提供

• 最佳实践的项目结构、配置文件、精简的POM
• 统一响应结果封装及生成工具
• 统一异常处理
• 简单的接口签名认证
• 常用基础方法抽象封装
• 使用Druid Spring Boot Starter 集成Druid数据库连接池与监控
• 使用FastJsonHttpMessageConverter，提高JSON序列化速度
• 集成MyBatis、通用Mapper插件、PageHelper分页插件，实现单表业务零SQL
• 提供代码生成器根据表名生成对应的Model、Mapper、MapperXML、Service、ServiceImpl、Controller等基础代码，其中Controller模板默认提供POST和RESTful两套，根据需求在CodeGenerator.genController(tableName)方法中自己选择，默认使用POST模板。代码模板可根据实际项目的需求来扩展，由于每个公司业务都不太一样，所以只提供了一些比较基础、通用的模板，主要是提供一个思路来减少重复代码的编写，我在实际项目的使用中，其实根据公司业务的抽象编写了大量的模板。另外，使用模板也有助于保持团队代码风格的统一
• 另有彩蛋，待你探索  

快速开始(项目中引入tkMybatis实现代码自动生成)

1. 克隆项目
2. 对test包内的代码生成器CodeGenerator进行配置，主要是JDBC，因为要根据表名来生成代码
3. 如果只是想根据上面的演示来亲自试试的话可以使用test resources目录下的demo-user.sql，否则忽略该步
4. 输入表名，运行CodeGenerator.main()方法，生成基础代码（可能需要刷新项目目录才会出来）
5. 根据业务在基础代码上进行扩展
6. 对开发环境配置文件application-dev.properties进行配置，启动项目，Have Fun！  

开发建议

• 表名，建议使用小写，多个单词使用下划线拼接(貌似出了故障，建议使用全小写无下划线)
• Model内成员变量建议与表字段数量对应，如需扩展成员变量（比如连表查询）建议创建DTO，否则需在扩展的成员变量上加@Transient注解，详情见通用Mapper插件文档说明
• 建议业务失败直接使用RRException("message")抛出，由统一异常处理器来封装业务失败的响应结果，比如throw new ServiceException("该手机号已被注册")，会直接被封装为{"code":400,"message":"该手机号已被注册"}返回，无需自己处理，尽情抛出
• 需要工具类的话建议先从apache-commons-*和guava中找，实在没有再造轮子或引入类库，尽量精简项目
• 开发规范建议遵循阿里巴巴Java开发手册
• 建议在公司内部使用ShowDoc、SpringFox-Swagger2 、RAP等开源项目来编写、管理API文档 

技术选型&文档

• Spring Boot（查看Spring Boot学习&使用指南）
• MyBatis（查看官方中文文档）
• MyBatisb通用Mapper插件（查看官方中文文档）
• MyBatis PageHelper分页插件（查看官方中文文档）
• Druid Spring Boot Starter（查看官方中文文档）
• Fastjson（查看官方中文文档）
• 其他略

最新更新整合

• 项目中引入kaptcha用于生成验验证码
• 项目引入shiro实现权限控制，oauth过滤在configurer/ShiroConfigurer类中
• 接口认证目前决定不再使用（原OwnWebMvcConfigurer），采用前后端分离方式（token表格存储，基础需要三张表：用户表、Token表、验证码表）
• 统一异常处理排除，采用@RestControllerAdvice注解实现控制器内异常统一管理
• 项目中引入微信登陆和微信支付，pom中已经引入工具包，相关配置在application.properties中修改即可
• 项目中已经引入Swagger2实现接口在线生成，案例可以查看web/WxLoginController类中checkAnswer方法

##测试SQL

SET FOREIGN_KEY_CHECKS=0;
-- ----------------------------
-- Table structure for sys_captcha
-- ----------------------------
DROP TABLE IF EXISTS `sys_captcha`;
CREATE TABLE `sys_captcha` (
  `uuid` char(36) NOT NULL COMMENT 'uuid',
  `code` varchar(6) NOT NULL COMMENT '验证码',
  `expiretime` datetime DEFAULT NULL COMMENT '过期时间',
  PRIMARY KEY (`uuid`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
-- ----------------------------
-- Table structure for sys_user
-- ----------------------------
DROP TABLE IF EXISTS `sys_user`;
CREATE TABLE `sys_user` (
  `userid` bigint(20) NOT NULL AUTO_INCREMENT,
  `username` varchar(50) NOT NULL COMMENT '用户名',
  `password` varchar(100) DEFAULT NULL COMMENT '密码',
  `salt` varchar(20) DEFAULT NULL COMMENT '盐',
  `email` varchar(100) DEFAULT NULL COMMENT '邮箱',
  `mobile` varchar(100) DEFAULT NULL COMMENT '手机号',
  `status` tinyint(4) DEFAULT NULL COMMENT '状态  0：禁用   1：正常',
  `createtime` datetime DEFAULT NULL COMMENT '创建时间',
  PRIMARY KEY (`userid`),
  UNIQUE KEY `username` (`username`)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8 COMMENT='系统用户';
-- ----------------------------
-- Table structure for sys_user_token
-- ----------------------------
DROP TABLE IF EXISTS `sys_user_token`;
CREATE TABLE `sys_user_token` (
  `userid` bigint(20) NOT NULL,
  `token` varchar(100) NOT NULL COMMENT 'token',
  `expiretime` datetime DEFAULT NULL COMMENT '过期时间',
  `updatetime` datetime DEFAULT NULL COMMENT '更新时间',
  PRIMARY KEY (`userid`),
  UNIQUE KEY `token` (`token`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='系统用户Token';