com.sun.syndication.fetcher
Interface FeedFetcher

All Known Implementing Classes:
AbstractFeedFetcher

public interface FeedFetcher


Field Summary
static java.lang.String DEFAULT_USER_AGENT
          The default user agent.
 
Method Summary
 void addFetcherEventListener(FetcherListener listener)
          Add a FetcherListener.
 java.lang.String getUserAgent()
           
 void removeFetcherPolledListener(FetcherListener listener)
          Remove a FetcherListener
 com.sun.syndication.feed.synd.SyndFeed retrieveFeed(java.net.URL feedUrl)
          Retrieve a feed over HTTP
 void setUserAgent(java.lang.String string)
           
 

Field Detail

DEFAULT_USER_AGENT

public static final java.lang.String DEFAULT_USER_AGENT
The default user agent. It is not marked final so buggy java compiler will not write this string into all classes that reference it.

See Also:
Constant Field Values
Method Detail

getUserAgent

public java.lang.String getUserAgent()
Returns:
the User-Agent currently being sent to servers

setUserAgent

public void setUserAgent(java.lang.String string)
Parameters:
string - The User-Agent to sent to servers

retrieveFeed

public com.sun.syndication.feed.synd.SyndFeed retrieveFeed(java.net.URL feedUrl)
                                                    throws java.lang.IllegalArgumentException,
                                                           java.io.IOException,
                                                           com.sun.syndication.io.FeedException,
                                                           FetcherException
Retrieve a feed over HTTP

Parameters:
feedUrl - A non-null URL of a RSS/Atom feed to retrieve
Returns:
A SyndFeed object
Throws:
java.lang.IllegalArgumentException - if the URL is null;
java.io.IOException - if a TCP error occurs
com.sun.syndication.io.FeedException - if the feed is not valid
FetcherException - if a HTTP error occurred

addFetcherEventListener

public void addFetcherEventListener(FetcherListener listener)

Add a FetcherListener.

The FetcherListener will receive an FetcherEvent when a Fetcher event (feed polled, retrieved, etc) occurs

Parameters:
listener - The FetcherListener to recieve the event

removeFetcherPolledListener

public void removeFetcherPolledListener(FetcherListener listener)

Remove a FetcherListener

Parameters:
listener - The FetcherListener to remove


Copyright © 2004 Sun Microsystems. All Rights Reserved.