2 * Copyright (c) 2015 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
9 package org.opendaylight.mdsal.binding.api;
11 import java.util.Collection;
12 import javax.annotation.Nonnull;
13 import javax.annotation.Nullable;
14 import org.opendaylight.yangtools.yang.binding.Augmentation;
15 import org.opendaylight.yangtools.yang.binding.ChildOf;
16 import org.opendaylight.yangtools.yang.binding.DataObject;
17 import org.opendaylight.yangtools.yang.binding.Identifiable;
18 import org.opendaylight.yangtools.yang.binding.Identifier;
19 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier.PathArgument;
22 * Modified Data Object.
24 * Represents modification of Data Object
26 * @param <T> Type of modified object
29 public interface DataObjectModification<T extends DataObject> extends org.opendaylight.yangtools.concepts.Identifiable<PathArgument> {
32 * Represents type of modification which has occured.
35 enum ModificationType {
38 * Child node (direct or indirect) was modified.
44 * Node was explicitly created / overwritten.
57 PathArgument getIdentifier();
60 * Returns type of modified object.
62 * @return type of modified object.
64 @Nonnull Class<T> getDataType();
68 * Returns type of modification
70 * @return type Type of performed modification.
72 @Nonnull ModificationType getModificationType();
75 * Returns before-state of top level container. Implementations are encouraged, but not required
76 * to provide this state.
79 * @return State of object before modification. Null if subtree was not present, or the
80 * implementation cannot provide the state.
82 @Nullable T getDataBefore();
85 * Returns after-state of top level container.
87 * @return State of object after modification. Null if subtree is not present.
89 @Nullable T getDataAfter();
92 * Returns unmodifiable collection of modified direct children.
94 * @return unmodifiable collection of modified direct children.
96 @Nonnull Collection<DataObjectModification<? extends DataObject>> getModifiedChildren();
99 * Returns child list item modification if {@code child} was modified by this modification.
101 * @param childType Type of list item - must be list item with key
102 * @return Modification of {@code child} if {@code child} was modified, null otherwise.
103 * @throws IllegalArgumentException If supplied {@code childType} class is not valid child according
104 * to generated model.
106 <C extends ChildOf<? super T>> Collection<DataObjectModification<C>> getModifiedChildren(@Nonnull Class<C> childType);
109 * Returns container child modification if {@code child} was modified by this
112 * For accessing all modified list items consider iterating over {@link #getModifiedChildren()}.
114 * @param child Type of child - must be only container
115 * @return Modification of {@code child} if {@code child} was modified, null otherwise.
116 * @throws IllegalArgumentException If supplied {@code child} class is not valid child according
117 * to generated model.
119 @Nullable <C extends ChildOf<? super T>> DataObjectModification<C> getModifiedChildContainer(@Nonnull Class<C> child);
122 * Returns augmentation child modification if {@code augmentation} was modified by this
125 * For accessing all modified list items consider iterating over {@link #getModifiedChildren()}.
127 * @param augmentation Type of augmentation - must be only container
128 * @return Modification of {@code augmentation} if {@code augmentation} was modified, null otherwise.
129 * @throws IllegalArgumentException If supplied {@code augmentation} class is not valid augmentation
130 * according to generated model.
132 @Nullable <C extends Augmentation<T> & DataObject> DataObjectModification<C> getModifiedAugmentation(@Nonnull Class<C> augmentation);
136 * Returns child list item modification if {@code child} was modified by this modification.
138 * @param listItem Type of list item - must be list item with key
139 * @param listKey List item key
140 * @return Modification of {@code child} if {@code child} was modified, null otherwise.
141 * @throws IllegalArgumentException If supplied {@code listItem} class is not valid child according
142 * to generated model.
144 <C extends Identifiable<K> & ChildOf<? super T>, K extends Identifier<C>> DataObjectModification<C> getModifiedChildListItem(
145 @Nonnull Class<C> listItem,@Nonnull K listKey);
148 * Returns a child modification if a node identified by {@code childArgument} was modified by
151 * @param childArgument Path Argument of child node
152 * @return Modification of child identified by {@code childArgument} if {@code childArgument}
153 * was modified, null otherwise.
154 * @throws IllegalArgumentException If supplied path argument is not valid child according to
158 @Nullable DataObjectModification<? extends DataObject> getModifiedChild(PathArgument childArgument);