From fdffe7d315204a056ec69086e4dd170a195a278a Mon Sep 17 00:00:00 2001 From: Patrick Gotthard Date: Fri, 4 Mar 2016 23:02:03 +0100 Subject: [PATCH] #276 added deprecation notice to rome-fetcher --- .../src/main/java/com/rometools/fetcher/FeedFetcher.java | 5 +++++ .../src/main/java/com/rometools/fetcher/FetcherEvent.java | 4 ++++ .../main/java/com/rometools/fetcher/FetcherException.java | 3 +++ .../src/main/java/com/rometools/fetcher/FetcherListener.java | 5 +++++ .../java/com/rometools/fetcher/impl/AbstractFeedFetcher.java | 5 +++++ .../rometools/fetcher/impl/AbstractFeedFetcherBeanInfo.java | 5 +++++ .../java/com/rometools/fetcher/impl/DiskFeedInfoCache.java | 4 ++++ .../java/com/rometools/fetcher/impl/FeedFetcherCache.java | 5 ++++- .../com/rometools/fetcher/impl/HashMapFeedInfoCache.java | 5 ++++- .../com/rometools/fetcher/impl/HttpClientFeedFetcher.java | 4 ++++ .../java/com/rometools/fetcher/impl/HttpURLFeedFetcher.java | 4 ++++ .../rometools/fetcher/impl/LinkedHashMapFeedInfoCache.java | 3 +++ .../java/com/rometools/fetcher/impl/ResponseHandler.java | 5 ++++- .../main/java/com/rometools/fetcher/impl/SyndFeedInfo.java | 4 ++++ 14 files changed, 58 insertions(+), 3 deletions(-) diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/FeedFetcher.java b/rome-fetcher/src/main/java/com/rometools/fetcher/FeedFetcher.java index 4425101..c22a887 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/FeedFetcher.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/FeedFetcher.java @@ -22,6 +22,11 @@ import java.net.URL; import com.rometools.rome.feed.synd.SyndFeed; import com.rometools.rome.io.FeedException; +/** + * @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 interface FeedFetcher { /** *

diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherEvent.java b/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherEvent.java index 6ed4a0c..547b8de 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherEvent.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherEvent.java @@ -10,7 +10,11 @@ import com.rometools.rome.feed.synd.SyndFeed; * fields final. * * @author nl + * + * @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 class FetcherEvent extends EventObject { private static final long serialVersionUID = 1L; diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherException.java b/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherException.java index 447ab2f..14f00f0 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherException.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherException.java @@ -19,7 +19,10 @@ package com.rometools.fetcher; /** * @author Nick Lothian * + * @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 class FetcherException extends Exception { private static final long serialVersionUID = 1L; diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherListener.java b/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherListener.java index 617532c..48f4af7 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherListener.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/FetcherListener.java @@ -2,6 +2,11 @@ package com.rometools.fetcher; import java.util.EventListener; +/** + * @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 interface FetcherListener extends EventListener { /** diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/AbstractFeedFetcher.java b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/AbstractFeedFetcher.java index fc3dce5..71db0e1 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/AbstractFeedFetcher.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/AbstractFeedFetcher.java @@ -34,6 +34,11 @@ import com.rometools.fetcher.FetcherException; import com.rometools.fetcher.FetcherListener; import com.rometools.rome.feed.synd.SyndFeed; +/** + * @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 implements FeedFetcher { private static final Logger LOG = LoggerFactory.getLogger(AbstractFeedFetcher.class); diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/AbstractFeedFetcherBeanInfo.java b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/AbstractFeedFetcherBeanInfo.java index 5bac21e..3860793 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/AbstractFeedFetcherBeanInfo.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/AbstractFeedFetcherBeanInfo.java @@ -7,6 +7,11 @@ import java.lang.reflect.Method; import com.rometools.fetcher.FetcherEvent; import com.rometools.fetcher.FetcherListener; +/** + * @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 class AbstractFeedFetcherBeanInfo extends SimpleBeanInfo { @Override diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/DiskFeedInfoCache.java b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/DiskFeedInfoCache.java index 92bc9b1..4817b12 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/DiskFeedInfoCache.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/DiskFeedInfoCache.java @@ -28,7 +28,11 @@ import com.rometools.utils.IO; /** * Disk based feed cache. + * + * @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 class DiskFeedInfoCache implements FeedFetcherCache { protected String cachePath = null; diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/FeedFetcherCache.java b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/FeedFetcherCache.java index 4c0ff0a..286c910 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/FeedFetcherCache.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/FeedFetcherCache.java @@ -25,8 +25,11 @@ import java.net.URL; *

* * @author Nick Lothian - * + * + * @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 interface FeedFetcherCache { /** diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HashMapFeedInfoCache.java b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HashMapFeedInfoCache.java index 7508ce7..5e5a20a 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HashMapFeedInfoCache.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HashMapFeedInfoCache.java @@ -35,8 +35,11 @@ import java.util.Map; *

* * @author Nick Lothian - * + * + * @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 class HashMapFeedInfoCache implements FeedFetcherCache, Serializable { private static final long serialVersionUID = 1L; diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HttpClientFeedFetcher.java b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HttpClientFeedFetcher.java index 3c0b55a..0e307f9 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HttpClientFeedFetcher.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HttpClientFeedFetcher.java @@ -46,7 +46,11 @@ import com.rometools.utils.IO; /** * @author Nick Lothian + * + * @deprecated HttpClient v3 is known to have some security vulnerabilities! In addition 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 class HttpClientFeedFetcher extends AbstractFeedFetcher { private CredentialSupplier credentialSupplier; diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HttpURLFeedFetcher.java b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HttpURLFeedFetcher.java index 106852f..f1c9db4 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HttpURLFeedFetcher.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/HttpURLFeedFetcher.java @@ -68,7 +68,11 @@ import com.rometools.utils.IO; * @see http://bobwyman.pubsub.com/main/2004/09/using_rfc3229_w.html * @author Nick Lothian + * + * @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 class HttpURLFeedFetcher extends AbstractFeedFetcher { private volatile int connectTimeout = -1; diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/LinkedHashMapFeedInfoCache.java b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/LinkedHashMapFeedInfoCache.java index a398bf6..9736792 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/LinkedHashMapFeedInfoCache.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/LinkedHashMapFeedInfoCache.java @@ -16,7 +16,10 @@ import java.util.Map; * @author Javier Kohen * @author Nick Lothian * + * @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 class LinkedHashMapFeedInfoCache extends HashMapFeedInfoCache { private final class CacheImpl extends LinkedHashMap { diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/ResponseHandler.java b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/ResponseHandler.java index 56b3ab8..beb0766 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/ResponseHandler.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/ResponseHandler.java @@ -22,8 +22,11 @@ import java.util.regex.Pattern; /** * Utility class to help deal with HTTP responses - * + * * + * @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 class ResponseHandler { public static final String defaultCharacterEncoding = "ISO-8859-1"; diff --git a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/SyndFeedInfo.java b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/SyndFeedInfo.java index 07c9bfe..b093038 100644 --- a/rome-fetcher/src/main/java/com/rometools/fetcher/impl/SyndFeedInfo.java +++ b/rome-fetcher/src/main/java/com/rometools/fetcher/impl/SyndFeedInfo.java @@ -33,7 +33,11 @@ import com.rometools.rome.feed.synd.SyndFeed; *

* * @author Nick Lothian + * + * @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 class SyndFeedInfo implements Cloneable, Serializable { private static final long serialVersionUID = 1L;