安装和初始化

MSS服务介绍

美团云存储服务(Meituan Storage Service, 简称MSS),是美团云对外提供的对象存储服务,其具备高可靠,安全,低成本等特性,并且其API兼容S3。MSS适合存放非结构化的数据,比如图片,视频,文档,备份等。

MSS基本概念介绍

MSS的API兼容S3, 其基本概念也和S3相同,主要包括Object, Bucket, Access Key, Secret Key等。
Object对应一个文件,包括数据和元数据两部分。元数据以key-value的形式构成,它包含一些默认的元数据信息,比如Content-Type, Etag等,用户也可以自定义元数据。
Bucket是object的容器,每个object都必须包含在一个bucket中。用户可以创建任意多个bucket。
Access Key和Secret Key: 用户注册MSS时,系统会给用户分配一对Access Key和Secret Key, 用于标识用户,用户在使用API使用MSS服务时,需要使用这两个Key。请在美团云管理控制台查询AccessKey和SecretKey。

MSS访问域名

mtmss.com

安装

下载MSS SDK for Java包后,进入MSS SDK for Java目录下,运行"mvn install",即可完成MSS SDK for Java的安装。
新创建的MSS相关的maven项目,只需要在pom文件的下添加MSS SDK for Java依赖:

<dependency>
        <groupId>com.amazonaws</groupId>
        <artifactId>mss-java-sdk-s3</artifactId>
        <version>1.9.4</version>
    </dependency>

注意:目前MSS SDK支持的Java版本包括Java1.6,Java1.7和Java1.8。

确定Endpoint

示例 说明
northchina1.mtmss.com 公网访问北京区域的Bucket
eastchina1.mtmss.com 公网访问上海区域的Bucket

初始化MSSClient

向MSS发送任一HTTP请求之前,必须先创建一个MSSClient实例:

//accessKey:用户的Access Key ID
//secretKey:用户的Access Key Secret
//hostname:MSS的endpoint服务地址
public static AmazonS3 CreateAmazonS3Conn (String accessKey, String secretKey, String hostname){
    AWSCredentials credentials = new BasicAWSCredentials(accessKey, secretKey);

    //生成云存储api client
    mssClient = new AmazonS3Client(credentials);

    //配置云存储服务地址
    mssClient.setEndpoint(hostname);

    //设置客户端生成的http请求hos格式,目前只支持path type的格式,不支持bucket域名的格式
    S3ClientOptions s3ClientOptions = new S3ClientOptions();
    s3ClientOptions.setPathStyleAccess(true);
    mssClient.setS3ClientOptions(s3ClientOptions);
    return mssClient;
}