qcloud-java-sdk

简介

java sdk for picture service of tencentyun.

版本信息

v2.0.0

支持2.0版本的图片restful api。内部实现了高度封装，对开发者透明。

v1.2.1

增加视频分片上传功能，较大视频可使用分片上传。

v1.2.0

稳定版本，支持微视频的基本api。 包括视频的上传、下载、查询和删除。

v1.0.0

稳定版本，支持图片云的基本api。 包括图片的上传、下载、复制、查询和删除。

v0.0.1

初始非稳定版本，仅支持上传。后续将会继续完善。

How to start

1. 在腾讯云 申请业务的授权

授权包括：

APP_ID 
SECRET_ID
SECRET_KEY

2.0版本的云服务在使用前，还需要先创建空间。在使用2.0 api时，需要使用空间名（Bucket）。

2. 创建对应操作类的对象

如果要使用图片，需要创建图片操作类对象

//v1版本	
PicCloud pc = new PicCloud(APP_ID, SECRET_ID, SECRET_KEY);
//v2版本
PicCloud pc = new PicCloud(APP_ID, SECRET_ID, SECRET_KEY, Bucket);

如果要使用视频，需要创建视频操作类对象

VideoCloud vc = new VideoCloud(APP_ID, SECRET_ID, SECRET_KEY);	

3. 调用对应的方法

在创建完对象后，根据实际需求，调用对应的操作方法就可以了。sdk提供的方法包括：签名计算、上传、复制、查询、下载和删除等。

获得版本信息

String version = pc.GetVersion();

上传数据

如果需要上传图片，根据不同的需求，可以选择不同的上传方法

//UploadResult是上传的返回结果
UploadResult result = new UploadResult();
//最简单的上传接口，提供userid和图片路径即可
int ret = Upload(userid, fileName, result);
//可以自定义fileid的上传接口
int ret = Upload(userid, fileName, fileid, result);

如果需要上传视频

//直接上传
int ret = vc.Upload(userid, video,"test_title","test_Desc","test_magic_context", result);
//视频分片上传
ret = vc.SliceUpload(userid, video,"test_title","test_Desc","test_magic_context", result);

复制图片

UploadResult result = new UploadResult();
int ret = pc.Copy(userid, fileid, result);

查询图片(视频)

//图片查询
PicInfo picInfo = new PicInfo();	
int ret = pc.Stat(userid, fileid, picInfo);
//视频查询
VideoInfo videoInfo = new VideoInfo();	
ret = vc.Stat(userid, fileid, videoInfo);

删除图片(视频)

ret = pc.Delete(userid, fileid);

下载图片

下载图片直接利用图片的下载url即可，开发者可以自行处理，这里提供的是本地下载的方法。 如果开启了防盗链，还需要在下载url后面追加签名，如果要自行处理，请参考腾讯云的wiki页，熟悉鉴权签名的算法。

//不开启防盗链
//ret = pc.Download(userid, result.fileid, "./download.jpg");
//开启防盗链
	ret = pc.DownloadEx(userid, result.fileid, "./download.jpg");
//直接提供url下载
//ret = pc.Download(result.download_url, "./download.jpg");