Provide RSS annotations for more automated way to produce feeds

[prema]

It would be helpful to annotate Entity/ or plain php objects with typically rss elements, to automate rss generation by a RSS generator:

• title
• description
• author
• publish date
• link

[mikey]

Initial rough draft of implementation

[mikey]

Attached is a rough and untested initial draft of how an implementation may look like. Usage is as follows:

$rssFeedGenerator->addEntity($entity);

This will do all the work to create a net::stubbles::xml::rss::stubRSSFeedItem instance from $entity and adds it to the feed generator instance. The method will return the instance as well, so the user may change some of their properties after this step as well.

The entity must be annotated as follows:

/**
 * An example entity.
 *
 * @RSSFeedItem
 */
class MyExampleEntity
{
    // methods here
}

This will assume the entity offers default methods to return the necessary values. It is possible to change the default methods:

/**
 * An example entity.
 *
 * @RSSFeedItem(titleMethod='getExampleTitle',
 *              linkMethod='getExampleLink',
 *              descriptionMethod='getExampleDescription',
 *              authorMethod='getExampleAuthor',
 *              pubDateMethod='getExampleDate'
 */
class MyExampleEntity
{
    // methods here
}

Default values for those methods are getTitle(), getLink(), getDescription(), getAuthor(), getPubDate(). It is mandatory that the entity has methods to supply the title, link and description. Any other properties are optional.

The patch supports the properties named above. If accepted, all other properties currently implemented by net::stubbles::xml::rss::stubRSSFeedItem will be supported as well.

[mikey]

Implemented with r1827.