本文介绍如何列举存储空间中的所有文件及指定前缀的文件。

列举存储空间中所有文件

以下代码用于列举存储空间中所有文件：

ListObjectsRequest listObjects = new ListObjectsRequest("<bucketName>");
 
// 设置成功、失败回调，发送异步列举请求。
OSSAsyncTask task = oss.asyncListObjects(listObjects, new OSSCompletedCallback<ListObjectsRequest, ListObjectsResult>() {
	@Override
	public void onSuccess(ListObjectsRequest request, ListObjectsResult result) {
		Log.d("AyncListObjects", "Success!");
		for (int i = 0; i < result.getObjectSummaries().size(); i++) {
			Log.d("AyncListObjects", "object: " + result.getObjectSummaries().get(i).getKey() + " "
					+ result.getObjectSummaries().get(i).getETag() + " "
					+ result.getObjectSummaries().get(i).getLastModified());
		}
	}

	@Override
	public void onFailure(ListObjectsRequest request, ClientException clientExcepion, ServiceException serviceException) {
		// 请求异常。
		if (clientExcepion != null) {
			// 本地异常，如网络异常等。
			clientExcepion.printStackTrace();
		}
		if (serviceException != null) {
			// 服务异常。
			Log.e("ErrorCode", serviceException.getErrorCode());
			Log.e("RequestId", serviceException.getRequestId());
			Log.e("HostId", serviceException.getHostId());
			Log.e("RawMessage", serviceException.getRawMessage());
		}
	}
});
// 等待任务完成。
task.waitUntilFinished();

列举存储空间中指定前缀的文件

以下代码用于列出存储空间中以“file”为前缀的所有文件。

 ListObjectsRequest listObjects = new ListObjectsRequest("<bucketName>");
 
// 设定前缀
listObjects.setPrefix("file");

// 设置成功、失败回调，发送异步列举请求
OSSAsyncTask task = oss.asyncListObjects(listObjects, new OSSCompletedCallback<ListObjectsRequest, ListObjectsResult>() {
	@Override
	public void onSuccess(ListObjectsRequest request, ListObjectsResult result) {
		Log.d("AyncListObjects", "Success!");
		for (int i = 0; i < result.getObjectSummaries().size(); i++) {
			Log.d("AyncListObjects", "object: " + result.getObjectSummaries().get(i).getKey() + " "
					+ result.getObjectSummaries().get(i).getETag() + " "
					+ result.getObjectSummaries().get(i).getLastModified());
		}
	}

	@Override
	public void onFailure(ListObjectsRequest request, ClientException clientExcepion, ServiceException serviceException) {
		// 请求异常
		if (clientExcepion != null) {
			// 本地异常如网络异常等
			clientExcepion.printStackTrace();
		}
		if (serviceException != null) {
			// 服务异常
			Log.e("ErrorCode", serviceException.getErrorCode());
			Log.e("RequestId", serviceException.getRequestId());
			Log.e("HostId", serviceException.getHostId());
			Log.e("RawMessage", serviceException.getRawMessage());
		}
	}
});
task.waitUntilFinished();

各参数说明如下：

名称 描述
delimiter 用于对Object名字进行分组的字符。所有名字包含指定的前缀且第一次出现delimiter字符之间的object作为一组元素: CommonPrefixes。
marker 设定结果从marker之后按字母排序的第一个开始返回。
maxkeys 限定此次返回object的最大数，如果不设定，默认为100，maxkeys取值不能大于1000。
prefix 限定返回的object key必须以prefix作为前缀。
说明 使用prefix查询时，返回的key中仍会包含prefix。