NAME
Store::Digest::Object - One distinct Store::Digest data object
VERSION
Version 0.01
SYNOPSIS
my $dataobj = $store->get('sha-256' => $key);
my $fh = $dataobj->content;METHODS
This class exists to encapsulate the metadata relevant to a Store::Digest data object. It is not instantiated directly. All methods are read-only accessors.
content
Returns a filehandle or equivalent, pointing to the object's content, open in read-only mode. Unless the object has been deleted, then this will be undef.
digest
my $uri = $dataobj->digest('sha-1');
my @algos = $dataobj->digest;Returns a URI::di object for the relevant digest algorithm. Will croak if an invalid digest algorithm is supplied. While valid digest algorithms are specified at creation time, you can retrieve them by calling this method with no arguments.
size
Returns the byte size of the object. Note that for deleted objects, this will be whatever the size of the object was before it was deleted.
type
Returns the MIME type
charset
Returns the character set (e.g. utf-8) of the data object if known.
language
Returns the natural language in RFC 5646 format, if it was supplied.
encoding
Returns the transfer encoding, of the data object if known, (e.g. gzip or deflate, not the "charset").
ctime
Returns the timestamp at which the object was added to the store, from the point of view of the system.
mtime
Returns the timestamp that was supplied as the modification time of the object from the point of view of the user, if different from "ctime".
ptime
Returns the timestamp of the time the metadata properties of the object were last updated.
dtime
Returns the system timestamp at which the object was deleted, if applicable.
type_checked
This flag represents that the claimed content-type has been checked.
type_valid
charset_checked
charset_valid
encoding_checked
encoding_valid
syntax_checked
This flag represents an additional layer of syntax checking, e.g. XML validation.
syntax_valid
matches $DIGEST
Pass in a URI::ni object or string representing a RFC6920 named identifier, and this method will tell you you whether or not the object possesses a matching digest.
as_string
AUTHOR
Dorian Taylor, <dorian at cpan.org>
LICENSE AND COPYRIGHT
Copyright 2012 Dorian Taylor.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.