Provides an easy way to continue a truncated object listing and retrieve the next page of results.
To continue the object listing and retrieve the next page of results, call the initial {@link ObjectListing} from one of thelistObjects
methods. If truncated (indicated when {@link ObjectListing#isTruncated()} returns true
),pass the ObjectListing
back into this method in order to retrieve the next page of results. Continue using this method to retrieve more results until the returned ObjectListing
indicates that it is not truncated.
@param previousObjectListing The previous truncated
ObjectListing
. If a non-truncated
ObjectListing
is passed in, an empty
ObjectListing
will be returned without ever contacting Amazon S3.
@return The next set of
ObjectListing
results, beginning immediatelyafter the last result in the specified previous
ObjectListing
.
@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 AmazonS3Client#listObjects(String)
@see AmazonS3Client#listObjects(String,String)
@see AmazonS3Client#listObjects(ListObjectsRequest)