IContextService¶

public interface IContextService¶: Interface for retrieving or creating IContext instances.

Methods¶

available¶

boolean available(ILanguageImpl language)¶

Checks if contexts are available for given language implementation.

Parameters:	language – Language implementation to check.
Returns:	True if contexts are available, false if not.

get¶

IContext get(FileObject resource, IProject project, ILanguageImpl language)¶

Retrieves or creates a context for given resource and language.

Parameters:	resource – Resource to get a context for. project – The project the resource belongs to. language – Language to get a context for.
Throws:	MetaborgRuntimeException – When `language` has multiple `ContextFacet`. ContextException – When an error occurs while retrieving or creating a context.
Returns:	Existing or created context.

getTemporary¶

ITemporaryContext getTemporary(FileObject resource, IProject project, ILanguageImpl language)¶

Creates a temporary context for given resource and language. Temporary contexts are not thread-safe, and must be closed after usage. Supports the try-with-resources statement for closing the temporary context.

Parameters:	resource – Resource to get a context for. project – The project the resource belongs to. language – Language to get a context for.
Throws:	MetaborgRuntimeException – When `language` has multiple `ContextFacet`. ContextException – When an error occurs while retrieving or creating a context.
Returns:	Temporary context.

unload¶

void unload(IContext context)¶

Unloads given context, persisting it to disk (if supported by the context) and removing it from memory.

Parameters:	context – Context to unload.