import com.google.common.base.Preconditions;
-
/**
* Failure reported when a data tree is no longer accessible.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeInaccessibleException} instead.
*/
+@Deprecated
public class DOMDataTreeInaccessibleException extends DOMDataTreeListeningException {
private static final long serialVersionUID = 1L;
private final DOMDataTreeIdentifier treeIdentifier;
/**
* Interface implemented by data consumers, e.g. processes wanting to act on data
* after it has been introduced to the conceptual data tree.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeListener} instead.
*/
+@Deprecated
public interface DOMDataTreeListener extends EventListener {
/**
* Invoked whenever one or more registered subtrees change. The logical changes are reported,
/**
* Base exception for various causes why and {@link DOMDataTreeListener}
* may be terminated by the {@link DOMDataTreeService} implementation.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeListeningException} instead.
*/
+@Deprecated
public class DOMDataTreeListeningException extends Exception {
private static final long serialVersionUID = 1L;
/**
* Exception thrown when a loop is detected in the way {@link DOMDataTreeListener}
* and {@link DOMDataTreeProducer} instances would be connected.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeLoopException} instead.
*/
+@Deprecated
public class DOMDataTreeLoopException extends Exception {
private static final long serialVersionUID = 1L;
* callback on that particular instance. Any transaction which is not submitted by the
* time the callback returns will be implicitly cancelled. A producer becomes unbound
* when the listener it is bound to becomes unregistered.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeProducer} instead.
*/
+@Deprecated
public interface DOMDataTreeProducer extends DOMDataTreeProducerFactory, AutoCloseable {
/**
* Allocate a new open transaction on this producer. Any and all transactions
/**
* Exception indicating that the {@link DOMDataTreeProducer} has an open user
* transaction and cannot be closed.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeProducerBusyException} instead.
*/
+@Deprecated
public class DOMDataTreeProducerBusyException extends DOMDataTreeProducerException {
private static final long serialVersionUID = 1L;
/**
* Base exception for all exceptions related to {@link DOMDataTreeProducer}s.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeProducerException} instead.
*/
+@Deprecated
public class DOMDataTreeProducerException extends Exception {
private static final long serialVersionUID = 1L;
/**
* Base source of {@link DOMDataTreeProducer}s. This interface is usually not used directly,
* but rather through one of its sub-interfaces.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeProducerFactory} instead.
*/
+@Deprecated
public interface DOMDataTreeProducerFactory {
/**
* Create a producer, which is able to access to a set of trees.
* not go into a feedback loop, where it is impossible to block either a producer or
* a consumer without accumulating excess work in the backlog stemming from its previous
* activity.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeService} instead.
*/
+@Deprecated
public interface DOMDataTreeService extends DOMDataTreeProducerFactory, DOMService {
/**
* Register a {@link DOMDataTreeListener} instance. Once registered, the listener
* a shard can receive. Each shard implementation is expected to also implement some of the
* datastore-level APIs. Which interfaces are required depends on the {@link DOMDataTreeShardingService}
* implementation.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeShard} instead.
*/
+@Deprecated
public interface DOMDataTreeShard extends EventListener {
/**
* Invoked whenever a child is getting attached as a more specific prefix under this shard.
import javax.annotation.Nonnull;
/**
- * Exception thrown when an attempt to attach a conflicting shard to the global
- * table.
+ * Exception thrown when an attempt to attach a conflicting shard to the global table.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeShardingConflictException} instead.
*/
+@Deprecated
public class DOMDataTreeShardingConflictException extends Exception {
private static final long serialVersionUID = 1L;
*
* Whenever a parent/child relationship is changed, the parent is notified, so it can
* understand that a logical child has been attached.
+ *
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.api.DOMDataTreeShardingService} instead.
*/
+@Deprecated
public interface DOMDataTreeShardingService extends DOMService {
/**
* Register a shard as responsible for a particular subtree prefix.
import org.opendaylight.controller.md.sal.dom.api.DOMDataTreeShard;
import org.opendaylight.yangtools.concepts.AbstractListenerRegistration;
+/**
+ * @deprecated To be removed with {@link ShardedDOMDataTree}.
+ */
+@Deprecated
final class ShardRegistration<T extends DOMDataTreeShard> extends AbstractListenerRegistration<T> {
private final DOMDataTreeIdentifier prefix;
private final ShardedDOMDataTree tree;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
+/**
+ * @deprecated Use {@link org.opendaylight.mdsal.dom.broker.ShardedDOMDataTree} instead.
+ */
+@Deprecated
public final class ShardedDOMDataTree implements DOMDataTreeService, DOMDataTreeShardingService {
private static final Logger LOG = LoggerFactory.getLogger(ShardedDOMDataTree.class);
private final Map<LogicalDatastoreType, ShardingTableEntry> shardingTables = new EnumMap<>(LogicalDatastoreType.class);
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
+/**
+ * @deprecated To be removed with {@link ShardedDOMDataTree}.
+ */
+@Deprecated
final class ShardedDOMDataTreeProducer implements DOMDataTreeProducer {
private static final Logger LOG = LoggerFactory.getLogger(ShardedDOMDataTreeProducer.class);
private final BiMap<DOMDataTreeShard, DOMStoreTransactionChain> shardToChain;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
+/**
+ * @deprecated To be removed with {@link ShardedDOMDataTree}.
+ */
+@Deprecated
@NotThreadSafe
final class ShardedDOMDataWriteTransaction implements DOMDataWriteTransaction {
private static final Logger LOG = LoggerFactory.getLogger(ShardedDOMDataWriteTransaction.class);
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
+/**
+ * @deprecated To be removed with {@link ShardedDOMDataTree}.
+ */
+@Deprecated
final class ShardingTableEntry implements Identifiable<PathArgument> {
private static final Logger LOG = LoggerFactory.getLogger(ShardingTableEntry.class);
private final Map<PathArgument, ShardingTableEntry> children = Collections.emptyMap();