Object Storage Service:Initialization (Android SDK)

// Set yourEndpoint to the Endpoint of the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set the Endpoint to https://oss-cn-hangzhou.aliyuncs.com.
String endpoint = "yourEndpoint";
// The temporary AccessKey ID and AccessKey secret obtained from the STS service.
String accessKeyId = "yourAccessKeyId";
String accessKeySecret = "yourAccessKeySecret";
// The security token obtained from the STS service.
String securityToken = "yourSecurityToken";
// Set region to the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set the region to cn-hangzhou.
String region = "yourRegion";

ClientConfiguration configuration = new ClientConfiguration();
// Set the maximum number of concurrent requests. Default value: 5.
// configuration.setMaxConcurrentRequest(3);
// Set the timeout period for data transmission at the socket layer. Default value: 60s.
// configuration.setSocketTimeout(50000);
// Set the timeout period for establishing a connection. Default value: 60s.
// configuration.setConnectionTimeout(50000);
// Set the size of the log file. Default value: 5 MB.
// configuration.setMaxLogSize(3 * 1024 * 1024);
// Set the maximum number of retries after a request fails. Default value: 2.
// configuration.setMaxErrorRetry(3);
// Elements in the list will skip CNAME parsing.
// List<String> cnameExcludeList = new ArrayList<>();
// cnameExcludeList.add("cname");
// configuration.setCustomCnameExcludeList(cnameExcludeList);
// The host address of the proxy server.
// configuration.setProxyHost("yourProxyHost");
// The port of the proxy server.
// configuration.setProxyPort(8080);
// The User-Agent header of HTTP in the user agent.
// configuration.setUserAgentMark("yourUserAgent");
// Specifies whether to enable cyclic redundancy check (CRC). Default value: false.
// configuration.setCheckCRC64(true);
// Specifies whether to enable HTTP redirection. Default value: false.
// configuration.setFollowRedirectsEnable(true);
// Set a custom OkHttpClient.
// OkHttpClient.Builder builder = new OkHttpClient.Builder();
// configuration.setOkHttpClient(builder.build());

OSSCredentialProvider credentialProvider = new OSSStsTokenCredentialProvider(accessKeyId, accessKeySecret, securityToken);
configuration.setSignVersion(SignVersion.V4);
// Create an OSSClient instance.
OSSClient oss = new OSSClient(getApplicationContext(), endpoint, credentialProvider);
oss.setRegion(region);

// Log style.
// Call OSSLog.enableLog() to enable viewing logs in the console.
// You can write log files to the \OSSLog\logs.csv path on the phone's built-in SD card. This is disabled by default.
// Logs record request data, response data, and exception information for OSS operations.
// For example, requestId and response header.
// The following is a sample log record.
// Android version.
// android_version: 5.1  
// Android phone model.
// mobile_model: XT1085
// Network status.  
// network_state: connected
// Network connection type.
// network_type: WIFI 
// Specific operation behavior information.
// [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
// Call this method to enable logging.
OSSLog.enableLog();              

Android SDK, yükleme ve indirme arayüzleri için hem senkron hem de asenkron çağrı örnekleri sağlar. Bunun nedeni, mobil uygulama geliştirmede ağ isteklerinin UI iş parçacığında izin verilmemesidir. Diğer arayüzler için asenkron çağrı örnekleri temel örneklerdir.

• Senkron çağrı

  • Senkron bir arayüz çağrısı, bir sonuç dönene kadar iş parçacığını engeller.

  • Senkron arayüzleri UI iş parçacığında çağırmayın.

  • Senkron bir arayüz çağrısı sırasında bir özel durum oluştuğunda, doğrudan bir ClientException veya ServiceException oluşturulur. ClientException, ağ bağlantısı sorunu veya geçersiz bir parametre gibi yerel bir özel durumu belirtir. ServiceException ise kimlik doğrulama hatası veya sunucu hatası gibi OSS tarafından döndürülen bir hizmet hatasını belirtir.

• Asenkron çağrı

  • Asenkron bir arayüz için, istek yaparken bir geri arama işlevi iletirsiniz. İstek sonucu geri aramada işlenir.

  • Asenkron bir istek sırasında bir özel durum oluştuğunda, özel durum geri arama işlevinde işlenir.

  • Asenkron bir arayüzün çağrılması doğrudan bir Task döndürür.

    OSSAsyncTask task = oss.asyncGetObejct(...);
    task.cancel(); // Cancel the task.
    task.waitUntilFinished(); // Wait until the task is complete.
    GetObjectResult result = task.getResult(); // Block the thread and wait for the result.