Deprecated API

Contents

• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Classes

Class and Description
org.thymeleaf.templateparser.xmldom.AbstractNonValidatingDOMTemplateParser DOM parsers are not supported anymore. Use SAX equivalents instead. Will be removed in 3.0.
org.thymeleaf.processor.attr.AbstractRemovalAttrProcessor Deprecated in 2.1.0, in favour of AbstractMarkupRemovalAttrProcessor. Will be removed in 3.0.
org.thymeleaf.templateparser.xmldom.AbstractValidatingDOMTemplateParser DOM parsers are not supported anymore. Use SAX equivalents instead. Will be removed in 3.0.
org.thymeleaf.util.PrefixUtils The PrefixUtils class has been deprecated in 2.1.0. From then on, the Element and Attribute classes are responsible for managing and combining dialect prefixes as required.
org.thymeleaf.standard.expression.StandardExpressionExecutor The StandardExpressionExecutor class has been deprecated in 2.1.0. Instead the "execute()" methods in Expression objects returned by parsers should be used directly.
org.thymeleaf.standard.expression.StandardExpressionProcessor the StandardExpressionProcessor class was deprecated in 2.1.0 for semantic and refactoring reasons. Should use the equivalent StandardExpressions instead if you want to obtain parser instances registered by the standard dialects, or instance your parser instances using their constructors directly if you are building your own dialect including these parserss. As for expression execution, this is no longer managed by executor objects (also deprecated) but by the expressions themselves. Will be removed in 3.0.
org.thymeleaf.util.UrlUtils in 2.1.4, and replaced by the use of Unbescape's UriEscape class.
org.thymeleaf.templateparser.xmldom.XhtmlAndHtml5NonValidatingDOMTemplateParser DOM parsers are not supported anymore. Use SAX equivalents instead. Will be removed in 3.0.
org.thymeleaf.templateparser.xmldom.XhtmlValidatingDOMTemplateParser DOM parsers are not supported anymore. Use SAX equivalents instead. Will be removed in 3.0.
org.thymeleaf.templateparser.xmldom.XmlNonValidatingDOMTemplateParser DOM parsers are not supported anymore. Use SAX equivalents instead. Will be removed in 3.0.
org.thymeleaf.templateparser.xmldom.XmlValidatingDOMTemplateParser DOM parsers are not supported anymore. Use SAX equivalents instead. Will be removed in 3.0.

Deprecated Fields

Field and Description
org.thymeleaf.standard.StandardDialect.EXPRESSION_EVALUATOR_EXECUTION_ATTRIBUTE This constant was removed in 2.1.0. Access to expression evaluator and expression parser objects should be made through the StandardExpressions class. Will be removed in 3.0
org.thymeleaf.standard.expression.StandardExpressionProcessor.STANDARD_EXPRESSION_EXECUTOR_ATTRIBUTE_NAME
org.thymeleaf.standard.expression.StandardExpressionProcessor.STANDARD_EXPRESSION_PARSER_ATTRIBUTE_NAME
org.thymeleaf.Configuration.STANDARD_THYMELEAF_DIALECT Deprecated in 2.1.0. Create a new instance of the StandardDialect using its constructors instead. Will be removed in 3.0

Deprecated Methods

Method and Description
org.thymeleaf.dom.Node.applyDialectPrefix(String, String) Deprecated in 2.1.0. Use Attribute.applyPrefixToAttributeName(String, String) or Element.applyPrefixToElementName(String, String) instead.
org.thymeleaf.util.ObjectUtils.convertToArray(Object) since 2.1, you should use the IStandardConversionService implementation corresponding to the dialect you are using or the methods in EvaluationUtil. Will be removed in 3.0.
org.thymeleaf.util.ObjectUtils.convertToIterable(Object) since 2.1, you should use the IStandardConversionService implementation corresponding to the dialect you are using or the methods in EvaluationUtil. Will be removed in 3.0.
org.thymeleaf.util.ObjectUtils.convertToList(Object) since 2.1, you should use the IStandardConversionService implementation corresponding to the dialect you are using or the methods in EvaluationUtil. Will be removed in 3.0.
org.thymeleaf.standard.expression.StandardExpressionProcessor.createStandardExpressionExecutor(IStandardVariableExpressionEvaluator)
org.thymeleaf.standard.expression.StandardExpressionProcessor.createStandardExpressionParser(StandardExpressionExecutor)
org.thymeleaf.util.DOMUtils.escapeXml(char[], boolean) This method has been deprecated in 2.1.3 and is no longer an adequate way to obtain escaped HTML code. The whole of the escaping mechanism defined on top of these DOMUtils escape/unescape methods had too many drawbacks and issues, so it was completely replaced by the Unbescape library. Will be removed in 3.0.
org.thymeleaf.util.DOMUtils.escapeXml(String, boolean) This method has been deprecated in 2.1.3 and is no longer an adequate way to obtain escaped HTML code. The whole of the escaping mechanism defined on top of these DOMUtils escape/unescape methods had too many drawbacks and issues, so it was completely replaced by the Unbescape library. Will be removed in 3.0.
org.thymeleaf.util.ObjectUtils.evaluateAsBoolean(Object) since 2.1, you should use the IStandardConversionService implementation corresponding to the dialect you are using or the methods in EvaluationUtil. Will be removed in 3.0.
org.thymeleaf.util.ObjectUtils.evaluateAsNumber(Object) since 2.1, you should use the IStandardConversionService implementation corresponding to the dialect you are using or the methods in EvaluationUtil. Will be removed in 3.0.
org.thymeleaf.standard.expression.StandardExpressionExecutor.executeExpression(Arguments, Expression)
org.thymeleaf.standard.expression.StandardExpressionProcessor.executeExpression(Arguments, Expression)
org.thymeleaf.standard.expression.StandardExpressionExecutor.executeExpression(Arguments, Expression, StandardExpressionExecutionContext)
org.thymeleaf.standard.expression.StandardExpressionProcessor.executeExpression(Arguments, Expression, StandardExpressionExecutionContext)
org.thymeleaf.standard.expression.StandardExpressionExecutor.executeExpression(Configuration, IProcessingContext, Expression)
org.thymeleaf.standard.expression.StandardExpressionProcessor.executeExpression(Configuration, IProcessingContext, Expression)
org.thymeleaf.standard.expression.StandardExpressionExecutor.executeExpression(Configuration, IProcessingContext, Expression, StandardExpressionExecutionContext)
org.thymeleaf.standard.expression.StandardExpressionProcessor.executeExpression(Configuration, IProcessingContext, Expression, StandardExpressionExecutionContext)
org.thymeleaf.context.WebContext.getApplicationAttributes() Get attributes from the ServletContext object directly instead. Will be removed in 3.0.
org.thymeleaf.dom.Element.getNormalizedPrefix() Deprecated in 2.1.0. There is no actual usage of this method
org.thymeleaf.dom.Attribute.getNormalizedPrefix() Deprecated in 2.1.0. There is no actual usage of this method
org.thymeleaf.util.PrefixUtils.getPrefix(String)
org.thymeleaf.context.WebContext.getRequestAttributes() Get attributes from the HttpServletRequest object directly instead. Will be removed in 3.0.
org.thymeleaf.context.WebContext.getRequestParameters() Get parameters from the HttpServletRequest object directly instead. Will be removed in 3.0.
org.thymeleaf.context.WebContext.getSessionAttributes() Get attributes from the HttpSession object directly instead. Will be removed in 3.0.
org.thymeleaf.util.PrefixUtils.getUnprefixed(String)
org.thymeleaf.dom.Element.getUnprefixedNormalizedName() Deprecated in 2.1.0. There is no actual usage of this method
org.thymeleaf.dom.Attribute.getUnprefixedNormalizedName() Deprecated in 2.1.0. There is no actual usage of this method
org.thymeleaf.dom.Attribute.getXmlnsPrefix() Deprecated in 2.1.0. The only usage of this method is at the moment of writing the template. No need to be always pre-computed.
org.thymeleaf.dom.Element.hasPrefix() Deprecated in 2.1.0. There is no actual usage of this method
org.thymeleaf.dom.Attribute.hasPrefix() Deprecated in 2.1.0. There is no actual usage of this method
org.thymeleaf.util.PrefixUtils.hasPrefix(String)
org.thymeleaf.dialect.AbstractDialect.isLenient() The leniency flag is not used anymore since 2.1.0. Will be removed in 3.0. This method was removed from the IDialect interface and added here as a default implementation in order to allow backwards-compatibility of dialects.
org.thymeleaf.dom.Attribute.isXmlnsAttribute() Deprecated in 2.1.0. The only usage of this method is at the moment of writing the template. No need to be always pre-computed.
org.thymeleaf.dom.Node.normalizeName(String) Deprecated in 2.1.0. Use Attribute.normalizeAttributeName(String) or Element.normalizeElementName(String) instead.
org.thymeleaf.standard.expression.StandardExpressionParser.parseAssignationSequence(Arguments, String, boolean) since 2.1.0. Deprecated in favour of StandardExpressionParser.parseAssignationSequence(org.thymeleaf.Configuration, org.thymeleaf.context.IProcessingContext, String, boolean). Will be removed in 3.0.
org.thymeleaf.standard.expression.StandardExpressionProcessor.parseAssignationSequence(Arguments, String, boolean)
org.thymeleaf.standard.expression.StandardExpressionProcessor.parseAssignationSequence(Configuration, IProcessingContext, String, boolean)
org.thymeleaf.standard.expression.StandardExpressionParser.parseEach(Arguments, String) since 2.1.0. Deprecated in favour of StandardExpressionParser.parseEach(org.thymeleaf.Configuration, org.thymeleaf.context.IProcessingContext, String). Will be removed in 3.0.
org.thymeleaf.standard.expression.StandardExpressionProcessor.parseEach(Arguments, String)
org.thymeleaf.standard.expression.StandardExpressionProcessor.parseEach(Configuration, IProcessingContext, String)
org.thymeleaf.standard.expression.StandardExpressionParser.parseExpression(Arguments, String) since 2.1.0. Deprecated in favour of StandardExpressionParser.parseExpression(org.thymeleaf.Configuration, org.thymeleaf.context.IProcessingContext, String). Will be removed in 3.0.
org.thymeleaf.standard.expression.StandardExpressionProcessor.parseExpression(Arguments, String)
org.thymeleaf.standard.expression.StandardExpressionProcessor.parseExpression(Configuration, IProcessingContext, String)
org.thymeleaf.standard.expression.StandardExpressionParser.parseExpressionSequence(Arguments, String) since 2.1.0. Deprecated in favour of StandardExpressionParser.parseExpressionSequence(org.thymeleaf.Configuration, org.thymeleaf.context.IProcessingContext, String). Will be removed in 3.0.
org.thymeleaf.standard.expression.StandardExpressionProcessor.parseExpressionSequence(Arguments, String)
org.thymeleaf.standard.expression.StandardExpressionProcessor.parseExpressionSequence(Configuration, IProcessingContext, String)
org.thymeleaf.standard.expression.StandardExpressionParser.parseFragmentSelection(Arguments, String) since 2.1.0. Deprecated in favour of StandardExpressionParser.parseFragmentSelection(org.thymeleaf.Configuration, org.thymeleaf.context.IProcessingContext, String). Will be removed in 3.0.
org.thymeleaf.standard.expression.StandardExpressionProcessor.parseFragmentSelection(Arguments, String)
org.thymeleaf.standard.expression.StandardExpressionProcessor.parseFragmentSelection(Configuration, IProcessingContext, String)
org.thymeleaf.standard.expression.StandardExpressionProcessor.processExpression(Arguments, String)
org.thymeleaf.standard.expression.StandardExpressionProcessor.processExpression(Arguments, String, StandardExpressionExecutionContext)
org.thymeleaf.standard.expression.StandardExpressionProcessor.processExpression(Configuration, IProcessingContext, String)
org.thymeleaf.standard.expression.StandardExpressionProcessor.processExpression(Configuration, IProcessingContext, String, StandardExpressionExecutionContext)
org.thymeleaf.util.DOMUtils.unescapeXml(String, boolean) This method has been deprecated in 2.1.3 and is no longer an adequate way to obtain unescaped HTML code. The whole of the escaping mechanism defined on top of these DOMUtils escape/unescape methods had too many drawbacks and issues, so it was completely replaced by the Unbescape library. Will be removed in 3.0.
org.thymeleaf.util.DOMUtils.writeXmlEscaped(char[], Writer, boolean) This method has been deprecated in 2.1.3 and is no longer an adequate way to obtain escaped HTML code. The whole of the escaping mechanism defined on top of these DOMUtils escape/unescape methods had too many drawbacks and issues, so it was completely replaced by the Unbescape library. Will be removed in 3.0.
org.thymeleaf.util.DOMUtils.writeXmlEscaped(String, Writer, boolean) This method has been deprecated in 2.1.3 and is no longer an adequate way to obtain escaped HTML code. The whole of the escaping mechanism defined on top of these DOMUtils escape/unescape methods had too many drawbacks and issues, so it was completely replaced by the Unbescape library. Will be removed in 3.0.

Deprecated Constructors

Constructor and Description
org.thymeleaf.dom.CDATASection(String, boolean) Deprecated in 2.1.3. Will be removed in 3.0. Text and CDATA nodes do not perform XML-escaping anymore.
org.thymeleaf.dom.CDATASection(String, boolean, String) Deprecated in 2.1.3. Will be removed in 3.0. Text and CDATA nodes do not perform XML-escaping anymore.
org.thymeleaf.dom.CDATASection(String, boolean, String, Integer) Deprecated in 2.1.3. Will be removed in 3.0. Text and CDATA nodes do not perform XML-escaping anymore.
org.thymeleaf.standard.expression.StandardExpressionExecutor(IStandardVariableExpressionEvaluator)
org.thymeleaf.dom.Text(String, boolean) Deprecated in 2.1.3. Will be removed in 3.0. Text and CDATA nodes do not perform XML-escaping anymore.
org.thymeleaf.dom.Text(String, boolean, String) Deprecated in 2.1.3. Will be removed in 3.0. Text and CDATA nodes do not perform XML-escaping anymore.
org.thymeleaf.dom.Text(String, boolean, String, Integer) Deprecated in 2.1.3. Will be removed in 3.0. Text and CDATA nodes do not perform XML-escaping anymore.