yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/spi/source/StatementWriter.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.source;
   9
  10 import javax.annotation.Nonnull;
  11 import javax.annotation.Nullable;
  12 import org.opendaylight.yangtools.yang.common.QName;
  13 import org.opendaylight.yangtools.yang.parser.spi.meta.ModelProcessingPhase;
  14
  15 public interface StatementWriter {
  16
  17     /**
  18      *
  19      * Starts statement with supplied name and location in source.
  20      *
  21      *
  22      * <p>
  23      * Each started statement must also be closed by
  24      * {@link #endStatement(StatementSourceReference)} in order for stream to be
  25      * correct.
  26      * </p>
  27      * <p>
  28      * If statement has substatements, in order to start substatement, call to
  29      * {@link #startStatement(QName, String, StatementSourceReference)} needs to be done
  30      * for substatement.
  31      *
  32      * @param name
  33      *            Fully qualified name of statement.
  34      * @param argument
  35      *            String representation of value as appeared in source, null if not present
  36      * @param ref
  37      *            Identifier of location in source, which will be used for
  38      *            reporting in case of statement processing error.
  39      * @throws SourceException
  40      *             if statement is not valid according to current context.
  41      */
  42     void startStatement(@Nonnull QName name, @Nullable String argument, @Nonnull StatementSourceReference ref);
  43
  44     /**
  45      * Ends current opened statement.
  46      *
  47      * @param ref
  48      *            Identifier of location in source, which will be used for
  49      *            reporting in case of statement processing error.
  50      * @throws SourceException
  51      *             if closed statement is not valid in current context, or there
  52      *             is no such statement
  53      */
  54     void endStatement(@Nonnull StatementSourceReference ref) throws SourceException;
  55
  56     /**
  57      *
  58      * @return current processing phase
  59      */
  60     @Nonnull ModelProcessingPhase getPhase();
  61 }