simple-base-s3
# 简介
提供文件管理服务及接口
模块
simple-base-s3-api 文件管理服务-客户端：
若只引入客户端需要启动服务端并(配置服务端调用地址 或 开启服务自动发现)
主要功能：提供调用服务端接口
simple-base-s3-service 文件管理服务-服务端：
可直接引入依赖，作为客户端也作为服务端
主要功能：提供文件管理服务接口
1
2
3
4
5
6
2
3
4
5
6
# 依赖关系
# 拆分客户端及服务端使用
# 启动服务端
下载代码
git clone https://github.com/ok1996/ok-system-simple.git
1
增加启动BaseS3ServiceApplication的vm配置--无需连接Nacos
-Dsimple.s3.accessKey=
-Dsimple.s3.secretKey=
-Dsimple.s3.endpoint=
1
2
3
2
3
若要连接Nacos则再增加配置
-Dspring.cloud.nacos.server-addr=http://127.0.0.1:8848
-Dspring.cloud.nacos.username=
-Dspring.cloud.nacos.password=
-Dspring.cloud.nacos.discovery.enabled=true
-Dspring.cloud.nacos.discovery.namespace=
-Dspring.cloud.nacos.config.enabled=true
-Dspring.cloud.nacos.config.namespace=
1
2
3
4
5
6
7
2
3
4
5
6
7
# 引入客户端
# 引入依赖-方式1
所需工程使用仅需引入客户端依赖
<dependencies>
<dependency>
<groupId>cn.iosd</groupId>
<artifactId>simple-base-s3-api</artifactId>
<version>Version</version>
</dependency>
</dependencies>
1
2
3
4
5
6
7
2
3
4
5
6
7
# 引入依赖-方式2
所需工程使用，引入服务端依赖，并通过配置文件关闭服务端功能，仅使用客户端功能
便于灵活切换启用本身作为服务端
<dependencies>
<dependency>
<groupId>cn.iosd</groupId>
<artifactId>simple-base-s3-service</artifactId>
<version>Version</version>
</dependency>
</dependencies>
1
2
3
4
5
6
7
2
3
4
5
6
7
配置项-关闭服务端功能
simple:
scan:
## 关闭service依赖中service服务端，仅使用service依赖中的api客户端
service:
enabled: false
1
2
3
4
5
2
3
4
5
# 配置项
若要连接Nacos则再增加vm配置
-Dspring.cloud.nacos.server-addr=http://127.0.0.1:8848
-Dspring.cloud.nacos.username=
-Dspring.cloud.nacos.password=
-Dspring.cloud.nacos.discovery.enabled=true
-Dspring.cloud.nacos.discovery.namespace=
-Dspring.cloud.nacos.config.enabled=true
-Dspring.cloud.nacos.config.namespace=
1
2
3
4
5
6
7
2
3
4
5
6
7
情况1：若工程 或 服务端 没有启用服务发现，则需要在客户端中配置调用服务端的调用地址
simple:
feign:
base:
## simple-base-s3-api
s3:
# 未开启注册中心需要指定调用地址
url: http://localhost:9020
1
2
3
4
5
6
7
2
3
4
5
6
7
情况2：若工程 和 服务端 均启用服务发现，则在客户端中配置调用服务端的调用地址为空即可
simple:
feign:
base:
s3:
# 未开启注册中心需要指定调用地址
url:
1
2
3
4
5
6
2
3
4
5
6
# 融合客户端和服务端使用
直接引入service依赖即包含客户端和服务端功能
# 引入依赖
<dependencies>
<dependency>
<groupId>cn.iosd</groupId>
<artifactId>simple-base-s3-service</artifactId>
<version>Version</version>
</dependency>
</dependencies>
1
2
3
4
5
6
7
2
3
4
5
6
7
# 查看服务端接口
POST 获取文件列表-首页
DELETE 删除文件
POST 上传文件-返回文件key
POST 获取文件列表-下一页
GET 生成带有预签名的URL，用于私有S3对象的访问
GET 创建存储桶
DELETE 删除存储桶
GET 获取存储桶列表
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
上次更新: 2024/03/25, 02:28:08