org.thymeleaf.spring5.dialect

Class SpringStandardDialect

Object

org.thymeleaf.dialect.AbstractDialect

org.thymeleaf.dialect.AbstractProcessorDialect

org.thymeleaf.standard.StandardDialect

org.thymeleaf.spring5.dialect.SpringStandardDialect

All Implemented Interfaces:

org.thymeleaf.dialect.IDialect, org.thymeleaf.dialect.IExecutionAttributeDialect, org.thymeleaf.dialect.IExpressionObjectDialect, org.thymeleaf.dialect.IProcessorDialect

public class SpringStandardDialect
extends org.thymeleaf.standard.StandardDialect

SpringStandard Dialect. This is the class containing the implementation of Thymeleaf Standard Dialect, including all th:* processors, expression objects, etc. for Spring-enabled environments.

This dialect is valid both for Spring WebMVC and Spring WebFlux environments.

Note this dialect uses SpringEL as an expression language and adds some Spring-specific features on top of StandardDialect, like th:field or Spring-related expression objects.

The usual and recommended way of using this dialect is by instancing SpringTemplateEngine instead of TemplateEngine. The former will automatically add this dialect and perform some specific configuration like e.g. Spring-integrated message resolution.

Note a class with this name existed since 1.0, but it was completely reimplemented in Thymeleaf 3.0

Since:

3.0.3

Author:

Daniel Fernández

Field Summary

Fields

Modifier and Type	Field and Description
static String	NAME
static String	PREFIX
static int	PROCESSOR_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
SpringStandardDialect()

Method Summary

Modifier and Type	Method and Description
static Set<org.thymeleaf.processor.IProcessor>	createSpringStandardProcessorsSet(String dialectPrefix) Create a the set of SpringStandard processors, all of them freshly instanced.
org.thymeleaf.standard.expression.IStandardConversionService	getConversionService()
boolean	getEnableSpringELCompiler() Returns whether the SpringEL compiler should be enabled in SpringEL expressions or not.
Map<String,Object>	getExecutionAttributes()
org.thymeleaf.expression.IExpressionObjectFactory	getExpressionObjectFactory()
Set<org.thymeleaf.processor.IProcessor>	getProcessors(String dialectPrefix)
org.thymeleaf.standard.expression.IStandardVariableExpressionEvaluator	getVariableExpressionEvaluator()
void	setEnableSpringELCompiler(boolean enableSpringELCompiler) Sets whether the SpringEL compiler should be enabled in SpringEL expressions or not.

Methods inherited from class org.thymeleaf.standard.StandardDialect

createStandardProcessorsSet, getCSSSerializer, getExpressionParser, getJavaScriptSerializer, setConversionService, setCSSSerializer, setExpressionParser, setJavaScriptSerializer, setVariableExpressionEvaluator

Methods inherited from class org.thymeleaf.dialect.AbstractProcessorDialect

getDialectProcessorPrecedence, getPrefix

Methods inherited from class org.thymeleaf.dialect.AbstractDialect

getName

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.thymeleaf.dialect.IDialect

getName

Field Detail

NAME

public static final String NAME

See Also:

Constant Field Values

PREFIX

public static final String PREFIX

See Also:

Constant Field Values

PROCESSOR_PRECEDENCE

public static final int PROCESSOR_PRECEDENCE

See Also:

Constant Field Values

Constructor Detail

SpringStandardDialect

public SpringStandardDialect()

Method Detail

getEnableSpringELCompiler

public boolean getEnableSpringELCompiler()

Returns whether the SpringEL compiler should be enabled in SpringEL expressions or not.

Expression compilation can significantly improve the performance of Spring EL expressions, but might not be adequate for every environment. Read the official Spring documentation for more detail.

Also note that although Spring includes a SpEL compiler since Spring 4.1, most expressions in Thymeleaf templates will only be able to properly benefit from this compilation step when at least Spring Framework version 4.2.4 is used.

This flag is set to false by default.

Returns:

true if SpEL expressions should be compiled if possible, false if not.

setEnableSpringELCompiler

public void setEnableSpringELCompiler(boolean enableSpringELCompiler)

Sets whether the SpringEL compiler should be enabled in SpringEL expressions or not.

Expression compilation can significantly improve the performance of Spring EL expressions, but might not be adequate for every environment. Read the official Spring documentation for more detail.

Also note that although Spring includes a SpEL compiler since Spring 4.1, most expressions in Thymeleaf templates will only be able to properly benefit from this compilation step when at least Spring Framework version 4.2.4 is used.

This flag is set to false by default.

Parameters:

enableSpringELCompiler - true if SpEL expressions should be compiled if possible, false if not.

getVariableExpressionEvaluator

public org.thymeleaf.standard.expression.IStandardVariableExpressionEvaluator getVariableExpressionEvaluator()

Overrides:

getVariableExpressionEvaluator in class org.thymeleaf.standard.StandardDialect

getConversionService

public org.thymeleaf.standard.expression.IStandardConversionService getConversionService()

Overrides:

getConversionService in class org.thymeleaf.standard.StandardDialect

getExpressionObjectFactory

public org.thymeleaf.expression.IExpressionObjectFactory getExpressionObjectFactory()

Specified by:

getExpressionObjectFactory in interface org.thymeleaf.dialect.IExpressionObjectDialect

Overrides:

getExpressionObjectFactory in class org.thymeleaf.standard.StandardDialect

getProcessors

public Set<org.thymeleaf.processor.IProcessor> getProcessors(String dialectPrefix)

Specified by:

getProcessors in interface org.thymeleaf.dialect.IProcessorDialect

Overrides:

getProcessors in class org.thymeleaf.standard.StandardDialect

getExecutionAttributes

public Map<String,Object> getExecutionAttributes()

Specified by:

getExecutionAttributes in interface org.thymeleaf.dialect.IExecutionAttributeDialect

Overrides:

getExecutionAttributes in class org.thymeleaf.standard.StandardDialect

createSpringStandardProcessorsSet

public static Set<org.thymeleaf.processor.IProcessor> createSpringStandardProcessorsSet(String dialectPrefix)

Create a the set of SpringStandard processors, all of them freshly instanced.

Parameters:

dialectPrefix - the prefix established for the Standard Dialect, needed for initialization

Returns:

the set of SpringStandard processors.