Constructor Detail

• public StreamingTemplateEngine()

  Create a streaming template engine instance using the default class loader

• public StreamingTemplateEngine(ClassLoader parentLoader)

  Create a streaming template engine instance using a custom class loader

  The custom loader is used when parsing the template code

  Parameters:

  parentLoader - The class loader to use when parsing the template code.

Method Detail

• @Override public Template createTemplate(Reader reader)

  Creates a template instance using the template source from the provided Reader.

  The template can be applied repeatedly on different bindings to produce custom output.

  Technical detail
  Under the hood the returned template is represented as a four argument closure where the three first arguments are curried in while generating the template.
  
  In essence we start with a closure on the form:

     { parentClass, stringSectionList, binding, out ->
        //code generated by parsing the template data
     }                                                                             *
   

  , we then curry in the parentClass and stringSectionList arguments so that the StreamingTemplate instance returned from 'createTemplate' internally contains a template closure on the form:

     { binding, out ->
        //code generated by parsing the template data
     }                                                                             *
   

  Calling template.make(binding), curries in the 'binding' argument:

     public Writable make(final Map map) {
       final Closure template = this.template.curry(new Object[]{map});
       return (Writable) template;
     }
   

  which only leaves the 'out' argument unbound. The only method on the writable interface is writeTo(Writer out) so groovy rules about casting a closure to a one-method-interface apply and the above works. I.e. we return the now one argument closure as the Writable which can be serialized to System.out, a file, etc according to the Writable interface contract.

  See Also:

  TemplateEngine.createTemplate