Template API

The modelant Templates mechanism provides a default implementation in the modelant.template.impl module. Nevertheless, it allows plugging in another implementation of the modelan Templates API, as of [A4].

Usage

As of the [A4], convention:

  • Construct a Template Engine with the unique name stated in the template compilation context:
engine = TemplateEngineFactory.constructEngine(templateCompilationContext)
  • Lookup the Template Engine after its instantiation, as many times as needed:
engine = TemplateEngineFactory.getEngine(uniqueName)
  • The implementation class should be provided in the META-INF\services\net.mdatools.modelant.template.spi.TemplateEngineSetup

Template Compilation Context

The Template Compilation Context provides:

  • encoding is the encoding as text files of all templates in the context and encoding of the produced output.
  • template source directory the root directory, relatively which the templates’ directories and files are located. Default: ${project.build.sourceDirectory}/../template
  • java directory the root directory where to translate the template to temporary java files.
    Default: ${project.build.directory}/java
  • class directory the root directory where to compile the java files the templates are translated to.
    Default: ${project.build.outputDirectory}
  • unique name a unique name of this template context among all other contexts used simultaneously. It identifies the context and makes the template names in it unique amnong the template names in all contexts.
    Examples: domain, view, persistence, db
  • keepGenerated indicates if the translation of the template to java should be kept (true) for review, instead of being deleted after the compilation (false)
    Default: false
  • compileForDebug indicates if the compilation of the template should include debug data (true) in the produced class.
    Default: false