10年 Java程序员,硬核人生!勇往直前,永不退缩!

欢迎围观我的git:https://github.com/R1310328554/spring_security_learn 寻找志同道合的有志于研究技术的朋友,关注本人微信公众号: 觉醒的码农,或Q群 165874185

  博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

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 

 

posted on 2017-12-08 21:36  CanntBelieve  阅读(3748)  评论(0编辑  收藏  举报