yl-yue/yue-library
Fork: 24 Star: 84 (更新于 2024-12-08 13:42:01)
license: Apache-2.0
Language: Java .
yue-library是一个基于SpringBoot封装的增强库,提供丰富的Java工具类库、优越的ORM框架、优雅的业务封装、优化的Spring环境配置、完善的规约限制、配套的代码生成平台
最后发布版本: j11.2.6.2 ( 2023-03-28 21:54:51)
一个基于SpringBoot封装的增强库
-- 主页:https://ylyue.cn/ --
-- QQ群:883630899 --
介绍
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-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-template-boot SpringBoot项目模版,提供快速开发示例
└── yue-library-template-cloud SpringCloud项目模版,SOA共享架构(阿里巴巴中台)
快速开始
引入项目依赖
maven项目,在pom.xml文件中添加如下一段代码,并将${version}
替换为对应版本号:
<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等模块皆已默认依赖。
<dependencies>
<dependency>
<groupId>ai.ylyue</groupId>
<artifactId>yue-library-web</artifactId>
</dependency>
...
</dependencies>
启动项目
新建一个SpringBoot main
方法启动类:
@SpringBootApplication
public 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,
"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工具包)。
同时提供优越的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-es
、auth-service
、auth-client
等模块的特性介绍与更详细的使用说明,请查看中文文档
社区
在Gitter的社区里可以找到yue-library的用户和开发者团队。
参与贡献
欢迎各路好汉一起来参与完善 yue-library,我们期待你的 PR!
- 贡献代码:代码地址 yue-library ,欢迎提交 Issue 或者 Pull Requests
- Fork本仓库并从master分支创建你的分支
- 如果你添加的代码需要测试,请添加测试,确保单元测试通过(测试代码请放在:
yue-library-test
中)- 如果你修改了API,请更新文档
- 确保代码风格一致
- 提交代码
- 新建Pull Request
- 等待维护者合并
- 维护文档:文档地址 yue-library-doc ,欢迎参与翻译和修订
PR遵照原则
yue-library欢迎你的加入,进行开源共建,提交的pr(pull request)需符合如下规范:
- 关于注释:提供完备的注释,尤其对每个新增的方法应按照Java文档规范标明方法说明、参数说明、返回值说明等信息,亦可加上署名,必要时请添加单元测试
- 关于缩进:采用IDEA中默认的
空格
作为标准,可设置一个tab
四个空格 - 关于三方库:新加的方法不要使用第三方库的方法,yue-library遵循无依赖原则
特别鸣谢
最近版本更新:(数据更新于 2024-10-11 10:31:44)
2023-03-28 21:54:51 j11.2.6.2
2022-12-28 11:28:54 j11.2.6.1
2022-05-10 19:05:46 j11.2.6.0
2021-06-06 23:28:14 j11.2.4.0
2021-05-31 09:49:47 j11.2.3.3
2021-04-17 23:17:54 j11.2.3.2
2021-02-18 00:25:56 j11.2.3.1
2021-01-10 18:18:43 j11.2.3.0
2020-10-09 00:42:19 j11.2.2.0
2020-08-06 22:26:36 2.1.0
主题(topics):
hutool, java, spring-boot, spring-cloud, springboot, yue-library
yl-yue/yue-library同语言 Java最近更新仓库
2024-12-20 19:54:15 mybatis-flex/mybatis-flex
2024-12-19 21:53:46 spring-projects/spring-boot
2024-12-19 21:25:16 Stirling-Tools/Stirling-PDF
2024-12-19 16:28:14 Tornaco/Thanox
2024-12-19 10:42:01 alibaba/nacos
2024-12-18 20:58:34 dromara/forest