yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/spi/meta/StmtContext.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.spi.meta;
   9
  10 import com.google.common.base.Optional;
  11 import java.util.Collection;
  12 import java.util.List;
  13 import java.util.Map;
  14 import javax.annotation.Nonnull;
  15 import javax.annotation.Nullable;
  16 import org.opendaylight.yangtools.yang.common.QNameModule;
  17 import org.opendaylight.yangtools.yang.model.api.SchemaPath;
  18 import org.opendaylight.yangtools.yang.model.api.meta.DeclaredStatement;
  19 import org.opendaylight.yangtools.yang.model.api.meta.EffectiveStatement;
  20 import org.opendaylight.yangtools.yang.model.api.meta.IdentifierNamespace;
  21 import org.opendaylight.yangtools.yang.model.api.meta.StatementDefinition;
  22 import org.opendaylight.yangtools.yang.model.api.meta.StatementSource;
  23 import org.opendaylight.yangtools.yang.parser.spi.source.SourceException;
  24 import org.opendaylight.yangtools.yang.parser.spi.source.StatementSourceReference;
  25 import org.opendaylight.yangtools.yang.parser.stmt.reactor.StatementContextBase;
  26
  27 public interface StmtContext<A, D extends DeclaredStatement<A>, E extends EffectiveStatement<A, D>> {
  28
  29     @Nonnull
  30     StatementSource getStatementSource();
  31
  32     @Nonnull
  33     StatementSourceReference getStatementSourceReference();
  34
  35     @Nonnull
  36     StatementDefinition getPublicDefinition();
  37
  38     @Nullable
  39     StmtContext<?, ?, ?> getParentContext();
  40
  41     @Nullable
  42     String rawStatementArgument();
  43
  44     @Nullable
  45     A getStatementArgument();
  46
  47     /**
  48      * Return the {@link SchemaPath} of this statement. Not all statements have a SchemaPath, in which case
  49      * {@link Optional#absent()} is returned.
  50      *
  51      * @return Optional SchemaPath
  52      */
  53     @Nonnull Optional<SchemaPath> getSchemaPath();
  54
  55     boolean isConfiguration();
  56
  57     @Nonnull
  58     <K, V, KT extends K, N extends IdentifierNamespace<K, V>> V getFromNamespace(
  59             Class<N> type, KT key) throws NamespaceNotAvailableException;
  60
  61     <K, V, N extends IdentifierNamespace<K, V>> Map<K, V> getAllFromNamespace(
  62             Class<N> type);
  63
  64     <K, V, N extends IdentifierNamespace<K, V>> Map<K, V> getAllFromCurrentStmtCtxNamespace(Class<N> type);
  65
  66     @Nonnull
  67     StmtContext<?, ?, ?> getRoot();
  68
  69     @Nonnull
  70     Collection<StatementContextBase<?, ?, ?>> declaredSubstatements();
  71
  72     Collection<StatementContextBase<?, ?, ?>> effectiveSubstatements();
  73
  74     Collection<StatementContextBase<?, ?, ?>> substatements();
  75
  76     D buildDeclared();
  77
  78     E buildEffective();
  79
  80     boolean isSupportedToBuildEffective();
  81
  82     void setIsSupportedToBuildEffective(boolean isSupportedToBuild);
  83
  84     Collection<StatementContextBase<?, ?, ?>> getEffectOfStatement();
  85
  86     void addAsEffectOfStatement(StatementContextBase<?, ?, ?> ctx);
  87
  88     StatementContextBase<?, ?, ?> createCopy(
  89             StatementContextBase<?, ?, ?> newParent, TypeOfCopy typeOfCopy)
  90             throws SourceException;
  91
  92     StatementContextBase<?, ?, ?> createCopy(QNameModule newQNameModule,
  93             StatementContextBase<?, ?, ?> newParent, TypeOfCopy typeOfCopy)
  94             throws SourceException;
  95
  96     enum TypeOfCopy {
  97         ORIGINAL, ADDED_BY_USES, ADDED_BY_AUGMENTATION, ADDED_BY_USES_AUGMENTATION
  98     }
  99
 100     List<TypeOfCopy> getCopyHistory();
 101
 102     void addAllToCopyHistory(List<TypeOfCopy> typeOfCopyList);
 103
 104     void addToCopyHistory(TypeOfCopy typeOfCopy);
 105
 106     StatementContextBase<?, ?, ?> getOriginalCtx();
 107
 108     void setOriginalCtx(StatementContextBase<?, ?, ?> originalCtx);
 109
 110     boolean isRootContext();
 111
 112     void setOrder(int order);
 113
 114     int getOrder();
 115
 116     void setCompletedPhase(ModelProcessingPhase completedPhase);
 117
 118     ModelProcessingPhase getCompletedPhase();
 119
 120     interface Mutable<A, D extends DeclaredStatement<A>, E extends EffectiveStatement<A, D>>
 121             extends StmtContext<A, D, E> {
 122
 123         @Override
 124         StmtContext.Mutable<?, ?, ?> getParentContext();
 125
 126         <K, V, KT extends K, VT extends V, N extends IdentifierNamespace<K, V>> void addToNs(
 127                 Class<N> type, KT key, VT value)
 128                 throws NamespaceNotAvailableException;
 129
 130         @Override
 131         StmtContext.Mutable<?, ?, ?> getRoot();
 132
 133         ModelActionBuilder newInferenceAction(ModelProcessingPhase phase);
 134
 135         <K, KT extends K, N extends StatementNamespace<K, ?, ?>> void addContext(
 136                 Class<N> namespace, KT key, StmtContext<?, ?, ?> stmt);
 137
 138     }
 139
 140 }