de.uni_hildesheim.sse

Class BuildLangModelUtility

java.lang.Object

net.ssehub.easy.dslCore.ModelUtility<de.uni_hildesheim.sse.vilBuildLanguage.ImplementationUnit,Script>

de.uni_hildesheim.sse.BuildLangModelUtility

All Implemented Interfaces:

IModelLoader<Script>

public class BuildLangModelUtility
extends ModelUtility<de.uni_hildesheim.sse.vilBuildLanguage.ImplementationUnit,Script>
implements IModelLoader<Script>

Provides language-wide functionality.

Author:

Holger Eichelberger

Nested Class Summary

Nested classes/interfaces inherited from interface net.ssehub.easy.basics.modelManagement.IModelLoader

IModelLoader.IModelInfoHolder<M extends IModel>, IModelLoader.LoadResult<M extends IModel>

Field Summary

Fields

Modifier and Type	Field and Description
static BuildLangModelUtility	INSTANCE

Constructor Summary

Constructors

Modifier	Constructor and Description
private	BuildLangModelUtility() Prevents external creation.

Method Summary

Modifier and Type	Method and Description
TranslationResult<Script>	createBuildModel(de.uni_hildesheim.sse.vilBuildLanguage.ImplementationUnit root, java.net.URI uri, boolean registerSuccessful) Create the build language model from an EMF implementation unit.
Expression	createExpression(java.lang.String text, IRuntimeEnvironment environment)
Expression	createExpression(java.lang.String text, Resolver resolver, java.lang.StringBuilder warnings) Parses text into an expression.
java.lang.String	getExtension() Returns the file extension / identifier to react on.
protected java.lang.ClassLoader	getLanguageClassLoader() Returns the actual class loader of the language.
protected java.lang.String	getLanguageName() Returns the language name as specified in the xText configuration.
protected void	initializeAfterResourceInitializer() Initializes instances which depend on ModelUtility.resourceInitializer.
java.util.List<ModelInfo<Script>>	obtainInfo(org.eclipse.emf.common.util.URI uri) Obtains model information.
TranslationResult<Script>	parse(org.eclipse.emf.common.util.URI uri, ImportResolver<Script> resolver) Parse an IVML model file for standalone application (without editor) with a given import resolver.
void	print(TranslationResult<Script> result, java.io.Writer out, boolean emitComments, boolean emitImports) Prints the model stored in the result to the console output stream (for debugging / testing).

Methods inherited from class net.ssehub.easy.dslCore.ModelUtility

append, appendWithNewLine, getGrammar, getInjector, getResourceInitializer, getResourceSet, handles, load, obtainInfo, parse, parse, parse, parseFragment, scan, setInjector, setResourceInitializer, toNetUri

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.ssehub.easy.basics.modelManagement.IModelLoader

load, scan

Field Detail

INSTANCE

public static final BuildLangModelUtility INSTANCE

Constructor Detail

BuildLangModelUtility

private BuildLangModelUtility()

Prevents external creation.

Method Detail

createBuildModel

public TranslationResult<Script> createBuildModel(de.uni_hildesheim.sse.vilBuildLanguage.ImplementationUnit root,
                                                  java.net.URI uri,
                                                  boolean registerSuccessful)

Create the build language model from an EMF implementation unit.

Parameters:

root - the root-level build unit

uri - the URI of the project to resolve (in order to find the closest project, may be null)

registerSuccessful - successfully created models shall be registered

Returns:

the created variability model including messages

initializeAfterResourceInitializer

protected void initializeAfterResourceInitializer()

Initializes instances which depend on ModelUtility.resourceInitializer.

Specified by:

initializeAfterResourceInitializer in class ModelUtility<de.uni_hildesheim.sse.vilBuildLanguage.ImplementationUnit,Script>

parse

public TranslationResult<Script> parse(org.eclipse.emf.common.util.URI uri,
                                       ImportResolver<Script> resolver)
                                throws java.io.IOException

Description copied from class: ModelUtility

Parse an IVML model file for standalone application (without editor) with a given import resolver.
Note: This method is called by de.uni_hildesheim.sse.model.management.VarModel so if you intend to use the management facilities in de.uni_hildesheim.sse.model.management.VarModel let the de.uni_hildesheim.sse.model.management.VarModel do this job for you and do not call this method directly!

Specified by:

parse in class ModelUtility<de.uni_hildesheim.sse.vilBuildLanguage.ImplementationUnit,Script>

Parameters:

uri - the location of the model, e.g. via URI.createURI("dummy:/example.ex1")

resolver - the import resolver (may be null for a new default import resolver)

Returns:

the created variability model including messages

Throws:

java.io.IOException - in case of any I/O or URI problem

print

public void print(TranslationResult<Script> result,
                  java.io.Writer out,
                  boolean emitComments,
                  boolean emitImports)

Prints the model stored in the result to the console output stream (for debugging / testing).

Parameters:

result - the result instance

out - the output writer

emitComments - whether comments shall be emitted

emitImports - whether imports shall be emitted

getLanguageName

protected java.lang.String getLanguageName()

Description copied from class: ModelUtility

Returns the language name as specified in the xText configuration. This name can be found as URL in the grammar file or corresponds to the Java path of the grammar-XMI file in src-gen.

Specified by:

getLanguageName in class ModelUtility<de.uni_hildesheim.sse.vilBuildLanguage.ImplementationUnit,Script>

Returns:

the language name in Java package notation

getLanguageClassLoader

protected java.lang.ClassLoader getLanguageClassLoader()

Description copied from class: ModelUtility

Returns the actual class loader of the language. This loader may be different due to different bundles.

Specified by:

getLanguageClassLoader in class ModelUtility<de.uni_hildesheim.sse.vilBuildLanguage.ImplementationUnit,Script>

Returns:

the class loader

createExpression

public Expression createExpression(java.lang.String text,
                                   Resolver resolver,
                                   java.lang.StringBuilder warnings)
                            throws VilException

Parses text into an expression.

Parameters:

text - the text to be parsed

environment - the runtime environment for resolving variables

an - optional buffer to collect warnings

Returns:

the resulting expression

Throws:

VilException - in case that parsing fails

createExpression

public Expression createExpression(java.lang.String text,
                                   IRuntimeEnvironment environment)
                            throws VilException

Throws:

VilException

getExtension

public java.lang.String getExtension()

Description copied from class: ModelUtility

Returns the file extension / identifier to react on.

Specified by:

getExtension in class ModelUtility<de.uni_hildesheim.sse.vilBuildLanguage.ImplementationUnit,Script>

Returns:

the extension

obtainInfo

public java.util.List<ModelInfo<Script>> obtainInfo(org.eclipse.emf.common.util.URI uri)
                                             throws java.io.IOException

Obtains model information.

Specified by:

obtainInfo in class ModelUtility<de.uni_hildesheim.sse.vilBuildLanguage.ImplementationUnit,Script>

Parameters:

uri - the URI to read the info from

Returns:

the project info instances related to uri

Throws:

java.io.IOException - in case that an I/O error happens during parsing