org.opendaylight.controller.md.sal.binding.api

Interface DataObjectModification<T extends org.opendaylight.yangtools.yang.binding.DataObject>

All Superinterfaces:

org.opendaylight.yangtools.concepts.Identifiable<org.opendaylight.yangtools.yang.binding.InstanceIdentifier.PathArgument>

public interface DataObjectModification<T extends org.opendaylight.yangtools.yang.binding.DataObject>
extends org.opendaylight.yangtools.concepts.Identifiable<org.opendaylight.yangtools.yang.binding.InstanceIdentifier.PathArgument>

Represents a modification of DataObject.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	DataObjectModification.ModificationType

Method Summary

Modifier and Type	Method and Description
T	getDataAfter() Returns after-state of top level container.
T	getDataBefore() Returns before-state of top level container.
Class<T>	getDataType() Returns type of modified object.
org.opendaylight.yangtools.yang.binding.InstanceIdentifier.PathArgument	getIdentifier()
DataObjectModification.ModificationType	getModificationType() Returns type of modification.
<C extends org.opendaylight.yangtools.yang.binding.Augmentation<T> & org.opendaylight.yangtools.yang.binding.DataObject> DataObjectModification<C>	getModifiedAugmentation(Class<C> augmentation) Returns augmentation child modification if augmentation was modified by this modification.
DataObjectModification<? extends org.opendaylight.yangtools.yang.binding.DataObject>	getModifiedChild(org.opendaylight.yangtools.yang.binding.InstanceIdentifier.PathArgument childArgument) Returns a child modification if a node identified by childArgument was modified by this modification.
<C extends org.opendaylight.yangtools.yang.binding.ChildOf<? super T>> DataObjectModification<C>	getModifiedChildContainer(Class<C> child) Returns container child modification if child was modified by this modification.
default <H extends org.opendaylight.yangtools.yang.binding.ChoiceIn<? super T> & org.opendaylight.yangtools.yang.binding.DataObject,C extends org.opendaylight.yangtools.yang.binding.ChildOf<? super H>> DataObjectModification<C>	getModifiedChildContainer(Class<H> caseType, Class<C> child) Returns container child modification if child was modified by this modification.
default <H extends org.opendaylight.yangtools.yang.binding.ChoiceIn<? super T> & org.opendaylight.yangtools.yang.binding.DataObject,C extends org.opendaylight.yangtools.yang.binding.Identifiable<K> & org.opendaylight.yangtools.yang.binding.ChildOf<? super H>,K extends org.opendaylight.yangtools.yang.binding.Identifier<C>> DataObjectModification<C>	getModifiedChildListItem(Class<H> caseType, Class<C> listItem, K listKey) Returns child list item modification if child was modified by this modification.
<N extends org.opendaylight.yangtools.yang.binding.Identifiable<K> & org.opendaylight.yangtools.yang.binding.ChildOf<? super T>,K extends org.opendaylight.yangtools.yang.binding.Identifier<N>> DataObjectModification<N>	getModifiedChildListItem(Class<N> listItem, K listKey) Returns child list item modification if child was modified by this modification.
Collection<? extends DataObjectModification<? extends org.opendaylight.yangtools.yang.binding.DataObject>>	getModifiedChildren() Returns unmodifiable collection of modified direct children.
default <H extends org.opendaylight.yangtools.yang.binding.ChoiceIn<? super T> & org.opendaylight.yangtools.yang.binding.DataObject,C extends org.opendaylight.yangtools.yang.binding.ChildOf<? super H>> Collection<DataObjectModification<C>>	getModifiedChildren(Class<H> caseType, Class<C> childType) Returns child list item modification if child was modified by this modification.

Method Detail

getIdentifier

org.opendaylight.yangtools.yang.binding.InstanceIdentifier.PathArgument getIdentifier()

Specified by:

getIdentifier in interface org.opendaylight.yangtools.concepts.Identifiable<org.opendaylight.yangtools.yang.binding.InstanceIdentifier.PathArgument>

getDataType

@Nonnull
Class<T> getDataType()

Returns type of modified object.

Returns:

type of modified object.

getModificationType

@Nonnull
DataObjectModification.ModificationType getModificationType()

Returns type of modification.

Returns:

type Type of performed modification.

getDataBefore

@Nullable
T getDataBefore()

Returns before-state of top level container. Implementations are encouraged, but not required to provide this state.

Returns:

State of object before modification. Null if subtree was not present, or the implementation cannot provide the state.

getDataAfter

@Nullable
T getDataAfter()

Returns after-state of top level container.

Returns:

State of object after modification. Null if subtree is not present.

getModifiedChildren

@Nonnull
Collection<? extends DataObjectModification<? extends org.opendaylight.yangtools.yang.binding.DataObject>> getModifiedChildren()

Returns unmodifiable collection of modified direct children.

Returns:

unmodifiable collection of modified direct children.

getModifiedChildren

default <H extends org.opendaylight.yangtools.yang.binding.ChoiceIn<? super T> & org.opendaylight.yangtools.yang.binding.DataObject,C extends org.opendaylight.yangtools.yang.binding.ChildOf<? super H>> Collection<DataObjectModification<C>> getModifiedChildren(@Nonnull
                                                                                                                                                                                                                                                                    Class<H> caseType,
                                                                                                                                                                                                                                                                    @Nonnull
                                                                                                                                                                                                                                                                    Class<C> childType)

Returns child list item modification if child was modified by this modification. This method should be used if the child is defined in a grouping brought into a case inside this object.

Parameters:

caseType - Case type class

childType - Type of list item - must be list item with key

Returns:

Modification of child if child was modified, null otherwise.

Throws:

IllegalArgumentException - If supplied childType class is not valid child according to generated model.

getModifiedChildContainer

@Nullable
default <H extends org.opendaylight.yangtools.yang.binding.ChoiceIn<? super T> & org.opendaylight.yangtools.yang.binding.DataObject,C extends org.opendaylight.yangtools.yang.binding.ChildOf<? super H>> DataObjectModification<C> getModifiedChildContainer(@Nonnull
                                                                                                                                                                                                                                                                        Class<H> caseType,
                                                                                                                                                                                                                                                                        @Nonnull
                                                                                                                                                                                                                                                                        Class<C> child)

Returns container child modification if child was modified by this modification. This method should be used if the child is defined in a grouping brought into a case inside this object.

For accessing all modified list items consider iterating over getModifiedChildren().

Parameters:

caseType - Case type class

child - Type of child - must be only container

Returns:

Modification of child if child was modified, null otherwise.

Throws:

IllegalArgumentException - If supplied child class is not valid child according to generated model.

getModifiedChildContainer

@Nullable
<C extends org.opendaylight.yangtools.yang.binding.ChildOf<? super T>> DataObjectModification<C> getModifiedChildContainer(@Nonnull
                                                                                                                                     Class<C> child)

Returns container child modification if child was modified by this modification.

For accessing all modified list items consider iterating over getModifiedChildren().

Parameters:

child - Type of child - must be only container

Returns:

Modification of child if child was modified, null otherwise.

Throws:

IllegalArgumentException - If supplied child class is not valid child according to generated model.

getModifiedAugmentation

@Nullable
<C extends org.opendaylight.yangtools.yang.binding.Augmentation<T> & org.opendaylight.yangtools.yang.binding.DataObject> DataObjectModification<C> getModifiedAugmentation(@Nonnull
                                                                                                                                                                                     Class<C> augmentation)

Returns augmentation child modification if augmentation was modified by this modification.

For accessing all modified list items consider iterating over getModifiedChildren().

Parameters:

augmentation - Type of augmentation - must be only container

Returns:

Modification of augmentation if augmentation was modified, null otherwise.

Throws:

IllegalArgumentException - If supplied augmentation class is not valid augmentation according to generated model.

getModifiedChildListItem

<N extends org.opendaylight.yangtools.yang.binding.Identifiable<K> & org.opendaylight.yangtools.yang.binding.ChildOf<? super T>,K extends org.opendaylight.yangtools.yang.binding.Identifier<N>> DataObjectModification<N> getModifiedChildListItem(@Nonnull
                                                                                                                                                                                                                                                    Class<N> listItem,
                                                                                                                                                                                                                                                    @Nonnull
                                                                                                                                                                                                                                                    K listKey)

Returns child list item modification if child was modified by this modification.

Parameters:

listItem - Type of list item - must be list item with key

listKey - List item key

Returns:

Modification of child if child was modified, null otherwise.

Throws:

IllegalArgumentException - If supplied listItem class is not valid child according to generated model.

getModifiedChildListItem

default <H extends org.opendaylight.yangtools.yang.binding.ChoiceIn<? super T> & org.opendaylight.yangtools.yang.binding.DataObject,C extends org.opendaylight.yangtools.yang.binding.Identifiable<K> & org.opendaylight.yangtools.yang.binding.ChildOf<? super H>,K extends org.opendaylight.yangtools.yang.binding.Identifier<C>> DataObjectModification<C> getModifiedChildListItem(@Nonnull
                                                                                                                                                                                                                                                                                                                                                                                       Class<H> caseType,
                                                                                                                                                                                                                                                                                                                                                                                       @Nonnull
                                                                                                                                                                                                                                                                                                                                                                                       Class<C> listItem,
                                                                                                                                                                                                                                                                                                                                                                                       @Nonnull
                                                                                                                                                                                                                                                                                                                                                                                       K listKey)

Returns child list item modification if child was modified by this modification.

Parameters:

caseType - Case type class

listItem - Type of list item - must be list item with key

listKey - List item key

Returns:

Modification of child if child was modified, null otherwise.

Throws:

IllegalArgumentException - If supplied listItem class is not valid child according to generated model.

getModifiedChild

@Nullable
DataObjectModification<? extends org.opendaylight.yangtools.yang.binding.DataObject> getModifiedChild(org.opendaylight.yangtools.yang.binding.InstanceIdentifier.PathArgument childArgument)

Returns a child modification if a node identified by childArgument was modified by this modification.

Parameters:

childArgument - Path Argument of child node

Returns:

Modification of child identified by childArgument if childArgument was modified, null otherwise.

Throws:

IllegalArgumentException - If supplied path argument is not valid child according to generated model.