Package org.opendaylight.yangtools.yang.parser.repo

Class YangTextSchemaContextResolver

java.lang.Object

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

All Implemented Interfaces:

AutoCloseable, SchemaSourceProvider<YangTextSource>

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

Method Summary

Modifier and Type	Method	Description
void	close()
static @NonNull YangTextSchemaContextResolver	create(String name)
static @NonNull YangTextSchemaContextResolver	create(String name, YangParserFactory factory)
Set<SourceIdentifier>	getAvailableSources()	Return the set of sources currently available in this resolved.
Optional<? extends EffectiveModelContext>	getEffectiveModelContext()	Try to parse all currently available yang files and build new schema context.
Optional<? extends EffectiveModelContext>	getEffectiveModelContext(StatementParserMode statementParserMode)	Try to parse all currently available yang files and build new schema context depending on specified parsing mode.
@NonNull FluentFuture<YangTextSource>	getSource(SourceIdentifier sourceIdentifier)	Returns a representation a for supplied YANG source identifier.
Collection<YangTextSource>	getSourceTexts(SourceIdentifier sourceIdentifier)
@NonNull Registration	registerSource(@NonNull URL url)	Register a URL containing a YANG text.
@NonNull Registration	registerSource(@NonNull YangTextSource source)	Register a YangTextSource.
@NonNull Registration	registerSupportedFeatures(QNameModule module, Set<String> features)	Register a QNameModule as a known module namespace with a set of supported features.
EffectiveModelContext	trySchemaContext()
EffectiveModelContext	trySchemaContext(StatementParserMode statementParserMode)

Methods inherited from class java.lang.Object

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

Method Details

create

public static @NonNull YangTextSchemaContextResolver create(String name)

create

public static @NonNull YangTextSchemaContextResolver create(String name,
 YangParserFactory factory)

registerSource

public @NonNull Registration registerSource(@NonNull YangTextSource source)
                                     throws SchemaSourceException,
IOException,
YangSyntaxErrorException

Register a YangTextSource.

Parameters:

source - YANG text source

Returns:

a Registration

Throws:

YangSyntaxErrorException - When the YANG file is syntactically invalid

IOException - when the URL is not readable

SchemaSourceException - When parsing encounters general error

NullPointerException - if source is null

registerSource

public @NonNull Registration 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

NullPointerException - if url is null

registerSupportedFeatures

public @NonNull Registration registerSupportedFeatures(QNameModule module,
 Set<String> features)

Register a QNameModule as a known module namespace with a set of supported features. Union of these registrations is forwarded to FeatureSet and this is then used in getEffectiveModelContext() and related methods.

Parameters:

module - Module namespace

features - Features supported for that module namespace

Returns:

a Registration, use Registration.close() to revert the effects of this method

Throws:

NullPointerException - if any argument is null

getEffectiveModelContext

public Optional<? extends EffectiveModelContext> getEffectiveModelContext()

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.

getEffectiveModelContext

public Optional<? extends EffectiveModelContext> getEffectiveModelContext(StatementParserMode statementParserMode)

Try to parse all currently available yang files and build new schema context depending 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 @NonNull FluentFuture<YangTextSource> 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 SourceRepresentation.sourceId().

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<YangTextSource>

Parameters:

sourceIdentifier - source identifier

Returns:

future 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.

getSourceTexts

@Beta
public Collection<YangTextSource> getSourceTexts(SourceIdentifier sourceIdentifier)

trySchemaContext

@Beta
public EffectiveModelContext trySchemaContext()
                                       throws SchemaResolutionException,
ExecutionException

Throws:

SchemaResolutionException

ExecutionException

trySchemaContext

@Beta
public EffectiveModelContext trySchemaContext(StatementParserMode statementParserMode)
                                       throws SchemaResolutionException,
ExecutionException

Throws:

SchemaResolutionException

ExecutionException

close

public void close()

Specified by:

close in interface AutoCloseable