初始化OSSClient

您可以通過以下多種方式新建OSSClient。

配置OSSClient

ClientConfiguration是OSSClient的配置類，您可通過此類來配置代理、連接超時、最大連接數(shù)等參數(shù)。

以下代碼用于使用ClientConfiguration配置OSSClient參數(shù)。

// yourEndpoint填寫B(tài)ucket所在地域?qū)腅ndpoint。以華東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填寫B(tài)ucket所在地域。以華東1（杭州）為例，region填寫為cn-hangzhou。
String region = "yourRegion";

ClientConfiguration configuration = new ClientConfiguration();
// 設置最大并發(fā)數(shù)，默認值5。
// configuration.setMaxConcurrentRequest(3);
// 設置Socket層傳輸數(shù)據(jù)的超時時間，默認值60s。
// configuration.setSocketTimeout(50000);
// 設置建立連接的超時時間，默認值60s。
// configuration.setConnectionTimeout(50000);
// 設置日志文件大小，默認值5 MB。
// configuration.setMaxLogSize(3 * 1024 * 1024);
// 請求失敗后最大的重試次數(shù)，默認值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);
// 創(chuàng)建OSSClient實例。
OSSClient oss = new OSSClient(getApplicationContext(), endpoint, credentialProvider);
oss.setRegion(region);

啟用日志

移動端的使用環(huán)境比較復雜。會出現(xiàn)部分區(qū)域或某一個時段無法正常使用OSS SDK的情況。為了進一步方便開發(fā)者定位問題，OSS SDK在開啟日志記錄功能后，會將一些日志信息記錄在本地。如需開啟，需要在OSSClient使用之前進行初始化，調(diào)用方法如下。

// 日志樣式。
// 通過調(diào)用OSSLog.enableLog()開啟在控制臺查看日志。
// 支持在手機內(nèi)置sd卡路徑\OSSLog\logs.csv下寫入日志文件，默認不開啟。
// 日志會記錄OSS操作行為中的請求數(shù)據(jù)、返回數(shù)據(jù)、異常信息。
// 例如requestId、response header等。
// 以下為日志記錄示例。
// Android版本。
// android_version：5.1  
// Android手機型號。
// mobile_model：XT1085
// 網(wǎng)絡狀況。  
// network_state：connected
// 網(wǎng)絡連接類型。
// 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
// 調(diào)用此方法開啟日志。
OSSLog.enableLog();              

同步接口和異步接口說明