初始化

确定 Endpoint

Endpoint 是阿里云 OSS 服务在各个区域的地址，目前支持两种形式：

• OSS 区域地址

  使用 OSS Bucket 所在区域地址时，您可以通过以下两种方式查询 Endpoint：

  • 查询 Endpoint 与区域对应关系详情，可以参考访问域名和数据中心。
  • 您可以登录 阿里云 OSS 管理控制台，进入 Bucket 概览页，Bucket 域名bucket-1.oss-cn-hangzhou.aliyuncs.com的后缀部分oss-cn-hangzhou.aliyuncs.com，即为该 Bucket 的外网 Endpoint。
• 用户自定义域名

  通过 CNAME 将自定义域名绑定到某个存储空间上，然后通过该域名访问存储空间内的文件。

  假设您要将域名 new-image.xxxxx.com 绑定到深圳区域名称为 image 的存储空间。您需要到您的域名xxxxx.com托管商处设定一个新的域名解析，并将http://new-image.xxxxx.com 解析到 http://image.oss-cn-shenzhen.aliyuncs.com ，类型为 CNAME。

设置 EndPoint 和凭证

移动终端是一个不受信任的环境，把AccessKeyId和AccessKeySecret直接保存在终端用来加签请求，存在极高的风险。推荐使用STS鉴权模式或自签名模式，详情请参考访问控制、 移动端直传。

设置 EndPoint 和 CredentialProvider 示例如下：

NSString *endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// 由阿里云颁发的AccessKeyId/AccessKeySecret构造一个CredentialProvider。
// 推荐使用OSSAuthCredentialProvider，token过期后会自动刷新。
id<OSSCredentialProvider> credential = [[OSSAuthCredentialProvider alloc] initWithAuthServerUrl:@"应用服务器地址，例如http://abc.com:8080"];
client = [[OSSClient alloc] initWithEndpoint:endPoint credentialProvider:credential];
			

设置 EndPoint 为 CNAME

如果您已经在 Bucket 上绑定 CNAME，将该 Endpoint 设置为 CNAME 即可。

NSString *endpoint = "http://new-image.xxxxx.com";
// 推荐使用OSSAuthCredentialProvider，token过期后会自动刷新。
id<OSSCredentialProvider> credential = [[OSSAuthCredentialProvider alloc] initWithAuthServerUrl:@"应用服务器地址，例如http://abc.com:8080"];
client = [[OSSClient alloc] initWithEndpoint:endPoint credentialProvider:credential];
			

启用日志

//日志的样式
//2017/10/25 11:05:43:863  [Debug]: 第17次：<NSThread: 0x7f8099108580>{number = 3, name = (null)}
//2017/10/25 11:05:43:863  [Debug]: 第15次：<NSThread: 0x7f80976052c0>
//2017/10/25 11:05:43:863  [Debug]: ----------TestDebug------------
[OSSLog enableLog];//执行该方法，开启日志记录
				

设置 ClientConfiguration

以下代码用于初始化时设置详细的 ClientConfiguration：

NSString *endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 推荐使用OSSAuthCredentialProvider，token过期后会自动刷新。
id<OSSCredentialProvider> credential = [[OSSAuthCredentialProvider alloc] initWithAuthServerUrl:@"应用服务器地址，例如http://abc.com:8080"];
                                                                                                        
OSSClientConfiguration * conf = [OSSClientConfiguration new];
conf.maxRetryCount = 3; // 网络请求遇到异常失败后的重试次数
conf.timeoutIntervalForRequest = 30; // 网络请求的超时时间
conf.timeoutIntervalForResource = 24 * 60 * 60; // 允许资源传输的最长时间
client = [[OSSClient alloc] initWithEndpoint:endPoint credentialProvider:credential clientConfiguration:conf];
			

OSSTask

所有调用 API 的操作都会立即获得一个 OSSTask，如：

OSSTask * task = [client getObject:get];

您可以为这个 Task 设置延续 (continution) 以实现异步回调，如：

[task continueWithBlock: ^(OSSTask *task) {
    // do something
    ...
    return nil;
}];

[task waitUntilFinished];