yue-library

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 94)

yue-library是一个基于SpringBoot封装的增强库，提供丰富的Java工具类库、优越的ORM框架、优雅的业务封装、优化的Spring环境配置、完善的规约限制、配套的代码生成平台

yue-library 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<a target="_blank" href="https://ylyue.cn/">
		<img src="docs/_images/logo.png" width="400">
	</a>


	一个基于SpringBoot封装的增强库


	<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-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.6+-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-2021+-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>


	-- 主页：<a href="https://ylyue.cn">https://ylyue.cn/</a> --


	-- QQ群：<a href="https://jq.qq.com/?_wv=1027&k=5WI2Vbb">883630899</a> --

-------------------------------------------------------------------------------

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

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

## 工程结构
在多模块打包时，为加快构建速度并增强模块独立维护性，部分模块在未迭代且兼容的情况下，不再随主版本一起发布

```
. yue-library
├── yue-library                       yue-library顶级模块
│   ├── yue-library-base                  基础核心模块，提供丰富的Java工具类库、接口参数校验、类型转换器等
│   ├── yue-library-base-crypto           加解密模块，提供对称、非对称和摘要算法、密钥交换加解密等
│   ├── yue-library-web                   WebMvc模块，servlet编程，提供请求与响应参数的包装与解析等
│   ├── yue-library-webflux               WebFlux模块，响应式编程（如：SpringCloudGateway）
│   ├── yue-library-data-mybatis          ORM框架，基于mybatis-plus，拥有着强大性能的同时又不失简单灵活等
│   ├── yue-library-data-redis            Redis客户端，基于SpringRedis，更简单灵活，提供分布式锁等
│   └── yue-library-data-log              日志模块，基于注解的日志自动记录，支持操作日志与登录日志等
└── yue-library-samples               yue-library示例项目
    ├── yue-library-test                  web测试项目，提供详细的特性使用示例、接口单元测试
    └── yue-library-test-webflux          webflux测试项目，提供详细的特性使用示例、接口单元测试
```

## 快速开始
### 引入项目依赖
maven项目，在pom.xml文件中添加如下一段代码，并将`${version}`替换为对应版本号：[![Maven Central with version prefix filter](https://img.shields.io/maven-central/v/ai.ylyue/yue-library/j?style=flat-square)](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-mybatis、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,
    "traceId": "a1bde0ba625de731",
    "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](https://hutool.cn)工具包）。 
　　同时提供优越的Spring本土化环境配置，可在 application.yml 文件中配置关闭，所有配置项皆是以`yue.*`开头，如：`yue.cors.allow=false`代表不允许跨域。
- 丰富的Java基础工具类，对文件、流、加密解密、转码、正则、线程、XML等JDK方法进行封装
- 完善的RESTful支持，使用HTTP响应包装对象`Result`，友好返回接口响应内容
- 完善的异常处理机制，支持I18n、规范打印、安全拦截敏感错误响应，异常提示简单易懂
- 出色的服务端校验框架`validator`，支持多种校验方式，简单易用，校验规则丰富，更贴切国内校验场景
- 强大的类型转换器`Convert`，优越的性能，超强的容错能力，妈妈再也不用担心我找不到好用的“BeanUtils”了
- 安全的异步线程池，完美解决子线程上下文环境问题，就算是高并发下，异步执行任务时再也不丢失token等参数了
- 优雅的密钥交换加密，安全高效的解决HTTP通信传输安全
- 简洁完善的Java全局网络代理，轻松解决内网部署时的网络代理需求

### yue-library-web/webflux（必备）
　　web/webflux模块提供友好的JavaWeb开发环境，免去本土化烦恼，提供友好的默认配置，解决开发中常遇的槽点，提升大家的开发质量与效率，降低企业研发成本。
- 美妙愉悦的开发体验，让跨域、热加载、时间格式、参数获取等，低级而又普遍存在的问题都见鬼去吧
- 强大的HTTP请求参数解析器，解决参数获取困扰，Request请求参数智能解析，让前后端联调和平相处
- 强大的HTTP响应消息转换器，优雅实现固定类型参数格式化、NULL值处理等，轻松收到来至前端同事的致谢
- 强大的HTTP请求包装器，解决Servlet输入流被前置的某个拦截器读取一空，导致请求参数获取不到
- 强大的`ServletUtils`，让我们在任何时候任何地方，对接口的请求参数与响应内容都能为所欲为
- 优雅的接口版本控制`@ApiVersion`，再也不用担心团队成员对接口规范视若无睹为所欲为了

### yue-library-data-mybatis（强烈推荐）
　　data-mybatis模块基于Mybatis-Plus封装的ORM框架，拥有着强大性能的同时又不失简单灵活，特性如下：
- **强大易用**：比MyBatis更方便好用、比SpringJpa更简单灵活、比SpringJdbc更健壮完善
- **无侵入**：data-mybatis在Mybatis-Plus的基础上进行扩展，只做增强不做改变，简化`CRUD`等操作
- **依赖管理**：引入即可启动项目，关联druid实现SQL全监控
- **预防Sql注入**：内置Sql注入剥离器，有效预防Sql注入攻击
- **损耗小**：封装大量经过SQL优化处理的CRUD方法，直接面向对象操作，对比原生级CRUD处理，性能基本无损甚至更优
- **通用CRUD操作**：内置通用DAO，通过继承方式即可实现单表大部分CRUD操作
- **更科学的分页**：分页参数统一处理，无多线程忧虑，自由拼接更通用，无分页性能忧虑，更有优化型分页SQL检查
- **内置性能分析插件**：可输出Sql语句以及其执行时间，建议开发测试时启用该功能，能有效解决慢查询
- **类型强化**：支持原生级SQL查询，并强化原生查询结果，简单便捷+可维护组合（支持全Json或全Entity）
- **CRUD校验**：CRUD操作是否符合预期，更好的避免脏数据的产生与违规操作
- **数据审计**：敏感操作全覆盖，简单实现对数据变动的审计需求
- **数据填充**：只需简单的配置即可实现字段默认值填充需求，新增与修改时数据自动填充
- **数据脱敏**：只需简单的配置即可实现对数据脱敏存储需求，操作时自动加解密
- **多租户**：完善的多租户方案与规范的框架支持，从容应对多租户需求，数据源SaaS隔离简单规范化
- **全局异常处理**：CRUD操作相关异常统一处理，定位更精准，提示更友好，实现全局RESTful风格

### 更多模块
　　关于`data-redis`、`data-log`等模块的特性介绍与更详细的使用说明，请查看[中文文档](https://ylyue.cn)

## 社区
　　在[Gitter](https://gitter.im/yl-yue/yue-library)的社区里可以找到yue-library的用户和开发者团队。

## 参与贡献
欢迎各路好汉一起来参与完善 yue-library，我们期待你的 PR！

- 贡献代码：代码地址 [yue-library](https://gitee.com/yl-yue/yue-library) ，欢迎提交 Issue 或者 Pull Requests

> 1. Fork本仓库并从master分支创建你的分支
> 2. 如果你添加的代码需要测试，请添加测试，确保单元测试通过（测试代码请放在：`yue-library-test`中）
> 3. 如果你修改了API，请更新文档
> 4. 确保代码风格一致
> 5. 提交代码
> 6. 新建Pull Request
> 7. 等待维护者合并

- 维护文档：文档地址 [yue-library-doc](https://gitee.com/yl-yue/yue-library/tree/master/docs) ，欢迎参与翻译和修订

### PR遵照原则
yue-library欢迎你的加入，进行[开源共建](https://ylyue.cn/#/开源共建/开源共建)，提交的pr（pull request）需符合如下规范：
- 关于注释：提供完备的注释，尤其对每个新增的方法应按照Java文档规范标明方法说明、参数说明、返回值说明等信息，亦可加上署名，必要时请添加单元测试
- 关于缩进：采用IDEA中默认的**`空格`**作为标准，可设置一个`tab`四个空格
- 关于三方库：新加的方法不要使用第三方库的方法，yue-library遵循无依赖原则

## 特别鸣谢
<a target="_blank" href="https://www.jetbrains.com/?from=yue-library">
	<img src="http://dcloud.ylyue.cn/yue-library/_images/jetbrains.svg" alt="logo-jetbrains">
</a>&emsp;&emsp;&emsp;&emsp;&emsp;

yue-library

yue-library 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

yue-library

yue-library 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README