WebService::Rackspace::CloudFiles::Object - Represent a Cloud Files object
# To create a new object my $xxx = $container->object( name => 'XXX' ); $xxx->put('this is the value'); # To create a new object with the contents of a local file my $yyy = $container->object( name => 'YYY', content_type => 'text/plain' ); $yyy->put_filename('README'); # To fetch an object: my $xxx2 = $container->object( name => 'XXX' ); my $value = $xxx2->get; say 'has name ' . $xxx2->name; say 'has md5 ' . $xxx2->etag; say 'has size ' . $xxx2->size; say 'has content type ' . $xxx2->content_type; say 'has last_modified ' . $xxx2->last_modified; # To download an object to a local file $yyy->get_filename('README.downloaded');
This class represents an object in Cloud Files. It is created by calling object or objects on a WebService::Rackspace::CloudFiles::Container object.
Returns the name of the object.
say 'has name ' . $object->name;
Fetches the metadata of the object:
$object->head;
When set to true, forces md5 calculation on every file download and compares it to the provided etag. This can be a very expensive operation, especially on larger files. Setting always_check_etag to false will avoid the checksum on the file and will validate the file transfer was complete by comparing the file sizes after download. Defaults to true.
When set to true, any values retrieved from the server will be cached within the object, this allows you to continue to use the value without re-retrieving it from CloudFiles repeatedly. Defaults to false.
Fetches the metadata and content of an object:
my $value = $object->get;
If cache_value is enabled, will not re-retrieve the value from CloudFiles. To force re-retrieval, pass true to the get routine:
my $value = $object->get(1);
Downloads the content of an object to a local file, checks the integrity of the file, sets metadata in the object and sets the last modified time of the file to the same as the object.
$object->get_filename('README.downloaded');
If cache_value is enabled and the file has already been retrieved and is present on the filesystem with the filename provided, and the file size and md5 hash of the local file match what is in CloudFiles, the file will not be re-retrieved and the local file will be returned as-is. To force a re-fetch of the file, pass a true value as the second arg to get_filename():
$object->get_filename('README.downloaded',1);
Deletes an object:
$object->delete;
Purges an object in a CDN enabled container without having to wait for the TTL to expire.
$object->purge_cdn;
Purging an object in a CDN enabled container may take long time. So you can optionally provide one or more emails to be notified after the object is fully purged.
my @emails = ('foo@example.com', 'bar@example.com'); $object->purge_cdn(@emails);
Creates a new object:
my $xxx = $container->object( name => 'XXX' ); $xxx->put('this is the value');
Creates a new object with the contents of a local file:
my $yyy = $container->object( name => 'YYY', content_type => 'text/plain' ); $yyy->put_filename('README');
Returns the entity tag of the object, which is its MD5:
say 'has md5 ' . $object->etag;
Return the size of an object in bytes:
say 'has size ' . $object->size;
Return the content type of an object:
say 'has content type ' . $object->content_type;
Return the last modified time of an object as a DateTime object:
say 'has last_modified ' . $object->last_modified;
Sets or returns a hashref of metadata to be stored along with the file in CloudFiles. This hashref must containe key => value pairs and values must be scalar type, if you require storage of complex data, you will need to flatten it in some way prior to setting it here. Also, due to the way that CloudFiles works with metadata, when retrieved from CloudFiles, your keys will be lowercase. Note that since underscores are not permitted in keys within CloudFiles, any underscores are translated to dashes when transmitted to CloudFiles. They are re-translated when they are retrieved. This is mentioned only because if you access your data through a different language or interface, your metadata keys will contain dashes instead of underscores.
Retrieve HTTP CDN url to object.
Retrieve HTTPS CDN url to object.
WebService::Rackspace::CloudFiles, WebService::Rackspace::CloudFiles::Container.
Christiaan Kras <ckras@cpan.org>. Leon Brocard <acme@astray.com>.
Copyright (C) 2010-2011, Christiaan Kras Copyright (C) 2008-9, Leon Brocard
This module is free software; you can redistribute it or modify it under the same terms as Perl itself.
To install WebService::Rackspace::CloudFiles, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WebService::Rackspace::CloudFiles
CPAN shell
perl -MCPAN -e shell install WebService::Rackspace::CloudFiles
For more information on module installation, please visit the detailed CPAN module installation guide.