README ¶
chao-cloud: springboot 拓展工具包
以 spring-boot 为基础,集成feign,微信sdk,百度ai等第三方工具,以及自定义接口权限拦截,表情处理,ftp连接池,地图坐标解析,mybatis-plus 代码自动生成,token防止表单重复提交,语音处理,敏感词过滤,分词器,参数校验等
chao-cloud
│
├─common //工具包
│ ├─core //核心
│ ├─extra //拓展
│ └─config //配置
│
└─......
chao-cloud 提供以下功能
- package-包结构
- chao-cloud-common-core
- chao-cloud-common-extra
- chao-cloud-common-config
maven 安装(以下为逐级依赖) 一般直接依赖 [config] 即可
parent(pom)
<dependency>
<groupId>com.github.chaojunzi</groupId>
<artifactId>chao-cloud-parent</artifactId>
<version>1.0.9</version>
</dependency>
core核心↑
<dependency>
<groupId>com.github.chaojunzi</groupId>
<artifactId>chao-cloud-common-core</artifactId>
<version>1.0.9</version>
</dependency>
extra 第三方依赖↑
<dependency>
<groupId>com.github.chaojunzi</groupId>
<artifactId>chao-cloud-common-extra</artifactId>
<version>1.0.9</version>
</dependency>
config 注解和配置↑
<dependency>
<groupId>com.github.chaojunzi</groupId>
<artifactId>chao-cloud-common-config</artifactId>
<version>1.0.9</version>
</dependency>
调用方法
chao-cloud 几乎所有功能都采取插件化处理,以注解和配置文件(yaml语法),在启动类配置即可
> package-包结构
1.chao-cloud-common-core
│
└─com.chao.cloud.common
├─annotation //注解,递归树,参数解析
├─base //接口工具,一些默认的公共方法
├─constant //常量和枚举,返回码,错误信息
├─core //核心包,Application,SpringUtil
├─entity //公共实体类,Response,Tree
├─exception //异常类,BusinessException
├─util //工具类,透明背景验证码,权限(2的权的和)校验,EntityUtil递归树,list转换
└─web //web(全局参数校验,controller拦截,全局异常,核心,健康检查,资源访问,参数解析等)
├─annotation //注解 application crypto exception sign valid web
├─config //配置 application controller crypto sign valid web
├─controller //controller 代理-> 执行时间统计,健康检查,返回值处理等
├─crypto //接口参数解密
└─sign //接口参数签名
2.chao-cloud-common-extra
│
└─com.chao.cloud.common.extra
├─access //接口访问控制(错误次数和超时时间)
├─emoji //表情过滤(接口层)
├─feign //spring-cloud 微服务间接口调用(可传递文件)
├─ftp //ftp连接池
├─map //地图解析(地址转坐标,距离计算一对多)
├─mybatis //mybatis 日志,代码自动生成,乐观锁,分页
├─token //拦截表单重复提交
├─tx //微服务分布式事务(springcloud+seata+feign)
├─voice //百度AI-语音转文字
├─wx //微信支付,微信小程序(单例)
└─xss //xss 跨站点脚本编制
3.chao-cloud-common-config
│
└─com.chao.cloud.common.config
├─auth //接口权限校验
├─cors //跨域访问
├─cron //cron 定时器
├─redis //redis 缓存
├─sensitive //敏感词过滤
├─thread //线程池-ThreadPoolTaskExecutor
└─tokenizer //分词器(可自定义词库)
> 递归树
//方法一:(接口法)
@Data
@Accessors(chain = true)
@NoArgsConstructor(staticName = "of")
public class TreeDTO implements TreeEntity<TreeDTO> {
private Integer id; // id
private Integer parentId;// 父id
private List<TreeDTO> subList;// 子集
@Override
public Serializable getId() {
return id;
}
@Override
public Serializable getParentId() {
return parentId;
}
@Override
public void setSubList(List<TreeDTO> subList) {
this.subList = subList;
}
}
//递归处理
public static void main(String[] args) {
List<TreeDTO> list = new ArrayList<>();
list.add(TreeDTO.of().setId(1).setParentId(0));
list.add(TreeDTO.of().setId(2).setParentId(0));
list.add(TreeDTO.of().setId(3).setParentId(1));
list.add(TreeDTO.of().setId(4).setParentId(2));
list.add(TreeDTO.of().setId(5).setParentId(2));
List<TreeDTO> treeList = EntityUtil.toTreeList(list, 0);
Console.log(JSONUtil.toJsonPrettyStr(treeList));
}
//方法二:(注解法)
@Data
@Accessors(chain = true)
@NoArgsConstructor(staticName = "of")
public class TreeDTO {
@TreeAnnotation(TreeEnum.ID)
private Integer id; // id
@TreeAnnotation(TreeEnum.PARENT_ID)
private Integer parentId;// 父id
@TreeAnnotation(TreeEnum.SUB_LIST)
private List<TreeDTO> subList;// 子集
}
//递归处理
public static void main(String[] args) {
List<TreeDTO> list = new ArrayList<>();
list.add(TreeDTO.of().setId(1).setParentId(0));
list.add(TreeDTO.of().setId(2).setParentId(0));
list.add(TreeDTO.of().setId(3).setParentId(1));
list.add(TreeDTO.of().setId(4).setParentId(2));
list.add(TreeDTO.of().setId(5).setParentId(2));
List<TreeDTO> treeList = EntityUtil.toTreeAnnoList(list, 0);
Console.log(JSONUtil.toJsonPrettyStr(treeList));
}
//结果
[
{
"subList": [
{
"subList": [
],
"id": 3,
"parentId": 1
}
],
"id": 1,
"parentId": 0
},
{
"subList": [
{
"subList": [
],
"id": 4,
"parentId": 2
},
{
"subList": [
],
"id": 5,
"parentId": 2
}
],
"id": 2,
"parentId": 0
}
]
> 透明背景验证码
HyalineCircleCaptcha captcha = HyalineCaptchaUtil.createCircleCaptcha(100, 42, 4, 3);
String code = captcha.getCode();
log.info("[验证码: {}]", code);
> Spring-核心配置
@EnableCore
- 说明
- 在启动类增加@EnableCore
- 可使用全局 SpringContextUtil 处理相关bean
- 可实现接口 [IApplicationRestart] 做一些容器启动后的相关操作
> 全局异常处理
@EnableGlobalException
- 说明
- 在启动类增加@EnableGlobalException
> 全局参数校验
@EnableValidator
//简单用法
@Null 被注释的元素必须为 null
@NotNull 被注释的元素必须不为 null
@AssertTrue 被注释的元素必须为 true
@AssertFalse 被注释的元素必须为 false
@Min(value) 被注释的元素必须是一个数字,其值必须大于等于指定的最小值
@Max(value) 被注释的元素必须是一个数字,其值必须小于等于指定的最大值
@DecimalMin(value) 被注释的元素必须是一个数字,其值必须大于等于指定的最小值
@DecimalMax(value) 被注释的元素必须是一个数字,其值必须小于等于指定的最大值
@Size(max=, min=) 被注释的元素的大小必须在指定的范围内
@Digits (integer, fraction) 被注释的元素必须是一个数字,其值必须在可接受的范围内
@Past 被注释的元素必须是一个过去的日期
@Future 被注释的元素必须是一个将来的日期
@Pattern(regex=,flag=) 被注释的元素必须符合指定的正则表达式
Hibernate Validator 附加的 constraint
@NotBlank(message =) 验证字符串非null,且长度必须大于0
@Email 被注释的元素必须是电子邮箱地址
@Length(min=,max=) 被注释的字符串的大小必须在指定的范围内
@NotEmpty 被注释的字符串的必须非空
@Range(min=,max=,message=) 被注释的元素必须在合适的范围内
- 说明
- 在启动类增加@EnableValidator
- 国际化
- 使用方式:
- 在Controller 添加注解 @Validated
- 在method-> 基本类型 前添加注解 @NotNull
- 在method-> String 前添加注解 @NotBlank
- 在method-> 对象 前添加注解 @Valid
- 详情请点击@参考1-普通版
- 详情请点击@参考2-springboot版
- 详情请点击github@hibernate-validator
- 在启动类增加@EnableValidator
> 接口参数解密
@EnableCrypto
//简单用法
@Crypto //需要解密的参数
//yaml
chao:
cloud:
crypto:
charset: UTF-8 #编码方式
order: 1 #切面的执行顺序,1为第一
proxy-target-class: true #CGLib动态代理织入增强
interceptor-names: cryptoInterceptor #拦截器的@Bean(name=) 默认已实现
keys: #针对前端参数的不同加密方式进行配置
DES: #对称加密
secret-key:
RSA: #非对称加密
private-key:
public-key:
- 说明
- 在启动类增加@EnableCrypto
- 使用方式:
- 在method-> 参数前添加注解 @Crypto(CryptoTypeEnum)
- 注:可用于String类型的参数或Bean中 String类型的属性
- 范围:String String[] List Set Map<String,String> Bean(String 字段)
> 接口参数签名
@EnableSign
//简单用法
@Sign //需要签名的参数
//yaml
chao:
cloud:
sign:
order: 11 #比【接口参数解密】要靠后一些执行
proxy-target-class: true #CGLib动态代理织入增强
interceptor-names: signInterceptor #拦截器的@Bean(name=) 默认已实现
sign-type: MD5 #签名方式 MD5|SHA1|SHA256
timeout: 60 #超时时间默认60秒
- 说明
- 在启动类增加@EnableSign
- 使用方式:
- 服务端:在method-> 参数前前添加注解 @Sign
- 前端:在header中添加请求头(http请求)
- Sign:参数签名为对Map参数按照key的顺序排序后拼接为字符串,然后根据提供的签名算法生成签名字符串 {k}{v}{k}{v}{k}{v}...(包含:Timestamp{时间戳毫秒数})
- Timestamp:当前时间的毫秒数
- 注:可用于简单值类型的参数或Bean中 简单值类型的属性以及Map接收的简单值参数
- 范围:String等简单值类型 Map<String,Object> Bean(简单值 字段)
> web
@EnableWeb
//yaml 配置
spring:
resources: #这里必须使用字符串 后面的 / 必须有,多个路径逗号分割(越靠前,优先级越高;默认包含下面4个路径,且高于下面的优先级)
static-locations: file:/path/static/
- 说明
- 在启动类增加@EnableWeb
- 默认集成@EnableValidator
- 默认集成@EnableCore
- 默认集成AOP->参数拦截器->ConvertInterceptor
- 默认集成健康检查:HealthController [/health/core]
- ip: 主机地址
- macAddress: 物理地址
- threadCount: 线程数
- freeMemory: 剩余可用内存
- totalMemory: 总内存
- useMemory: 已经使用内存
- useRate: 使用比率
- 默认集成静态资源访问:spring.resources.static-locations
- classpath:/META-INF/resources/
- classpath:/resources/
- classpath:/static/
- classpath:/public/
- 在启动类增加@EnableWeb
> 新建一个web项目
//1.创建启动类
@SpringBootApplication
@EnableWeb // web
@EnableGlobalException // 全局异常处理
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
//2.yaml 配置
logging.config: classpath:chao-logback.xml
log.path: /logs/${spring.application.name}
log.maxHistory: 30
server:
port: 8080 #端口
spring:
application:
name: ApplicationName
output:
ansi: #彩色日志
enabled: always
//3.maven-pom
<parent>
<groupId>com.github.chaojunzi</groupId>
<artifactId>chao-cloud-parent</artifactId>
<version>1.0.9</version>
</parent>
<dependencies>
<dependency>
<groupId>com.github.chaojunzi</groupId>
<artifactId>chao-cloud-common-config</artifactId>
<version>${chao.cloud.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
- 说明
- 在启动类增加@SpringBootApplication
- 在启动类增加@EnableWeb
- 在启动类增加@EnableGlobalException
- 自定义接口->end
> 接口访问控制
@EnableAccessLimit
- 说明
- 在启动类增加@EnableAccessLimit
- 方法method增加@AccessLimit(Controller)
- timeout: 拦截持续时间
- count: 最大出错次数
- enable: 是否可用,false,此注解将无效。
> 表情过滤
@EnableEmojiFilter
- 说明
- 在启动类增加@EnableEmojiFilter
- 方法method增加@EmojiFilter(Controller)
- value: 是否可用,false,将不参与拦截。
> feign微服务接口调用
@EnableFeign
//yaml 配置文件
chao:
cloud:
feign:
request:
connect-timeout: #连接超时
read-timeout: #读超时
write-timeout: #写超时
maxIdleConnections: #最大连接数
keepAliveDuration: #保持连接时间(分钟)
- 说明
- 在启动类增加@EnableFeign
- 方法method增加@FeignFallback(Controller 接口格式请自行查阅官方文档)
- 文件传输MultipartFile::name 数组必须为files
> ftp连接池
@EnableFtp
//业务类注入
@Autowired
private IFileOperation fileOperation;
//yaml 配置文件
chao:
cloud:
ftp:
config:
username: #用户名
password: #密码
host: #主机
port: #端口
path: #文件夹根目录
logo: #文字水印
- 说明
- 在启动类增加@EnableFtp
- 在调用类注入 IFileOperation
> license
@EnableLicenseCreator
@EnableLicenseVerify
<!-- License -->
<dependency>
<groupId>de.schlichtherle.truelicense</groupId>
<artifactId>truelicense-core</artifactId>
</dependency>
- 说明
- 在启动类增加@EnableLicenseCreator-生成
- 在启动类增加@EnableLicenseVerify-校验
> 地图解析
@EnableMapAnalysis
//业务类注入
@Autowired
private MapService mapService;
//yaml 配置文件
chao:
cloud:
map:
key: #腾讯地图申请key
- 说明
- 在启动类增加@EnableMapAnalysis
- 在调用类注入 MapService
> mybatis-plus
//maven
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid-spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
</dependency>
@MybatisPlusConfig
//yaml 配置文件
mybatis-plus:
configuration:
map-underscore-to-camel-case: true #sql 实体类驼峰下划线转换
log-impl: com.chao.cloud.common.extra.mybatis.log.Slf4jLogImpl #日志打印
- 说明
- 在启动类增加@MybatisPlusConfig
- 默认集成乐观锁和分页插件
- 详情请点击原创@mybatis-plus
> mybatis-plus-generator
//maven
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-generator</artifactId>
</dependency>
@EnableMybatisGenerator
//业务类注入
@Autowired
private ZipAutoGenerator autoGenerator;
//yaml 配置文件
#默认使用本地数据源-代码自动生成
chao:
cloud:
codegen: #代码自动生成
before:
template-style: rest #rest 风格
datasource:
url: ${spring.datasource.url}
username: ${spring.datasource.username}
password: ${spring.datasource.password}
driver-name: ${spring.datasource.driver-class-name}
package:
parent: com.chao.cloud.generator #上级包名
global:
author: #作者
strategy:
logic-delete-field-name: deleted #逻辑删除
- 说明
- 在启动类增加@EnableMybatisGenerator
- 在调用类注入 ZipAutoGenerator
- 使用:autoGenerator.execute(out); //out 为输出流
- 案例@chao-cloud-generator
- 详情请点击原创@mybatis-plus-generator
> sharding-jdbc
@EnableShardingExtra
<!-- sharding 分库分表 -->
<dependency>
<groupId>org.apache.shardingsphere</groupId>
<artifactId>sharding-jdbc-spring-boot-starter</artifactId>
</dependency>
- 说明
- 在启动类增加@EnableShardingExtra
> 防止表单重复提交
@EnableFormToken
- 说明
- 在启动类增加@EnableFormToken
- 方法method增加@FormToken(Controller)
- save: 添加session[uuid]。
- remove: 删除session[uuid]。
- 表单 input name="formToken"
- 目前只支持session,后续将支持redis等
> seata-分布式事务
@EnableTxSeata
//yaml 配置
chao:
cloud:
tx:
seata:
server-addr: # seata->nacos地址
namespace: # seata->nacos命名空间 默认 空
cluster: # seata->集群标识 默认 default
- 说明
- 在启动类增加@EnableTxSeata
- 目前只支持 nacos+feign+seata
- demo->chaojunzi@分布式事务微服务
> 语音识别-百度AI
@EnableVoiceAI
//业务类注入
@Autowired
private SpeechRecognitionService speechRecognitionService;
//yaml 配置
chao:
cloud:
ai:
voice:
client:
app-id: #百度语音ai申请
secret-key: #百度语音ai申请
api-key: #百度语音ai申请
timeout-connection: #连接时间
timeout-socket: #超时时间
- 说明
- 在启动类增加@EnableVoiceAI
- 在调用类注入 SpeechRecognitionService
- 详情请点击@百度ai-语音识别
> 微信小程序
@EnableWxMaSingleton
//业务类注入
@Autowired
private WxAppUserInfoApi wxAppUserInfoApi;
//yaml 配置
chao:
cloud:
wx:
ma:
config:
appid: #微信平台申请
secret: #微信平台申请
- 说明
- 在启动类增加@EnableWxMaSingleton
- 在调用类注入 WxAppUserInfoApi
- 详情请点击@WxJava-sdk
- 详情请点击@小程序开发文档
> 微信支付
@EnableWxPaySingleton
//业务类注入
@Autowired
private WxPayService wxPayService;
//yaml 配置
chao:
cloud:
wx:
pay:
config:
app-id: #微信平台申请
mch-id: #微信平台申请
mch-key: #微信平台设置
notify-url: #支付结果回调地址
- 说明
- 在启动类增加@EnableWxPaySingleton
- 在调用类注入 WxPayService
- 详情请点击@WxJava-sdk
- 详情请点击@微信支付开发文档
> XSS
@EnableXssFilter
//yaml 配置
chao:
cloud:
xss:
filter-name: XSSFilter #过滤器名字
order: 0 #过滤器执行顺序
url-patterns: #匹配的路径
- 说明
- 在启动类增加@EnableXssFilter
- XSS 跨站点脚本编制
> 接口权限校验
@EnableAuthUser
//格式(自定义)
//1.UserTypeEnum
public enum UserTypeEnum {
STUDENT(1), // 学生
VISITOR(0); // 游客
Integer type;
UserTypeEnum(Integer type) {
this.type = type;
}
public Integer getType() {
return type;
}
}
//2.UserStatusEnum
public enum UserStatusEnum {
FREEZE(0),//冻结
PASS(1),//正常
NOT_PERFECT(2);//未完善
public Integer status;
UserStatusEnum(Integer status) {
this.status = status;
}
}
//3.PermConstant
/**
* 命名规范:
* - [Set<Integer> ERROR_PERM] 必须存在
* - TYPE_STATUS 用户类型_用户状态
* - int 值不可以重复
*/
public interface PermConstant {
/**
* 错误权限
*/
Set<Integer> ERROR_PERM = CollUtil.newHashSet(PermConstant.FREEZE);
/**
* 冻结用户-(不可访问)
*/
int FREEZE = -1;
/**
* 游客 (必须进行转型-只有查看功能)
*/
int VISITOR = 0;
/**
* 学生
*/
int STUDENT_PASS = 1;
/**
*学生-未完善
*/
int STUDENT_NOT_PERFECT = 2;
}
//yaml 配置
chao:
cloud:
auth:
type: UserTypeEnum #枚举
status: UserStatusEnum #枚举
perm: PermConstant #常量
- 说明
- 在启动类增加@EnableAuthUser
- 方法method增加@Permission(Controller)
- hasPerm: 权限列表:PermConstant(数组)
- retCode: 返回值错误码 默认 0403
- retMsg: 返回值信息
- 注:UserTypeEnum
- 必须存在 type 属性 类型为Integer
- 注:UserStatusEnum
- 必须存在 status 属性 类型为Integer
- 注:PermConstant
- 必须存在 [Set ERROR_PERM],且有初始化赋值
> 跨域访问
@EnableCors
- 说明
- 在启动类增加@EnableCors
- 允许任何域名
- 允许任何头
- 允许任何方法
- 在启动类增加@EnableCors
> cron-定时器
@EnableCron
- 说明
- 在启动类增加@EnableCron
- 实现接口 com.chao.cloud.common.config.cron.task.CronTask
- 方法一:注入Spring 容器即可. 如 @Component
- 方法二:CronService.schedule(CronTask task);
- 删除:CronService.remove(String id);
- 列表:CronService.list();
- 在启动类增加@EnableCron
> redis
//maven
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
@EnableRedisCache
//业务类注入
@Autowired
private IRedisService redisService;
//yaml 配置文件
spring:
redis:
host: 127.0.0.1
port: 6379
password: #密码
- 说明
- 在启动类增加@EnableRedisCache
- 在调用类注入 IRedisService
- 详情请点击原创@whvcse/RedisUtil
> 敏感词过滤
@EnableSensitiveWord
- 说明
- 在启动类增加@EnableSensitiveWord
- 增加资源文件 config/SensitiveWord.txt
- 每一行为一个词
- 在启动类增加@EnableSensitiveWord
> 线程池
@EnableThreadPool
//yaml 配置
thread:
pool:
async:
core-pool-size: #核心线程数
max-pool-size: #最大线程
keep-alive-seconds: #持续时间
thread-name-prefix: #线程名称前缀
- 说明
- 在启动类增加@EnableThreadPool
> 分词器
@EnableTokenizer
//yaml 配置
chao.cloud.tokenizer.word: #词库以逗号分割 [,]
- 说明
- 在启动类增加@EnableTokenizer
- 词库以逗号分割 [,]
- 在启动类增加@EnableTokenizer
环境依赖
jdk1.8+↑
Eclipse 4.7(Oxygen[氧气])+↑
maven阿里云仓库
开发工具请安装lombok
版权
Apache License Version 2.0
- 如不特殊注明,所有模块都以此协议授权使用。
- 任何使用了chao-cloud的全部或部分功能的项目、产品或文章等形式的成果必须显式注明chao-cloud。
NPL (The 996 Prohibited License)
- 不允许 996 工作制度企业使用该开源软件
其他版权方
- 实施上由个人维护,欢迎任何人与任何公司向本项目开源模块。
- 充分尊重所有版权方的贡献,本项目不占有用户贡献模块的版权。
鸣谢
感谢下列优秀开源项目:
感谢诸位用户的关注和使用,chao-cloud并不完善,未来还恳求各位开源爱好者多多关照,提出宝贵意见。
作者 [@chaojunzi 1521515935@qq.com]
2019年8月13日
Click to show internal directories.
Click to hide internal directories.