Utilisez la méthode HeadObject pour récupérer les métadonnées d'un objet sans télécharger son contenu.
Notes
Les métadonnées d'objet décrivent les propriétés d'un objet. Elles comprennent les en-têtes HTTP standard et les métadonnées définies par l'utilisateur. Configurez les en-têtes HTTP standard pour définir des politiques de requête HTTP, telles que les politiques de mise en cache ou de téléchargement forcé. Définissez également 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 à l'aide d'un nom de domaine personnalisé ou du Security Token Service (STS). Pour plus d'informations, consultez la rubrique Initialisation (SDK Android).
Exemple de code
L'exemple de 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.