Returns a list of summary information about the objects in the specified buckets. List results are always returned in lexicographic (alphabetical) order.
Since buckets can contain a virtually unlimited number of keys, the complete results of a list query can be extremely large. To manage large result sets, Amazon S3 uses pagination to split them into multiple responses. Always check the {@link ObjectListing#isTruncated()} method to see if the returnedlisting is complete, or if additional calls are needed to get more results. Alternatively, use the {@link AmazonS3Client#listNextBatchOfObjects(ObjectListing)} method asan easy way to get the next page of object listings.
List performance is not substantially affected by the total number of keys in a bucket.
@param bucketName The name of the Amazon S3 bucket to list. @return A listing of the objects in the specified bucket, along with anyother associated information such as common prefixes (if a delimiter was specified), the original request parameters, etc. @throws AmazonClientException If any errors are encountered on the client while making the request or handling the response. @throws AmazonServiceException If any errors occurred in Amazon S3 while processing the request. @see {@link AmazonS3Client#listObjects(String bucketName,String prefix)} @see {@link AmazonS3Client#listObjects(ListObjectsRequest listObjectsRequest)}This method can be performed by anonymous services. @param bucket the bucket whose contents will be listed. This must be a valid S3Bucket object that is non-null and contains a name. @return the set of objects contained in a bucket. @throws S3ServiceException
Objects in the bucket that do not match one of the prefixes will not be listed. @param bucketName the name of the bucket in which the objects are stored. @param prefixes an array of prefix strings. A separate listing thread will be run for each of these prefix strings, and the method will only complete once the entire object listing for each prefix has been obtained (unless the operation is cancelled, or an error occurs) @param delimiter an optional delimiter string to apply to each listing operation. This parameter should be null if you do not wish to apply a delimiter. @param maxListingLength the maximum number of objects to list in each iteration. This should be a value between 1 and 1000, where 1000 will be the best choice in almost all circumstances. Regardless of this value, all the objects in the bucket that match the criteria will be returned.
The maximum number of threads is controlled by the JetS3t configuration property threaded-service.admin-max-thread-count. @return true if all the threaded tasks completed successfully, false otherwise.
Objects in the bucket that do not match one of the prefixes will not be listed. @param bucketName the name of the bucket in which the objects are stored. @param prefixes an array of prefix strings. A separate listing thread will be run for each of these prefix strings, and the method will only complete once the entire object listing for each prefix has been obtained (unless the operation is cancelled, or an error occurs) @param delimiter an optional delimiter string to apply to each listing operation. This parameter should be null if you do not wish to apply a delimiter. @param maxListingLength the maximum number of objects to list in each iteration. This should be a value between 1 and 1000, where 1000 will be the best choice in almost all circumstances. Regardless of this value, all the objects in the bucket that match the criteria will be returned.
The maximum number of threads is controlled by the JetS3t configuration property s3service.admin-max-thread-count. @return true if all the threaded tasks completed successfully, false otherwise.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|