Java-based template engine based on django template syntax, adapted to render jinja templates (at least the subset of jinja in use in HubSpot content). Currently used in production to render thousands of websites with hundreds of millions of page views per month on the HubSpot COS. Note: Requires Java >= 8. Originally forked from jangod.
<dependency>
<groupId>com.hubspot.jinjava</groupId>
<artifactId>jinjava</artifactId>
<version>2.1.0</version>
</dependency>or if you're stuck on java 7:
<dependency>
<groupId>com.hubspot.jinjava</groupId>
<artifactId>jinjava</artifactId>
<version>2.0.11-java7</version>
</dependency>my-template.html:
<div>Hello, {{ name }}!</div>java code:
Jinjava jinjava = new Jinjava();
Map<String, Object> context = Maps.newHashMap();
context.put("name", "Jared");
String template = Resources.toString(Resources.getResource("my-template.html"), Charsets.UTF_8);
String renderedTemplate = jinjava.render(template, context);result:
<div>Hello, Handsome!</div>Voila! Hey, wait a minute...
Jinjava needs to know how to interpret template paths, so it can properly handle tags like:
{% extends "foo/bar/base.html" %}
By default, it will load a FileLocator; you will likely want to provide your own implementation of
ResourceLoader to hook into your application's template repository, and then tell jinjava about it:
JinjavaConfig config = new JinjavaConfig();
Jinjava jinjava = new Jinjava(config);
jinjava.setResourceLocator(new MyCustomResourceLocator());You can provide custom jinja tags, filters, and static functions to the template engine.
// define a custom tag implementing com.hubspot.jinjava.lib.Tag
jinjava.getGlobalContext().registerTag(new MyCustomTag());
// define a custom filter implementing com.hubspot.jinjava.lib.Filter
jinjava.getGlobalContext().registerFilter(new MyAwesomeFilter());
// define a custom public static function (this one will bind to myfn.my_func('foo', 42))
jinjava.getGlobalContext().registerFunction(new ELFunctionDefinition("myfn", "my_func",
MyFuncsClass.class, "myFunc", String.class, Integer.class);
// define any number of classes which extend Importable
jinjava.getGlobalContext().registerClasses(Class<? extends Importable>... classes);
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent