让 Minio 的集成和使用更简单
Dante OSS 是一款简化对象存储(OSS)操作的开源框架。借鉴 JPA 标准化设计思想,逐步提取和抽象各厂商 OSS 标准化操作,构建统一的 Java OSS API 规范。形成类似于 JPA 规范的、以 Java OSS API 为核心的、不同 OSS 厂商 SDK 为实现的对象存储使用模式,方便大家在不同厂商 OSS 之间切换而不需要修改代码。
Dante OSS 最初的设计目标,是深度封装 Minio Java SDK,可以更方便的实现复杂的 Minio 管理操作,同时提升使用 Minio 自定义开发的便捷度。随着版本的不断迭代,以及更多用户需求的收集,Dante OSS 的设计思想也在不断迭代。
随着 Amazon S3、阿里云等不同 OSS 厂商 SDK 的不断融入,发现虽然各 OSS 产品大多兼容 S3 标准,使用 Amazon S3 SDK 是可以完成其它厂商的 OSS 操作,但也仅限于常规的、基础的 OSS 操作,不能充分发挥个厂商 OSS 的特性。而且由于实现的不同,即使相同的 OSS 操作,传递的参数和返回值也不同,是的相同业务逻辑的代码,如果使用 A 厂商 SDK 实现,在 B 厂商 SDK 上是无法使用的,必须要重新实现一遍才能使用,这极大地的提高了迁移 OSS 的成本。
虽然,现在也有很多优秀的对象存储操作的封装框架,可以支持的 OSS 厂商 非常多,但是其中支持的操作没有那么丰富。Dante OSS 的目标除了满足 OSS 常规操作的使用以外,还行希望提供更丰富的、统一的 OSS 管理操作,用户可以更方便的在自己的应用中集成和开发更丰富、更新细致 OSS 管理功能。
因此,Dante OSS 在维持原有简化 Minio 管理操作目标的基础之上,借鉴 JPA 标准化设计思想,提取和抽象 OSS 标准化操作,形成统一的 Java OSS API 规范。同时封装可操作任意厂商的、统一的 REST API,形成定义统一、动态实现的应用模式(类似于 Hibernate 是 JPA 的一种实现,Hibernate 以 Dialect 方式支持不同的数据库一样),以方便不同 OSS 的切换和迁移。
目前以 Minio 作为 Java OSS API 规范的默认实现,当前仅提供 Minio 个性化操作 REST API 实现。
具体对比,参见在线文档【功能说明章节】
dante-oss
├── oss-bom -- Dante OSS 顶级 Maven 依赖,统一控制依赖及其版本
├── oss-dialect -- 不同厂商 OSS 实现。
├ ├── dialect-autoconfigure -- OSS Dialect 自动配置模块
├ ├── dialect-core -- OSS Dialect 通用代码模块
├ ├── dialect-sdk-aliyun -- Aliyun OSS Java SDK 封装代码模块
├ ├── dialect-sdk-minio -- Minio OSS Java SDK 封装代码模块
├ └── dialect-sdk-s3 -- Amazon S3 OSS Java SDK 封装代码模块
├── oss-rest -- Dante OSS REST API
├ ├── rest-sdk-minio -- Minio 特有 REST API 模块
├ └── rest-sdk-specification -- 基于 Dante Java OSS API 规范实现的统一 REST API
├── oss-solution -- 基于 Dante Java OSS API 规范的常规 OSS 应用方案实现模块
├── oss-specification -- Dante Java OSS API 规范定义
├── oss-starter -- Dante OSS 相关 Starter
├ ├── oss-aliyun-spring-boot-starter -- 用于独立使用的 Aliyun OSS Java SDK 封装 Starter
├ ├── oss-minio-spring-boot-starter -- 用于独立使用的 Minio OSS Java SDK 封装 Starter
├ ├── oss-s3-spring-boot-starter -- 用于独立使用的 Amazon S3 OSS Java SDK 封装 Starter
└── └── oss-spring-boot-starter -- Dante OSS 统一 Starter
Dante Cloud 技术内幕高阶文档专栏(Cookbook)
因目前所使用的阅读产品支持度有限,想要购买全文请点击对应文章链接,在电脑浏览器中打开后进行购买。
序号 | 文章标题 | 付费 | 说明 | 扫码阅读 |
---|---|---|---|---|
1 | Dante Cloud 及相关知识学习方法和学习路径的建议V2 | 免费 | ||
2 | OAuth 2 中的 Scope 与 Role 深度解析 | 付费,有试读章节 | 全网独家,深度解析 OAuth2 协议中和 Spring Security 生态各组件中 Scope 和 Role 概念与原理,以及在实战中的应用 | |
3 | Spring Boot 3 之自动配置与注入顺序控制 | 付费,有试读章节 | Spring 生态重要知识点,掌握步入微服务的关键开关 | |
4 | Spring Cloud 之 Session 共享及一致性处理 | 付费,有试读章节 | 深入浅出剖析微服务架构 Session 共享技术难点 | |
5 | OAuth 2 中的鉴权和动态接口鉴权 | 付费,有试读章节 | 带您跟随 Dante Cloud 源代码,由浅入深全面掌握 Spring Security 5 & 6 以及基于 OAuth2 的微服务动态接口鉴权的原理与实现 | |
6 | Spring Boot 3 之 Rest 接口传参方式详解 | 付费,有试读章节 | 一文让你彻底掌握 Spring Boot Rest 各种传参方式和方法的“正确打开方式” |
<dependency>
<groupId>cn.herodotus.oss</groupId>
<artifactId>oss-spring-boot-starter</artifactId>
<version>最新版本</version>
</dependency>
herodotus:
oss:
dialect: minio
minio:
endpoint: http://127.0.0.1:9000
access-key: XXXXXXXXX
secret-key: XXXXXXXXX
use-proxy: true
proxy-source-endpoint: http://localhost:3000/api
// 参考代码
public static Result<String> resolveException(Exception ex, String path) {
return GlobalExceptionHandler.resolveException(ex, path);
}
// 或者
@ExceptionHandler({HerodotusException.class, PlatformException.class})
public static Result<String> exception(Exception ex, HttpServletRequest request, HttpServletResponse response) {
······
}
// 在系统统一错误处,调用以下代码即可返回包含自定义错误码的、更具交互性错误信息。
if (ex instanceof HerodotusException exception) {
Result<String> result = exception.getResult();
result.path(path);
log.error("[Herodotus] |- Global Exception Handler, Error is : {}", result);
return result;
}
除了 dialect-core
和 oss-specification
模块以外,其它所有模块均可以单独使用。可以根据自身需要,仅选择某个模块进行使用。
包含对 Aliyun 基础 API 封装的 Service 代码, 作为 OSS 统一抽象的实现方式之一,也包含对 Dante Java OSS API 规范的实现代码。可以单独使用,引入 oss-aliyun-spring-boot-starter
可开启自动配置。
目前暂不提供 Aliyun REST API 封装,请根据自身的需要直接申请使用阿里云 REST API 或者使用 Dante OSS 统一 REST API 接口。
包含对 Amazon S3 基础 API 封装的 Service 代码, 作为 OSS 统一抽象的实现方式之一,也包含对 Dante Java OSS API 规范的实现代码。可以单独使用,引入 oss-s3-spring-boot-starter
可开启自动配置。
目前暂不提供 Amazon S3 REST API 封装,请根据自身的需要直接申请使用Amazon S3 REST API 或者使用 Dante OSS 统一 REST API 接口。
包含对 Minio 基础 API 封装的 Service 代码, 作为 OSS 统一抽象的实现方式之一,也包含对 Dante Java OSS API 规范的实现代码。
提供 Minio 标准操作 REST API 封装 rest-sdk-minio
注意:
rest-sdk-minio
中不包含大文件分片上传通用解决方案业务功能以及符合 Dante Java OSS API 规范的通用功能 REST API
使用 oss-minio-spring-boot-starter
可统一开启 Minio Service 和 REST API 自动配置。
提供 Minio 标准操作 REST API 封装。使用 oss-minio-spring-boot-starter
可统一开启 Minio Service 和 REST API 自动配置。
rest-sdk-specification
是通过对 Minio、Aliyun、Amazon S3 现有 API 共性内容进行抽象,提取 Dante Java OSS API 规范定义后,形成的统一操作 REST API。目标是形成类似于 Spring Data Repository 统一形式的 Java OSS API 和 REST API,以期在不修改代码的情况下,以一套 API 就可以支持不同的 OSS 厂商的无缝切换。
是对大文件分片等主流对象存储业务解决方案的高度抽象,以及相关管理操作 Dante Java OSS API 规范封装。使用该模块就可以方便的、快捷的集成或自定义自己大文件分片实现。
Dante OSS 的所有内容,可直接引入使用。以 OSS 共性抽象为基础,通过 Spring Boot 配置,实现不同 OSS 操作实现的切换。目前以 Minio 作为默认实现,同时提供 Minio 相关完整的 REST API。Aliyun 和 Amazon S3 目前仅包含对其 Java SDK 封装的 Service API,作为不同 OSS 实现的可选项。如要使用其 REST API 的方式,请直接按照对应厂商官网文档操作申请即可,暂不考虑将这一部分融入 Dante OSS。
Dante OSS 作为 Dante Cloud 生态产品,不在单独提供演示环境和示例,请直接使用 Dante 环境查看效果和了解使用,这样也更贴近实际。
提供基于 Spring Authorization Server 的单体版、微服务版案例,从 SDK、Spring Boot Starter 到完整项目任你选择。前端采用一个基于 Vue3、Typescript5、Vite4、Pinia 2 的完整的前端项目作为集成示例,包括详细的 Typescript 类型定义以及 vue-simple-uploader 等主流组件集成和使用方法。
注意:如果您仅是想了解基本的使用方式和使用效果,建议使用单体架构演示环境。具体搭建方式参见【在线文档】中,单体版章节。
本项目基于 Apache License Version 2.0 开源协议,可用于商业项目,但必须遵守以下补充条款。
序号 | 赞助人 | 赞助时间 | 序号 | 赞助人 | 赞助时间 | 序号 | 赞助人 | 赞助时间 |
---|---|---|---|---|---|---|---|---|
1 | ご沉默菋噵 | 2021-10-25 | 2 | 偷土豆的人 | 2021-11-24 | 3 | lorron | 2022-04-04 |
4 | 在云端 | 2022-12-26 | 5 | 西晽 | 2022-12-27 | 6 | p911gt3rs | 2023-01-03 |
7 | jacsty | 2023-01-31 | 8 | hubert_rust | 2023-03-16 | 9 | Zkey Z | 2023-03-18 |
10 | 志国欧巴 | 2023-03-27 | 11 | michael | 2023-04-07 | 12 | 大叔丨小巷 | 2023-04-11 |
13 | sun_left | 2023-04-19 | 14 | time 丶 sand | 2023-07-06 | 15 | 印第安老斑鸠 | 2023-09-09 |
16 | 一阵风 | 2023-12-10 | 17 | Jack | 2024-03-01 | 18 |
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
1. 开源生态
2. 协作、人、软件
3. 评估模型