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     @Nonnull
  56     <K, V, KT extends K, N extends IdentifierNamespace<K, V>> V getFromNamespace(
  57             Class<N> type, KT key) throws NamespaceNotAvailableException;
  58
  59     <K, V, N extends IdentifierNamespace<K, V>> Map<K, V> getAllFromNamespace(
  60             Class<N> type);
  61
  62     <K, V, N extends IdentifierNamespace<K, V>> Map<K, V> getAllFromCurrentStmtCtxNamespace(Class<N> type);
  63
  64     @Nonnull
  65     StmtContext<?, ?, ?> getRoot();
  66
  67     @Nonnull
  68     Collection<StatementContextBase<?, ?, ?>> declaredSubstatements();
  69
  70     Collection<StatementContextBase<?, ?, ?>> effectiveSubstatements();
  71
  72     Collection<StatementContextBase<?, ?, ?>> substatements();
  73
  74     D buildDeclared();
  75
  76     E buildEffective();
  77
  78     boolean isSupportedToBuildEffective();
  79
  80     void setIsSupportedToBuildEffective(boolean isSupportedToBuild);
  81
  82     Collection<StatementContextBase<?, ?, ?>> getEffectOfStatement();
  83
  84     void addAsEffectOfStatement(StatementContextBase<?, ?, ?> ctx);
  85
  86     StatementContextBase<?, ?, ?> createCopy(
  87             StatementContextBase<?, ?, ?> newParent, TypeOfCopy typeOfCopy)
  88             throws SourceException;
  89
  90     StatementContextBase<?, ?, ?> createCopy(QNameModule newQNameModule,
  91             StatementContextBase<?, ?, ?> newParent, TypeOfCopy typeOfCopy)
  92             throws SourceException;
  93
  94     enum TypeOfCopy {
  95         ORIGINAL, ADDED_BY_USES, ADDED_BY_AUGMENTATION, ADDED_BY_USES_AUGMENTATION
  96     }
  97
  98     List<TypeOfCopy> getCopyHistory();
  99
 100     void addAllToCopyHistory(List<TypeOfCopy> typeOfCopyList);
 101
 102     void addToCopyHistory(TypeOfCopy typeOfCopy);
 103
 104     StatementContextBase<?, ?, ?> getOriginalCtx();
 105
 106     void setOriginalCtx(StatementContextBase<?, ?, ?> originalCtx);
 107
 108     boolean isRootContext();
 109
 110     void setOrder(int order);
 111
 112     int getOrder();
 113
 114     void setCompletedPhase(ModelProcessingPhase completedPhase);
 115
 116     ModelProcessingPhase getCompletedPhase();
 117
 118     interface Mutable<A, D extends DeclaredStatement<A>, E extends EffectiveStatement<A, D>>
 119             extends StmtContext<A, D, E> {
 120
 121         @Override
 122         StmtContext.Mutable<?, ?, ?> getParentContext();
 123
 124         <K, V, KT extends K, VT extends V, N extends IdentifierNamespace<K, V>> void addToNs(
 125                 Class<N> type, KT key, VT value)
 126                 throws NamespaceNotAvailableException;
 127
 128         @Override
 129         StmtContext.Mutable<?, ?, ?> getRoot();
 130
 131         ModelActionBuilder newInferenceAction(ModelProcessingPhase phase);
 132
 133         <K, KT extends K, N extends StatementNamespace<K, ?, ?>> void addContext(
 134                 Class<N> namespace, KT key, StmtContext<?, ?, ?> stmt);
 135
 136     }
 137
 138 }