Utilisez la méthode HeadObject pour récupérer les métadonnées d'un objet sans son contenu.
Notes
Les métadonnées d'un objet décrivent ses propriétés. Elles incluent des en-têtes HTTP standard et des métadonnées définies par l'utilisateur. Vous pouvez configurer des en-têtes HTTP standard pour définir des politiques de requête HTTP, telles que des politiques de mise en cache ou de téléchargement forcé. Vous pouvez également définir des métadonnées personnalisées pour identifier l'objectif ou les propriétés d'un objet. Pour plus d'informations, consultez la rubrique Métadonnées d'objet.
Le SDK OSS pour Android ne prend pas en charge la définition ni la modification des métadonnées d'objet.
Avant d'exécuter l'exemple de code de cette rubrique, créez une instance OSSClient en utilisant un nom de domaine personnalisé ou le Security Token Service (STS). Pour plus d'informations, consultez la rubrique Initialisation (SDK Android).
Exemple de code
Le code suivant montre comment récupérer les métadonnées d'un objet.
// Create a request to synchronously get object metadata.
// Specify the bucket name, such as examplebucket, and the full path of the object, such as exampledir/exampleobject.txt. The full path cannot contain the bucket name.
HeadObjectRequest head = new HeadObjectRequest("examplebucket", "exampledir/exampleobject.txt");
// Get the object metadata.
OSSAsyncTask task = oss.asyncHeadObject(head, new OSSCompletedCallback<HeadObjectRequest, HeadObjectResult>() {
@Override
public void onSuccess(HeadObjectRequest request, HeadObjectResult result) {
// Get the object length.
Log.d("headObject", "object Size: " + result.getMetadata().getContentLength());
// Get the object type.
Log.d("headObject", "object Content Type: " + result.getMetadata().getContentType());
}
@Override
public void onFailure(HeadObjectRequest request, ClientException clientExcepion, ServiceException serviceException) {
// Request exception.
if (clientExcepion != null) {
// A client exception occurred, such as a network error.
clientExcepion.printStackTrace();
}
if (serviceException != null) {
// A server exception occurred.
Log.e("ErrorCode", serviceException.getErrorCode());
Log.e("RequestId", serviceException.getRequestId());
Log.e("HostId", serviceException.getHostId());
Log.e("RawMessage", serviceException.getRawMessage());
}
}
});
// task.waitUntilFinished(); // Wait for the task to complete.Références
Pour plus d'informations sur l'opération API permettant de récupérer les métadonnées d'un objet, consultez la rubrique GetObjectMeta.
Pour savoir comment initialiser une instance OSSClient, consultez la rubrique Initialiser une instance OSSClient pour Android.