NAME

XML::Atom::Syndication::Thing - base class for the feed and entry class

METHODS

This module is a subclass of XML::Atom::Syndication::Object.the following additional methods are available.

Class->new($HASHREF)

In addition to the keys recognized by its superclass this class recognizes:

Stream

A SCALAR or FILEHANDLE (GLOB) to a valid Atom document. Stream takes presidence over Elem.

$thing->author([$author,$author...])

$thing->contributor([$contributor,$contributor...])

$thing->category([$category,$category...])

These three accessors methods have similar purposes for accessing known complex Atom object types. You can optionally pass in one of more Atom objects that will overwrite any existing elements. author and contributor expect a XML::Atom::Syndication::Person object while category expects a XML::Atom::Syndication::Category object. The method returns the first object if called in a SCALAR context and all elements if called in an ARRAY context.

$thing->add_link($link)

Creates a new link element. $link can be a XML::Atom::Syndication::Link object or a HASH reference. The HASH reference contains key value pairs that will be assigned the new link object as attributes. Keys must include namespace URIs and local name in Clarkian notation.

$thing->link

If called in a SCALAR context returns the first XML::Atom::Syndication::Link. In an ARRAY context all link objects will be returned.

AUTHOR & COPYRIGHT

Please see the XML::Atom::Syndication manpage for author, copyright, and license information.