Merge pull request #277 from rometools/ROME-276-fetcher-removal

#276 added deprecation notice to rome-fetcher
rometools · Mar 4, 2016 · 91da300 · 91da300
2 parents b718922 + fdffe7d
commit 91da300
Show file tree

Hide file tree

Showing 14 changed files with 58 additions and 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
@@ -22,6 +22,11 @@
 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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
+ */
+@Deprecated
 public interface FeedFetcher {
     /**
      * <p>

diff --git 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 @@
  * 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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
  */
+@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
@@ -19,7 +19,10 @@
 /**
  * @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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
  */
+@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
@@ -2,6 +2,11 @@
 
 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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
+ */
+@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
@@ -34,6 +34,11 @@
 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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
+ */
+@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
@@ -7,6 +7,11 @@
 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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
+ */
+@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
@@ -28,7 +28,11 @@
 
 /**
  * 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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
  */
+@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
@@ -25,8 +25,11 @@
  * </p>
  *
  * @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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
  */
+@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
@@ -35,8 +35,11 @@
  * </p>
  *
  * @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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
  */
+@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
@@ -46,7 +46,11 @@
 
 /**
  * @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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
  */
+@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
@@ -68,7 +68,11 @@
  * @see <a
  *      href="http://bobwyman.pubsub.com/main/2004/09/using_rfc3229_w.html">http://bobwyman.pubsub.com/main/2004/09/using_rfc3229_w.html</a>
  * @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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
  */
+@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
@@ -16,7 +16,10 @@
  * @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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
  */
+@Deprecated
 public class LinkedHashMapFeedInfoCache extends HashMapFeedInfoCache {
 
     private final class CacheImpl extends LinkedHashMap<String, SyndFeedInfo> {

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
@@ -22,8 +22,11 @@
 
 /**
  * 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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
  */
+@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
@@ -33,7 +33,11 @@
  * </p>
  *
  * @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 <a href="https://github.com/rometools/rome/issues/276">detailed explanation</a>.
  */
+@Deprecated
 public class SyndFeedInfo implements Cloneable, Serializable {
     private static final long serialVersionUID = 1L;