First of all, you need to add Stencil to the list of dependencies in your project. The Stencil home page shows the current version you can use in your build files.
The public Java API is accessible in the io.github.erdos.stencil.API
class. Check out the Stencil Javadoc page for details.
API.prepare()
funtion with the template file.API.render()
function.close()
method to free allocated resources.The following example takes a template from the file system, fills it with data from the arguments and writes the rendered document back to the file system.
public void renderInvoiceDocument(String userName, Integer totalCost) throws IOException {
final File template = new File("/path/to/template.docx");
final PreparedTemplate prepared = API.prepare(template);
final Map<String, Object> data = new HashMap<>();
data.put("name", userName);
data.put("cost", totalCost);
final EvaluatedDocument rendered = API.render(prepared, TemplateData.fromMap(data));
rendered.writeToFile(new File("target/invoice-" + userName + ".docx"));
}
Both the PreparedTemplate
and PreparedFragment
types implement AutoClosable
, which makes resource handling simpler with the try-with-resources
syntax.
try (PreparedTemplate template = API.prepare("template.docx")) {
EvaluatedDocument rendered = API.render(template, TemplateData.fromMap());
rendered.writeToFile(new File("target/rendered.docx"));
}
We recomment checking the Stencil Clojure documentation for details and API usage.
You need to import the stencil api namespace: (require '[stencil.api :as api])
First, we need to compile a template file.
(def template-1 (api/prepare (clojure.java.io/resource "template1.docx")))
Then, we can define a helper function to render the template.
(defn render-template-1 [output-file data]
(api/render! template-1 data :output output-file))
Call the function to render file.
(render-template-1 "/tmp/output-1.docx" {"customerName" "John Doe"})
This renders the template to /tmp/output-1.docx
with the supplied data.
Call the (api/cleanup!)
function on the prepared template instance when not used anymore to clean
up associated resources. Alternatively, use a with-open form
to automate resource deallocation:
(with-open [tempate (api/prepare "/path/to/template.docx")]
(api/render! template data :output "/path/to/output.docx"))
Calling the close
method on a PreparedTemplate
or a PreparedFragment
can be used to free up some of the cache filed allocated on creation.
Please note, an already closed template or fragment cannot be used for rendering a template, and an IllegalStateException
will be thrown in such cases.
stencil.tmpdir
environment variable to change the default location used
to store caches for prepared template and fragment files. When not set, the value of java.io.tmpdir
is used (eg.: /tmp
in Linux).If you need to convert the resulting document to other document types you can use the amazing JODConverter library.
Can you improve this documentation? These fine people already did:
janos erdos & Janos ErdosEdit on GitHub
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close