A TemplateEngine integrated with Scalatra.
Creates a render context to be used by default in the template engine.
Creates a render context to be used by default in the template engine.
Returns a ScalatraRenderContext by default in order to bind some other framework variables (e.g., multiParams, flash). ScalatraTemplateEngine assumes this returns ScalatraRenderContext in its binding of "context". If you return something other than a ScalatraRenderContext, you will also want to redefine that binding.
Creates the templateEngine from the config.
Creates the templateEngine from the config. There is little reason to override this unless you have created a ServletBase extension outside an HttpServlet or Filter.
The default index page when the path is a directory.
The default index page when the path is a directory.
The default path to search for templates.
The default path to search for templates. Left as a def so it can be read from the servletContext in initialize, but you probably want a constant.
Defaults to:
- /WEB-INF/templates/views
(recommended)
- /WEB-INF/views
(used by previous Scalatra quickstarts)
- /WEB-INF/scalate/templates
(used by previous Scalatra quickstarts)
The default template format.
The default template format.
The default path to search for templates.
The default path to search for templates. Left as a def so it can be read from the servletContext in initialize, but you probably want a constant.
Defaults to:
- /WEB-INF/templates/views
(recommended)
- /WEB-INF/views
(used by previous Scalatra quickstarts)
- /WEB-INF/scalate/templates
(used by previous Scalatra quickstarts)
Finds a template for a path.
Finds a template for a path. Delegates to a TemplateFinder, and if
that fails, tries again with /defaultIndexName
appended.
Flag whether the Scalate error page is enabled.
Flag whether the Scalate error page is enabled. If true, uncaught exceptions will be caught and rendered by the Scalate error page.
The default is true.
Convenience method for layoutTemplateAs("jade")
.
Convenience method for layoutTemplateAs("jade")
.
Finds and renders a template with the current layout strategy, looking for all known extensions, returning the result.
Finds and renders a template with the current layout strategy, looking for all known extensions, returning the result.
The path of the template, passed to findTemplate
.
Attributes to path to the render context. Disable
layouts by passing layout -> ""
.
Finds and renders a template with the current layout strategy, returning the result.
Finds and renders a template with the current layout strategy, returning the result.
The extensions to look for a template.
The path of the template, passed to findTemplate
.
Attributes to path to the render context. Disable
layouts by passing layout -> ""
.
Convenience method for layoutTemplateAs("mustache")
.
Convenience method for layoutTemplateAs("mustache")
.
Convenience method for layoutTemplateAs("scaml")
.
Convenience method for layoutTemplateAs("scaml")
.
Convenience method for layoutTemplateAs("ssp")
.
Convenience method for layoutTemplateAs("ssp")
.
A request-scoped map of attributes to pass to the template.
A request-scoped map of attributes to pass to the template. This map
will be set to any render context created with the createRenderContext
method.
The template engine used by the methods in this support class.
The template engine used by the methods in this support class. It
provides a lower-level interface to Scalate and may be used directly
to circumvent the conventions imposed by the helpers in this class.
For instance, paths passed directly to the template engine are not
run through findTemplate
.
(Since version 2.1.0) Do not invoke directly. Use withRequest
to change the binding, or request to get the value
(Since version 2.1.0) Do not invoke directly. Use withResponse
to change the binding, or response
to get the value
(Since version 2.1.0) Use servletContext instead
Creates a render context and renders directly to that.
Creates a render context and renders directly to that. No template search is performed, and the layout strategy is circumvented. Clients are urged to consider layoutTemplate instead.
(Since version 2.0.0) not idiomatic Scalate; consider layoutTemplate instead
(Since version 2.1.0) Use status_=(Int) instead