Thymeleaf Expression Processor

A simplified API for working with Thymeleaf expressions.

Installation

Minimum of Java 8 and Thymeleaf 3.1 required.

For Maven and Maven-compatible dependency managers

Add a dependency to your project with the following co-ordinates:

• GroupId: nz.net.ultraq.thymeleaf
• ArtifactId: thymeleaf-expression-processor
• Version: 3.2.0

Check the project releases for a list of available versions. Each release page also includes a downloadable JAR if you want to manually add it to your project classpath.

Usage

Create an instance of ExpressionProcessor using the current expression context (the context object passed to Thymeleaf processors is a type of IExpressionContext), and then parse/process any string that is a Thymeleaf expression, using any of the instance methods described below:

parse(String expression) -> IStandardExpression

Parses an expression, returning the matching expression type.

parseFragmentExpression(String fragmentExpression) -> FragmentExpression

Parses an expression under the assumption it is a fragment expression. This method will wrap fragment expressions written in Thymeleaf 2 syntax as a backwards compatibility measure for those migrating their web apps to Thymeleaf 3. (This is because Thymeleaf 3 currently does the same, but expect this method to go away when Thymeleaf starts enforcing the new fragment expression syntax itself.)

process(String expression) -> Object

Parse and executes an expression, returning whatever the type of the expression result is.

processAsString(String expression) -> String

Parse and execute an expression, returning the result as a string. Useful for expressions that expect a simple result.