com.rometools.fetcher.impl

Class AbstractFeedFetcher

java.lang.Object

com.rometools.fetcher.impl.AbstractFeedFetcher

All Implemented Interfaces:

FeedFetcher

Direct Known Subclasses:

HttpClientFeedFetcher, HttpURLFeedFetcher

Deprecated.

ROME Fetcher will be dropped in the next major version of ROME (version 2). For more information and some migration hints, please have a look at our detailed explanation.

@Deprecated
public abstract class AbstractFeedFetcher
extends Object
implements FeedFetcher

Field Summary

Fields inherited from interface com.rometools.fetcher.FeedFetcher

DEFAULT_USER_AGENT

Constructor Summary

Constructors

Constructor and Description
AbstractFeedFetcher() Deprecated.

Method Summary

Modifier and Type	Method and Description
void	addFetcherEventListener(FetcherListener listener) Deprecated. Add a FetcherListener.
static SyndFeed	combineFeeds(SyndFeed originalFeed, SyndFeed newFeed) Deprecated. Combine the entries in two feeds into a single feed.
protected void	fireEvent(String eventType, String urlStr) Deprecated.
protected void	fireEvent(String eventType, String urlStr, SyndFeed feed) Deprecated.
protected void	fireEvent(String eventType, URLConnection connection) Deprecated.
protected void	fireEvent(String eventType, URLConnection connection, SyndFeed feed) Deprecated.
String	getUserAgent() Deprecated.
protected void	handleErrorCodes(int responseCode) Deprecated. Handles HTTP error codes.
boolean	isAllowDoctypes() Deprecated.
boolean	isPreserveWireFeed() Deprecated.
boolean	isUsingDeltaEncoding() Deprecated. Is this fetcher using rfc3229 delta encoding?
void	removeFetcherEventListener(FetcherListener listener) Deprecated. Remove a FetcherListener
void	setAllowDoctypes(boolean allowDoctypes) Deprecated. In ROME 1.5.1 we fixed a security vulnerability by disallowing Doctype declarations by default.
void	setPreserveWireFeed(boolean preserveWireFeed) Deprecated. If set to true, the WireFeed will be made accessible from the SyndFeed object returned from the Fetcher via the originalWireFeed() method.
void	setUserAgent(String string) Deprecated.
void	setUsingDeltaEncoding(boolean useDeltaEncoding) Deprecated. Turn on or off rfc3229 delta encoding See http://www.ietf.org/rfc/rfc3229.txt and http://bobwyman.pubsub.com/main/2004/09/using_rfc3229_w.html NOTE: This is experimental and feedback is welcome!
protected void	throw4XXError(int responseCode) Deprecated.
protected void	throwAuthenticationError(int responseCode) Deprecated.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.rometools.fetcher.FeedFetcher

retrieveFeed, retrieveFeed

Constructor Detail

AbstractFeedFetcher

public AbstractFeedFetcher()

Deprecated.

Method Detail

getUserAgent

public String getUserAgent()

Deprecated.

Specified by:

getUserAgent in interface FeedFetcher

Returns:

the User-Agent currently being sent to servers

setUserAgent

public void setUserAgent(String string)

Deprecated.

Specified by:

setUserAgent in interface FeedFetcher

Parameters:

string - The User-Agent to sent to servers

fireEvent

protected void fireEvent(String eventType,
                         URLConnection connection)

Deprecated.

Parameters:

eventType - The event type to fire

connection - the current connection

fireEvent

protected void fireEvent(String eventType,
                         URLConnection connection,
                         SyndFeed feed)

Deprecated.

Parameters:

eventType - The event type to fire

connection - the current connection

feed - The feed to pass to the event

fireEvent

protected void fireEvent(String eventType,
                         String urlStr)

Deprecated.

Parameters:

eventType - The event type to fire

urlStr - the current url as a string

fireEvent

protected void fireEvent(String eventType,
                         String urlStr,
                         SyndFeed feed)

Deprecated.

Parameters:

eventType - The event type to fire

urlStr - the current url as a string

feed - The feed to pass to the event

addFetcherEventListener

public void addFetcherEventListener(FetcherListener listener)

Deprecated.

Description copied from interface: FeedFetcher

Add a FetcherListener.

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

Specified by:

addFetcherEventListener in interface FeedFetcher

Parameters:

listener - The FetcherListener to recieve the event

removeFetcherEventListener

public void removeFetcherEventListener(FetcherListener listener)

Deprecated.

Description copied from interface: FeedFetcher

Remove a FetcherListener

Specified by:

removeFetcherEventListener in interface FeedFetcher

Parameters:

listener - The FetcherListener to remove

isUsingDeltaEncoding

public boolean isUsingDeltaEncoding()

Deprecated.

Description copied from interface: FeedFetcher

Is this fetcher using rfc3229 delta encoding?

Specified by:

isUsingDeltaEncoding in interface FeedFetcher

Returns:

Returns the useDeltaEncoding.

setUsingDeltaEncoding

public void setUsingDeltaEncoding(boolean useDeltaEncoding)

Deprecated.

Description copied from interface: FeedFetcher

Turn on or off rfc3229 delta encoding

See http://www.ietf.org/rfc/rfc3229.txt and http://bobwyman.pubsub.com/main/2004/09/using_rfc3229_w.html

NOTE: This is experimental and feedback is welcome!

Specified by:

setUsingDeltaEncoding in interface FeedFetcher

Parameters:

useDeltaEncoding - The useDeltaEncoding to set.

handleErrorCodes

protected void handleErrorCodes(int responseCode)
                         throws FetcherException

Deprecated.

Handles HTTP error codes.

Parameters:

responseCode - the HTTP response code

Throws:

FetcherException - if response code is in the range 400 to 599 inclusive

throw4XXError

protected void throw4XXError(int responseCode)
                      throws FetcherException

Deprecated.

Throws:

FetcherException

throwAuthenticationError

protected void throwAuthenticationError(int responseCode)
                                 throws FetcherException

Deprecated.

Throws:

FetcherException

combineFeeds

public static SyndFeed combineFeeds(SyndFeed originalFeed,
                                    SyndFeed newFeed)

Deprecated.

Combine the entries in two feeds into a single feed.

The returned feed will have the same data as the newFeed parameter, with the entries from originalFeed appended to the end of its entries.

Parameters:

originalFeed -

newFeed -

Returns:

isPreserveWireFeed

public boolean isPreserveWireFeed()

Deprecated.

setPreserveWireFeed

public void setPreserveWireFeed(boolean preserveWireFeed)

Deprecated.

Description copied from interface: FeedFetcher

If set to true, the WireFeed will be made accessible from the SyndFeed object returned from the Fetcher via the originalWireFeed() method. Each Entry in the feed will have the corresponding wireEntry property set.

Specified by:

setPreserveWireFeed in interface FeedFetcher

isAllowDoctypes

public boolean isAllowDoctypes()

Deprecated.

setAllowDoctypes

public void setAllowDoctypes(boolean allowDoctypes)

Deprecated.

Description copied from interface: FeedFetcher

In ROME 1.5.1 we fixed a security vulnerability by disallowing Doctype declarations by default. This change breaks the compatibility with at least RSS 0.91N because it requires a Doctype declaration. You are able to allow Doctype declarations again with this property. You should only activate it when the feeds that you process are absolutely trustful.

Specified by:

setAllowDoctypes in interface FeedFetcher

Parameters:

allowDoctypes - true when Doctype declarations should be allowed again, false otherwise