Outerthought :: Template features

Introduction

Here we give an overview of the features of the Kauri template language, and their current state. We also give a qualification of the importance/urgency of the feature.

Legend:

--	not needed
+	nice to have
++	need to have
+++	blocker (i.e. need to have asap)

Template directives

directive	state	qualification	note
if...		++
if... else...		--	no added value next to choose when... otherwise...
choose -> when...		++
choose -> otherwise...		++
forEach...		++ ++	repeat number of times ; access to: index, number, (size), (position), revIndex, revNumber foreach x in collection
import <template>		++	@runtime - xslt-alike - local macro's and var assignments overrule the ones in the imported template
include <template>		++	@runtime - xslt-alike - included macro's and var assignments can overrule when include is after the local declaration
insert <url> insert <var>		+++ +	@runtime - verbatim copy of refered document @runtime - serialize in sax events from refered object
comment		+	ability to generate comments in output
attribute		++
element		++ +	create an output element with a dynamic name support creation of namespaced elements : #391
macro		+
variable		++ +	create a local alias of an object support dom-trees

Expression language

expression	state	qualification	note
true, false		++
and, or, ! (not)		++
==, !=, <, >, <=, >=		++
toUpperCase, toLowerCase		++
substring, left, right		+
trim		+
length		++
concat		+	although this can be done implicit, we provided the method (with varargs) for convenience
date (with formatting options), now		+
startswith, endswith, contains		++
exp ? val1 : val2		++

Advanced topics

topic	state	qualification	note
taglibs support		++	first attempt
decorator		+	waiting for concrete use case
formatting, i18n		+++	very important - via EL
public uri translate		+++	very important - via EL
function registry		+++	enable through module interface: important
whitespace handling		++	keep in mind
template inheritance mechanism		+++	cfr include and import ; important
XPath support in EL		++	inspiration from xslt - use jxpath (cfr jxtemplate) ? #392
support for groovy expressions		+++
security aspect		--	possibility to white- or blacklist locations of scripts (e.g. groovy) and templates : not needed, responsibility of template author

Template engine

subject	state	note
template executor		sax based default implementation
template builder		sax based default implementation
template service		first version with some basic caching
junit tests
documentation		some more javadoc, documentation
restlet/kauri integration		resolver, context, ...
caching		caching (compiledtemplate & output) : basic caching available, might need more work : #42