开源软件名称：

yue-library

开源软件地址：

https://gitee.com/yl-yue/yue-library

开源软件介绍：

一个基于SpringBoot封装的增强库

-- 主页：https://ylyue.cn/ --

-- QQ群：883630899 --

介绍

　　yue-library是一个基于SpringBoot封装的增强库，提供丰富的Java工具类库、优越的ORM框架、优雅的业务封装、优化的Spring环境配置、完善的规约限制、配套的代码生成平台、安稳贴切的开源架构方案等，只为打造更好的JavaWeb开发环境，提升大家的开发质量与效率，降低企业研发成本。

　　适用于企业快速构建属于自己的切合架构，不为技术负累，不盲目跟风，不原地踏步，从单体与集群到分布式与微服务，企业结合自身业务所处阶段，灵活选择逐步跟进升级。

工程结构

. yue-library├── yue-library                       │   ├── yue-library-dependencies      dependencies版本控制│   ├── yue-library-base              基础核心模块，提供丰富的Java工具类库、接口参数校验、类型转换器等│   ├── yue-library-base-crypto       加解密模块，提供对称、非对称和摘要算法、密钥交换加解密等│   ├── yue-library-web               WebMvc模块，servlet编程，提供请求与响应参数的包装与解析等│   ├── yue-library-webflux           WebFlux实现，响应式编程（如：SpringCloudGateway）│   ├── yue-library-data-jdbc         ORM框架，基于SpringJdbc，拥有着强大性能的同时又不失简单灵活等│   ├── yue-library-data-redis        Redis客户端，基于SpringRedis，更简单灵活，提供分布式锁等│   ├── yue-library-auth-service      OAuth2认证模块，基于SpringSecurity，更简单灵活，提供全局token与登录等│   ├── yue-library-auth-client       OAuth2客户端模块，提供获取当前登录用户状态信息等│   └── yue-library-pay               支付模块，基于pay-java-parent，让你真正做到一行代码实现支付聚合└── yue-library-samples                   ├── yue-library-test              web测试项目，提供详细的特性使用示例、接口单元测试    ├── yue-library-test-webflux      webflux测试项目，提供详细的特性使用示例、接口单元测试    ├── yue-library-template-boot     SpringBoot项目模版，提供快速开发示例    └── yue-library-template-cloud    SpringCloud项目模版，SOA共享架构（阿里巴巴中台）

快速开始

引入项目依赖

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

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

随后引入所需要的模块，如WebMvc项目引入：yue-library-web

依赖说明：yue-library-base为基础模块，一般情况下不需要单独引入，如：web、data-jdbc、data-redis等模块皆已默认依赖。

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

启动项目

新建一个SpringBoot main方法启动类：

@SpringBootApplicationpublic class TestApplication {	public static void main(String[] args) throws Exception {		SpringApplication.run(TestApplication.class, args);	}}

写一个测试接口：

@RestController@RequestMapping("/quickstart")public class QuickstartController {	@GetMapping("/get")	public Result<?> get(JSONObject paramJson) {		return R.success(paramJson);	}	}

访问接口测试，如：http://localhost:8080/quickstart/get

{    "code": 200,    "msg": "成功",    "flag": true,    "count": null,    "data": {}}

上述代码完全保持了SpringBoot的风格，但又使用到了yue-library的增强特性，如：

HTTP消息转换器支持使用Alibaba Fastjson作为参数接收对象
请求参数智能解析，无需再为URL query-string、Body from-data、Body application/json传参方式烦恼
错误时会对异常进行统一处理，响应RESTful风格的错误提示
支持前端跨域请求

当然除了这些已使用到的特性之外，你还可以尝试如：响应时间类型时自动格式化、请求参数校验、API接口版本控制、反复读取Servlet输入流等。并且在yue-library-samples目录下，存放着不同架构类型的示例模板，你可以根据自身需求选择，从而快速上手。

核心模块说明

yue-library-base（必备）

　　base模块提供了丰富的Java工具类库，它能够帮助我们简化每一行代码（增强Hutool工具包）。
　　同时提供优越的Spring本土化环境配置，可在 application.yml 文件中配置关闭，所有配置项皆是以yue.*开头，如：yue.cors.allow=false代表不允许跨域。