thymeleaf内置对象

thymeleaf模板引擎之内置对象

一、简介

和JSP一样，Thymeleaf也是具有内置对象一说的，笔者在这里会进一步搜集和汇总thymeleaf常用的内置对象。为了能够进一步详细讲解这一段的使用方法，基于官网，并且翻阅同行前辈们的资料的基础上，详细汇编出这一章的内容，用于笔者技术水平有限，错误之处在所难免，敬请各位读者谅解和提出宝贵的意见和建议。

二、基础对象

1、ctx: the context object
ctx对象继承org.thymeleaf.context.IContext或者org.thymeleaf.context.IWebContext，取决于当前环境是不是web环境。
如果程序集成了spring，那么将会是org.thymeleaf.spring[3|4].context.SpringWebContext
#org.thymeleaf.context.IContext
${#ctx.locale}
${#ctx.variables}
#org.thymeleaf.context.IWebContext
${#ctx.applicationAttributes}
${#ctx.httpServletRequest}
${#ctx.httpServletResponse}
${#ctx.httpSession}
${#ctx.requestAttributes}
${#ctx.requestParameters}
${#ctx.servletContext}
${#ctx.sessionAttributes}

2、vars: the context variables
访问VariablesMap所有上下文中的变量
#org.thymeleaf.context.VariablesMap
${#vars.get(‘foo’)}
${#vars.containsKey(‘foo’)}
${#vars.size()}

3、locale: the context locale
java.util.Locale对象的访问

Established locale country: US

4、request: (only in Web Contexts) the HttpServletRequest object
5、response: (only in Web Contexts) the HttpServletResponse object
6、session: (only in Web Contexts) the HttpSession object(需要contoller/action(HttpSession session))
7、servletContext: (only in Web Contexts) the ServletContext object

三、web环境对象

1、#httpServletRequest :javax.servlet.http.HttpServletRequest对象实例
${#httpServletRequest.getAttribute(‘foo’)}
${#httpServletRequest.getParameter(‘foo’)}
${#httpServletRequest.getContextPath()}
${#httpServletRequest.getRequestName()}

2、#httpSession(需要contoller/action(HttpSession session))
${#httpSession.getAttribute(‘foo’)}
${#httpSession.id}
${#httpSession.lastAccessedTime}

四、Spring环境对象

#themes : 提供和“ spring:theme JSP tag.”同样的功能。
${#themes.code(‘foo’)}

五、web环境中request/session等属性的使用

1、param :获取请求的参数.
${param.foo} // Retrieves a String[] with the values of request parameter ‘foo’
${param.size()}
${param.isEmpty()}
${param.containsKey(‘foo’)}

2、session:访问session属性
${session.foo} // Retrieves the session atttribute ‘foo’
${session.size()}
${session.isEmpty()}
${session.containsKey(‘foo’)}

3、application：获取应用程序/ servlet上下文属性
${application.foo} // Retrieves the ServletContext atttribute ‘foo’
${application.size()}
${application.isEmpty()}
${application.containsKey(‘foo’)}

六、直接访问spring注册对象

七、表达式实用程序对象

#dates : 为 java.util.Date对象提供工具方法,比如：格式化,提取年月日等；

#calendars : 类似于#dates , 但是只针对java.util.Calendar对象；

#numbers : 为数值型对象提供工具方法；

#strings :为String 对象提供工具方法。如: contains, startsWith, prepending/appending等；

#objects : 为object 对象提供常用的工具方法；

#bools : 为boolean 对象提供常用的工具方法；

#arrays : 为arrays 对象提供常用的工具方法；

#lists :为lists对象提供常用的工具方法；

#sets : 为sets对象提供常用的工具方法；

#maps : 为maps对象提供常用的工具方法；

#aggregates :为创造一个arrays 或者 collections聚集函数提供常用的工具方法；

#messages :用于在变量表达式中获得外部消息的实用方法，与使用#{…}语法获得的方式相同；

#uris：用于在Thymeleaf标准表达式中执行URI / URL操作（特别是转义/消除转义）的实用对象；

#conversions：允许在模板的任意位置执行转换服务的实用程序对象；

#ids : 为可能需要循环的ID属性提供常用的工具方法。

这些使用表达式对象在package org.thymeleaf.expression包下都有对应的类，如果不知道怎么使用直接看Javadoc就好，推荐使用的时候按需查询。