基于SpringBoot封装的增强库，提供丰富的Java工具类库、优越的ORM框架、优雅.zip

<p align="center"> <a target="_blank" href="https://ylyue.cn/"> <img src="https://dcloud.ylyue.cn/yue-library/_images/logo.png" width="400"> </a> </p> <p align="center"> <strong>一个基于SpringBoot封装的增强库</strong> </p> <p align="center"> <a target="_blank" href="https://ylyue.cn/"> <img src="https://img.shields.io/badge/文档-yue-blue.svg?style=flat-square" alt="yue-library官网"> </a> <a target="_blank" href="https://apidoc.gitee.com/yl-yue/yue-library/"> <img src="https://img.shields.io/badge/文档-javadoc-blue.svg?style=flat-square" alt="yue-library JavaDoc"> </a> <a target="_blank" href="https://maven-badges.herokuapp.com/maven-central/ai.ylyue/yue-library-dependencies"> <img alt="Maven Central with version prefix filter" src="https://img.shields.io/maven-central/v/ai.ylyue/yue-library/j?style=flat-square"> </a> <a target="_blank" href="https://www.apache.org/licenses/LICENSE-2.0.html"> <img alt="GitHub" src="https://img.shields.io/github/license/yl-yue/yue-library?style=flat-square"> </a> <a target="_blank" href="https://www.oracle.com/technetwork/java/javase/downloads/jdk11-downloads-5066655.html"> <img src="https://img.shields.io/badge/Java-8+11+-green?style=flat-square" > </a> <a target="_blank" href="https://spring.io/projects/spring-boot"> <img src="https://img.shields.io/badge/Spring%20Boot-2.1+2.2+-green?style=flat-square" alt="Spring%20Boot Version"> </a> <a target="_blank" href="https://spring.io/projects/spring-cloud"> <img src="https://img.shields.io/badge/Spring%20Cloud-Greenwich+Hoxton+-green?style=flat-square" alt="Spring%20Cloud Version"> </a> <a target="_blank" href="https://gitter.im/yl-yue/yue-library?utm_source=share-link&utm_medium=link&utm_campaign=share-link"> <img src="https://badges.gitter.im/yl-yue/yue-library.svg" > </a> <a target="_blank" href="https://gitee.com/yl-yue/yue-library"> <img src='https://gitee.com/yl-yue/yue-library/badge/star.svg?theme=dark' alt='gitee star'> </a> <a target="_blank" href='https://github.com/yl-yue/yue-library'> <img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/yl-yue/yue-library?style=social"> </a> <a target="_blank" href="https://github.com/yl-yue/yue-library/issues"> <img alt="GitHub issues" src="https://img.shields.io/github/issues/yl-yue/yue-library?style=flat-square"> </a> </p> <p align="center"> -- 主页：<a href="https://ylyue.cn">https://ylyue.cn/</a> -- </p> <p align="center"> -- QQ群：<a href="https://jq.qq.com/?_wv=1027&k=5WI2Vbb">883630899</a> -- </p> ------------------------------------------------------------------------------- ## 介绍 　　yue-library是一个基于SpringBoot封装的增强库，提供丰富的Java工具类库、优越的ORM框架、优雅的业务封装、优化的Spring环境配置、完善的规约限制、配套的代码生成平台、安稳贴切的开源架构方案等，只为打造更好的JavaWeb开发环境，提升大家的开发质量与效率，降低企业研发成本。 　　适用于企业快速构建属于自己的切合架构，不为技术负累，不盲目跟风，不原地踏步，从**单体与集群**到**分布式与微服务**，企业结合自身业务所处阶段，灵活选择逐步跟进升级。 ## 工程结构 yue-library工程区分顶级module与子级module： - 顶级module即父子模块，迭代维护频繁 - 子级module属于当前版本已成熟或暂不需要频繁迭代维护的模块 - 子级module位于：yue-library-extra目录下 - 区分顶级module与子级module的目的在于，进行多模块打包时，可以加快构建速度并且增强模块独立维护性（子级module未迭代且兼容的情况下，不再随主版本一起发布） - 顶级module与子级module会在不同版本进行对调 ``` . yue-library ├── yue-library yue-library顶级模块 │ ├── yue-library-base 基础核心模块，提供丰富的Java工具类库、接口参数校验、类型转换器等 │ ├── yue-library-web WebMvc模块，servlet编程，提供请求与响应参数的包装与解析等 │ └── yue-library-data-jdbc ORM框架，基于SpringJdbc，拥有着强大性能的同时又不失简单灵活等 ├── yue-library-extra yue-library子级模块 │ ├── yue-library-base-crypto 加解密模块，提供对称、非对称和摘要算法、密钥交换加解密等 │ ├── yue-library-webflux WebFlux模块，响应式编程（如：SpringCloudGateway） │ ├── yue-library-web-grpc gRPC模块，RPC编程，Protobuf协议定义接口与序列化数据 │ ├── yue-library-data-redis Redis客户端，基于SpringRedis，更简单灵活，提供分布式锁等 │ ├── yue-library-data-es Elasticsearch Rest与SQL客户端（兼容OpenSearch），提供安全认证等属性配置 │ ├── yue-library-auth-service OAuth2认证模块，基于SpringSecurity，更简单灵活，提供全局token与登录等 │ ├── yue-library-auth-client OAuth2客户端模块，提供获取当前登录用户状态信息等 │ └── yue-library-pay 支付模块，基于pay-java-parent，让你真正做到一行代码实现支付聚合 └── yue-library-samples yue-library示例项目 ├── yue-library-test web测试项目，提供详细的特性使用示例、接口单元测试 ├── yue-library-test-webflux webflux测试项目，提供详细的特性使用示例、接口单元测试 ├── yue-library-test-grpc grpc测试项目，提供详细的特性使用示例、接口单元测试 ├── yue-library-template-boot SpringBoot项目模版，提供快速开发示例 └── yue-library-template-cloud SpringCloud项目模版，SOA共享架构（阿里巴巴中台） ``` ## 快速开始 ### 引入项目依赖 maven项目，在pom.xml文件中添加如下一段代码，并将`${version}`替换为对应版本号：[](https://maven-badges.herokuapp.com/maven-central/ai.ylyue/yue-library-dependencies) ```xml <parent> <groupId>ai.ylyue</groupId> <artifactId>yue-library</artifactId> <version>${version}</version> </parent> ``` 随后引入所需要的模块，如WebMvc项目引入：`yue-library-web` 依赖说明：`yue-library-base`为基础模块，一般情况下不需要单独引入，如：web、data-jdbc、data-redis等模块皆已默认依赖。 ```xml <dependencies> <dependency> <groupId>ai.ylyue</groupId> <artifactId>yue-library-web</artifactId> </dependency> ... </dependencies> ``` ### 启动项目 新建一个SpringBoot `main`方法启动类： ```java @SpringBootApplication public class TestApplication { public static void main(String[] args) throws Exception { SpringApplication.run(TestApplication.class, args); } } ``` 写一个测试接口： ```java @RestController @RequestMapping("/quickstart") public class QuickstartController { @GetMapping("/get") public Result<?> get(JSONObject paramJson) { return R.success(paramJson); } } ``` 访问接口测试，如：http://localhost:8080/quickstart/get ```json { "code": 200, "msg": "成功", "flag": true, "count": null, "data": {} } ``` 上述代码完全保持了SpringBoot的风格，但又使用到了yue-library的增强特性，如： - HTTP消息转换器支持使用Alibaba Fastjson作为参数接收对象 - 请求参数智能解析，无需再为URL query-string、Body from-data、Body application/json传参方式烦恼 - 错