Migrate DocumentedNode/Status to JDT annotations
[yangtools.git] / yang / yang-parser-rfc7950 / src / main / java / org / opendaylight / yangtools / yang / parser / rfc7950 / stmt / AbstractEffectiveSimpleDataNodeContainer.java
1 /*
2  * Copyright (c) 2015 Cisco Systems, Inc. and others.  All rights reserved.
3  *
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
7  */
8 package org.opendaylight.yangtools.yang.parser.rfc7950.stmt;
9
10 import com.google.common.collect.ImmutableList;
11 import com.google.common.collect.ImmutableSet;
12 import java.util.ArrayList;
13 import java.util.LinkedHashSet;
14 import java.util.List;
15 import java.util.Optional;
16 import java.util.Set;
17 import javax.annotation.Nonnull;
18 import org.eclipse.jdt.annotation.NonNull;
19 import org.opendaylight.yangtools.yang.common.QName;
20 import org.opendaylight.yangtools.yang.model.api.AugmentationSchemaNode;
21 import org.opendaylight.yangtools.yang.model.api.AugmentationTarget;
22 import org.opendaylight.yangtools.yang.model.api.DataSchemaNode;
23 import org.opendaylight.yangtools.yang.model.api.RevisionAwareXPath;
24 import org.opendaylight.yangtools.yang.model.api.SchemaPath;
25 import org.opendaylight.yangtools.yang.model.api.UnknownSchemaNode;
26 import org.opendaylight.yangtools.yang.model.api.meta.DeclaredStatement;
27 import org.opendaylight.yangtools.yang.model.api.meta.EffectiveStatement;
28 import org.opendaylight.yangtools.yang.model.api.stmt.WhenEffectiveStatement;
29 import org.opendaylight.yangtools.yang.parser.spi.meta.CopyHistory;
30 import org.opendaylight.yangtools.yang.parser.spi.meta.CopyType;
31 import org.opendaylight.yangtools.yang.parser.spi.meta.StmtContext;
32
33 public abstract class AbstractEffectiveSimpleDataNodeContainer<D extends DeclaredStatement<QName>> extends
34         AbstractEffectiveDocumentedDataNodeContainer<QName, D> implements AugmentationTarget, DataSchemaNode {
35
36     private final Set<AugmentationSchemaNode> augmentations;
37     private final @NonNull List<UnknownSchemaNode> unknownNodes;
38     private final RevisionAwareXPath whenCondition;
39     private final SchemaPath path;
40     private final boolean configuration;
41     private final boolean addedByUses;
42
43     // FIXME: YANGTOOLS-724: this field should be final
44     private boolean augmenting;
45
46     protected AbstractEffectiveSimpleDataNodeContainer(final StmtContext<QName, D, ?> ctx) {
47         super(ctx);
48
49         this.path = ctx.getSchemaPath().get();
50         this.configuration = ctx.isConfiguration();
51
52         whenCondition = findFirstEffectiveSubstatementArgument(WhenEffectiveStatement.class).orElse(null);
53
54         // initSubstatementCollectionsAndFields
55
56         List<UnknownSchemaNode> unknownNodesInit = new ArrayList<>();
57         Set<AugmentationSchemaNode> augmentationsInit = new LinkedHashSet<>();
58         for (EffectiveStatement<?, ?> effectiveStatement : effectiveSubstatements()) {
59             if (effectiveStatement instanceof UnknownSchemaNode) {
60                 unknownNodesInit.add((UnknownSchemaNode) effectiveStatement);
61             }
62             if (effectiveStatement instanceof AugmentationSchemaNode) {
63                 augmentationsInit.add((AugmentationSchemaNode) effectiveStatement);
64             }
65         }
66         this.unknownNodes = ImmutableList.copyOf(unknownNodesInit);
67         this.augmentations = ImmutableSet.copyOf(augmentationsInit);
68
69         // initCopyType
70         final CopyHistory copyTypesFromOriginal = ctx.getCopyHistory();
71         if (copyTypesFromOriginal.contains(CopyType.ADDED_BY_USES_AUGMENTATION)) {
72             this.augmenting = true;
73             this.addedByUses = true;
74         } else {
75             this.augmenting = copyTypesFromOriginal.contains(CopyType.ADDED_BY_AUGMENTATION);
76             this.addedByUses = copyTypesFromOriginal.contains(CopyType.ADDED_BY_USES);
77         }
78     }
79
80     @Nonnull
81     @Override
82     public QName getQName() {
83         return path.getLastComponent();
84     }
85
86     @Nonnull
87     @Override
88     public SchemaPath getPath() {
89         return path;
90     }
91
92     @Deprecated
93     @Override
94     public boolean isAugmenting() {
95         return augmenting;
96     }
97
98     @Deprecated
99     @Override
100     public boolean isAddedByUses() {
101         return addedByUses;
102     }
103
104     @Override
105     public boolean isConfiguration() {
106         return configuration;
107     }
108
109     @Override
110     public Set<AugmentationSchemaNode> getAvailableAugmentations() {
111         return augmentations;
112     }
113
114     @Override
115     public List<UnknownSchemaNode> getUnknownSchemaNodes() {
116         return unknownNodes;
117     }
118
119     @Override
120     public final Optional<RevisionAwareXPath> getWhenCondition() {
121         return Optional.ofNullable(whenCondition);
122     }
123
124     /**
125      * Reset {@link #isAugmenting()} to false.
126      *
127      * @deprecated This method is a violation of immutable contract and is a side-effect of bad/incomplete lifecycle,
128      *             which needs to be fixed. Do not introduce new callers. This deficiency is tracked in YANGTOOLS-724.
129      */
130     @Deprecated
131     public final void resetAugmenting() {
132         augmenting = false;
133     }
134 }