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();              

Le SDK Android propose des exemples d'appels synchrones et asynchrones pour les interfaces de téléversement et de téléchargement. Cette distinction s'explique par l'interdiction d'effectuer des requêtes réseau dans le thread d'interface utilisateur lors du développement d'applications mobiles. Pour les autres interfaces, les exemples fournis privilégient les appels asynchrones.

• Appel synchrone

  • Un appel d'interface synchrone bloque le thread jusqu'au renvoi d'un résultat.

  • N'appelez pas d'interfaces synchrones dans le thread d'interface utilisateur.

  • Lorsqu'une exception se produit lors d'un appel d'interface synchrone, une ClientException ou une ServiceException est directement levée. Une ClientException indique une exception locale, telle qu'un problème de connectivité réseau ou un paramètre invalide. Une ServiceException signale une erreur de service renvoyée par OSS, comme un échec d'authentification ou une erreur serveur.

• Appel asynchrone

  • Pour une interface asynchrone, transmettez une fonction de rappel lors de la requête. Le résultat de la requête est traité dans ce rappel.

  • Lorsqu'une exception survient lors d'une requête asynchrone, elle est gérée dans la fonction de rappel.

  • L'appel d'une interface asynchrone renvoie directement une Task.

    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.