在项目中使用阿里云OSS对象存储图片

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

---

前言

做项目需要将用户上传的图片存储在一个地方，然后将这个地方的地址存放在数据库中方便后面回显图片，但是存本地又需要占很多空间，所有使用了阿里云的OSS对象存储技术，本文是介绍关于如何在项目中使用OSS技术的过程。

---

一、OSS是什么？

对象存储服务”（Object Storage Service），这是一种云存储服务，用于存储和检索大规模数据。对象存储服务通常提供高可用性、扩展性和安全性，适用于各种不同类型的应用程序和工作负载。

二、使用步骤

1.引入Maven依赖

   <!--        阿里的oss依赖-->
        <dependency>
            <groupId>com.aliyun.oss</groupId>
            <artifactId>aliyun-sdk-oss</artifactId>
        </dependency>
          <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-json</artifactId>
        </dependency>

2.创建阿里云OSS

1. 登录阿里云的Oss创建bucket（存放图片的云仓库），并复制自己的endpoint、access-key-id、access-key-secret、bucket-name写进配置文件里面 如图
   
2. 定义了一个用于存储阿里云 OSS 配置信息的 Java 类 AliOssProperties，并通过注解实现了与配置文件的绑定，使得可以方便地将配置文件中的属性值注入到该类的字段中。
3. 创建一个名为 aliOssUtil 的 bean，用于操作阿里云 OSS（对象存储服务）。同时，它会根据 AliOssProperties 对象中的属性值来配置 AliOssUtil 对象
   

3.写一个调用OSS对象将字节数组上传到阿里云 OSS，并返回上传成功后的文件访问路径的功能的方法。

@Data
@AllArgsConstructor
@Slf4j
public class AliOssUtil {

    private String endpoint;
    private String accessKeyId;
    private String accessKeySecret;
    private String bucketName;

    /**
     * 文件上传
     *
     * @param bytes
     * @param objectName
     * @return
     */
    public String upload(byte[] bytes, String objectName) {

        // 创建OSSClient实例。
        OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);

        try {
            // 创建PutObject请求。
            ossClient.putObject(bucketName, objectName, new ByteArrayInputStream(bytes));
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }

        //文件访问路径规则 https://BucketName.Endpoint/ObjectName
        StringBuilder stringBuilder = new StringBuilder("https://");
        stringBuilder
                .append(bucketName)
                .append(".")
                .append(endpoint)
                .append("/")
                .append(objectName);

        log.info("文件上传到:{}", stringBuilder.toString());

        return stringBuilder.toString();
    }
}

---

4.在Controller中调用该方法

@RestController
@RequestMapping("/admin/common")
@Slf4j
@Api("通用接口")
public class CommonController {
    @Autowired
    private AliOssUtil aliOssUtil;

    @PostMapping("/upload")
    @ApiOperation("文件上传")
    public Result<String> upload(MultipartFile file){
        try {
            String originalFilename = file.getOriginalFilename(); //获取原始文件名
            String entension = originalFilename.substring(originalFilename.lastIndexOf("."));//获取文件后缀
            String objectName = UUID.randomUUID().toString() + entension;//得到最终的文件名
            String filePath = aliOssUtil.upload(file.getBytes(), objectName);
            return Result.success(filePath);
        } catch (IOException e) {
            log.info("文件上传失败{}",e);
        }
        return  Result.error(MessageConstant.UPLOAD_FAILED);

    }
}

5.前端调用

只要将前端的图片传到Controller的这个接口地址，那么Contrller就会将文件使用字节传递到你的bucket仓库中，并返回仓库里这张图片的地址，只要将地址存进数据库，那么下次再次需要该图片只要访问数据库的地址就能看到这张图片了。

总结

以上就是今天要讲的内容，通俗点就是获取你的仓库权限，然后初始化oss实例并将你传的文件传到仓库里返回图片地址