Object Storage Service:Inicialización (SDK de Android)

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

El SDK de Android proporciona ejemplos de llamadas síncronas y asíncronas para las interfaces de carga y descarga. Esto se debe a que el desarrollo de aplicaciones móviles no permite solicitudes de red en el hilo de la interfaz de usuario. Para las demás interfaces, los ejemplos principales son llamadas asíncronas.

• Llamada síncrona

  • Una llamada a una interfaz síncrona bloquea el hilo hasta que devuelve un resultado.

  • No llame a interfaces síncronas desde el hilo de la interfaz de usuario.

  • Si ocurre una excepción durante una llamada a una interfaz síncrona, se lanza directamente una ClientException o una ServiceException. Una ClientException indica una excepción local, como un problema de conectividad de red o un parámetro no válido. Una ServiceException indica un error del servicio que devuelve OSS, como un fallo de autenticación o un error del servidor.

• Llamada asíncrona

  • En una interfaz asíncrona, usted pasa una función de callback al hacer la solicitud. El resultado de la solicitud se procesa en dicho callback.

  • Si ocurre una excepción durante una solicitud asíncrona, la función de callback gestiona el error.

  • La llamada a una interfaz asíncrona devuelve directamente un 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.