NAME

XML::RAI::Channel - An interface to the channel elements of a RSS feed.

DESCRIPTION

A subclass of XML::RAI::Object, XML::RAI::Channel handles the mapping function and retrieval of RSS channel elements.

METHODS

$channel->src: Returns the XML::RSS::Parser::Element that the object is using as its source.
$channel->parent: Returns the parent of the RAI object.
$channel->add_mapping(key, @xpaths): Creates or appends XPath mappings to the channel object for extensibility and easier access of RAI.

META DATA ACCESSORS

These accessor methods attempt to retrieve meta data from the source XML::RSS::Parser element by checking a list of potential tag names until one returns a value. They are generally based on Dublin Core terminology and RSS elements that are common across the many formats. If called in a SCALAR context, the value of the first element of the tag being matched is returned. If called in an ARRAY context it will return all of the values to the tag being matched -- it does not return all of the values for all of the tags that have been mapped to the method. (Note that some mappings only allow one value to be returned.) Returns "undef" if nothing could be found.

The following are the tags (listed in XPath notation) mapped to each method and the order in which they are checked.

$channel->contributor

•: dc:contributor

$channel->coverage

•: dc:coverage

$channel->creator

•: dc:creator

$channel->description

description
dc:description
dcterms:abstract
dcterms:alternative

$channel->format

•: dc:format

$channel->generator

admin:generatorAgent/@rdf:resource
admin:generatorAgent
generator

$channel->identifier

dc:identifier/@rdf:resource
dc:identifier
link

$channel->issued

dcterms:issued
dc:date
lastBuildDate
rss091:lastBuildDate

$channel->issued_strict

•: dcterms:issued

$channel->language

@xml:lang
dc:language
language
rss091:language
$channel->link

link
@rdf:about

•: $channel->maintainer

admin:errorReportsTo/@rdf:resource
admin:errorReportsTo
webMaster

•: $channel->modified

dcterms:modified
dc:date
lastBuildDate
rss091:lastBuildDate

•: $channel->modified_strict

•: dcterms:modified

•: $channel->publisher

dc:publisher
managingEditor
rss091:managingEditor

•: $channel->relation

dc:relation/@rdf:resource
dc:relation

•: $channel->rights

dc:rights
copyright
creativeCommons:license
rss091:copyright

•: $channel->source

dc:source
source
title

•: $channel->subject

dc:subject
category

•: $channel->title

title
dc:title

•: $channel->type

•: dc:type

•: $channel->valid

dcterms:valid
expirationDate

AUTHOR & COPYRIGHT

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

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

Around line 88:: =begin without a target?
Around line 102:: '=item' outside of any '=over'
Around line 116:: You forgot a '=back' before '=head2'
Around line 239:: Expected '=item *'
Around line 249:: Expected '=item *'
Around line 261:: Expected '=item *'
Around line 275:: Expected '=item *'
Around line 283:: Expected '=item *'
Around line 295:: Expected '=item *'
Around line 305:: Expected '=item *'
Around line 319:: Expected '=item *'
Around line 331:: Expected '=item *'
Around line 341:: Expected '=item *'
Around line 351:: Expected '=item *'
Around line 359:: Expected '=item *'
Around line 371:: You forgot a '=back' before '=head1'
Around line 378:: '=end' without a target?