/ 
HTTP-LRDD-0.01
River stage one • 1 direct dependent • 1 total dependent
/ HTTP::LRDD

NAME

HTTP::LRDD - link-based resource descriptor discovery

SYNOPSIS

use HTTP::LRDD;

my $lrdd        = HTTP::LRDD->new;
my @descriptors = $lrdd->discover($resource);

or

use HTTP::LRDD;
my @descriptors = HTTP::LRDD->discover($resource);

VERSION

0.01

DESCRIPTION

Import Routine

use HTTP::LRDD (@predicates);

When importing HTTP::LRDD, you can optionally provide a list of predicate URIs (i.e. the URIs which rel values expand to). This may also include IANA-registered link types, which are short tokens rather than full URIs.

If you do not provide a list of predicate URIs, then a sensible default set is used.

Constructors

HTTP::LRDD->new(@predicates);

Create a new LRDD discovery object using the given predicate URIs. If @predicates is omitted, then the predicates passed to the import routine are used instead.

HTTP::LRDD->new_strict(@predicates);

Create a new LRDD discovery object using the 'describedby' and 'lrdd' IANA-registered predicates.

HTTP::LRDD->new_default(@predicates);

Create a new LRDD discovery object using the default set of predicates ('describedby', 'lrdd', 'xhv:meta' and 'rdfs:seeAlso').

Public Method

$lrdd->discover($uri)

Discovers a descriptor for the given URI; or if called in a list context, a list of descriptors.

A descriptor is a resource that provides a description for something. So, if the given URI was the web address for an image, then the descriptor might be the web address for a metadata file about the image. If the given URI was an e-mail address, then the descriptor might be a profile document for the person to whom the address belongs.

There is no guaranteed file format for the descriptor, but it is often RDF, POWDER XML or XRD.

This method can also be called without an object (as a class method) in which case, a temporary object is created automatically using new.

BUGS

Please report any bugs to http://rt.cpan.org/.

SEE ALSO

XRD::Parser, WWW::Finger, RDF::TrineShortcuts.

http://www.perlrdf.org/.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT

Copyright 2010 Toby Inkster

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.