public class MarkupTemplatingModule extends AbstractModule
To use it one has to register the module and then render MarkupTemplate
instances.
Instances of MarkupTemplate
can be created using one of the
Groovy.groovyMarkupTemplate(java.util.Map, String, String)
static methods.
By default templates are looked up in the templates
directory of the application root.
So groovyMarkupTemplate("my/template/path.gtpl")
maps to tempaltes/my/template/path.gtpl
in the application root directory.
The template engine can be configured using the template configuration
. In particular, it is possible to configure
things like automatic indentation.
Response content type can be manually specified, i.e. groovyMarkupTemplate("template.gtpl", model, "text/html")
if
not specified will default to text/html
.
import ratpack.groovy.markuptemplates.MarkupTemplatingModule;
import ratpack.guice.Guice;
import ratpack.test.embed.BaseDirBuilder;
import ratpack.test.embed.EmbeddedApp;
import java.nio.file.Path;
import static ratpack.groovy.Groovy.groovyMarkupTemplate;
public class Example {
public static void main(String... args) {
Path baseDir = BaseDirBuilder.tmpDir().build(builder ->
builder.file("templates/myTemplate.gtpl", "html { body { p(value) } }")
);
EmbeddedApp.fromHandlerFactory(baseDir, launchConfig ->
Guice.builder(launchConfig)
.bindings(b -> b.add(new MarkupTemplatingModule()))
.build(chain -> chain
.get(ctx -> ctx.render(groovyMarkupTemplate("myTemplate.gtpl", m -> m.put("value", "hello!"))))
)
).test(httpClient -> {
assert httpClient.get().getBody().getText().equals("<html><body><p>hello!</p></body></html>");
});
}
}
Constructor and Description |
---|
MarkupTemplatingModule() |
Modifier and Type | Method and Description |
---|---|
protected void |
configure() |
String |
getTemplatesDirectory() |
void |
setTemplatesDirectory(String templatesDirectory) |
addError, addError, addError, bind, bind, bind, bindConstant, binder, bindInterceptor, bindListener, bindScope, configure, convertToTypes, currentStage, getMembersInjector, getMembersInjector, getProvider, getProvider, install, requestInjection, requestStaticInjection, requireBinding, requireBinding
public String getTemplatesDirectory()
public void setTemplatesDirectory(String templatesDirectory)
protected void configure()
configure
in class AbstractModule