yue-library

yue-library 是一个基于 SpringBoot 封装的基础库

内置丰富的 JDK 工具
自动装配了一系列的基础 Bean 与环境配置项
快速构建 SpringCloud 项目，让微服务变得更简单

收藏一波以表支持吧(≧▽≦)/！本次更新主要完善注释与文档，提供 SpringBoot 模板项目，优化与修复 BUG 为主。接下来计划添加 oss、sms 等模块。

点击查看完整的版本更新日志

Greenwich.SR2.1【2019-10-15】

新特性

完善包注释与类注释，提供更舒爽的 javadoc，完善项目文档，提供更多的代码示例与使用说明。同时优化项目部分代码结构与紧急修复 redis User 类
合并统一异常处理类继承结构，更改redis常量配置属性为可配置属性
【base】增强字段校验器 Validator 类型自动识别与错误参数提示，更加强大方便好用
【base】 Result 新增方法 public <D> List<D> dataToList(Class<D> clazz) {
【base】 Result 新增方法 public <D> D dataToObject(Class<D> clazz) {
【base】 Result 新增方法 public <D> D dataToJavaBean(Class<D> clazz) {
【samples】建立示例项目组结构，添加简单的SpringBoot模版项目 template-simple，用于直接上手开发

Bug修复

【redis】 User 类所依赖的 ConstantProperties 配置未启用，导致的启动异常

工程结构

. yue-library
├── yue-library  基础库
│   ├── yue-library-dependencies  父pom
│   ├── yue-library-base          基础库提供了丰富的Java工具包，同时也自动装配了一系列基础Bean等
│   ├── yue-library-data-jdbc     基于SpringJDBC进行二次封装，拥有着强大性能的同时又不失简单、灵活等
│   ├── yue-library-data-redis    基于SpringRedis进行二次封装，更简单灵活，提供全局token与登录相关特性等
│   ├── yue-library-pay           基于pay-java-parent进行二次封装，让你真正做到一行代码实现支付聚合
│   ├── yue-library-cloud-oss
│   └── yue-library-cloud-sms
├── yue-library-samples  基础库示例
│   ├── yue-library-test			yue-library代码测试项目：单元测试、接口测试、代码示例
│   ├── yue-library-template-simple		yue-library模版：SpringBoot项目模版
│   └── yue-library-template-ssc		yue-library模版：SpringCloud项目模版，SOA共享架构（阿里巴巴中台）
└── yue

快速开始

引入项目依赖

maven项目，在pom.xml文件中添加如下一段代码，并将${version}替换为对应版本号：

<parent>
	<groupId>ai.ylyue</groupId>
	<artifactId>yue-library-dependencies</artifactId>
	<version>${version}</version>
</parent>

随后引入所需要的模块，如基础库：yue-library-base

<dependencies>
	<dependency>
		<groupId>ai.ylyue</groupId>
		<artifactId>yue-library-base</artifactId>
	</dependency>
	...
</dependencies>

版本说明

yue-library的版本命名方式，采用SpringCloud版本名作为前缀，然后以.1、.2、.3...这种形式，目的是为了方便区分所依赖的SpringCloud版本。

yue-library-base为其他模块的基础依赖（简称基础库），所以若需要引入除基础库之外的模块（如：data-jdbc、data-redis），可以不引入yue-library-base。

JDK版本	JDK说明	SpringCloud版本	版本说明
JDK8	LTS（Oracle长期支持版本），目前大部分互联网公司采用版本	Finchley	JDK8兼容版本，每次新特性发布都会进行一次全面的兼容适配与测试，以供JDK8用户稳定使用
JDK11	LTS（Oracle长期支持版本），作者采用版本	Greenwich	JDK11推荐版本，提供更快速的迭代与反馈

配置与文档说明

yue-library自动装配了一系列的基础Bean与环境配置项，可在 application.yml 文件中配置关闭，所有配置项皆是以yue.*开头，如：yue.cors.allow=false代表不允许跨域，更多配置项与细节介绍，可查看官方文档中各模块的详细说明。

官方文档提供各模块的详细介绍与使用示例，类与方法说明可参阅 API文档，SpringBoot项目基础模版可使用 yue-library-template-simple，单元测试代码与标准示例可参考：yue-library-test

结语

引用此项目作基础依赖，后续也可很好的对于服务架构进行升级（单体架构、集群架构、微服务、SOA微服务）

新开发项目，建议直接以集群架构形式撸代码，不需要一开始就搭建微服务等，可根据业务需求实际出发。（不限于有SOA共享中心的伙伴）

SpringBoot 增强库 yue-library 更新，提供模板项目