BUG-2383: mark classes/methods as deprecated 05/17505/1
authorRobert Varga <rovarga@cisco.com>
Tue, 31 Mar 2015 21:37:09 +0000 (23:37 +0200)
committerRobert Varga <rovarga@cisco.com>
Tue, 31 Mar 2015 21:38:32 +0000 (23:38 +0200)
The RIB rework should result in major simplification of the interfaces
exposed and general mechanics. Mark classes which are slated for
removal.

Change-Id: Ie8ed18035089261695495ba29c1638776ebc9391
Signed-off-by: Robert Varga <rovarga@cisco.com>
18 files changed:
bgp/rib-impl/src/main/java/org/opendaylight/protocol/bgp/rib/impl/AbstractAdjRIBsOut.java
bgp/rib-impl/src/main/java/org/opendaylight/protocol/bgp/rib/impl/AdjRIBOutEntry.java
bgp/rib-impl/src/main/java/org/opendaylight/protocol/bgp/rib/impl/AdjRIBsTransactionImpl.java
bgp/rib-impl/src/main/java/org/opendaylight/protocol/bgp/rib/impl/Ipv4AdjRIBsIn.java
bgp/rib-impl/src/main/java/org/opendaylight/protocol/bgp/rib/impl/Ipv6AdjRIBsIn.java
bgp/rib-impl/src/main/java/org/opendaylight/protocol/bgp/rib/impl/RIBImpl.java
bgp/rib-impl/src/main/java/org/opendaylight/protocol/bgp/rib/impl/RIBTables.java
bgp/rib-impl/src/main/java/org/opendaylight/protocol/bgp/rib/impl/SessionRIBsOut.java
bgp/rib-impl/src/main/java/org/opendaylight/protocol/bgp/rib/impl/spi/AdjRIBsOut.java
bgp/rib-impl/src/main/java/org/opendaylight/protocol/bgp/rib/impl/spi/AdjRIBsOutRegistration.java
bgp/rib-impl/src/main/java/org/opendaylight/protocol/bgp/rib/impl/spi/RIB.java
bgp/rib-spi/src/main/java/org/opendaylight/protocol/bgp/rib/spi/AbstractAdjRIBs.java
bgp/rib-spi/src/main/java/org/opendaylight/protocol/bgp/rib/spi/AdjRIBsFactory.java
bgp/rib-spi/src/main/java/org/opendaylight/protocol/bgp/rib/spi/AdjRIBsIn.java
bgp/rib-spi/src/main/java/org/opendaylight/protocol/bgp/rib/spi/AdjRIBsTransaction.java
bgp/rib-spi/src/main/java/org/opendaylight/protocol/bgp/rib/spi/BGPObjectComparator.java
bgp/rib-spi/src/main/java/org/opendaylight/protocol/bgp/rib/spi/RIBEntry.java
bgp/rib-spi/src/main/java/org/opendaylight/protocol/bgp/rib/spi/RouteEncoder.java

index a475f9a458b5e8d6a2f273975dd1cc8ef56aaf07..8e02c519a0835d73721e8c198c2f07403c8a68e0 100644 (file)
@@ -8,12 +8,10 @@
 package org.opendaylight.protocol.bgp.rib.impl;
 
 import com.google.common.base.Preconditions;
-
 import java.util.Queue;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.ConcurrentLinkedQueue;
 import java.util.concurrent.ConcurrentMap;
-
 import org.opendaylight.protocol.bgp.rib.impl.spi.AdjRIBsOut;
 import org.opendaylight.protocol.bgp.rib.spi.RouteEncoder;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.message.rev130919.Update;
@@ -24,6 +22,7 @@ import org.opendaylight.yangtools.yang.binding.DataObject;
  * A per-peer collection of data which needs to be sent out. This class is kept lockfree
  * on purpose.
  */
+@Deprecated
 abstract class AbstractAdjRIBsOut implements AdjRIBsOut {
     private final ConcurrentMap<Object, AdjRIBOutEntry<Object, Route>> data = new ConcurrentHashMap<>();
     private final Queue<Object> queue = new ConcurrentLinkedQueue<>();
index 4e02d4725d4e1136be2f6cd3a3e2cbc254332a08..48c5ef0640ba1211a9df8dd898ef793191b50f2a 100644 (file)
@@ -14,6 +14,7 @@ import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.rib.
 import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.rib.rev130925.route.Attributes;
 import org.opendaylight.yangtools.yang.binding.DataContainer;
 
+@Deprecated
 final class AdjRIBOutEntry<K, V extends Route> {
     @SuppressWarnings("rawtypes")
     private static final AtomicReferenceFieldUpdater<AdjRIBOutEntry, Route> NLRIENTRY_ADV_UPDATER = AtomicReferenceFieldUpdater.newUpdater(AdjRIBOutEntry.class, Route.class, "advertisedValue");
index 2d888311b2e12ffd6ef49dd284466b8ce60c1b74..ccb8bdaa3c926db5d8f6dea358a4044234dc0478 100644 (file)
@@ -27,6 +27,7 @@ import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+@Deprecated
 class AdjRIBsTransactionImpl implements AdjRIBsTransaction {
     private static final Logger LOG = LoggerFactory.getLogger(AdjRIBsTransactionImpl.class);
     private final BGPObjectComparator comparator;
index c7f649cff975d4c083daafb4cb4f2f48e4d31506..add1b66f7c3555d8326d01a21d2c8b2e682c5997 100644 (file)
@@ -36,6 +36,7 @@ import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.rib.
 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
 import org.opendaylight.yangtools.yang.binding.KeyedInstanceIdentifier;
 
+@Deprecated
 final class Ipv4AdjRIBsIn extends AbstractAdjRIBs<Ipv4Prefix, Ipv4Route, Ipv4RouteKey> {
     private final InstanceIdentifier<Ipv4Routes> routesBasePath;
 
index 7a0118916bb3d09c7e95f5d5453e8682cc3ce648..e308333df3708735a0cc972df5008febaff8c4ae 100644 (file)
@@ -36,6 +36,7 @@ import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.rib.
 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
 import org.opendaylight.yangtools.yang.binding.KeyedInstanceIdentifier;
 
+@Deprecated
 final class Ipv6AdjRIBsIn extends AbstractAdjRIBs<Ipv6Prefix, Ipv6Route, Ipv6RouteKey> {
     private final InstanceIdentifier<Ipv6Routes> routesBasePath;
 
index ac3dd2e85c05192286e23773204a7b1fd45e1270..4464eb364f3b1fc13402bf80f0a718ddc9949586 100644 (file)
@@ -231,10 +231,12 @@ public final class RIBImpl extends DefaultRibReference implements AutoCloseable,
         });
     }
 
+    @Deprecated
     synchronized void initTables(final byte[] remoteBgpId) {
     }
 
     @Override
+    @Deprecated
     public synchronized void updateTables(final Peer peer, final Update message) {
         final AdjRIBsTransactionImpl trans = new AdjRIBsTransactionImpl(this.ribOuts, this.comparator, this.chain.newWriteOnlyTransaction());
 
@@ -346,6 +348,7 @@ public final class RIBImpl extends DefaultRibReference implements AutoCloseable,
         });
     }
 
+    @Deprecated
     @Override
     public synchronized void clearTable(final Peer peer, final TablesKey key) {
         final AdjRIBsIn<?, ?> ari = this.tables.get(key);
@@ -377,6 +380,7 @@ public final class RIBImpl extends DefaultRibReference implements AutoCloseable,
     }
 
     @SuppressWarnings("unchecked")
+    @Deprecated
     protected <K, V extends Route> AdjRIBsIn<K, V> getTable(final TablesKey key) {
         return (AdjRIBsIn<K, V>) this.tables.get(key);
     }
@@ -419,6 +423,7 @@ public final class RIBImpl extends DefaultRibReference implements AutoCloseable,
         return this.dispatcher;
     }
 
+    @Deprecated
     @Override
     public void initTable(final Peer bgpPeer, final TablesKey key) {
         // FIXME: BUG-196: support graceful restart
index d41d3b5ef680ed6441cb098e593fe533e28c503b..0c98ae144977440ad9dc6c4e58760dc6222ba1ea 100644 (file)
@@ -8,10 +8,8 @@
 package org.opendaylight.protocol.bgp.rib.impl;
 
 import com.google.common.base.Preconditions;
-
 import java.util.HashMap;
 import java.util.Map;
-
 import org.opendaylight.controller.md.sal.binding.api.WriteTransaction;
 import org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType;
 import org.opendaylight.protocol.bgp.rib.RibReference;
@@ -27,6 +25,7 @@ import org.opendaylight.yangtools.yang.binding.KeyedInstanceIdentifier;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+@Deprecated
 final class RIBTables {
 
     private static final Logger LOG = LoggerFactory.getLogger(RIBTables.class);
index 783ce132e15f195f424067eeb3974016e812f416..db1b77227c143fe2c8a7f6672e0624d70ae27713 100644 (file)
@@ -8,11 +8,10 @@
 package org.opendaylight.protocol.bgp.rib.impl;
 
 import com.google.common.base.Preconditions;
-
 import java.util.concurrent.atomic.AtomicBoolean;
-
 import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.message.rev130919.Update;
 
+@Deprecated
 final class SessionRIBsOut extends AbstractAdjRIBsOut implements Runnable {
     private final AtomicBoolean scheduled = new AtomicBoolean(false);
     private final BGPSessionImpl session;
index dc4a526a623e4253784b4e31d76499404a9a0aa5..6385faaeba64f001f80dcc3a5c1963b1747cdf26 100644 (file)
@@ -10,6 +10,7 @@ package org.opendaylight.protocol.bgp.rib.impl.spi;
 import org.opendaylight.protocol.bgp.rib.spi.RouteEncoder;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.rib.rev130925.Route;
 
+@Deprecated
 public interface AdjRIBsOut {
     void put(final RouteEncoder ribOut, final Object key, final Route newValue);
 }
index 6991074993075f417ab8b2f67428896f8a6e3bc9..2f599031a7feb96da3a354a0719688004f43fd9f 100644 (file)
@@ -9,6 +9,7 @@ package org.opendaylight.protocol.bgp.rib.impl.spi;
 
 import org.opendaylight.yangtools.concepts.AbstractObjectRegistration;
 
+@Deprecated
 public abstract class AdjRIBsOutRegistration extends AbstractObjectRegistration<AdjRIBsOut> {
     protected AdjRIBsOutRegistration(final AdjRIBsOut instance) {
         super(instance);
index e55cdaa49dde3ecae4cf7464d7808f6e5d7bedd3..cdf0866a6ddaa64a96b19375056265fc62ceebb7 100644 (file)
@@ -37,10 +37,13 @@ public interface RIB {
      */
     @Nonnull Set<? extends BgpTableType> getLocalTables();
 
+    @Deprecated
     void initTable(Peer bgpPeer, TablesKey key);
 
+    @Deprecated
     void clearTable(Peer bgpPeer, TablesKey key);
 
+    @Deprecated
     void updateTables(Peer bgpPeer, Update message);
 
     BGPDispatcher getDispatcher();
index 02d06d92b4026b32520d15c592926d9cf3a7ff5e..1d3591873b2c15cdd8adb3c4b292e5b9aeda8528 100644 (file)
@@ -39,6 +39,7 @@ import org.opendaylight.yangtools.yang.binding.KeyedInstanceIdentifier;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+@Deprecated
 @ThreadSafe
 public abstract class AbstractAdjRIBs<I, D extends Identifiable<K> & Route, K extends Identifier<D>> implements AdjRIBsIn<I, D>, RouteEncoder {
     protected abstract static class RIBEntryData<I, D extends Identifiable<K> & Route, K extends Identifier<D>> {
index 95faa5e477b78607ef221f9eba389a00cf1be315..da6fe9754f02c1062eb79516a500ca579762c7b3 100644 (file)
@@ -12,6 +12,7 @@ import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.rib.
 import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.rib.rev130925.rib.TablesKey;
 import org.opendaylight.yangtools.yang.binding.KeyedInstanceIdentifier;
 
+@Deprecated
 public interface AdjRIBsFactory {
     /*
      * Create an instance of route tables for the specified backend data store. Note that the
index 72f1e03edccde7217a1f89490121683ef8ff6239..171bc73874ba00367bcc97b843ffccec2ab03433 100644 (file)
@@ -14,6 +14,7 @@ import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.mult
 import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.multiprotocol.rev130919.update.path.attributes.MpUnreachNlri;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.rib.rev130925.Route;
 
+@Deprecated
 public interface AdjRIBsIn<K, V extends Route> {
 
     /**
index 78c2f0a5b5dae08e4055ff6ab3259f760102ba7f..bd6bc1833a171f2f37c9a8eb7d062113bf208d05 100644 (file)
@@ -14,6 +14,7 @@ import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
 /**
  * An execution context for a single LocRib transaction.
  */
+@Deprecated
 public interface AdjRIBsTransaction {
 
     BGPObjectComparator comparator();
index 1279d52306853c89f230b2b05c301e8988e9ff09..8ea34e669de120d0cf4ed5efd672f7dcf36538b5 100644 (file)
@@ -25,6 +25,7 @@ import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.type
  * This comparator is intended to implement BGP Best Path Selection algorithm, as described at
  * <a href="http://www.cisco.com/en/US/tech/tk365/technologies_tech_note09186a0080094431.shtml">here</a>
  */
+@Deprecated
 public final class BGPObjectComparator implements Comparator<RIBEntryData<?, ?, ?>>, Serializable {
 
     private static final long serialVersionUID = 3299599519482155374L;
index 2a212c5ec5f1dfdc3d477fdd24a1736c3c5b18f8..e60107aad6b9925b25f95141a6d7a785c6e3a12f 100644 (file)
@@ -24,6 +24,7 @@ import org.slf4j.LoggerFactory;
  * on ordering specified by the supplied comparator.
  *
  */
+@Deprecated
 final class RIBEntry<I, D extends Identifiable<K> & Route, K extends Identifier<D>> {
     private static final Logger LOG = LoggerFactory.getLogger(RIBEntry.class);
     private static final int DEFAULT_MAP_SIZE = 2;
index 5c4470594ac2658902189e2c586f38558c168adb..36afb218520c345e5a3706982153025e9283ec11 100644 (file)
@@ -10,6 +10,7 @@ package org.opendaylight.protocol.bgp.rib.spi;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.message.rev130919.Update;
 import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.bgp.rib.rev130925.Route;
 
+@Deprecated
 public interface RouteEncoder {
     Update updateMessageFor(Object key, Route route);
 }