数据备份的OSS接口
最近在做一个新的项目,从RDS备份到OSS,进行数据备份以及后续的还原。这边对阿里云的OSS数据上传接口进行说明,先做下笔记先简单介绍下OSS:
①Object
在OSS中,用户操作的基本数据单元是Object。单个Object最大允许存储5TB的数据。Object包含key、meta和data。其中,key是Object的名字;meta是用户对该object的描述,由一系列name-value对组成;data是Object的数据。
其中Object命名规范:使用UTF-8编码;长度必须在1-1023字节之间;不能以”/或者”\字符开头。
命名demo1:example.txt 这个在Bucket内存储的就是一个文件。
命名demo2:cd/example.txt 这个在Bucket内存储的就是一个文件夹的形式,一级目录是cd,二级目录才是文件example.txt。等下我会在下面的demo实例中给出截图。
②Bucket
存储在OSS上的每个Object必须都包含在某个Bucket中。这个去阿里的OSS上注册OSS实体Bucket。系统会给用户分配一对Access Key ID和Access Key Secret,称为ID对,用于标识用户,为访问OSS的每个Bucket做签名验证。
1)文件存储到OSS:
我们使用的是OSSClient中的方法public PutObjectResult putObject(String bucketName, String key, File file, ObjectMetadata metadata)
参数介绍:
bucketName:你的Bucket名称
key:就是你存储Object的路径,也就是上面介绍的Object命名。like:"example.tar"
file:你存储到OSS上的文件
metadata:ObjectMetaData是用户对该object的描述,由一系列name-value对组成。这里我们直接设为空。
import com.aliyun.oss.OSSClient; import com.aliyun.oss.model.ObjectMetadata; import com.aliyun.oss.model.PutObjectResult; import java.io.File; import java.io.InputStream; import java.net.HttpURLConnection; import java.net.URL; /** * Created by XuHui on 2016/9/28. */ public class TestJava { static String accessKeyId = "Your Access Key ID";//你注册OSS建立实例Bucket的accessKeyId和accessKeySecret static String accessKeySecret = "Your Access Key Secret"; static String endPoint = "OSS url";//OSS的访问地址 static String bucketName = "bucket-example";//Bucket的名称 public static void main(String[] rags)throws Exception{ //上传的File File file = new File("C:\\Users\\Desktop\\example.tar"); OSSClient ossClient = new OSSClient(endPoint, accessKeyId, accessKeySecret); //objKey是存储到Bucket的Object的相对路径 String objKey = "example.tar"; ObjectMetadata objMetadata = new ObjectMetadata();//objMetadata可为空 PutObjectResult result = ossClient.putObject(bucketName, objKey, file, objMetadata); System.out.print("PutObjectResult " + result + ", " + result.getETag()); } }
看看Bukect的存储效果
2)URL下载内容存储到OSS:
我们使用的是OSSClient中的方法public PutObjectResult putObject(String bucketName, String key, InputStream input, ObjectMetadata metadata)
参数介绍:
bucketName:你的Bucket名称
key:就是你存储Object的路径,也就是上面介绍的Object命名。like:"cd/example.tar"
input:也就是输入流,这个我们把Url内容存储到OSS的Bukect上,其实也就是转化为流的方式进行存储的。这样做的目的主要就是url下载File,把File上传到OSS,这样会大大影响存储速率。所以在项目中数据备份都是通过流的方式,而不是建立中间临时文件。
metadata:ObjectMetaData是用户对该object的描述,由一系列name-value对组成。这里我们直接设为空。
注:获取流的方法除了我下面写的,还有我注释掉的bis = url.openStream()这种方法同样可以获取到InputStream。
import com.aliyun.oss.OSSClient; import com.aliyun.oss.model.ObjectMetadata; import com.aliyun.oss.model.PutObjectResult; import java.io.InputStream; import java.net.HttpURLConnection; import java.net.URL; /** * Created by XuHui on 2016/9/28. */ public class TestJava { static String accessKeyId = "Your Access Key ID";//你注册OSS建立实例Bucket的accessKeyId和accessKeySecret static String accessKeySecret = "Your Access Key Secret"; static String endPoint = "OSS url";//OSS的访问地址 static String bucketName = "bucket-example";//Bucket的名称 public static void main(String[] rags)throws Exception{ //上传的Url地址 String path = "Your Download Url"; URL url = new URL(path.trim()); HttpURLConnection urlConnection = (HttpURLConnection) url.openConnection(); InputStream bis = urlConnection.getInputStream(); //bis = url.openStream(); //创建OSSClient OSSClient ossClient = new OSSClient(endPoint, accessKeyId, accessKeySecret); //objKey是存储到Bucket的Object的相对路径 String objKey = "cd/example.tar"; ObjectMetadata objMetadata = new ObjectMetadata();//objMetadata可为空 PutObjectResult result = ossClient.putObject(bucketName, objKey, bis, objMetadata); System.out.print("PutObjectResult " + result + ", " + result.getETag()); } }
下面直接看下存储的Bucket效果吧
这边我说一个这个程序很奇怪的问题,这边我自己弄了好久。OSS的访问endPoint地址,我的Bucket上信息显示oss-cn-hangzhou-am24-a.**.lab.com,用这个地址一直不能上传,之后我改成地址前面加BucketName:bucket-for-rds.oss-cn-hangzhou-am24-a.**.lab.com才好使。
这个遇到的同学还可以尝试endPoint前面加BukectName,这个我猜测可能是公有云和私有云的区别,有了解的同学可以交流一下。最近一直在做数据存储方面的项目,如果描述或者程序有错,请指出,谢谢~