Springboot 整合阿里云oss文件上传

1.前往阿里云开通oss

在这里插入图片描述

2.创建bucket

![在这里插入图片描述](https://img-blog.csdnimg.cn/d974d5acd25241d7b358f249dfeb4c99.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA5LiN6KiA5byD44CB,size_20,color_FFFFFF,t_70,g_se,x_16

在这里插入图片描述

3. 获取AccessKeyId、AccessKeySecret

在这里插入图片描述
在这里插入图片描述

4.获取EndPoint

在这里插入图片描述

5.创建fileDir

在这里插入图片描述

6.添加maven依赖

	  <!-- 阿里云OSS-->
      <dependency>
          <groupId>com.aliyun.oss</groupId>
          <artifactId>aliyun-sdk-oss</artifactId>
          <version>2.4.0</version>
      </dependency>
      <dependency>
          <groupId>commons-fileupload</groupId>
          <artifactId>commons-fileupload</artifactId>
          <version>1.3.1</version>
      </dependency>

6.测试代码

工具类

package com.wang.learn.cloudredis.utils;

import com.alibaba.fastjson.JSONObject;
import com.aliyun.oss.*;
import com.aliyun.oss.model.CannedAccessControlList;
import com.aliyun.oss.model.CreateBucketRequest;
import com.aliyun.oss.model.PutObjectRequest;
import com.aliyun.oss.model.PutObjectResult;
import com.wang.learn.cloudredis.constant.AliyunOSSConstants;
import org.slf4j.LoggerFactory;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.UUID;

/**
 * ClassName AliyunOSSUtil
 * Description
 *
 * @author wang
 * Date 2021/9/2 19:13
 */
public class AliyunOSSUtil {

    private static final org.slf4j.Logger logger = LoggerFactory.getLogger(AliyunOSSUtil.class);

    /**
     * 上传文件
     */
    public static String upLoad(MultipartFile file) {
        logger.info("------OSS文件上传开始--------" + file.getName());

        String endPoint = AliyunOSSConstants.END_POINT;
        String accessKeyId = AliyunOSSConstants.ASSCESS_KEY_ID;
        String accessKeySecret = AliyunOSSConstants.ASSCESS_KEY_SECRET;
        String bucketName = AliyunOSSConstants.BUCKET_NAME;
        String fileDir = AliyunOSSConstants.FILE_DIR;
        SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
        String dateStr = format.format(new Date());
        String fileUrl = null;
        OSS client = new OSSClientBuilder().build(endPoint, accessKeyId, accessKeySecret);
        try {
            // 判断容器是否存在,不存在就创建
            if (!client.doesBucketExist(bucketName)) {
                client.createBucket(bucketName);
                CreateBucketRequest createBucketRequest = new CreateBucketRequest(bucketName);
                createBucketRequest.setCannedACL(CannedAccessControlList.PublicRead);
                client.createBucket(createBucketRequest);
            }
            String originalFilename = file.getOriginalFilename();
            String suffix = originalFilename.substring(originalFilename.indexOf("."));
            // 设置文件路径和名称
            fileUrl = fileDir + "/" + (dateStr + "/" + UUID.randomUUID().toString().replace("-", "") + suffix);
            logger.info("fileUrl:" + fileUrl);
            // 上传文件
            PutObjectResult result = client.putObject(new PutObjectRequest(bucketName, fileUrl, file.getInputStream()));
            // 设置权限(公开读)
            client.setBucketAcl(bucketName, CannedAccessControlList.PublicRead);
            if (result != null) {
                logger.info("resp:" + JSONObject.toJSONString(result));
                logger.info("------OSS文件上传成功------" + AliyunOSSConstants.COMMON_URL + fileUrl);
            }
        } catch (OSSException oe) {
            logger.error(oe.getMessage());
        } catch (ClientException ce) {
            logger.error(ce.getErrorMessage());
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            if (client != null) {
                client.shutdown();
            }
        }
        return AliyunOSSConstants.COMMON_URL + fileUrl;
    }

    /**
     * 删除文件
     */
    public static String delete(String fileUrl) {
        logger.info("------OSS文件删除开始--------" + fileUrl);

        String endPoint = AliyunOSSConstants.END_POINT;
        String accessKeyId = AliyunOSSConstants.ASSCESS_KEY_ID;
        String accessKeySecret = AliyunOSSConstants.ASSCESS_KEY_SECRET;
        String bucketName = AliyunOSSConstants.BUCKET_NAME;
        OSS client = new OSSClientBuilder().build(endPoint, accessKeyId, accessKeySecret);
        try {
            client.deleteObject(bucketName, fileUrl);
            logger.info("------OSS文件删除成功------" + AliyunOSSConstants.COMMON_URL + fileUrl);
        } catch (OSSException oe) {
            logger.error(oe.getMessage());
        } catch (ClientException ce) {
            logger.error(ce.getErrorMessage());
        } finally {
            if (client != null) {
                client.shutdown();
            }
        }
        return AliyunOSSConstants.COMMON_URL + fileUrl;
    }


}


控制层

package com.wang.learn.cloudredis.controller;

import com.wang.learn.cloudredis.utils.AliyunOSSUtil;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;

/**
 * ClassName RedisController
 * Description
 *
 * @author wang
 * Date 2021/6/19 10:48
 */
@RestController
@RequestMapping("/file")
public class UploadController {


    /**
     * 文件上传
     */
    @PostMapping(value = "/upload")
    public Object upload(@RequestParam("files") List<MultipartFile> files) {
        List<Object> list = new ArrayList<>();
        try {
            for (MultipartFile file : files) {
                String uploadUrl = AliyunOSSUtil.upLoad(file);
                list.add(uploadUrl);
            }
        } catch (Exception ex) {
            ex.printStackTrace();
        }
        return list;
    }

    /**
     * 文件删除
     */
    @PostMapping(value = "/delete")
    public Object delete(@RequestParam("fileUrl") String fileUrl) {
        try {
                AliyunOSSUtil.delete(fileUrl);
        } catch (Exception ex) {
            ex.printStackTrace();
            return "fail";
        }
        return "success";
    }
}


常量类

package com.wang.learn.cloudredis.constant;

/**
 * ClassName AliyunOSSConstants
 * Description
 *
 * @author wang
 * Date 2021/9/2 19:15
 */
public class AliyunOSSConstants {

    /**
     * AccessKey ID
     * LTAI5t5eTxvcpkoEjndbLto9
     * AccessKey Secret
     * ul1EPPCaAEDuYTbwZNrYeZiLSDe3Bl
     */

	// OSS唯一key
    public static final String ASSCESS_KEY_ID = "";
    // OSS唯一key秘钥
    public static final String ASSCESS_KEY_SECRET = "";
    // 地域节点
    public static final String END_POINT = "";
    // Bucket名称
    public static final String BUCKET_NAME = "";
    // 文件一级路径
    public static final String FILE_DIR = "test";
    // 文件访问域名
    public static final String COMMON_URL = "";



}

### Spring Boot集成阿里云OSS实现文件上传和下载 #### 创建启动类 为了使Spring Boot应用程序能够运行并管理依赖组件,创建`OssApplication.java`作为项目的入口点[^1]。 ```java package com.sun.oss; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.context.annotation.ComponentScan; @SpringBootApplication @ComponentScan({"com.sun"}) public class OssApplication { public static void main(String[] args) { SpringApplication.run(OssApplication.class, args); } } ``` #### 添加Maven依赖项 为了让项目支持与阿里云OSS交互的功能,在`pom.xml`中加入必要的库来处理对象存储服务的操作[^2]。 ```xml <dependency> <groupId>com.aliyun</groupId> <artifactId>aliyun-java-sdk-oss</artifactId> <version>LATEST_VERSION_HERE</version> </dependency> ``` 注意替换`LATEST_VERSION_HERE`为实际版本号。 #### OSS配置属性设置 定义用于连接到阿里云OSS的服务端点、访问密钥和其他必要参数的应用程序属性。这些通常放在`application.properties`或`application.yml`文件内。 对于`.properties`格式: ```properties # application.properties spring.cloud.alicloud.access-key=your-access-key-id spring.cloud.alicloud.secret-key=your-secret-access-key spring.cloud.alicloud.endpoint=http://oss-cn-hangzhou.aliyuncs.com spring.cloud.alicloud.bucketName=test-bucket-name ``` 对于`.yaml`格式: ```yaml # application.yml spring: cloud: alicloud: access-key: your-access-key-id secret-key: your-secret-access-key endpoint: http://oss-cn-hangzhou.aliyuncs.com bucketName: test-bucket-name ``` #### 编写控制器方法以执行上传操作 通过编写RESTful API接口允许客户端发送POST请求来进行文件上载至指定位置,并返回成功与否的信息给调用者。 ```java @RestController @RequestMapping("/api/file") public class FileController { private final String BUCKET_NAME = "test-bucket-name"; @Autowired private AliyunOSSClient aliyunOSSClient; /** * 实现文件上传逻辑 */ @PostMapping("/upload") public ResponseEntity<String> uploadFile(@RequestParam("file") MultipartFile file){ try{ // 调用工具类完成具体上传过程 boolean result = aliyunOSSClient.upload(BUCKET_NAME,file.getInputStream(),file.getOriginalFilename()); if(result){ return new ResponseEntity<>("Upload Success", HttpStatus.OK); }else{ return new ResponseEntity<>("Upload Failed",HttpStatus.INTERNAL_SERVER_ERROR); } }catch(Exception e){ e.printStackTrace(); return new ResponseEntity<>(e.getMessage(),HttpStatus.BAD_REQUEST); } } } ``` #### 定义服务层负责具体的业务逻辑 这里假设存在名为`AliyunOSSClient`的一个辅助类用来封装同阿里云SDK之间的通信细节以及提供简单的API供外部调用。 ```java @Service public class AliyunOSSClient { @Value("${spring.cloud.alicloud.endpoint}") private String ENDPOINT; @Value("${spring.cloud.alicloud.access-key}") private String ACCESS_KEY_ID; @Value("${spring.cloud.alicloud.secret-key}") private String SECRET_ACCESS_KEY; @Value("${spring.cloud.alicloud.bucketName}") private String BUCKET_NAME; private OSS client; @PostConstruct public void init(){ this.client=new OSSClientBuilder().build(ENDPOINT,ACCESS_KEY_ID,SECRET_ACCESS_KEY); } /** * 将输入流中的数据保存到目标bucket下的object名称所指代的对象处 * *@param bucket 存储空间名 *@param inputStream 输入的数据源 *@param objectName 对象的名字(即路径加文件名) *@return 是否上传成功的标志位 */ public Boolean upload(String bucket, InputStream inputStream,String objectName){ ObjectMetadata metadata = new ObjectMetadata(); PutObjectRequest request = new PutObjectRequest(bucket, objectName, inputStream,metadata); try{ PutObjectResult putRes =client.putObject(request); return true; }finally { IOUtils.closeQuietly(inputStream); } } } ``` #### 处理文件下载请求 同样地,可以构建另一个HTTP GET类型的API端点让用户可以从远程仓库获取所需资源。 ```java @GetMapping("/download/{fileName:.+}") public ResponseEntity<Resource> downloadFile(@PathVariable String fileName){ Resource resource=null; try{ byte[] bytes=this.aliyunOSSClient.download(fileName).readAllBytes(); ByteArrayInputStream bis=new ByteArrayInputStream(bytes); resource=new InputStreamResource(bis); HttpHeaders headers=new HttpHeaders(); headers.add(HttpHeaders.CONTENT_DISPOSITION,"attachment; filename="+URLEncoder.encode(fileName,"UTF-8")); return ResponseEntity.ok() .headers(headers) .contentLength(resource.contentLength()) .contentType(MediaType.APPLICATION_OCTET_STREAM) .body(resource); } catch (IOException ex) { throw new RuntimeException(ex.getMessage()); } } /** * 获取对应名字的文件字节数组 */ private ByteArrayOutputStream download(String keyName)throws IOException{ OSSObject ossObj = null; try{ ossObj = client.getObject(new GetObjectRequest(BUCKET_NAME,keyName)); ByteArrayOutputStream byteArrayOutputStream =new ByteArrayOutputStream(); IOUtils.copy(ossObj.getObjectContent(),byteArrayOutputStream ); return byteArrayOutputStream ; } finally { if(null != ossObj){ ossObj.close(); } } } ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

宁漂打工仔

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值