2 * Copyright (c) 2015 Cisco Systems, Inc. and others. All rights reserved.
4 * This program and the accompanying materials are made available under the
5 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6 * and is available at http://www.eclipse.org/legal/epl-v10.html
9 package org.opendaylight.controller.cluster.databroker;
11 import com.google.common.base.Preconditions;
12 import com.google.common.util.concurrent.FluentFuture;
13 import java.lang.invoke.MethodHandles;
14 import java.lang.invoke.VarHandle;
15 import java.util.Collection;
16 import java.util.EnumMap;
18 import org.opendaylight.mdsal.common.api.CommitInfo;
19 import org.opendaylight.mdsal.common.api.LogicalDatastoreType;
20 import org.opendaylight.mdsal.dom.api.DOMDataTreeReadTransaction;
21 import org.opendaylight.mdsal.dom.api.DOMDataTreeReadWriteTransaction;
22 import org.opendaylight.mdsal.dom.api.DOMDataTreeWriteTransaction;
23 import org.opendaylight.mdsal.dom.spi.store.DOMStoreThreePhaseCommitCohort;
24 import org.opendaylight.mdsal.dom.spi.store.DOMStoreTransactionFactory;
25 import org.slf4j.Logger;
26 import org.slf4j.LoggerFactory;
28 public abstract class AbstractDOMTransactionFactory<T extends DOMStoreTransactionFactory> implements AutoCloseable {
29 private static final Logger LOG = LoggerFactory.getLogger(AbstractDOMTransactionFactory.class);
30 private static final VarHandle CLOSED;
34 CLOSED = MethodHandles.lookup().findVarHandle(AbstractDOMTransactionFactory.class, "closed", boolean.class);
35 } catch (NoSuchFieldException | IllegalAccessException e) {
36 throw new ExceptionInInitializerError(e);
40 private final Map<LogicalDatastoreType, T> storeTxFactories;
42 private volatile boolean closed;
44 protected AbstractDOMTransactionFactory(final Map<LogicalDatastoreType, T> txFactories) {
45 this.storeTxFactories = new EnumMap<>(txFactories);
49 * Implementations must return unique identifier for each and every call of
52 * @return new Unique transaction identifier.
54 protected abstract Object newTransactionIdentifier();
57 * Submits a transaction asynchronously for commit.
59 * @param transaction the transaction to submit
60 * @param cohorts the associated cohorts
61 * @return a resulting Future
63 protected abstract FluentFuture<? extends CommitInfo> commit(DOMDataTreeWriteTransaction transaction,
64 Collection<DOMStoreThreePhaseCommitCohort> cohorts);
67 * Creates a new read-only transaction.
69 * @return the transaction instance
71 public final DOMDataTreeReadTransaction newReadOnlyTransaction() {
74 return new DOMBrokerReadOnlyTransaction(newTransactionIdentifier(), storeTxFactories);
79 * Creates a new write-only transaction.
81 * @return the transaction instance
83 public final DOMDataTreeWriteTransaction newWriteOnlyTransaction() {
86 return new DOMBrokerWriteOnlyTransaction(newTransactionIdentifier(), storeTxFactories, this);
91 * Creates a new read-write transaction.
93 * @return the transaction instance
95 public final DOMDataTreeReadWriteTransaction newReadWriteTransaction() {
98 return new DOMBrokerReadWriteTransaction(newTransactionIdentifier(), storeTxFactories, this);
102 * Convenience accessor of backing factories intended to be used only by
103 * finalization of this class.
106 * Finalization of this class may want to access other functionality of
107 * supplied Transaction factories.
109 * @return Map of backing transaction factories.
111 public final Map<LogicalDatastoreType, T> getTxFactories() {
112 return storeTxFactories;
116 * Checks if instance is not closed.
118 * @throws IllegalStateException If instance of this class was closed.
121 protected final void checkNotClosed() {
122 Preconditions.checkState(!closed, "Transaction factory was closed. No further operations allowed.");
126 public void close() {
127 if (!CLOSED.compareAndSet(this, false, true)) {
128 LOG.warn("Transaction factory was already closed", new Throwable());