org.opendaylight.mdsal.binding.api

Interface DataTreeCommitCohort<T extends DataObject>

@Beta
public interface DataTreeCommitCohort<T extends DataObject>

Commit cohort participating in commit of data modification, which can validate data tree modifications, with option to reject supplied modification, and with callbacks describing state of commit.

Performance implications

DataTreeCommitCohorts are hooked up into commit of data tree changes and MAY negatively affect performance of data broker / store.

Implementations of this interface are discouraged, unless you really need ability to veto data tree changes, or to provide external state change in sync with visibility of commited data.

Implementation requirements

Correctness assumptions

Implementation SHOULD use only provided DataTreeModification for validation purposes.

Use of any other external mutable state is discouraged, implementation MUST NOT use any transaction related APIs on same data broker / data store instance during invocation of callbacks, except ones provided as argument. Note that this MAY BE enforced by some implementations of DataBroker or Commit coordinator

Note that this may be enforced by some implementations of DataTreeCommitCohortRegistry and such calls may fail.

DataTreeCandidate assumptions

Implementation SHOULD NOT make any assumptions on DataTreeModification being successfully committed until associated PostCanCommitStep.preCommit() and PostPreCommitStep.commit() callback was invoked.

Usage patterns

Data Tree Validator

Validator is implementation, which only validates DataTreeModification and does not retain any state derived from edited data - does not care if DataTreeModification was rejected afterwards or transaction was cancelled.

Implementation may opt-out from receiving preCommit(), commit(), abort() callbacks by returning PostCanCommitStep.NOOP.

TODO: Provide example and describe more usage patterns

Author:

Tony Tkacik <ttkacik@cisco.com>

Method Summary

Modifier and Type	Method and Description
com.google.common.util.concurrent.CheckedFuture<PostCanCommitStep,DataValidationFailedException>	canCommit(Object txId, DataTreeModification<T> modification)

Method Detail

canCommit

com.google.common.util.concurrent.CheckedFuture<PostCanCommitStep,DataValidationFailedException> canCommit(Object txId,
                                                                                                           DataTreeModification<T> modification)