2 * Copyright (c) 2014 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
8 package org.opendaylight.controller.md.sal.common.api.data;
10 import org.opendaylight.yangtools.concepts.Path;
13 * A chain of transactions. Transactions in a chain need to be committed in sequence and each
14 * transaction should see the effects of previous transactions as if they happened. A chain
15 * makes no guarantees of atomicity, in fact transactions are committed as soon as possible.
18 public interface TransactionChain<P extends Path<P>, D> extends AutoCloseable, AsyncDataTransactionFactory<P, D> {
21 * Create a new read only transaction which will continue the chain.
22 * The previous read-write transaction has to be either COMMITED or CANCELLED.
24 * @return New transaction in the chain.
25 * @throws IllegalStateException if the previous transaction was not COMMITED
27 * @throws TransactionChainClosedException if the chain has been closed.
30 public AsyncReadOnlyTransaction<P, D> newReadOnlyTransaction();
34 * Create a new read write transaction which will continue the chain.
35 * The previous read-write transaction has to be either COMMITED or CANCELLED.
37 * @return New transaction in the chain.
38 * @throws IllegalStateException if the previous transaction was not COMMITTED
40 * @throws TransactionChainClosedException if the chain has been closed.
43 public AsyncReadWriteTransaction<P, D> newReadWriteTransaction();