springboot程序文件上传集成腾讯云cos

前提:有腾讯云服务器并开通cos对象存储

  1. 创建cos存储桶(访问权限需要设置为共有读私有写,这样到时上传的文件才可以通过链接访问)

  2. 创建cos对象存储访问密钥拿到secretId和secretKey


    注意创建的密钥一定要保存好后期是无法再次次查看的

  3. 在项目中添加腾讯云cos坐标

JavaScript 复制代码
<!--      腾讯云cos坐标-->
      <dependency>
          <groupId>com.qcloud</groupId>
          <artifactId>cos_api</artifactId>
          <version>5.6.155</version>
      </dependency>
  </dependencies>
  1. 创建文件上传工具类UploadUtil.java
JavaScript 复制代码
package org.example.utils;

import com.qcloud.cos.COSClient;
import com.qcloud.cos.ClientConfig;
import com.qcloud.cos.auth.BasicCOSCredentials;
import com.qcloud.cos.auth.COSCredentials;
import com.qcloud.cos.http.HttpProtocol;
import com.qcloud.cos.model.PutObjectRequest;
import com.qcloud.cos.model.PutObjectResult;
import com.qcloud.cos.region.Region;

import java.io.File;

public class UploadUtil {
    /**
     * 该函数用于上传指定文件至腾讯云对象存储服务(COS),并返回上传后文件的HTTP访问链接。
     *
     * @param secretId 用户的SecretId,用于身份验证,建议使用具有最小权限的子账号密钥。
     * @param secretKey 用户的SecretKey,与SecretId配合使用进行身份验证,同样建议使用子账号密钥。
     * @param bucketName 存储桶名称,指定文件将上传到的存储桶。
     * @param regionName 存储桶所在地域的简称,参考腾讯云官方文档获取有效地区名称。
     * @param file 待上传的本地文件对象。
     * @param fileName 文件上传到COS后的对象键,即文件路径。
     *
     * @return 返回一个字符串类型的URL,表示上传成功后文件在COS中的访问地址。
     *
     * @throws IllegalArgumentException 如果输入的参数不合法或上传过程中出现异常,则可能会抛出异常。
     *
     * 注意:此函数依赖于腾讯云COS Java SDK,需要预先初始化相关配置并设置好用户凭证信息。
     */

    public static String uploadFileToCos(String secretId, String secretKey, String bucketName, String regionName, File file, String fileName) {
        // 1 初始化用户身份信息(secretId, secretKey)。
        COSCredentials cred = new BasicCOSCredentials(secretId, secretKey);
        // 2 设置 bucket 的地域, COS 地域的简称请参见 https://cloud.tencent.com/document/product/436/6224
        Region region = new Region(regionName);
        ClientConfig clientConfig = new ClientConfig(region);
        // 这里建议设置使用 https 协议
        // 从 5.6.54 版本开始,默认使用了 https
        clientConfig.setHttpProtocol(HttpProtocol.https);
        // 3 生成 cos 客户端。
        COSClient cosClient = new COSClient(cred, clientConfig);

        // 指定文件上传到 COS 上的路径,即对象键。例如对象键为 folder/picture.jpg,则表示将文件 picture.jpg 上传到 folder 路径下
        PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, fileName, file);
        PutObjectResult putObjectResult = cosClient.putObject(putObjectRequest);
        return "https://"+bucketName+".cos."+regionName+".myqcloud.com/"+fileName;
    }
    /**
     * 该函数用于校验文件类型是否合法。
     *
     * @param fileType 文件类型。
     *
     * @return 是否通过格式校验
     */

    public static boolean isValidFileType(String fileType) {
        // 定义允许的文件类型列表
        String[] allowedFileTypes = { "jpg", "jpeg", "png", "gif", "mp4" };
        for (String allowedType : allowedFileTypes) {
            if (allowedType.equalsIgnoreCase(fileType)) {
                return true;
            }
        }
        return false;
    }


}
  1. 实现接口
JavaScript 复制代码
package org.example.controller;

import jakarta.servlet.ServletOutputStream;
import jakarta.servlet.http.HttpServletResponse;
import org.example.pojo.Result;
import org.example.utils.UploadUtil;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.URLEncoder;
import java.util.UUID;

/**
 * 文件处理接口
 */
@RestController
public class FileUploadController {

    private static final String ACCESS_KEY_ID = "XXX";//密钥secretId
    private static final String ACCESS_KEY_SECRET = "XXX";//密钥secretKey
    private static final String REGION = "XXX";//存储桶所在区域
    private static final String BUCKET_NAME = "XXX";//存储桶名称

    /**
     *上传文件到腾讯云cos
     */
    @PostMapping("/uploadToCos")
    public Result<String> uploadToCos(MultipartFile file) throws IOException {
        //判断文件是否为空
        if (file == null || file.isEmpty()) {
            return Result.error("文件不能为空");
        }
        //获取上传文件名
        String originalFilename = file.getOriginalFilename();
        String fileType = originalFilename.substring(originalFilename.lastIndexOf(".") + 1);
        // 对文件类型进行检查
        if (!UploadUtil.isValidFileType(fileType)) {
            return Result.error("不支持的文件类型");
        }

        //保证文件名唯一  防止文件覆盖
        String fileName = UUID.randomUUID().toString() + originalFilename.substring(originalFilename.lastIndexOf("."));
        //MultipartFile转换为file
        File tempFile = File.createTempFile(fileName, null);

        try {
            file.transferTo(tempFile);
            //上传到腾讯云
            String url = UploadUtil.uploadFileToCos(ACCESS_KEY_ID, ACCESS_KEY_SECRET, BUCKET_NAME, REGION, tempFile, fileName);
            //返回前端文件地址
            return Result.success(url);
        } catch (IOException e) {
            // 处理异常,如记录日志,返回错误信息等
            e.printStackTrace();
            return Result.error("文件上传失败");
        } finally {
            // 删除临时文件
            tempFile.delete();
        }
    }
}
  1. 上传超过后可以在存储桶中看到自己上传的文件

相关推荐
跟着珅聪学java24 分钟前
spring boot +Elment UI 上传文件教程
java·spring boot·后端·ui·elementui·vue
我命由我1234529 分钟前
Spring Boot 自定义日志打印(日志级别、logback-spring.xml 文件、自定义日志打印解读)
java·开发语言·jvm·spring boot·spring·java-ee·logback
徐小黑ACG1 小时前
GO语言 使用protobuf
开发语言·后端·golang·protobuf
战族狼魂4 小时前
CSGO 皮肤交易平台后端 (Spring Boot) 代码结构与示例
java·spring boot·后端
杉之5 小时前
常见前端GET请求以及对应的Spring后端接收接口写法
java·前端·后端·spring·vue
hycccccch6 小时前
Canal+RabbitMQ实现MySQL数据增量同步
java·数据库·后端·rabbitmq
bobz9657 小时前
k8s 怎么提供虚拟机更好
后端
bobz9657 小时前
nova compute 如何创建 ovs 端口
后端
用键盘当武器的秋刀鱼7 小时前
springBoot统一响应类型3.5.1版本
java·spring boot·后端
Asthenia04128 小时前
从迷宫到公式:为 NFA 构造正规式
后端