yue-library
yue-library是一个基于SpringBoot封装的基础库
- 内置丰富的JDK工具
- 自动装配了一系列的基础Bean与环境配置项
- 快速构建SpringCloud项目,让微服务变得更简单
距离上次大版本更新已是数月有余,在这期间yue团队经过不断的使用实践,为大家带来了更多新特性。本次更新主要升级了SpringCloud版本与新增Pay模块、分离加解密模块。接下来计划添加oss、sms等模块。
Greenwich.SR2【2019-09-03】
新特性
- 版本升级注意:
lombok
版本和IDE lombok
版本一致,此版本完善了之前遗留下来的规范,导致部分类与方法失效,但所有失效类与方法都提供了指引说明 - 升级基础依赖:
SpringCloud:Greenwich.SR2
SpringBoot:2.1.6.RELEASE
hutool:4.6.2
fastjson:1.2.59
- 新增
yue-library-base-crypto
模块,基于hutool提供更完善的加解密、签名等操作。提供自动配置全局单例 - 新增
yue-library-pay
模块,基于pay-java-parent进行二次封装,让你真正做到一行代码实现支付聚合,让你可以不用理解支付怎么对接,只需要专注你的业务 JSONObject
参数解析器@PostMapping public Result<?> post(JSONObject paramJson) {
ApplicationContextUtils
普通类操作Spring上下文,更方面的SpringBean操作ServletUtils
对Servlet操作的增强,迁入原有工具类HttpUtils
CookieUtils
- 优化serialVersionUID
- 完善文档-更详细的教程,更多的细节介绍和建议。
快速开始
maven项目,在pom.xml文件中添加如下一段代码,并将${version}
替换为对应版本号:
<parent>
<groupId>ai.ylyue</groupId>
<artifactId>yue-library-dependencies</artifactId>
<version>${version}</version>
</parent>
随后引入所需要的模块
<dependencies>
<dependency>
<groupId>ai.ylyue</groupId>
<artifactId>yue-library-base</artifactId>
</dependency>
...
</dependencies>
yue-library的版本命名方式,采用SpringCloud版本名作为前缀,然后以.1、.2、.3...这种形式,目的是为了方便区分基础依赖版本。
同时所有模块皆依赖于基础库,若需要引入除基础库之外的模块(如:data-jdbc、data-redis),可以不用引入此模块。
配置
yue-library
自动装配了一系列的基础Bean与环境配置项,可在 application.yml 文件中配置关闭,所有配置项皆是以yue.*
开头,如:yue.cors.allow=false
代表不允许跨域。
默认配置项
- ConstantProperties-yue常量配置 (AES密钥、RSA公钥、RSA私钥、Token超时时间、验证码超时时间等)详见:
base
- Validator-校验器 (唯一Bean,可直接覆盖)详见:
base
- RestTemplate-HTTPS客户端 (唯一Bean,可直接覆盖)详见:
base
- DB JDBC数据库操作,建议直接继承
DBDAO 或 DBTDAO
。详见:data-jdbc
- Redis Redis数据库操作,如:分布式锁等。详见:
data-redis
- User 用户Bean,如:登录、token操作等。详见:
data-redis
可选配置项
- ExceptionHandlerConfig-全局统一异常处理
yue.exception-handler.*
详见:base
- AsyncConfig-异步线程池(共用父线程上下文环境,异步执行任务时不丢失token)
yue.thread-pool.async.*
详见:base
- CorsConfig-跨域配置
yue.cors.*
详见:base
- WxMaUser 微信小程序登录Bean
yue.wx.miniapp.*
详见:data-redis
结语
引用此项目作基础依赖,后续也可很好的对于服务架构进行升级(单体架构、集群架构、微服务、SOA微服务)
新开发项目,建议直接以集群架构形式撸代码,不需要一开始就搭建微服务等,可根据业务需求实际出发。(不限于有SOA共享中心的伙伴)