Android初始化

初始化OSSClient

您可以通过以下多种方式新建OSSClient。

配置OSSClient

ClientConfiguration是OSSClient的配置类，您可通过此类来配置代理、连接超时、最大连接数等参数。

以下代码用于使用ClientConfiguration配置OSSClient参数。

// yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
String endpoint = "yourEndpoint";
// 从STS服务获取的临时访问密钥（AccessKey ID和AccessKey Secret）。
String accessKeyId = "yourAccessKeyId";
String accessKeySecret = "yourAccessKeySecret";
// 从STS服务获取的安全令牌（SecurityToken）。
String securityToken = "yourSecurityToken";
// yourEndpoint填写Bucket所在地域。以华东1（杭州）为例，region填写为cn-hangzhou。
String region = "yourRegion";

ClientConfiguration configuration = new ClientConfiguration();
// 设置最大并发数，默认值5。
// configuration.setMaxConcurrentRequest(3);
// 设置Socket层传输数据的超时时间，默认值60s。
// configuration.setSocketTimeout(50000);
// 设置建立连接的超时时间，默认值60s。
// configuration.setConnectionTimeout(50000);
// 设置日志文件大小，默认值5 MB。
// configuration.setMaxLogSize(3 * 1024 * 1024);
// 请求失败后最大的重试次数，默认值2。
// configuration.setMaxErrorRetry(3);
// 列表中的元素将跳过CNAME解析。
// List<String> cnameExcludeList = new ArrayList<>();
// cnameExcludeList.add("cname");
// configuration.setCustomCnameExcludeList(cnameExcludeList);
// 代理服务器主机地址。
// configuration.setProxyHost("yourProxyHost");
// 代理服务器端口。
// configuration.setProxyPort(8080);
// 用户代理中HTTP的User-Agent头。
// configuration.setUserAgentMark("yourUserAgent");
// 是否开启CRC校验，默认值false。
// configuration.setCheckCRC64(true);
// 是否开启HTTP重定向，默认值false。
// configuration.setFollowRedirectsEnable(true);
// 设置自定义OkHttpClient。
// OkHttpClient.Builder builder = new OkHttpClient.Builder();
// configuration.setOkHttpClient(builder.build());

OSSCredentialProvider credentialProvider = new OSSStsTokenCredentialProvider(accessKeyId, accessKeySecret, securityToken);
configuration.setSignVersion(SignVersion.V4);
// 创建OSSClient实例。
OSSClient oss = new OSSClient(getApplicationContext(), endpoint, credentialProvider);
oss.setRegion(region);

启用日志

移动端的使用环境比较复杂。会出现部分区域或某一个时段无法正常使用OSS SDK的情况。为了进一步方便开发者定位问题，OSS SDK在开启日志记录功能后，会将一些日志信息记录在本地。如需开启，需要在OSSClient使用之前进行初始化，调用方法如下。

// 日志样式。
// 通过调用OSSLog.enableLog()开启在控制台查看日志。
// 支持在手机内置sd卡路径\OSSLog\logs.csv下写入日志文件，默认不开启。
// 日志会记录OSS操作行为中的请求数据、返回数据、异常信息。
// 例如requestId、response header等。
// 以下为日志记录示例。
// Android版本。
// android_version：5.1  
// Android手机型号。
// mobile_model：XT1085
// 网络状况。  
// network_state：connected
// 网络连接类型。
// network_type：WIFI 
// 具体的操作行为信息。
// [2017-09-05 16:54:52] - Encounter local execpiton: //java.lang.IllegalArgumentException: The bucket name is invalid. 
// A bucket name must: 
// 1) be comprised of lower-case characters, numbers or dash(-); 
// 2) start with lower case or numbers; 
// 3) be between 3-63 characters long. 
//------>end of log
// 调用此方法开启日志。
OSSLog.enableLog();              

同步接口和异步接口说明