thymeleaf手動渲染@{}的問題與解決

一、簡介

最近寫了一個專案，然後想利用TemplateEngine實現thymeleaf的手動渲染，將生成的html頁面加入Redis快取，提高專案訪問速度。

二、SpringBoot 1.x實現

以前使用的maven版本如下所示：

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>1.5.9.RELEASE</version>
  </parent>
    <!-- SpringMVC -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- thymeleaf -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency>

可以看出是springboot1.x版本。

附上該版本thymeleaf手動渲染的實現。

    @RequestMapping(value = "/to_list", produces = "text/html")
    @ResponseBody
    public String toGoods(Model model, MiaoshaUser user,
                          final HttpServletRequest request,
                          final HttpServletResponse response) {

        //取快取
        String html;
        html = redisService.get(GoodsKey.getGoodsList(), "", String.class);
        if (html != null) {//如果快取有這個頁面
            return html;
        } else {//如果沒有這個頁面
            //訪問資料庫獲取商品資料
            List<GoodsVo> goodsList = goodsService.listGoodsVo();
            if (user != null) {
                //如果有使用者資訊，則儲存在Model中
                model.addAttribute("user", user);
            }
            //將商品資料儲存在Model中
            model.addAttribute("goodsList", goodsList);

            //手動渲染
            SpringWebContext springWebContext = new SpringWebContext(request, response, request.getServletContext(), request.getLocale(), model.asMap(), context);
            html = viewResolver.getTemplateEngine().process("goods_list", springWebContext);
            if (!StringUtils.isEmpty(html)) {
                //儲存到快取
                redisService.set(GoodsKey.getGoodsList(), "", html);
            }
            //返回到瀏覽器
            return html;
        }

    }

需要依賴兩個類：ThymeleafViewResolver以及ApplicationContext

這兩個類都可以通過Spring容器注入進去，如下所示：

@Autowired
private ThymeleafViewResolver viewResolver;

@Autowired
private ApplicationContext context;

將上面手動渲染流程程式碼抽離出來，使用模版如下：

//首先建立一個上下文容器，context是Spring的ApplicationContext
SpringWebContext springWebContext = new SpringWebContext(request, response, request.getServletContext(), request.getLocale(), model.asMap(), context);

//獲取模版引擎，進行使用process方法解析
//第一個引數"goods_list"指需要解析的thymeleaf模版，一般在template目錄下
//第二個引數就是上下文容器
html = viewResolver.getTemplateEngine().process("goods_list", springWebContext);
if (!StringUtils.isEmpty(html)) {
    //儲存到快取
    redisService.set(GoodsKey.getGoodsList(), "", html);
}
//返回到瀏覽器
return html;

三、Springboot 2.x實現

pom.xml如下所示：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.1.17.RELEASE</version>
</parent>

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

首先如果直接使用上面的方式，會發現找不到SpringWebContext這個類，這個類是Spring4下的，在Spring5如移除掉了。

那麼我們可以使用其他的類進行代替。

1. 第一個是Context

這個是很多博主使用的方式，我最初也採用了這種，這種文章比較多，博主就不再演示了。

當頁面在渲染@{}標籤時，就會報錯，如下所示：

Caused by: org.attoparser.ParseException: Link base “/css/global.css” cannot be context relative (/…) unless the context used for executing the engine implements the org.thymeleaf.context.IWebContext interface (template: “/mail/activation” - line 6, col 25)

Caused by: org.thymeleaf.exceptions.TemplateProcessingException: Link base “/css/global.css” cannot be context relative (/…) unless the context used for executing the engine implements the org.thymeleaf.context.IWebContext interface (template: “/mail/activation” - line 6, col 25)

這個是因為沒有使用IWebContext 的介面容器所導致

2. 第二個是WebContext類

使用方式如下：

IWebContext webContext = new WebContext(request,response,request.getServletContext(),response.getLocale(),model.asMap());
String cacheHtml = templateEngine.process("/index", webContext);

此時就不會報錯，相比Spring4或者Springboot1.x而言，剔除了ApplicationContext 過多的依賴，現在thymeleaf渲染不再過多依賴spring容器