数据备份的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，这个我猜测可能是公有云和私有云的区别，有了解的同学可以交流一下。最近一直在做数据存储方面的项目，如果描述或者程序有错，请指出，谢谢~