References to Atom on the JSPWiki site refer to the Atom Syndication Format, an alternative to RSS.

As described on the Wikipedia's Atom page:

While Atom isn't at this time as popular as RSS (indeed, the name alone is relatively unknown), it does have a number of major advantages, namely a stronger design and no bad history of competing designs, names, versions, etc.

Support within JSPWiki#

JSPWiki has supported RSS feeds since relatively early versions. In the 2.5.x branch there is now support for RSS 1.0, RSS 2.0 and Atom feeds, in three modes: 'wiki', 'blog', or 'full'.

Programmatically#

The com.ecyrd.jspwiki.rss.RSSGenerator now permits specification of the specific feed format. There are a number of generate methods permitting wiki-wide, page-wide, or as a list of com.ecyrd.jspwiki.rss.Entry objects. .e.g.,

    import com.ecyrd.jspwiki.rss.*
    // ...

    List entries = new ArrayList();
    // add Entry objects from some source (in this example, some kind of array)
    for ( int i = 0; i < sources.size(); i++ ) {
        SomeSource source = sources[i];
        Entry entry = new Entry();
        entry.setAuthor( source.getAuthor() );   // author (String)
        entry.setContent( source.getContent() ); // content (String)
        entry.setPage( source.getWikiPage() );   // (WikiPage)
        entry.setTitle( source.getTitle() );     // title (String)
        entry.setURL( source.getURL() );         // url (String)
        entries.add(entry);
    }
    // now generate Atom output (String)
    RSSGenerator rssgen = wikiEngine.getRSSGenerator();
    String mode = "wiki"; // the mode ( 'wiki' | 'blog' | 'full' )
    String type = "atom"; // the type ( 'rss10' | 'RSS20' | 'atom' ). Default is RSS 1.0
    // Generates a feed based on a context and list of changes. 
    String out = rssgen.generateFeed( wikiContext, entries, mode, type );

   // write String to appropriate output...

Links#

• RFC 4287 - The formal standard
• Comparison of RSS and Atom Web Feed Formats
• Atom Wiki - The main place for work on Atom.

There are many more links on the Wikipedia Atom page.

What is the difference between these three RSS modes? - Tyton