htchien / rome

Java library for RSS and Atom feeds

Rome

Rome is a Java framework for RSS and Atom feeds. The framework consist of several modules:

⚠️ Maintenance and development of the project is currently limited due to a shortage of active maintainers. Consider becoming an active maintainer.

Project structure

Module	Description
rome	Library for generating and parsing RSS and Atom feeds.
rome-modules	Generators and parsers for extensions like MediaRSS, GeoRSS and others.
rome-opml	OPML parsers and tools.
rome-fetcher	DEPRECATED (see #276 for details)

Other deprecated modules: rome-certiorem, rome-certiorem-webapp and rome-propono.

Examples

Parse a feed:

String url = "https://stackoverflow.com/feeds/tag?tagnames=rome";
SyndFeed feed = new SyndFeedInput().build(new XmlReader(new URL(url)));
System.out.println(feed.getTitle());

Beware! The URL class used in this example is rudimentary and works only for simplest cases. Please consider using a separate library for fetching the feed (see example in #276).

Generate a feed:

SyndFeed feed = new SyndFeedImpl();
feed.setFeedType("rss_2.0");
feed.setTitle("test-title");
feed.setDescription("test-description");
feed.setLink("https://example.org");
System.out.println(new SyndFeedOutput().outputString(feed));