Object::Signature::File - Extended signature API for storing objects in file
Whereas the basic Object::Signature class provides for only a raw cryptographic
extends the signature method to add
specialised information for objects that want some control over how they are
stored as files.
For example, some objects may want the cached object to have a matching file
extension (for example a gif image) so that web-accessible cache path could be
used in a web page.
The image would then be sent out to the browser with the correct mime type.
The "signature_ext" method indicates the preferable file extension for
the content of the object, if applicable.
If the method returns a string, it indicates the object should be stored in a
file with a specific extension.
If the method returns a null string, it indicates that the file should be stored
with no extension.
If the method return "undef" (the default value), it indicates no
preference for the extension of the file.
method is the least-useful part of this extended API,
and is rarely used. It is included mostly for completeness.
If the method returns a string, it indicates the name part of a file name that
the object should be stored in, if possible.
If the method return a null string, it explicitly indicates there is no file
name or a file name is not possible.
If the method returns "undef" (the default value), it indicates no
preference for the name of the file.
Adam Kennedy <firstname.lastname@example.org>
Copyright 2004 - 2007 Adam Kennedy.
This program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included with this