# oss-spring-boot-starter

**Repository Path**: d00x/oss-spring-boot-starter

## Basic Information

- **Project Name**: oss-spring-boot-starter
- **Description**: 通用对象存储实现
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-12-13
- **Last Updated**: 2021-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# oss-spring-boot-starter

对象存储
## 需求

### 对象常见使用场景：

1. 用户上传，只允许用户自己及后台管理员查看，如证件照上传
2. 运营人员上传，允许所有人查看，如默认头像、活动图片等
3. 后台运营人员上传，只允许系统读取，如发货单导入

### 场景分析：

1. 使用私有库，因为场景固定的原因，文件名及存储路径可以通过算法得出，无须存储文件路径
2. 使用公有库，场景不固定，系统内存储完整访问路径
3. 使用私有库，场景固定，文件名不固定，但一般是一次性访问，也无须存储文件路径

也就是说在系统内上传的场景都无须在系统内保存完整路径，需要完整访问路径的是我们在系统外创建的，因此在系统内的实现都不管保存还是复制，都无须返回上传后的路径，因为上传后的路径就是传入的文件保存路径


## 功能特征

1. 配置文件中有相应配置则自动配置对应OssService
2. 用户可以通过自定义配置覆盖默认配置
3. 用户可以配置多个OssService来应对多个OSS的场景，比如一个公有库，一个私有库

## 快速开始

增加相关依赖到你的项目

```
<dependencies>
    <dependency>
        <groupId>top.lemna</groupId>
        <artifactId>oss-spring-boot-starter</artifactId>
        <version>1.0.2</version>
    </dependency>
</dependencies>
```






## 己有的OSS实现

### 阿里云

在配置文件中配置如下参数

```
top:
  lemna:
    oss:
      proxyDomain:
      aliyun:
        accessId:
        accessKey:
        endpoint:
        bucket:
```
注:proxyDomain定义域名，用于替换生成的图片访问链接原有域名 主要用于某些环境对于图片访问域名有要求的场景，比如小程序的图片保存 

配置此域名只是将原域名替换成指定的域名，实际访问需要用户自行配置对应的域名解析


## 创建自己的OSS实现