前言
本文档基于AWS Java SDK 编写. 互盟云对象存储支持AWS S3接口。
环境准备
请使用JDK 6及以上版本。
安装方式
在Maven项目中加入依赖项(推荐方式)
在Maven工程中使用S3 Java SDK,只需在pom.xml中加入相应依赖项即可。以1.11.490版本为例,在<dependencies>内加入如下内容:
<dependency>
<groupId>com.amazonaws</groupId>
<artifactId>aws-java-sdk-s3</artifactId>
<version>1.11.490</version>
</dependency>
在Eclipse项目中导入JAR包
步骤如下:
下载AWS Java SDK开发包。
1.解压该开发包。
2.将解压后文件夹中的 aws-java-sdk-<versionId>.jar 以及lib文件夹下的所有文件拷贝到您的项目中。
3.在Eclipse中选择您的工程,右击选择 Properties > Java Build Path > Libraries > Add JARs。
选中您在第3步拷贝的所有JAR文件,导入到Libraries中。
初始化
您可以创建S3Client,用于管理存储空间和文件等OSS资源。使用Java SDK发起OSS请求,您需要使用您的AccessKey和SecretKey初始化一个S3Client,并根据需要修改ClientConfig的默认配置项。
新建S3Client
import com.amazonaws.auth.AWSCredentialsProvider;
import com.amazonaws.auth.AWSStaticCredentialsProvider;
import com.amazonaws.client.builder.AwsClientBuilder;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3Client;
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.ClientConfiguration;
import com.amazonaws.Protocol;
import com.amazonaws.SDKGlobalConfiguration;
public class S3SdkTest{
public static void main(String[ ] args) {
final String accessKey = "<your accesskey>";
final String secretKey = "<your secretkey>";
final String endpoint = "https://oss-cn-shenzhen.humengyun.com";
ClientConfiguration config = new ClientConfiguration();
AwsClientBuilder.EndpointConfiguration endpointConfig =
new AwsClientBuilder.EndpointConfiguration(endpoint, "<REGION>");
AWSCredentials awsCredentials = new BasicAWSCredentials(accessKey,secretKey);
AWSCredentialsProvider awsCredentialsProvider = new AWSStaticCredentialsProvider(awsCredentials);
AmazonS3 s3 = AmazonS3Client.builder()
.withEndpointConfiguration(endpointConfig)
.withClientConfiguration(config)
.withCredentials(awsCredentialsProvider)
.disableChunkedEncoding()
.withPathStyleAccessEnabled(true)
.build();
}
}