yue-library 介绍
一个基于SpringBoot封装的基础库
介绍
yue-library 是一个基于 SpringBoot 封装的基础库,内置丰富的 JDK 工具,并且自动装配了一系列的基础
Bean,不仅如此,还可以用于快速构建 SpringCloud 项目,让微服务变得更简单。
工程结构
. 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-base(必备)
yue-library- base提供了丰富的Java工具包,它能够帮助我们简化每一行代码(集成Hutool工具包)。
同时也自动装配了一系列基础Bean,可在 application.yml
文件中配置关闭,所有配置项皆是以yue.*开头,如:yue.cors.allow=false代表不允许跨域。
全局统一异常处理基类,结合Result对象,定位异常更轻松,前端显示更贴切
异步线程池:共用父线程上下文环境,异步执行任务时不丢失token
ResultHttp最外层响应对象,更适应Restful风格API
validator参数校验器,支持单参数连写与POJO对象(注解)校验等,更多的校验规则,更贴切的国内校验场景。(如:手机号、身份证号码)
Convert类型转换器,内置hutool、fastjson、yue三种类型转换规则,判断精确性能强大,未知类型兼容性更强
更多详细介绍,请查看中文文档
yue-library-data-jdbc(强烈推荐)
data-jdbc库基于SpringJDBC进行二次封装,拥有着强大性能的同时又不失简单、灵活。特性如下:
比SpringJDBC更方便好用、比SpringJPA更简单灵活
无侵入 :data-jdbc 在 SpringJDBC 的基础上进行扩展,只做增强不做改变,简化CRUD操作
依赖管理 :引入即可启动项目,关联druid实现sql全监控
通用CRUD操作 :内置通用 DAO,通过继承方式即可实现单表大部分 CRUD 操作
CRUD校验 :CRUD操作是否符合预期,更好的避免脏数据的产生与违规操作
全局异常处理 :CRUD操作相关异常统一处理,定位更精准,提示更友好,实现全局Restful风格
更多详细介绍,请查看中文文档
yue-library-data-redis(推荐)
data-redis库基于SpringRedis进行二次封装,更简单灵活,提供全局token与登录等特性:
保留SpringRedis所有常用特性:分布式缓存
提供分布式token、分布式锁
更多详细介绍,请查看中文文档
社区
在Gitter的社区里可以找到yue-library的用户和开发者团队。
参与贡献
欢迎各路好汉一起来参与完善 yue-library,我们期待你的 PR!
贡献代码:代码地址 yue-library ,欢迎提交 Issue 或者 Pull Requests
维护文档:文档地址 yue-library-doc ,欢迎参与翻译和修订
yue-library 官网
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 [email protected] 举报,一经查实,本站将立刻删除。