Remove deprecated MD-SAL APIs

[controller.git] / opendaylight / md-sal / sal-dom-spi / src / main / java / org / opendaylight / controller / sal / core / spi / data / SnapshotBackedReadTransaction.java

diff --git a/opendaylight/md-sal/sal-dom-spi/src/main/java/org/opendaylight/controller/sal/core/spi/data/SnapshotBackedReadTransaction.java b/opendaylight/md-sal/sal-dom-spi/src/main/java/org/opendaylight/controller/sal/core/spi/data/SnapshotBackedReadTransaction.java
deleted file mode 100644 (file)
index bb402f8..0000000
--- a/opendaylight/md-sal/sal-dom-spi/src/main/java/org/opendaylight/controller/sal/core/spi/data/SnapshotBackedReadTransaction.java
+++ /dev/null
@@ -1,129 +0,0 @@
-/*
- * Copyright (c) 2014 Cisco Systems, Inc. and others.  All rights reserved.
- *
- * This program and the accompanying materials are made available under the
- * terms of the Eclipse Public License v1.0 which accompanies this distribution,
- * and is available at http://www.eclipse.org/legal/epl-v10.html
- */
-package org.opendaylight.controller.sal.core.spi.data;
-
-import static java.util.Objects.requireNonNull;
-
-import com.google.common.annotations.Beta;
-import com.google.common.base.Optional;
-import com.google.common.util.concurrent.CheckedFuture;
-import com.google.common.util.concurrent.Futures;
-import java.util.concurrent.atomic.AtomicReferenceFieldUpdater;
-import org.opendaylight.controller.md.sal.common.api.data.ReadFailedException;
-import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
-import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode;
-import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeSnapshot;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * Implementation of read-only transaction backed by {@link DataTreeSnapshot}.
- *
- * <p>
- * Implementation of read-only transaction backed by {@link DataTreeSnapshot}
- * which delegates most of its calls to similar methods provided by underlying snapshot.
- *
- * @param <T> identifier type
- *
- * @deprecated Use {@link org.opendaylight.mdsal.dom.spi.store.SnapshotBackedReadTransaction} instead.
- */
-@Deprecated(forRemoval = true)
-@Beta
-public final class SnapshotBackedReadTransaction<T> extends AbstractDOMStoreTransaction<T>
-        implements DOMStoreReadTransaction {
-    private static final Logger LOG = LoggerFactory.getLogger(SnapshotBackedReadTransaction.class);
-
-    @SuppressWarnings("rawtypes")
-    private static final AtomicReferenceFieldUpdater<SnapshotBackedReadTransaction, DataTreeSnapshot> SNAPSHOT_UPDATER =
-            AtomicReferenceFieldUpdater.newUpdater(SnapshotBackedReadTransaction.class, DataTreeSnapshot.class,
-                "stableSnapshot");
-
-    // Guarded by stableSnapshot CAS, hence it does not need to be volatile
-    private TransactionClosePrototype<T> closeImpl;
-    private volatile DataTreeSnapshot stableSnapshot;
-
-    /**
-     * Creates a new read-only transaction.
-     *
-     * @param identifier Transaction Identifier
-     * @param debug Enable transaction debugging
-     * @param snapshot Snapshot which will be modified.
-     */
-    SnapshotBackedReadTransaction(final T identifier, final boolean debug, final DataTreeSnapshot snapshot,
-            final TransactionClosePrototype<T> closeImpl) {
-        super(identifier, debug);
-        this.stableSnapshot = requireNonNull(snapshot);
-        this.closeImpl = closeImpl;
-        LOG.debug("ReadOnly Tx: {} allocated with snapshot {}", identifier, snapshot);
-    }
-
-    @Override
-    public void close() {
-        final DataTreeSnapshot prev = SNAPSHOT_UPDATER.getAndSet(this, null);
-        if (prev == null) {
-            LOG.debug("Store transaction: {} : previously closed", getIdentifier());
-            return;
-        }
-
-        LOG.debug("Store transaction: {} : Closed", getIdentifier());
-        if (closeImpl != null) {
-            closeImpl.transactionClosed(this);
-            closeImpl = null;
-        }
-    }
-
-    @Override
-    @SuppressWarnings("checkstyle:IllegalCatch")
-    public CheckedFuture<Optional<NormalizedNode<?,?>>, ReadFailedException> read(final YangInstanceIdentifier path) {
-        LOG.debug("Tx: {} Read: {}", getIdentifier(), path);
-        requireNonNull(path, "Path must not be null.");
-
-        final DataTreeSnapshot snapshot = stableSnapshot;
-        if (snapshot == null) {
-            return Futures.immediateFailedCheckedFuture(new ReadFailedException("Transaction is closed"));
-        }
-
-        try {
-            return Futures.immediateCheckedFuture(Optional.fromJavaUtil(snapshot.readNode(path)));
-        } catch (RuntimeException e) {
-            LOG.error("Tx: {} Failed Read of {}", getIdentifier(), path, e);
-            return Futures.immediateFailedCheckedFuture(new ReadFailedException("Read failed",e));
-        }
-    }
-
-    @Override
-    public CheckedFuture<Boolean, ReadFailedException> exists(final YangInstanceIdentifier path) {
-        LOG.debug("Tx: {} Exists: {}", getIdentifier(), path);
-        requireNonNull(path, "Path must not be null.");
-
-        try {
-            return Futures.immediateCheckedFuture(read(path).checkedGet().isPresent());
-        } catch (ReadFailedException e) {
-            return Futures.immediateFailedCheckedFuture(e);
-        }
-    }
-
-    /**
-     * Prototype implementation of {@link SnapshotBackedReadTransaction#close()}.
-     *
-     * <p>
-     * This class is intended to be implemented by Transaction factories responsible for allocation
-     * of {@link org.opendaylight.mdsal.dom.spi.store.SnapshotBackedReadTransaction} and
-     * providing underlying logic for applying implementation.
-     *
-     * @param <T> identifier type
-     */
-    public interface TransactionClosePrototype<T> {
-        /**
-         * Called when a transaction is closed. This is not invoked at most once for every transaction.
-         *
-         * @param tx Transaction which got closed.
-         */
-        void transactionClosed(SnapshotBackedReadTransaction<T> tx);
-    }
-}