*/
package org.opendaylight.controller.cluster.databroker.actors.dds;
-import akka.actor.ActorRef;
import com.google.common.annotations.Beta;
import com.google.common.base.Preconditions;
-import java.util.concurrent.atomic.AtomicIntegerFieldUpdater;
-import javax.annotation.concurrent.NotThreadSafe;
+import com.google.common.base.Verify;
+import java.util.concurrent.atomic.AtomicLongFieldUpdater;
import org.opendaylight.controller.cluster.access.concepts.LocalHistoryIdentifier;
+import org.opendaylight.controller.cluster.access.concepts.TransactionIdentifier;
/**
* Client-side view of a local history. This class tracks all state related to a particular history and routes
* frontend requests towards the backend.
*
+ * <p>
* This interface is used by the world outside of the actor system and in the actor system it is manifested via
* its client actor. That requires some state transfer with {@link DistributedDataStoreClientBehavior}. In order to
* reduce request latency, all messages are carbon-copied (and enqueued first) to the client actor.
* @author Robert Varga
*/
@Beta
-@NotThreadSafe
-public final class ClientLocalHistory implements AutoCloseable {
- private static final AtomicIntegerFieldUpdater<ClientLocalHistory> CLOSED_UPDATER =
- AtomicIntegerFieldUpdater.newUpdater(ClientLocalHistory.class, "state");
- private static final int IDLE_STATE = 0;
- private static final int CLOSED_STATE = 1;
-
- private final LocalHistoryIdentifier historyId;
- private final ActorRef backendActor;
- private final ActorRef clientActor;
-
- private volatile int state = IDLE_STATE;
-
- ClientLocalHistory(final DistributedDataStoreClientBehavior client, final long historyId,
- final ActorRef backendActor) {
- this.clientActor = client.self();
- this.backendActor = Preconditions.checkNotNull(backendActor);
- this.historyId = new LocalHistoryIdentifier(client.getIdentifier(), historyId);
+public final class ClientLocalHistory extends AbstractClientHistory implements AutoCloseable {
+
+ private static final AtomicLongFieldUpdater<ClientLocalHistory> NEXT_TX_UPDATER =
+ AtomicLongFieldUpdater.newUpdater(ClientLocalHistory.class, "nextTx");
+
+ // Used via NEXT_TX_UPDATER
+ @SuppressWarnings("unused")
+ private volatile long nextTx = 0;
+
+ ClientLocalHistory(final DistributedDataStoreClientBehavior client, final LocalHistoryIdentifier historyId) {
+ super(client, historyId);
}
- private void checkNotClosed() {
- Preconditions.checkState(state != CLOSED_STATE, "Local history %s has been closed", historyId);
+ public ClientTransaction createTransaction() {
+ final State local = state();
+ Preconditions.checkState(local == State.IDLE, "Local history %s state is %s", this, local);
+ updateState(local, State.TX_OPEN);
+
+ return new ClientTransaction(this, new TransactionIdentifier(getIdentifier(),
+ NEXT_TX_UPDATER.getAndIncrement(this)));
}
@Override
public void close() {
- if (CLOSED_UPDATER.compareAndSet(this, IDLE_STATE, CLOSED_STATE)) {
- // FIXME: signal close to both client actor and backend actor
- } else if (state != CLOSED_STATE) {
- throw new IllegalStateException("Cannot close history with an open transaction");
+ final State local = state();
+ if (local != State.CLOSED) {
+ Preconditions.checkState(local == State.IDLE, "Local history %s has an open transaction", this);
+ updateState(local, State.CLOSED);
}
}
- // FIXME: add client requests related to a particular local history
+ @Override
+ void onTransactionReady(final ClientTransaction transaction) {
+ final State local = state();
+ Verify.verify(local == State.TX_OPEN, "Local history %s is in unexpected state %s", this, local);
+ updateState(local, State.IDLE);
+ super.onTransactionReady(transaction);
+ }
}