SpringBoot 之 thymeleaf

thymeleaf 的maven 配置我们都知道：

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>

但是， 它还是很多坑的。

先看一个boot 的默认配置：

# THYMELEAF (ThymeleafAutoConfiguration)
spring.thymeleaf.cache=true # Enable template caching.
spring.thymeleaf.check-template=true # Check that the template exists before rendering it.
spring.thymeleaf.check-template-location=true # Check that the templates location exists.
spring.thymeleaf.content-type=text/html # Content-Type value.
spring.thymeleaf.enabled=true # Enable MVC Thymeleaf view resolution.
spring.thymeleaf.encoding=UTF-8 # Template encoding.
spring.thymeleaf.excluded-view-names= # Comma-separated list of view names that should be excluded from resolution.
spring.thymeleaf.mode=HTML5 # Template mode to be applied to templates. See also StandardTemplateModeHandlers.
spring.thymeleaf.prefix=classpath:/templates/ # Prefix that gets prepended to view names when building a URL.
spring.thymeleaf.suffix=.html # Suffix that gets appended to view names when building a URL.
spring.thymeleaf.template-resolver-order= # Order of the template resolver in the chain.
spring.thymeleaf.view-names= # Comma-separated list of view names that can be resolved.

注意到 spring.thymeleaf.prefix=classpath:/templates/  ， 而 suffix=.html 。这两个配置是相当关键的， 不然就被坑死了！。 它的意思一定不能搞错：

spring.thymeleaf.prefix=classpath:/templates/   指明 thymeleaf 查找view 资源的根目录。 默认是 /templates/ 目录。 templates 的意思正确理解是模板 文件目录。

spring.thymeleaf.suffix=.html  　　　　　　      指明 thymeleaf  查找view 资源时候使用的 后缀。 默认是 html 文件。

上面两个配置， 我们一般不需要做什么修改。 有意思的是下面的 配置：

spring.thymeleaf.excluded-view-names     要排除的 view Name，也就是 试图名称。他可以是一个包含星号（*）的路径名，（不是正则表达式）。

spring.thymeleaf.view-names= 　　　　   可以被解析的 view Names, 也可以是一个包含星号的路径名。只有@RequestMapping返回的view 的name 落在了这个  Comma-separated list ， 那么boot 才会使用ThymeleafViewResolver 进行解析。

ThymeleafViewResolver 关键代码是：

    protected boolean canHandle(String viewName, Locale locale) {
        String[] viewNamesToBeProcessed = this.getViewNames();
        String[] viewNamesNotToBeProcessed = this.getExcludedViewNames();
        return (viewNamesToBeProcessed == null || PatternMatchUtils.simpleMatch(viewNamesToBeProcessed, viewName)) && (viewNamesNotToBeProcessed == null || !PatternMatchUtils.simpleMatch(viewNamesNotToBeProcessed, viewName));
    }

ThymeleafViewResolver  的处理view 的优先级是第一位，也就是如果它能够处理，那么就交给他处理。 否则交给其他 ViewResolver处理。

我们可以通过 spring.thymeleaf.template-resolver-order 进行配置。

注意， 如果ThymeleafViewResolver  能够处理， 但是，资源却找不到，那么会看到一个后台错误，如：

org.thymeleaf.exceptions.TemplateInputException: Error resolving template "/v222/index", template might not exist or might not be accessible by any of the configured Template Resolvers
at org.thymeleaf.TemplateRepository.getTemplate(TemplateRepository.java:246) ~[thymeleaf-2.1.5.RELEASE.jar:2.1.5.RELEASE]
at org.thymeleaf.TemplateEngine.process(TemplateEngine.java:1104) ~[thymeleaf-2.1.5.RELEASE.jar:2.1.5.RELEASE]
at org.thymeleaf.TemplateEngine.process(TemplateEngine.java:1060) ~[thymeleaf-2.1.5.RELEASE.jar:2.1.5.RELEASE]

如果ThymeleafViewResolver  不能处理，当然， 是看不到这个错误的。 也就是说， 我们可以同时使用 ThymeleafViewResolver ， 和 JspxxViewResolver， 即同时使用 thymeleaf 模板和 jsp 页面试图技术。 但是他们有个先后顺序。

关于thymeleaf 的语法， 这里不在赘述，请参见：

http://www.cnblogs.com/nuoyiamy/p/5591559.html