腾讯云存储COS简介和使用流程

目录

一、准备工作

1、注册或登录账号

2、创建COS桶

二,集成腾讯云cos(以Java为例)

1、修改配置

2、添加配置文件内容

3、创建初始化配置的工具类

4、测试如何创建存储桶

5、编写接口实现

6、实现上传文件

7、实现下载文件


一、准备工作

1、注册或登录账号

点击:腾讯云登录或者注册

对于没有账号你来说,就是点击:没用账号,注册后再关联

对于有账号的你来说:我已经有腾讯云账号,登录后关联

2、创建COS桶

点击:购买腾讯云COS

选择:中国大陆通用,存储容量,标准存储容量包。

然后点击:登录腾讯云控制台

创建存储桶。设置存储桶的权限为 公有读,私有写

设置cors规则

AllowHeader 需配成*,如下图所示

因为我们本身没有域名,所以这里设置成*****,仅限于测试,正式环境的话,这里需要配置真实的域名地址

到这里,我们的腾讯云存储桶就设置好了。

二,集成腾讯云cos(以Java为例)

使用SDK需要一些必要信息,比如secret_key和secret_id,这个可以从API密钥管理页面获取。

环境依赖

SDK 支持 JDK 1.7、1.8及以上版本。

1、修改配置

     <!--腾讯云cos依赖-->
        <dependency>
            <groupId>com.qcloud</groupId>
            <artifactId>cos_api</artifactId>
            <version>5.6.54</version>
        </dependency>

        <!-- 日期工具栏依赖 -->
        <dependency>
            <groupId>joda-time</groupId>
            <artifactId>joda-time</artifactId>
        </dependency>

2、添加配置文件内容

# 服务端口
server.port=8205
# 服务名
spring.application.name=service-oss

#返回json的全局时间格式
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
spring.jackson.time-zone=GMT+8

#腾讯云api秘钥id
tencent.yun.secretid=
#腾讯云api秘钥key
tencent.yun.secretkey=

3、创建初始化配置的工具类

/**
 * 在主启动类启动时初始化配置文件中的内容
 * <p>
 * 创建时间: 2022-03-24 14:46
 *
 * @author v_fuxshen
 * @version v1.0.0
 * @since v1.0.0
 */
@Component
public class ConstantOssPropertiesUtils implements InitializingBean {

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

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


	public static String Tencent_secretId;
	public static String Tencent_secretKey;


	@Override
	public void afterPropertiesSet() throws Exception {
		Tencent_secretId = secretId;
		Tencent_secretKey = secretKey;
	}
}

4、测试如何创建存储桶

public class OssTest {
	public static void main(String[] args) {
// 1 初始化用户身份信息(secretId, secretKey)。
        // SECRETID和SECRETKEY请登录访问管理控制台 https://console.cloud.tencent.com/cam/capi 进行查看和管理
		String secretId = "";
		String 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-guangzhou");//此处设置的地域为广州
		ClientConfig clientConfig = new ClientConfig(region);
       // 这里建议设置使用 https 协议
       // 从 5.6.54 版本开始,默认使用了 https
		clientConfig.setHttpProtocol(HttpProtocol.https);
       // 3 生成 cos 客户端。
		COSClient cosClient = new COSClient(cred, clientConfig);


		//创建存储桶  如果腾讯云cos中已经存在存储通,那么此步骤可省略
		String bucket = ""; //存储桶名称,格式:BucketName-APPID
		CreateBucketRequest createBucketRequest = new CreateBucketRequest(bucket);
        // 设置 bucket 的权限为 Private(私有读写)、其他可选有 PublicRead(公有读私有写)、PublicReadWrite(公有读写)
		createBucketRequest.setCannedAcl(CannedAccessControlList.PublicRead);
		try{
			Bucket bucketResult = cosClient.createBucket(createBucketRequest);
		} catch (CosServiceException serverException) {
			serverException.printStackTrace();
		} catch (CosClientException clientException) {
			clientException.printStackTrace();
		}
	}
}

5、编写接口实现

controller

@RestController
@RequestMapping("/api/oss/file")
@Api(tags = "腾讯云cos接口")
public class FileApiController {

	@Autowired
	private FileService fileService;

	@PostMapping("fileUpload")
	@ApiOperation(value = "上传文件到腾讯云")
	public Result fileUpload(MultipartFile file){
		//获取上传文件(返回的为文件存储的路径)
		String url = fileService.fileUpload(file);
        return Result.success(url);
	}
}

service

@Service
@Slf4j
public class FileServiceImpl implements FileService {
	@Override
	public String fileUpload(MultipartFile file) {

		// 1 初始化用户身份信息(secretId, secretKey)。
		// SECRETID和SECRETKEY请登录访问管理控制台 https://console.cloud.tencent.com/cam/capi 进行查看和管理
		String secretId = ConstantOssPropertiesUtils.Tencent_secretId;

		String secretKey = ConstantOssPropertiesUtils.Tencent_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-guangzhou");
		ClientConfig clientConfig = new ClientConfig(region);

		// 这里建议设置使用 https 协议
		// 从 5.6.54 版本开始,默认使用了 https
		clientConfig.setHttpProtocol(HttpProtocol.https);

		// 3 生成 cos 客户端。
		COSClient cosClient = new COSClient(cred, clientConfig);

		// 指定文件将要存放的存储桶
		String bucketName = "yygh-bucket-1307593240";
      
        //文件名称 为了保证文件名称唯一,此处使用uuid来设置文件名称
		String filename = UUID.randomUUID().toString().replaceAll("-","") +"_"+file.getOriginalFilename();

        //目录的生成 当前日期
		SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");
		String date = dateFormat.format(new Date());
		
		// 指定文件上传到 COS 上的路径,即对象键。例如对象键为folder/picture.jpg,则表示将文件 picture.jpg 上传到 folder 路径下
		//此处目录规则为  当前日期/文件名称
		String key = date+"/"+filename;
		PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, key, multipartFileToFile(file));
		PutObjectResult putObjectResult = cosClient.putObject(putObjectRequest);
		log.info("putObjectResult:"+putObjectResult);
		
		//删除本地上传资源
		delteTempFile(multipartFileToFile(file));

		Date expiration = new Date(new Date().getTime() + 5 * 60 * 10000);

		GeneratePresignedUrlRequest req =
				new GeneratePresignedUrlRequest(bucketName, key, HttpMethodName.GET);
		// 设置签名过期时间(可选), 若未进行设置, 则默认使用 ClientConfig 中的签名过期时间(1小时)
		// 可以设置任意一个未来的时间,推荐是设置 10 分钟到 3 天的过期时间
		req.setExpiration(expiration);

		URL url = cosClient.generatePresignedUrl(req);

		//关闭客户端
		cosClient.shutdown();

		//拼接文件地址
		StringBuffer stringBuffer = new StringBuffer()
				.append(url.getProtocol())
				.append("://")
				.append(url.getHost())
				.append(url.getPath());

		return stringBuffer.toString();
	}

	/**
	 * 此方法将multipartFile转为file
	 *
	 * @param file
	 * @return java.io.File
	 * @author v_fuxshen
	 * @date 2022-03-24 15:10:03
	 **/
	private File multipartFileToFile(MultipartFile file)  {

		File toFile = null;
		if (file.equals("") || file.getSize() <= 0) {
			file = null;
		} else {

			try {
				InputStream ins = null;
				ins = file.getInputStream();
				toFile = new File(file.getOriginalFilename());
				inputStreamToFile(ins, toFile);
				ins.close();
			} catch (IOException e) {
				e.printStackTrace();
			}
		}
		return toFile;
	}

	/**
	 * 获取流文件
	 * @param ins
	 * @param file
	 */
	private static void inputStreamToFile(InputStream ins, File file) {
		try {
			OutputStream os = new FileOutputStream(file);
			int bytesRead = 0;
			byte[] buffer = new byte[8192];
			while ((bytesRead = ins.read(buffer, 0, 8192)) != -1) {
				os.write(buffer, 0, bytesRead);
			}
			os.close();
			ins.close();
		} catch (Exception e) {
			e.printStackTrace();
		}
	}


	/**
	 * 删除本地临时文件
	 * @param file
	 */
	public static void delteTempFile(File file) {
		if (file != null) {
			File del = new File(file.toURI());
			del.delete();
		}
	}
}

6、实现上传文件

package com.xxxxx.cjrh.file.server.util;

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.HttpMethodName;
import com.qcloud.cos.model.GeneratePresignedUrlRequest;
import com.qcloud.cos.model.GetObjectRequest;
import com.qcloud.cos.model.PutObjectRequest;
import com.qcloud.cos.model.PutObjectResult;
import com.qcloud.cos.region.Region;
import com.qcloud.cos.transfer.Download;
import com.qcloud.cos.transfer.TransferManager;

import java.io.File;
import java.net.URL;
import java.util.Date;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;

public class CosUtils {

    private static String secretId = "**************";
    private static String secretKey = "**************";
    private static String bucketName = "zs-1259422979";//bucket名称
    private static String regionName = "ap-guangzhou";  //地区
    private static String baseUrl = "https://zs-1259422979.cos.ap-guangzhou.myqcloud.com"; //cos基本地址
    private static String appId = "*****";

    static TransferManager transferManager = null;

    //获取cosClient
    public static COSClient getCosClient() {
        // 1 初始化用户身份信息(secretId, 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(regionName);
        ClientConfig clientConfig = new ClientConfig(region);
        // 3 生成 cos 客户端。
        COSClient cosClient = new COSClient(cred, clientConfig);
        // 指定要上传到 COS 上的路径
        ExecutorService threadPool = Executors.newFixedThreadPool(32);
        // 传入一个 threadpool, 若不传入线程池, 默认 TransferManager 中会生成一个单线程的线程池。
        transferManager = new TransferManager(cosClient, threadPool);
        return cosClient;
    }

    //1.普通上传
    public static String  uploadCos(File localFile ,String filePath){
        //获取客户端
        COSClient cosClient =getCosClient();
        // 指定要上传到 COS 的文件路径
        //String key = "cjrh/img/1111.png";
        String key = filePath;
        PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, key, localFile);
        PutObjectResult putObjectResult = cosClient.putObject(putObjectRequest);
        //关闭客户端
        cosClient.shutdown();
        return baseUrl+"/"+key;
    }

    public static void main(String[] args) {

        // 指定要上传的文件
        File localFile = new File("D:\\1111.png");
        String filePath = "cjrh/img/3333.png";
        String url = uploadCos(localFile,filePath);
       System.out.println(url);



    }
}

7、实现下载文件

public class CosUtils {

    private static String secretId = "*************";
    private static String secretKey = "***********";
    private static String bucketName = "zs-1259422979";//bucket名称
    private static String regionName = "ap-guangzhou";  //地区
    private static String baseUrl = "https://zs-1259422979.cos.ap-guangzhou.myqcloud.com"; //cos基本地址
    private static String appId = "**************";

    static TransferManager transferManager = null;

    //获取cosClient
    public static COSClient getCosClient() {
        // 1 初始化用户身份信息(secretId, 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(regionName);
        ClientConfig clientConfig = new ClientConfig(region);
        // 3 生成 cos 客户端。
        COSClient cosClient = new COSClient(cred, clientConfig);
        // 指定要上传到 COS 上的路径
        ExecutorService threadPool = Executors.newFixedThreadPool(32);
        // 传入一个 threadpool, 若不传入线程池, 默认 TransferManager 中会生成一个单线程的线程池。
        transferManager = new TransferManager(cosClient, threadPool);
        return cosClient;
    }

  

    //2.普通下载
    public static void downLoadFile() {
        // 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(regionName));
        // 3 生成cos客户端
        COSClient cosclient = new COSClient(cred, clientConfig);
        // bucket名需包含appid
        String bucket = "zs-1259422979";

        ExecutorService threadPool = Executors.newFixedThreadPool(32);
        // 传入一个threadpool, 若不传入线程池, 默认TransferManager中会生成一个单线程的线程池。
        TransferManager transferManager = new TransferManager(cosclient, threadPool);

        String key = "/cjrh/img/1111.png";
        File downloadFile = new File("d:/1-4.png");
        GetObjectRequest getObjectRequest = new GetObjectRequest(bucket, key);
        try {
            // 返回一个异步结果copy, 可同步的调用waitForCompletion等待download结束, 成功返回void, 失败抛出异常.
            Download download = transferManager.download(getObjectRequest, downloadFile);
            download.waitForCompletion();
        } catch (CosServiceException e) {
            e.printStackTrace();
        } catch (CosClientException e) {
            e.printStackTrace();
        } catch (InterruptedException e) {
            e.printStackTrace();
        }

        transferManager.shutdownNow();
        cosclient.shutdown();
    }


  

    public static void main(String[] args) {



        //下载
        downLoadFile();

      

    }
}

  • 1
    点赞
  • 11
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值