*/
package org.opendaylight.controller.cluster.datastore;
+import static java.util.Objects.requireNonNull;
+
+import com.google.common.base.MoreObjects.ToStringHelper;
import com.google.common.base.Preconditions;
-import com.google.common.util.concurrent.Futures;
-import com.google.common.util.concurrent.ListenableFuture;
-import org.opendaylight.controller.cluster.datastore.utils.PruningDataTreeModification;
-import org.opendaylight.controller.md.sal.common.api.data.OptimisticLockFailedException;
-import org.opendaylight.controller.md.sal.common.api.data.TransactionCommitFailedException;
-import org.opendaylight.yangtools.yang.data.api.schema.tree.ConflictingModificationAppliedException;
+import com.google.common.base.Verify;
+import com.google.common.primitives.UnsignedLong;
+import com.google.common.util.concurrent.FutureCallback;
+import java.util.Optional;
+import java.util.SortedSet;
+import java.util.concurrent.CompletionStage;
+import org.eclipse.jdt.annotation.Nullable;
+import org.opendaylight.controller.cluster.access.concepts.TransactionIdentifier;
+import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeCandidate;
import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeCandidateTip;
import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeModification;
-import org.opendaylight.yangtools.yang.data.api.schema.tree.DataValidationFailedException;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
final class SimpleShardDataTreeCohort extends ShardDataTreeCohort {
private static final Logger LOG = LoggerFactory.getLogger(SimpleShardDataTreeCohort.class);
- private static final ListenableFuture<Boolean> TRUE_FUTURE = Futures.immediateFuture(Boolean.TRUE);
- private static final ListenableFuture<Void> VOID_FUTURE = Futures.immediateFuture(null);
+
private final DataTreeModification transaction;
private final ShardDataTree dataTree;
- private final String transactionId;
+ private final TransactionIdentifier transactionId;
+ private final CompositeDataTreeCohort userCohorts;
+ private final @Nullable SortedSet<String> participatingShardNames;
+
+ private State state = State.READY;
private DataTreeCandidateTip candidate;
+ private FutureCallback<?> callback;
+ private Exception nextFailure;
+
+ SimpleShardDataTreeCohort(final ShardDataTree dataTree, final DataTreeModification transaction,
+ final TransactionIdentifier transactionId, final CompositeDataTreeCohort userCohorts,
+ final Optional<SortedSet<String>> participatingShardNames) {
+ this.dataTree = requireNonNull(dataTree);
+ this.transaction = requireNonNull(transaction);
+ this.transactionId = requireNonNull(transactionId);
+ this.userCohorts = requireNonNull(userCohorts);
+ this.participatingShardNames = requireNonNull(participatingShardNames).orElse(null);
+ }
SimpleShardDataTreeCohort(final ShardDataTree dataTree, final DataTreeModification transaction,
- final String transactionId) {
- this.dataTree = Preconditions.checkNotNull(dataTree);
- this.transaction = Preconditions.checkNotNull(transaction);
- this.transactionId = transactionId;
+ final TransactionIdentifier transactionId, final Exception nextFailure) {
+ this.dataTree = requireNonNull(dataTree);
+ this.transaction = requireNonNull(transaction);
+ this.transactionId = requireNonNull(transactionId);
+ this.userCohorts = null;
+ this.participatingShardNames = null;
+ this.nextFailure = requireNonNull(nextFailure);
+ }
+
+ @Override
+ public TransactionIdentifier getIdentifier() {
+ return transactionId;
}
@Override
}
@Override
- public ListenableFuture<Boolean> canCommit() {
- DataTreeModification modification = getDataTreeModification();
- try {
- dataTree.getDataTree().validate(modification);
- LOG.trace("Transaction {} validated", transaction);
- return TRUE_FUTURE;
+ DataTreeModification getDataTreeModification() {
+ return transaction;
+ }
+
+ @Override
+ Optional<SortedSet<String>> getParticipatingShardNames() {
+ return Optional.ofNullable(participatingShardNames);
+ }
+
+ private void checkState(final State expected) {
+ Preconditions.checkState(state == expected, "State %s does not match expected state %s for %s",
+ state, expected, getIdentifier());
+ }
+
+ @Override
+ public void canCommit(final FutureCallback<Void> newCallback) {
+ if (state == State.CAN_COMMIT_PENDING) {
+ return;
}
- catch (ConflictingModificationAppliedException e) {
- LOG.warn("Store Tx {}: Conflicting modification for path {}.", transactionId, e.getPath());
- return Futures.immediateFailedFuture(new OptimisticLockFailedException("Optimistic lock failed.", e));
- } catch (DataValidationFailedException e) {
- LOG.warn("Store Tx {}: Data validation failed for path {}.", transactionId, e.getPath(), e);
-
- // For debugging purposes, allow dumping of the modification. Coupled with the above
- // precondition log, it should allow us to understand what went on.
- LOG.debug("Store Tx {}: modifications: {} tree: {}", transactionId, modification, dataTree.getDataTree());
-
- return Futures.immediateFailedFuture(new TransactionCommitFailedException("Data did not pass validation.", e));
- } catch (Exception e) {
- LOG.warn("Unexpected failure in validation phase", e);
- return Futures.immediateFailedFuture(e);
+
+ checkState(State.READY);
+ this.callback = requireNonNull(newCallback);
+ state = State.CAN_COMMIT_PENDING;
+
+ if (nextFailure == null) {
+ dataTree.startCanCommit(this);
+ } else {
+ failedCanCommit(nextFailure);
}
}
@Override
- public ListenableFuture<Void> preCommit() {
- try {
- candidate = dataTree.getDataTree().prepare(getDataTreeModification());
- /*
- * FIXME: this is the place where we should be interacting with persistence, specifically by invoking
- * persist on the candidate (which gives us a Future).
- */
- LOG.trace("Transaction {} prepared candidate {}", transaction, candidate);
- return VOID_FUTURE;
- } catch (Exception e) {
- if(LOG.isTraceEnabled()) {
- LOG.trace("Transaction {} failed to prepare", transaction, e);
- } else {
- LOG.error("Transaction failed to prepare", e);
- }
- return Futures.immediateFailedFuture(e);
+ public void preCommit(final FutureCallback<DataTreeCandidate> newCallback) {
+ checkState(State.CAN_COMMIT_COMPLETE);
+ this.callback = requireNonNull(newCallback);
+ state = State.PRE_COMMIT_PENDING;
+
+ if (nextFailure == null) {
+ dataTree.startPreCommit(this);
+ } else {
+ failedPreCommit(nextFailure);
}
}
@Override
- DataTreeModification getDataTreeModification() {
- DataTreeModification dataTreeModification = transaction;
- if(transaction instanceof PruningDataTreeModification){
- dataTreeModification = ((PruningDataTreeModification) transaction).getResultingModification();
+ public void abort(final FutureCallback<Void> abortCallback) {
+ if (!dataTree.startAbort(this)) {
+ abortCallback.onSuccess(null);
+ return;
+ }
+
+ candidate = null;
+ state = State.ABORTED;
+
+ final Optional<CompletionStage<?>> maybeAborts = userCohorts.abort();
+ if (!maybeAborts.isPresent()) {
+ abortCallback.onSuccess(null);
+ return;
}
- return dataTreeModification;
+
+ maybeAborts.get().whenComplete((noop, failure) -> {
+ if (failure != null) {
+ abortCallback.onFailure(failure);
+ } else {
+ abortCallback.onSuccess(null);
+ }
+ });
}
@Override
- public ListenableFuture<Void> abort() {
- // No-op, really
- return VOID_FUTURE;
+ public void commit(final FutureCallback<UnsignedLong> newCallback) {
+ checkState(State.PRE_COMMIT_COMPLETE);
+ this.callback = requireNonNull(newCallback);
+ state = State.COMMIT_PENDING;
+
+ if (nextFailure == null) {
+ dataTree.startCommit(this, candidate);
+ } else {
+ failedCommit(nextFailure);
+ }
}
- @Override
- public ListenableFuture<Void> commit() {
- try {
- dataTree.getDataTree().commit(candidate);
- } catch (Exception e) {
- if(LOG.isTraceEnabled()) {
- LOG.trace("Transaction {} failed to commit", transaction, e);
+ private <T> FutureCallback<T> switchState(final State newState) {
+ @SuppressWarnings("unchecked")
+ final FutureCallback<T> ret = (FutureCallback<T>) this.callback;
+ this.callback = null;
+ LOG.debug("Transaction {} changing state from {} to {}", transactionId, state, newState);
+ this.state = newState;
+ return ret;
+ }
+
+ void setNewCandidate(final DataTreeCandidateTip dataTreeCandidate) {
+ checkState(State.PRE_COMMIT_COMPLETE);
+ this.candidate = Verify.verifyNotNull(dataTreeCandidate);
+ }
+
+ void successfulCanCommit() {
+ switchState(State.CAN_COMMIT_COMPLETE).onSuccess(null);
+ }
+
+ void failedCanCommit(final Exception cause) {
+ switchState(State.FAILED).onFailure(cause);
+ }
+
+ /**
+ * Run user-defined canCommit and preCommit hooks. We want to run these before we initiate persistence so that
+ * any failure to validate is propagated before we record the transaction.
+ *
+ * @param dataTreeCandidate {@link DataTreeCandidate} under consideration
+ * @param futureCallback the callback to invoke on completion, which may be immediate or async.
+ */
+ void userPreCommit(final DataTreeCandidate dataTreeCandidate, final FutureCallback<Void> futureCallback) {
+ userCohorts.reset();
+
+ final Optional<CompletionStage<Void>> maybeCanCommitFuture = userCohorts.canCommit(dataTreeCandidate);
+ if (!maybeCanCommitFuture.isPresent()) {
+ doUserPreCommit(futureCallback);
+ return;
+ }
+
+ maybeCanCommitFuture.get().whenComplete((noop, failure) -> {
+ if (failure != null) {
+ futureCallback.onFailure(failure);
+ } else {
+ doUserPreCommit(futureCallback);
+ }
+ });
+ }
+
+ private void doUserPreCommit(final FutureCallback<Void> futureCallback) {
+ final Optional<CompletionStage<Void>> maybePreCommitFuture = userCohorts.preCommit();
+ if (!maybePreCommitFuture.isPresent()) {
+ futureCallback.onSuccess(null);
+ return;
+ }
+
+ maybePreCommitFuture.get().whenComplete((noop, failure) -> {
+ if (failure != null) {
+ futureCallback.onFailure(failure);
} else {
- LOG.error("Transaction failed to commit", e);
+ futureCallback.onSuccess(null);
}
- return Futures.immediateFailedFuture(e);
+ });
+ }
+
+ void successfulPreCommit(final DataTreeCandidateTip dataTreeCandidate) {
+ LOG.trace("Transaction {} prepared candidate {}", transaction, dataTreeCandidate);
+ this.candidate = Verify.verifyNotNull(dataTreeCandidate);
+ switchState(State.PRE_COMMIT_COMPLETE).onSuccess(dataTreeCandidate);
+ }
+
+ void failedPreCommit(final Throwable cause) {
+ if (LOG.isTraceEnabled()) {
+ LOG.trace("Transaction {} failed to prepare", transaction, cause);
+ } else {
+ LOG.error("Transaction {} failed to prepare", transactionId, cause);
}
- LOG.trace("Transaction {} committed, proceeding to notify", transaction);
- dataTree.notifyListeners(candidate);
- return VOID_FUTURE;
+ userCohorts.abort();
+ switchState(State.FAILED).onFailure(cause);
+ }
+
+ void successfulCommit(final UnsignedLong journalIndex, final Runnable onComplete) {
+ final Optional<CompletionStage<Void>> maybeCommitFuture = userCohorts.commit();
+ if (!maybeCommitFuture.isPresent()) {
+ finishSuccessfulCommit(journalIndex, onComplete);
+ return;
+ }
+
+ maybeCommitFuture.get().whenComplete((noop, failure) -> {
+ if (failure != null) {
+ LOG.error("User cohorts failed to commit", failure);
+ }
+
+ finishSuccessfulCommit(journalIndex, onComplete);
+ });
+ }
+
+ private void finishSuccessfulCommit(final UnsignedLong journalIndex, final Runnable onComplete) {
+ switchState(State.COMMITTED).onSuccess(journalIndex);
+ onComplete.run();
+ }
+
+ void failedCommit(final Exception cause) {
+ if (LOG.isTraceEnabled()) {
+ LOG.trace("Transaction {} failed to commit", transaction, cause);
+ } else {
+ LOG.error("Transaction failed to commit", cause);
+ }
+
+ userCohorts.abort();
+ switchState(State.FAILED).onFailure(cause);
+ }
+
+ @Override
+ public State getState() {
+ return state;
+ }
+
+ void reportFailure(final Exception cause) {
+ if (nextFailure == null) {
+ this.nextFailure = requireNonNull(cause);
+ } else {
+ LOG.debug("Transaction {} already has a set failure, not updating it", transactionId, cause);
+ }
+ }
+
+ @Override
+ public boolean isFailed() {
+ return state == State.FAILED || nextFailure != null;
+ }
+
+ @Override
+ ToStringHelper addToStringAttributes(final ToStringHelper toStringHelper) {
+ return super.addToStringAttributes(toStringHelper).add("nextFailure", nextFailure);
}
}