ROME: RSS and Atom Utilities
"...ending syndication feed confusion by supporting all of 'em. " *

ROME is a set of Atom/RSS Java utilities that make it easy to work in Java with most syndication formats:

• RSS 0.90
• RSS 0.91 Netscape
• RSS 0.91 Userland
• RSS 0.92
• RSS 0.93
• RSS 0.94
• RSS 1.0
• RSS 2.0
• Atom 0.3
• Atom 1.0

ROME includes a set of parsers and generators for the various flavors of syndication feeds, as well as converters to convert from one format to another. The parsers can give you back Java objects that are either specific for the format you want to work with, or a generic normalized SyndFeed class that lets you work on with the data without bothering about the incoming or outgoing feed type.

If you use ROME for your site or software, please add it to the wiki page PoweredByRome, or drop us an email.

Latest release: ROME v0.9 Beta Release (Dec/11/2006)

Normally each release of ROME includes a whole new set of Wiki pages with the corresponding version number. ROME 0.9 is reusing ROME 0.8 (and earlier) Wiki pages as much as possible.

• What is New, Highlights
  • ROME now supports the final version of the Atom Syndication Format RFC 4287: let's Nuke all these feeds! NEW
  • Enclosure support at the Synd level, for all our podcaster friends
  • Bug fixes and more. Details in the ChangeList
  • Modules galore: Content, iTunes Podcast, Slash, Google Base, Creative Commons, MediaRSS
• Dependencies
  • J2SE 1.4+
  • JDOM 1.0
• Downloads
  • Source tar.gz
  • Source zip
  • Binary tar.gz
  • Binary zip
  • Samples source tar.gz
  • Samples source zip
• Javadocs
• Tutorials and Articles
• Changes Log

Previous Releases

• Rome v0.8 Beta (Feb/01/2006)
• Rome v0.7 Beta (Sep/09/2005)
• Rome v0.6 Beta (Apr/01/2005)
• Rome v0.5 Beta (Jan/10/2005)
• Rome v0.4 (Sep/27/2004)
• Rome v0.3 (Jul/28/2004)
• Rome v0.2 (Jun/16/2004)
• Rome v0.1 (Jun/08/2004)

ROME Subprojects

• ROME Propono - NEW supports publishing protocols, specifically the Atom Publishing Protocol and the legacy MetaWeblog API. Propono includes an Atom client library, an Atom server framework and a Blog client that supports both Atom protocol and the MetaWeblog API. Latest release: ROME Propono v0.5.

• ROME Fetcher - a caching feed fetcher that supports retrieval of feeds via HTTP conditional GET. Supports ETags, GZip compression, and RFC3229 Delta encoding. Latest release: ROME Fetcher v0.9 Beta Release (Dec/12/2006)

• ROME Aqueduct - defines a DAO layer used for the persistence of SyndFeeds. The Aqueduct-Prevayler implementation of the DAO allows for the simple persistence of hundreds or thousands of SyndFeeds, as well as providing a query mechanism using Regular Expressions. Latest release: ROME Aqueduct - Prevayler Implementation v0.1 Beta Release (Mar/17/2005)

• Rome Modules - provide support for feed extensions such as GeoRSS, iTunes, Microsoft SSE and SLE, Google GData and others.

• ROME.Mano NEW - is a pipeline framework for RSS and Atom feeds.

• OPML for ROME - Outline Processor Markup Language parser and tools.

Further information

• Working with ROME
  • What part of the API you should be using
• Articles about ROME
  • Project Motivation - why we started ROME
  • API FAQ, why things are like they are
  • Evaluation of existing RSS parsing libraries
• Inside ROME, How Things Work
  • How ROME Works, Understanding ROME, a detailed overview by Dave Johnson (This doc is based on ROME v0.4)
  • ROME Plugins Mechanism, bootstrap, adding and changing parsers, generators, converters and modules
  • Feeds Date Elements, how Date data is mapped to SyndFeed and SyndEntry
  • Feed and Entry URI Mapping, how SyndFeed and SyndEntry 'uri' properties map to concrete feed elements
  • XML Charset Encoding Detection, how ROME helps getting the right charset encoding
  • Creating a custom Module, creating all necessary pieces, bean, parser and generator
  • The CopyFrom interface
  • ROME bean utilities, equals, toString and cloning
  • Customizing Date and time parsing in the rome.properties file
• ROME development
  • How to build ROME (ROME uses Maven)
  • Changes Log, what and when
  • ROME Development Process
  • ROME Development Proposals - proposals for new ROME features and releases