152 lines
No EOL
7.4 KiB
HTML
152 lines
No EOL
7.4 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<!-- Generated by Apache Maven Doxia Site Renderer 1.4 at 2013-09-27 -->
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
|
<title>ROME - Rome v0.1 Tutorial, Using Rome to read a syndication feed</title>
|
|
<style type="text/css" media="all">
|
|
@import url("../../../css/maven-base.css");
|
|
@import url("../../../css/maven-theme.css");
|
|
@import url("../../../css/site.css");
|
|
</style>
|
|
<link rel="stylesheet" href="../../../css/print.css" type="text/css" media="print" />
|
|
<meta name="author" content="mkurz" />
|
|
<meta name="Date-Creation-yyyymmdd" content="20110815" />
|
|
<meta name="Date-Revision-yyyymmdd" content="20130927" />
|
|
<meta http-equiv="Content-Language" content="en" />
|
|
|
|
</head>
|
|
<body class="composite">
|
|
<div id="banner">
|
|
<a href="http://github.com/" id="bannerLeft">
|
|
<img src="../../../images/romelogo.png" alt="ROME" />
|
|
</a>
|
|
<div class="clear">
|
|
<hr/>
|
|
</div>
|
|
</div>
|
|
<div id="breadcrumbs">
|
|
|
|
|
|
<div class="xright">
|
|
|
|
<span id="publishDate">Last Published: 2013-09-27</span>
|
|
| <span id="projectVersion">Version: 1.1-SNAPSHOT</span>
|
|
</div>
|
|
<div class="clear">
|
|
<hr/>
|
|
</div>
|
|
</div>
|
|
<div id="leftColumn">
|
|
<div id="navcolumn">
|
|
|
|
|
|
<h5>Rome</h5>
|
|
<ul>
|
|
<li class="none">
|
|
<a href="../../../index.html" title="Overview">Overview</a>
|
|
</li>
|
|
<li class="collapsed">
|
|
<a href="../../../HowRomeWorks/index.html" title="How Rome Works">How Rome Works</a>
|
|
</li>
|
|
<li class="none">
|
|
<a href="../../../RssAndAtOMUtilitiEsROMEV0.5AndAboveTutorialsAndArticles/index.html" title="Tutorials And Articles">Tutorials And Articles</a>
|
|
</li>
|
|
<li class="collapsed">
|
|
<a href="../../../ROMEReleases/index.html" title="Releases">Releases</a>
|
|
</li>
|
|
<li class="none">
|
|
<a href="../../../ROMEDevelopmentProposals/index.html" title="ROME Development Proposals">ROME Development Proposals</a>
|
|
</li>
|
|
</ul>
|
|
<h5>Project Documentation</h5>
|
|
<ul>
|
|
<li class="collapsed">
|
|
<a href="../../../project-info.html" title="Project Information">Project Information</a>
|
|
</li>
|
|
<li class="collapsed">
|
|
<a href="../../../project-reports.html" title="Project Reports">Project Reports</a>
|
|
</li>
|
|
</ul>
|
|
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
|
|
<img class="poweredBy" alt="Built by Maven" src="../../../images/logos/maven-feather.png" />
|
|
</a>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
<div id="bodyColumn">
|
|
<div id="contentBox">
|
|
<div class="section">
|
|
<h2>Rome v0.1 Tutorial, Using Rome to read a syndication feed<a name="Rome_v0.1_Tutorial_Using_Rome_to_read_a_syndication_feed"></a></h2>
|
|
<p><b>Software requirements:</b> J2SE 1.4+, Xerces 2.4.0, JDOM B10, Commons Codec 1.2 and Rome 0.1.</p>
|
|
<p>Rome represents syndication feeds (RSS and Atom) as instances of the com.sun.syndication.synd.SyndFeedI interface. The SyndFeedI interfaces and its properties follow the Java Bean patterns. The default implementations provided with Rome are all lightweight classes.</p>
|
|
<p>Rome includes parsers to process syndication feeds into SyndFeedI instances. The SyndInput class handles the parsers using the correct one based on the syndication feed being processed. The developer does not need to worry about selecting the right parser for a syndication feed, the SyndInput will take care of it by peeking at the syndication feed structure. All it takes to read a syndication feed using Rome are the following 2 lines of code:</p>
|
|
<div class="source">
|
|
<pre>
|
|
SyndInput input = new SyndInput();
|
|
SyndFeedI feed = input.build(feedUrl.openStream());
|
|
</pre></div>
|
|
<p>The first line creates a SyndInput instance that will work with any syndication feed type (RSS and Atom versions). The second line instructs the SyndInput to read the syndication feed from the InputStream of a URL pointing to the feed. The SyndInput.build() method returns a SyndFeedI instance that can be easily processed.</p>
|
|
<p>The default SyndFeedI implementation has a detailed and clear toString() implementation. The following line just prints it to the application's output.</p>
|
|
<div class="source">
|
|
<pre>
|
|
System.out.println(feed);
|
|
</pre></div>
|
|
<p>Following is the full code for a Java application that reads a syndication feed and prints the SyndFeedI bean to the application's output.</p>
|
|
<div class="source">
|
|
<pre>
|
|
package com.sun.syndication.samples;
|
|
|
|
import java.net.URL;
|
|
import com.sun.syndication.feed.synd.SyndFeedI;
|
|
import com.sun.syndication.io.SyndInput;
|
|
|
|
public class FeedReader {
|
|
|
|
public static void main(String[] args) {
|
|
boolean ok = false;
|
|
if (args.length==1) {
|
|
try {
|
|
URL feedUrl = new URL(args[0]);
|
|
|
|
SyndInput input = new SyndInput();
|
|
SyndFeedI feed = input.build(feedUrl.openStream());
|
|
|
|
System.out.println(feed);
|
|
|
|
ok = true;
|
|
}
|
|
catch (Exception ex) {
|
|
System.out.println("ERROR: "+ex.getMessage());
|
|
}
|
|
}
|
|
|
|
if (!ok) {
|
|
System.out.println();
|
|
System.out.println("FeedReader reads and prints any RSS/Atom feed type.");
|
|
System.out.println("The first parameter must be the URL of the feed to read.");
|
|
System.out.println();
|
|
}
|
|
}
|
|
|
|
}
|
|
</pre></div></div>
|
|
</div>
|
|
</div>
|
|
<div class="clear">
|
|
<hr/>
|
|
</div>
|
|
<div id="footer">
|
|
<div class="xright">
|
|
Copyright © 2004-2013
|
|
<a href="http://www.rometools.org">ROME Project</a>.
|
|
All Rights Reserved.
|
|
|
|
</div>
|
|
<div class="clear">
|
|
<hr/>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |