Object Storage Service：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";

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);
// Proxy 伺服器主機地址。
// configuration.setProxyHost("yourProxyHost");
// Proxy 伺服器連接埠。
// 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);
// 建立OSSClient執行個體。
OSSClient oss = new OSSClient(getApplicationContext(),endpoint, credentialProvider, configuration);

啟用日誌

移動端的使用環境比較複雜。會出現部分地區或某一個時段無法正常使用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();              

同步介面和非同步介面說明