org.opendaylight.yangtools.yang.model.parser.api

Interface YangParser

@Beta
 @NotThreadSafe
public interface YangParser

Configurable single-use YANG parser. Each instance can be configured to use a different set of models after which it is built. Models once added cannot be removed.

Author:

Robert Varga

Method Summary

Modifier and Type	Method and Description
YangParser	addLibSource(SchemaSourceRepresentation source)
default YangParser	addLibSources(Collection<SchemaSourceRepresentation> sources)
default YangParser	addLibSources(SchemaSourceRepresentation... sources) Add library sources.
YangParser	addSource(SchemaSourceRepresentation source) Add main source.
default YangParser	addSources(Collection<? extends SchemaSourceRepresentation> sources)
default YangParser	addSources(SchemaSourceRepresentation... sources) Add main sources.
List<DeclaredStatement<?>>	buildDeclaredModel() Build the declared view of a combined view of declared statements.
default Map<QNameModule,ModuleEffectiveStatement>	buildEffectiveModel() Build the effective view of a combined view of effective statements.
SchemaContext	buildSchemaContext() Build effective SchemaContext.
YangParser	setModulesWithSupportedDeviations(@NonNull com.google.common.collect.SetMultimap<QNameModule,QNameModule> modulesDeviatedByModules) Set YANG modules which can be deviated by specified modules during the parsing process.
YangParser	setSupportedFeatures(@NonNull Set<QName> supportedFeatures) Set supported features based on which all if-feature statements in the parsed YANG modules will be resolved.
Collection<Class<? extends SchemaSourceRepresentation>>	supportedSourceRepresentations() Return enumeration of concrete types of SchemaSourceRepresentation parsers created from this factory support.
Set<QName>	supportedStatements() Return the set of all YANG statements semantically supported by this parser instance.

Method Detail

supportedSourceRepresentations

Collection<Class<? extends SchemaSourceRepresentation>> supportedSourceRepresentations()

Return enumeration of concrete types of SchemaSourceRepresentation parsers created from this factory support. Users can use this information prepare the source they have to a representation which will be accepted by this parser.

Returns:

Enumeration of supported schema source representations.

supportedStatements

Set<QName> supportedStatements()

Return the set of all YANG statements semantically supported by this parser instance.

Returns:

Set of all YANG statements semantically supported by this parser instance.

addSource

YangParser addSource(SchemaSourceRepresentation source)
              throws IOException,
                     YangSyntaxErrorException

Add main source. All main sources are present in resulting SchemaContext.

Parameters:

source - which should be added into main sources

Throws:

YangSyntaxErrorException - when one of the sources fails syntactic analysis

IOException - when an IO error occurs

IllegalArgumentException - if the representation is not supported

addSources

default YangParser addSources(SchemaSourceRepresentation... sources)
                       throws IOException,
                              YangSyntaxErrorException

Add main sources. All main sources are present in resulting SchemaContext.

Parameters:

sources - which should be added into main sources

Throws:

YangSyntaxErrorException - when one of the sources fails syntactic analysis

IOException - when an IO error occurs

IllegalArgumentException - if the representation is not supported

addSources

default YangParser addSources(Collection<? extends SchemaSourceRepresentation> sources)
                       throws IOException,
                              YangSyntaxErrorException

Throws:

IOException

YangSyntaxErrorException

addLibSource

YangParser addLibSource(SchemaSourceRepresentation source)
                 throws IOException,
                        YangSyntaxErrorException

Throws:

IOException

YangSyntaxErrorException

addLibSources

default YangParser addLibSources(SchemaSourceRepresentation... sources)
                          throws IOException,
                                 YangSyntaxErrorException

Add library sources. Only library sources required by main sources are present in resulting SchemaContext. Any other library sources are ignored and this also applies to error reporting.

Note: Library sources are not supported in semantic version mode currently.

Parameters:

sources - YANG sources which should be added into library sources

Throws:

YangSyntaxErrorException - when one of the sources fails syntactic analysis

IOException - when an IO error occurs

IllegalArgumentException - if the representation is not supported

addLibSources

default YangParser addLibSources(Collection<SchemaSourceRepresentation> sources)
                          throws IOException,
                                 YangSyntaxErrorException

Throws:

IOException

YangSyntaxErrorException

setSupportedFeatures

YangParser setSupportedFeatures(@NonNull Set<QName> supportedFeatures)

Set supported features based on which all if-feature statements in the parsed YANG modules will be resolved. If this method is not invoked, all features will be supported.

Parameters:

supportedFeatures - Set of supported features in the final SchemaContext. If the set is empty, no features encountered will be supported.

setModulesWithSupportedDeviations

YangParser setModulesWithSupportedDeviations(@NonNull com.google.common.collect.SetMultimap<QNameModule,QNameModule> modulesDeviatedByModules)

Set YANG modules which can be deviated by specified modules during the parsing process. Map key (QNameModule) denotes a module which can be deviated by the modules in the Map value.

Parameters:

modulesDeviatedByModules - Map of YANG modules (Map key) which can be deviated by specified modules (Map value) in the final SchemaContext. If the map is empty, no deviations encountered will be supported.

buildDeclaredModel

List<DeclaredStatement<?>> buildDeclaredModel()
                                       throws YangParserException

Build the declared view of a combined view of declared statements.

Returns:

Ordered collection of declared statements from requested sources.

Throws:

YangSyntaxErrorException - When a syntactic error is encountered.

YangParserException

buildEffectiveModel

default Map<QNameModule,ModuleEffectiveStatement> buildEffectiveModel()
                                                               throws YangParserException

Build the effective view of a combined view of effective statements. Note that this representation, unlike buildDeclaredModel() does not expose submodules as top-level contracts. These are available from their respective parent modules.

Returns:

Effective module statements indexed by their QNameModule.

Throws:

YangSyntaxErrorException - When a syntactic error is encountered.

YangParserException

buildSchemaContext

SchemaContext buildSchemaContext()
                          throws YangParserException

Build effective SchemaContext.

Returns:

An effective schema context comprised of configured models.

Throws:

YangSyntaxErrorException - When a syntactic error is encountered.

YangParserException