Cantella::Store::UUID::File - File represented by a UUID
To make file location deterministic, files are stored under only their UUID, along with their respective meta file which is named $UUID.meta eg (DD5EB40A-164B-11DE-9893-5FA9AE3835A0.meta). The meta files may contain any number of key/value pairs relevant to the file such as the original file name, extension, MIME type, etc. Meta files are stored in JSON format.
$UUID.meta
DD5EB40A-164B-11DE-9893-5FA9AE3835A0.meta
Cantella::Store::UUID is a subclass of Moose::Object. It inherits the new object provided by Moose. All attributes can be set using the new constructor method, or their respecitive writer method, if applicable.
Cantella::Store::UUID
new
Required, read-only Data::GUID object, will automatically coerce.
Required, read-only Path::Class::File object representing the directory where this file is stored. Automatically coercing.
Lazy-building, read-only Path::Class::File object representing the file being stored under this UUID.
Lazy_building, read-write hashref which contains the file's metadata. Setting it with the writer method will write the data to disk, modifying the hashref directly, or via the key writer, will not.
Lazy-building, read-only Path::Class::File object pointing at the meta file.
\%arguments
$object_instance
Constructor.
Write the contents of metadata to the metadata file.
metadata
$bool_success
Removes the file and metadata file from the store. Returns true if both are removed successfully. An exception will be thrown if there is an error deleting the files.
$bool
Checks for existence of both the file and the metadata file. Returns true only if both exist.
$mime_type
Will return the mime-type for the file. If there is a value for the 'mime-type' property, that value will be used. If the key isn't present, File::MimeInfo will be used to find the mime-type of the file and store in the meta file.
If no mime-type can be determined, undef will be returned in scalr context and an empty list in list context.
$extension
Will return an appropriate extension for a file, by using it's mime-type, or original file name if mime-type is unavailable. If no known extension is known it returns an empty string.
Guillermo Roditi (groditi) <groditi@cpan.org>
This software is copyright (c) 2009, 2010 by Guillermo Roditi.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Cantella::Store::UUID, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Cantella::Store::UUID
CPAN shell
perl -MCPAN -e shell install Cantella::Store::UUID
For more information on module installation, please visit the detailed CPAN module installation guide.