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)