springboot集成腾讯cos实现文件上传

腾讯对象存储介绍

对象存储(Cloud Object Storage,COS)是腾讯云提供的一种存储海量文件的分布式存储服务,具有高扩展性、低成本、可靠安全等优点。通过控制台、API、SDK 和工具等多样化方式,用户可简单、快速地接入 COS,进行多格式文件的上传、下载和管理,实现海量数据存储和管理。

开通“对象存储COS”服务

(1)申请腾讯云账号:https://cloud.tencent.com/

(2)实名认证

(3)开通“对象存储COS”服务

(4)进入管理控制台
在这里插入图片描述

创建bucket

进入管理控制台,找到存储桶列表, 创建存储桶txkt-1256940009
在这里插入图片描述
输入桶名称,选择:公有读取,其他默认:

点击 桶名称,进入详情页,可测试上传文件:
在这里插入图片描述

进入API秘钥管理

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

快速入门

https://cloud.tencent.com/document/product/436/10199

引入依赖

<dependency>
       <groupId>com.qcloud</groupId>
       <artifactId>cos_api</artifactId>
       <version>5.6.54</version>
</dependency>

测试上传

import com.alibaba.fastjson.JSON;
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.exception.CosClientException;
import com.qcloud.cos.exception.CosServiceException;
import com.qcloud.cos.http.HttpProtocol;
import com.qcloud.cos.model.*;
import com.qcloud.cos.region.Region;

import java.io.File;

public class FileTest {

    public static void main(String[] args) {
        // 1 初始化用户身份信息(secretId, secretKey)。
        // SECRETID和SECRETKEY请登录访问管理控制台 https://console.cloud.tencent.com/cam/capi 进行查看和管理
        String secretId = "你的secretId";
        String secretKey = "你的secretKey";
        COSCredentials cred = new BasicCOSCredentials(secretId, secretKey);
        // 2 设置 bucket 的地域, COS 地域的简称请参照 https://cloud.tencent.com/document/product/436/6224
        // clientConfig 中包含了设置 region, https(默认 http), 超时, 代理等 set 方法, 使用可参见源码或者常见问题 Java SDK 部分。
        Region region = new Region("ap-nanjing");
        ClientConfig clientConfig = new ClientConfig(region);
        // 这里建议设置使用 https 协议
        // 从 5.6.54 版本开始,默认使用了 https
        clientConfig.setHttpProtocol(HttpProtocol.https);
        // 3 生成 cos 客户端。
        COSClient cosClient = new COSClient(cred, clientConfig);

        try{
            // 指定要上传的文件
            File localFile = new File("D:\\glkt_work\\glkt\\11.png");
            // 指定文件将要存放的存储桶
            String bucketName = "你的bucketName";
            // 指定文件上传到 COS 上的路径,即对象键。例如对象键为folder/picture.jpg,则表示将文件 picture.jpg 上传到 folder 路径下
            String key = "test-11.png";
            PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, key, localFile);
            PutObjectResult putObjectResult = cosClient.putObject(putObjectRequest);
            System.out.println(JSON.toJSONString(putObjectResult));
        } catch (Exception clientException) {
            clientException.printStackTrace();
        }

    }
}

Springboot集成COS

添加配置

# 腾讯COS
tencent:
  cos:
    file:
      region: ap-nanjing
      secretid: AKIDMXXXXXXXXXapnTt
      secretkey: B4h4AzXXXXXXXXXXfGbfSyDBs
      bucketname: txkt-1256940009

创建配置类

@Component
public class ConstantPropertiesUtil implements InitializingBean {

    @Value("${tencent.cos.file.region}")
    private String region;

    @Value("${tencent.cos.file.secretid}")
    private String secretId;

    @Value("${tencent.cos.file.secretkey}")
    private String secretKey;

    @Value("${tencent.cos.file.bucketname}")
    private String bucketName;

    public static String END_POINT;
    public static String ACCESS_KEY_ID;
    public static String ACCESS_KEY_SECRET;
    public static String BUCKET_NAME;

    @Override
    public void afterPropertiesSet() throws Exception {
        END_POINT = region;
        ACCESS_KEY_ID = secretId;
        ACCESS_KEY_SECRET = secretKey;
        BUCKET_NAME = bucketName;
    }
}

创建Service

public interface FileService {
    //文件上传
    String upload(MultipartFile file);
}
@Service
public class FileServiceImpl implements FileService {

    //文件上传
    @Override
    public String upload(MultipartFile file) {
        // 1 初始化用户身份信息(secretId, secretKey)。
        String secretId = ConstantPropertiesUtil.ACCESS_KEY_ID;
        String secretKey = ConstantPropertiesUtil.ACCESS_KEY_SECRET;
        COSCredentials cred = new BasicCOSCredentials(secretId, secretKey);
        // 2 设置 bucket 的地域, COS 地域的简称请参照 https://cloud.tencent.com/document/product/436/6224
        Region region = new Region(ConstantPropertiesUtil.END_POINT);
        ClientConfig clientConfig = new ClientConfig(region);
        // 这里建议设置使用 https 协议
        clientConfig.setHttpProtocol(HttpProtocol.https);
        // 3 生成 cos 客户端。
        COSClient cosClient = new COSClient(cred, clientConfig);

        // 存储桶的命名格式为 BucketName-APPID,此处填写的存储桶名称必须为此格式
        String bucketName = ConstantPropertiesUtil.BUCKET_NAME;
        // 对象键(Key)是对象在存储桶中的唯一标识。  998u-09iu-09i-333
        //在文件名称前面添加uuid值
        String key = UUID.randomUUID().toString().replaceAll("-","")
                +file.getOriginalFilename();
        //对上传文件分组,根据当前日期  /2022/11/11
        String dateTime = new DateTime().toString("yyyy/MM/dd");
        key = dateTime+"/"+key;
        try {
            //获取上传文件输入流
            InputStream inputStream = file.getInputStream();
            ObjectMetadata objectMetadata = new ObjectMetadata();
            PutObjectRequest putObjectRequest = new PutObjectRequest(
                    bucketName,
                    key,
                    inputStream,
                    objectMetadata);
            // 高级接口会返回一个异步结果Upload
            PutObjectResult putObjectResult = cosClient.putObject(putObjectRequest);
            //返回上传文件路径
            //https://ggkt-atguigu-1310644373.cos.ap-beijing.myqcloud.com/01.jpg
            String url = "https://"+bucketName+"."+"cos"+"."+ConstantPropertiesUtil.END_POINT+".myqcloud.com"+"/"+key;
            return url;
        } catch (Exception e) {
            e.printStackTrace();
        }
        return null;
    }
}

创建controller

@Api(tags = "文件上传接口")
@RestController
@RequestMapping("/admin/file")
public class FileUploadController {
    @Autowired
    private FileService fileService;
    /**
     * 文件上传
     */
    @ApiOperation(value = "文件上传")
    @PostMapping("upload")
    public Result upload(
            @ApiParam(name = "file", value = "文件", required = true)
            @RequestParam("file") MultipartFile file) {
        String uploadUrl = fileService.upload(file);
        return Result.ok(uploadUrl).message("文件上传成功");
    }
}
### Spring Boot 集成腾讯COS 服务配置指南 为了在 Spring Boot集成腾讯云对象存储 (COS),需要完成几个主要部分的设置。这包括引入必要的依赖项、创建并配置应用程序属性文件以及编写用于操作 COSJava 类。 #### 添加 Maven 或 Gradle 依赖 对于基于 Maven 构建工具的应用程序,在 `pom.xml` 文件中加入如下依赖: ```xml <dependency> <groupId>com.qcloud</groupId> <artifactId>cossdk</artifactId> <version>LATEST_VERSION</version><!-- 替换成最新版本号 --> </dependency> ``` 如果是使用 Gradle,则应在 build.gradle 文件里添加下面的内容: ```groovy implementation 'com.qcloud:cossdk:LATEST_VERSION'// 替换成具体版本号 ``` #### 应用程序属性配置 编辑项目的 application.properties 或者 application.yml 来定义连接到 COS 所需的信息,比如 Secret ID 和 Key, Bucket 名字和地区等参数: ```yaml tencent.cos: secret-id: YOUR_SECRET_ID # 用户密钥ID secret-key: YOUR_SECRET_KEY # 用户密钥Key region: ap-guangzhou # 地区名称 bucket-name: your-bucket # 存储桶名 ``` #### 编写访问 COS 的 Service 类 接下来可以构建一个简单的 service 层来处理上传下载等功能。这里给出一个基本的例子展示如何实现这些功能之一——向 COS 上载文件的功能[^1]: ```java @Service public class CosService { private final String secretId; private final String secretKey; private final Region region; private final String bucketName; @Autowired public CosService(@Value("${tencent.cos.secret-id}") String secretId, @Value("${tencent.cos.secret-key}") String secretKey, @Value("${tencent.cos.region}") String regionStr, @Value("${tencent.cos.bucket-name}") String bucketName) { this.secretId = secretId; this.secretKey = secretKey; this.region = new Region(regionStr); this.bucketName = bucketName; } /** * 将本地文件上传COS. */ public void uploadFile(String localFilePath, String key){ COSClient cosClient = null; try{ QCloudCredentials credentials = new BasicCOSCredentials(secretId,secretKey); ClientConfig clientConfig = new ClientConfig(this.region); cosClient = new COSClient(credentials,clientConfig); PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName,key,new File(localFilePath)); PutObjectResult result = cosClient.putObject(putObjectRequest); System.out.println(result.getETag()); } finally { if(cosClient != null){ cosClient.shutdown(); } } } } ``` 通过上述步骤就可以成功地把 Spring Boot 应用同腾讯云的对象存储服务结合起来,并能够执行诸如上传文件之类的操作了。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值