Skip to content

springboot2.x 脚手架 日志,缓存,分布式锁,分页,权限认证,等开箱即用

License

Notifications You must be signed in to change notification settings

senssic/sc-whorl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sc-whorl

项目简介

License JDK 1.8+

sc-whorl是一个基于springboot2.x的微服务开发脚手架,整合了多种开源框架配置,可以作为领域单体直接进行使用,可以根据自己的实际需求进行二次开发和扩展.

此项目不但包括springBoot体系相关的配置集成示例,还包括了一些自定义的注解以及注解实现.包括防重提交注解,限流注解,常用验证注解以及扩展,另外为了方便开发还增加了对于统一日志打印,统一异常处理,分页,分布式锁等基础服务等一些常用规范示例.

项目使用技术栈

  • springboot2.0
  • docker +docker plugin
  • mybatis +pageHelper
  • redis
  • springSecurity+jwt
  • swagger2
  • mysql
  • Spring Boot Cache
  • Srping Boot Mail

自定义注解说明

@limit 应用服务器限流注解

//限流 10秒内最多允许1000次访问
@Limit(key = "USER:LOGIN", period = 10, count = 1000)
public MsgResponseBody<JWTUserDetail> login(@RequestJsonParam("userName") String userName, @RequestJsonParam("passWord") String passWord) {
}

注解字段说明

//资源的名字
String name() default "";
//资源的key
String key() default "";
//Key的前缀
String prefix() default "";
//给定的时间段,单位秒
int period();
//最多的访问限制次数
int count();
//类型
LimitType limitType() default LimitType.CUSTOMER;

@PreventResubmitLock & @PreventParam 应用服务防重提交

//默认5秒内同一手机号不可重复提交
@PreventResubmitLock(prefix = "USER:REGISTER")
public MsgResponseBody<String> register(@RequestBody @PreventParam(name = "userPhone") UserVo userVo) {
    userService.register(userVo);
    return MsgResponseBody.success().setResult("注册成功");
}

注解字段说明

@PreventResubmitLock

//redis 锁key的前缀
String prefix() default "";
//轮询锁的时间,过期秒数,默认为5秒
int expire() default 5;
//超时时间单位,秒
TimeUnit timeUnit() default TimeUnit.SECONDS;
//Key的分隔符(默认 :)
String delimiter() default ":";

@PreventParam

//字段名称,即为防止重复提交的入参key,用于反射
String name() default "";

@RequestJsonParam 请求体为json的属性提取

public MsgResponseBody<JWTUserDetail> login(@RequestJsonParam("userName") String userName, @RequestJsonParam("passWord") String passWord) {
}

注解字段说明

//用于绑定的请求参数名字
String value() default "" ;
//是否必须,默认是
boolean required() default true;
//是否是当前json对象,默认false,表示当前josn对象中的某一个值,若是true,则忽略value
boolean current() default false;
//如果是日期类型的,设置其时间.默认为:yyyy-MM-dd HH:mm:ss
String dateFormat() default YMDHMS;

项目部署

  • 新建mysql的whorl库编码格式为UTF-8,导入工程中的whorl_db.sql
  • 修改spring-boot的配置文件,数据库连接,redis连接等指向对应的配置路径
  • 以springboot或dockerFile的方式启动工程

呜谢

部分代码和参考实现来源于网络

感谢

battch

awesome-spring-boot

About

springboot2.x 脚手架 日志,缓存,分布式锁,分页,权限认证,等开箱即用

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published