org.opendaylight.yangtools.yang.parser.repo

Class YangTextSchemaContextResolver

java.lang.Object

org.opendaylight.yangtools.yang.parser.repo.YangTextSchemaContextResolver

All Implemented Interfaces:

AutoCloseable, SchemaSourceProvider<YangTextSchemaSource>

public final class YangTextSchemaContextResolver
extends Object
implements AutoCloseable, SchemaSourceProvider<YangTextSchemaSource>

Method Summary

Modifier and Type	Method and Description
void	close()
static YangTextSchemaContextResolver	create(String name)
Set<SourceIdentifier>	getAvailableSources() Return the set of sources currently available in this resolved.
com.google.common.base.Optional<SchemaContext>	getSchemaContext() Try to parse all currently available yang files and build new schema context.
com.google.common.base.Optional<SchemaContext>	getSchemaContext(StatementParserMode statementParserMode) Try to parse all currently available yang files and build new schema context in dependence on specified parsing mode.
com.google.common.util.concurrent.CheckedFuture<YangTextSchemaSource,SchemaSourceException>	getSource(SourceIdentifier sourceIdentifier) Returns a representation a for supplied YANG source identifier.
YangTextSchemaSourceRegistration	registerSource(URL url) Register a URL containing a YANG text.
YangTextSchemaSourceRegistration	registerSource(YangTextSchemaSource source) Register a YangTextSchemaSource.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static YangTextSchemaContextResolver create(String name)

registerSource

public YangTextSchemaSourceRegistration registerSource(@Nonnull
                                                       YangTextSchemaSource source)
                                                throws SchemaSourceException,
                                                       IOException,
                                                       YangSyntaxErrorException

Register a YangTextSchemaSource.

Parameters:

source - YANG text source

Returns:

a YangTextSchemaSourceRegistration

Throws:

YangSyntaxErrorException - When the YANG file is syntactically invalid

IOException - when the URL is not readable

SchemaSourceException - When parsing encounters general error

registerSource

public YangTextSchemaSourceRegistration registerSource(@Nonnull
                                                       URL url)
                                                throws SchemaSourceException,
                                                       IOException,
                                                       YangSyntaxErrorException

Register a URL containing a YANG text.

Parameters:

url - YANG text source URL

Returns:

a YangTextSchemaSourceRegistration for this URL

Throws:

YangSyntaxErrorException - When the YANG file is syntactically invalid

IOException - when the URL is not readable

SchemaSourceException - When parsing encounters general error

getSchemaContext

public com.google.common.base.Optional<SchemaContext> getSchemaContext()

Try to parse all currently available yang files and build new schema context.

Returns:

new schema context iif there is at least 1 yang file registered and new schema context was successfully built.

getSchemaContext

public com.google.common.base.Optional<SchemaContext> getSchemaContext(StatementParserMode statementParserMode)

Try to parse all currently available yang files and build new schema context in dependence on specified parsing mode.

Parameters:

statementParserMode - mode of statement parser

Returns:

new schema context iif there is at least 1 yang file registered and new schema context was successfully built.

getSource

public com.google.common.util.concurrent.CheckedFuture<YangTextSchemaSource,SchemaSourceException> getSource(SourceIdentifier sourceIdentifier)

Description copied from interface: SchemaSourceProvider

Returns a representation a for supplied YANG source identifier. The resolution criteria are as follows:

• If the source identifier specifies a revision, this method returns either a representation of that particular revision or throw MissingSchemaSourceException.
• If the source identifier does not specify a revision, this method returns the newest available revision, or throws MissingSchemaSourceException.

In either case the returned representation is required to report a non-null revision in the SourceIdentifier returned from SchemaSourceRepresentation.getIdentifier().

Implementations are not required to provide constant behavior in time, notably this different invocation of this method may produce different results.

Specified by:

getSource in interface SchemaSourceProvider<YangTextSchemaSource>

Parameters:

sourceIdentifier - source identifier

Returns:

source representation if supplied YANG module is available

getAvailableSources

public Set<SourceIdentifier> getAvailableSources()

Return the set of sources currently available in this resolved.

Returns:

An immutable point-in-time view of available sources.

close

public void close()

Specified by:

close in interface AutoCloseable