Fork me on GitHub

腾讯云 COS 对象存储 简单文件上传笔记

这两天用到了腾讯云的 COS对象存储 了(阿里云的对象存储叫:OSS),因此记录一下简单上传的代码,其他的代码后续会逐步上;

COS 对象存储 - 简单文件上传代码:

1、官方文档

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


2、SDK

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

3、代码 

我使用的是COS的本地文件上传方式,前端传来的文件数据是【MultipartFile】类型的,但是COS在接收本地文件上传时接收的文件数据类型是【File】,因此需要先转一下并生成一个临时的本地文件(生成在服务器端),因此在上传成功后需要删除生成的临时文件,所以,思路很清晰;

  第一步:创建COS连接对象并将【MultipartFile】转化生成一个【File】类型的本地临时文件在服务器上;

  第二步:使用COS连接对象开始上传文件;

  第三步:关闭COS连接、删除本地临时文件;

代码围绕上面的三步如下:

public class COSUploadUtils {

    // 初始化用户身份信息(secretId, secretKey)
    private static String SecretId = "***********";
    private static String SecretKey = "************";
    // bucket的区域
    private static String region_name = "ap-beijing";
    // bucket名
    private static String bucket_name = "****-130*****93";
    // 文件目录
    private static String fileDir = "/***/**/";


    // 将本地文件上传到COS
    public static String SimpleUploadFileFromLocal(MultipartFile file) {
        // 1 初始化用户身份信息(secretId, secretKey)
        COSCredentials cred = new BasicCOSCredentials(SecretId, SecretKey);
        // 2 设置bucket的区域, COS地域的简称请参照 https://www.qcloud.com/document/product/436/6224
        ClientConfig clientConfig = new ClientConfig(new Region(region_name));
        // 3 生成cos客户端
        COSClient cosclient = new COSClient(cred, clientConfig);


        String originalFilename = file.getOriginalFilename();
        String substring = originalFilename.substring(originalFilename.lastIndexOf(".")).toLowerCase();
        Random random = new Random();

        String name = System.currentTimeMillis()+"";

        String key = System.currentTimeMillis()+ substring;

        File localFile = null;
        try {
            localFile = new File(key);
            InputStream inputStream = file.getInputStream();
            FileUtils.copyInputStreamToFile(inputStream, localFile);
            localFile = File.createTempFile(name, substring);
            file.transferTo(localFile);
            inputStream.close();
        } catch (Exception e) {
            e.printStackTrace();
        }

        PutObjectRequest putObjectRequest = new PutObjectRequest(bucket_name, fileDir+key, localFile);
        // 设置存储类型, 默认是标准(Standard), 低频(standard_ia)
        putObjectRequest.setStorageClass(StorageClass.Standard);
        String fileName = "";
        try {
            PutObjectResult putObjectResult = cosclient.putObject(putObjectRequest);
            // putobjectResult会返回文件的etag
            String etag = putObjectResult.getETag();
            String crc64 = putObjectResult.getCrc64Ecma();
            fileName = name+substring;
        } catch (CosServiceException e) {
            e.printStackTrace();
        } catch (CosClientException e) {
            e.printStackTrace();
        }

        // 关闭客户端
        cosclient.shutdown();
     
        File f = new File(key);
        if(f.exists()){
            f.delete();
        }
        return fileName;
    }
}

注意事项:

  3.1、在写代码前首先开启腾讯COS服务,并创建存储桶;    

    主要的配置其实也没什么,基本上红框里的填上即可;   

  建议上图中的访问权限选择给【公共读私有写】,因为如果设定私密读的话会在后边的文件访问(他们官方叫:下载)有一定的影响,因为私密读的情况下需要进行签名参数,签名参数中必须要有过期时间设定,存在过期时间的设定就会引发一个问题:缓存,当有了时间设定后的就无法再进行缓存了,因为每次创建一个访问链接都会重新设定一个这个链接的超时时间,每个连接都不同,因此很难在客户端做到缓存的操作,所以,正常情况下设定为【公共读、私有写】即可,当然,如果不考虑缓存的话还是【私有读写】更好一点,无他,安全;

  

  3.2、代码中的COS各个配置信息含义及其获取途径:   

  // 初始化用户身份信息(secretId, secretKey)
    private static String SecretId = "***********";
    private static String SecretKey = "************";

  这个尽量使用子账号进行创建,大概的思路就是【1、创建子用户(权限只针对COS的读写,不赋予任何有关权限的权限);2、在存储桶中配置生成】

    // bucket的区域
    private static String region_name = "ap-beijing";
    // bucket名
    private static String bucket_name = "****-130*****93";
// 文件目录
private static String fileDir = "/***/**/";

  这个是我自定义的参数,很有用,而且COS也是支持这样弄得,主要作用其实就是在上传文件时告诉COS这个文件放在那个文件夹下,也就是文件路径,这个文件路径可以不必提前创建,当你写的路径COS对象存储空间中不存在时它会自动创建出来,而这个路径的使用位置是在上面代码中的:

PutObjectRequest putObjectRequest = new PutObjectRequest(bucket_name, fileDir+key, localFile);

这个是配置好的COS的文件上传对象,

fileDir+key:要拆分成两部分去看1、fileDir,文件所在存储桶的文件路径;2、key:文件最终存到存储桶中的文件名称; 

重要:在创建完存储桶后大家需要注意一下它的安全问题,例如防盗链、服务端加密、容灾容错处理、权限的配置等,在此就不多赘述了;

另外,在写demo时还发现了个小知识点:

  delete 与 deleteOnExit 的区别:

    delete : 删除文件,一旦调用,程序立即执行删除操作;

    deleteOnExit :存在则删除, 它被调用时,相当于对deleteOnExit做了一个生声明, 不会立刻执行删除操作, 而是程序运行结束也就是JVM终止时才真正调用删除操作。即该方法是将删除的命令缓存了一下,到服务停止的时候再进行操作! 


 

上面有什么不太理解的同学可以@我,看到后一定会回复;

 

posted @ 2020-12-17 20:26  90后程序猿  阅读(2989)  评论(0编辑  收藏  举报
/* 看板娘 */