注意事項(xiàng)

• 文件元數(shù)據(jù)是對文件的屬性描述，包括HTTP標(biāo)準(zhǔn)屬性（HTTP Header）和用戶自定義元數(shù)據(jù)（User Meta）兩種。您可以通過設(shè)置HTTP標(biāo)準(zhǔn)屬性來自定義HTTP請求的策略，例如文件（Object）緩存策略、強(qiáng)制下載策略等。您還可以通過設(shè)置用戶自定義元數(shù)據(jù)來標(biāo)識Object的用途或?qū)傩缘取８嘈畔ⅲ垍⒁?a title="" class="xref" href="http://bestwisewords.com/zh/oss/user-guide/manage-object-metadata-10#concept-lkf-swy-5db">文件元數(shù)據(jù)。

• Android SDK當(dāng)前不支持設(shè)置和修改文件元數(shù)據(jù)。

• 使用本文示例前您需要先通過自定義域名、STS等方式新建OSSClient，具體請參見如何初始化Android端OSSClient實(shí)例。

示例代碼

以下代碼用于獲取文件元數(shù)據(jù)。

// 創(chuàng)建同步獲取文件元數(shù)據(jù)請求。
// 依次填寫B(tài)ucket名稱（例如examplebucket）和Object完整路徑（例如exampledir/exampleobject.txt）。Object完整路徑中不能包含Bucket名稱。
HeadObjectRequest head = new HeadObjectRequest("examplebucket", "exampledir/exampleobject.txt");

// 獲取文件元數(shù)據(jù)。
OSSAsyncTask task = oss.asyncHeadObject(head, new OSSCompletedCallback<HeadObjectRequest, HeadObjectResult>() {
    @Override
    public void onSuccess(HeadObjectRequest request, HeadObjectResult result) {
    
    // 獲取文件長度。
        Log.d("headObject", "object Size: " + result.getMetadata().getContentLength()); 
    // 獲取文件類型。
        Log.d("headObject", "object Content Type: " + result.getMetadata().getContentType()); 
    }

    @Override
    public void onFailure(HeadObjectRequest request, ClientException clientExcepion, ServiceException serviceException) {
        // 請求異常。
        if (clientExcepion != null) {
            // 本地異常，如網(wǎng)絡(luò)異常等。
            clientExcepion.printStackTrace();
        }
        if (serviceException != null) {
            // 服務(wù)異常。
            Log.e("ErrorCode", serviceException.getErrorCode());
            Log.e("RequestId", serviceException.getRequestId());
            Log.e("HostId", serviceException.getHostId());
            Log.e("RawMessage", serviceException.getRawMessage());
        }
    }
});

// task.waitUntilFinished(); //等待任務(wù)完成。

相關(guān)文檔

• 關(guān)于獲取文件元數(shù)據(jù)的API接口說明，請參見GetObjectMeta。

• 關(guān)于初始化OSSClient，請參見如何初始化Android端OSSClient實(shí)例。