NAME
AWS::S3::FileIterator - Easily access and iterate through your S3 files.
SYNOPSIS
# Iterate through all ".txt" files, 100 at a time:
my $iter = $bucket->files(
# Required params:
page_size => 100,
page_number => 1,
# Optional params:
pattern => qr(\.txt$)
);
while( my @files = $iter->next_page )
{
warn $iter->page_number, "\n";
foreach my $file ( @files )
{
print "\t", $file->key, "\n";
}# end foreach()
}# end while()DESCRIPTION
AWS::S3::FileIterator provides a means of iterating through your S3 files.
If you only have a few files it might seem odd to require an iterator, but if you have thousands (or millions) of files, the iterator will save you a lot of effort.
PUBLIC PROPERTIES
page_number
Integer - read-write
marker
String - read-only
Used internally to tell Amazon S3 where the last request for a listing of files left off.
pattern
Regexp - read-only
If supplied to the constructor, only files which match the pattern will be returned.
PUBLIC METHODS
next_page()
Returns the next page of results as an array in list context or arrayref in scalar context.
Increments page_number by one.
SEE ALSO
The Amazon S3 API Documentation
Iterator::Paged - on which this class is built.
AUTHOR
John Drago <jdrago_999@yahoo.com>
LICENSE AND COPYRIGHT
This software is Free software and may be used and redistributed under the same terms as any version of perl itself.
Copyright John Drago 2011 all rights reserved.