Thymeleaf 主題商店

本指南的這一章和后續(xù)章節(jié)中顯示的示例的源代碼可以在 Good Thymes Virtual Grocery GitHub 存儲庫中找到。

1. 網(wǎng)上商店

為了更好地解釋使用 Thymeleaf 處理模板所涉及的概念mq翻譯主題模板中的代碼，本教程將使用可從項目網(wǎng)站下載的演示應用程序。

這個應用程序是一個虛構的虛擬雜貨網(wǎng)站，將為我們提供許多場景來展示 Thymeleaf 的許多功能。

首先，我們的應用程序需要一組簡單的模型實體：通過創(chuàng)建產(chǎn)品進行銷售。我們還將管理這些：CustomersOrdersCommentsProducts。

我們的應用程序還有一個非常簡單的服務層，由包含以下方法的 Service 對象組成：

public class ProductService {    ...    public List findAll() {        return ProductRepository.getInstance().findAll();    }    public Product findById(Integer id) {        return ProductRepository.getInstance().findById(id);    }}

在 web 層，我們的應用程序將有一個過濾器，它將根據(jù)請求 URL 將執(zhí)行委托給啟用了 Thymeleaf 的命令：

private boolean process(HttpServletRequest request, HttpServletResponse response)        throws ServletException {    try {        // This prevents triggering engine executions for resource URLs        if (request.getRequestURI().startsWith("/css") ||                request.getRequestURI().startsWith("/images") ||                request.getRequestURI().startsWith("/favicon")) {            return false;        }        /*         * Query controller/URL mapping and obtain the controller         * that will process the request. If no controller is available,         * return false and let other filters/servlets process the request.         */        IGTVGController controller = this.application.resolveControllerForRequest(request);        if (controller == null) {            return false;        }        /*         * Obtain the TemplateEngine instance.         */        ITemplateEngine templateEngine = this.application.getTemplateEngine();        /*         * Write the response headers         */        response.setContentType("text/html;charset=UTF-8");        response.setHeader("Pragma", "no-cache");        response.setHeader("Cache-Control", "no-cache");        response.setDateHeader("Expires", 0);        /*         * Execute the controller and process view template,         * writing the results to the response writer.         */        controller.process(                request, response, this.servletContext, templateEngine);        return true;    } catch (Exception e) {        try {            response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);        } catch (final IOException ignored) {            // Just ignore this        }        throw new ServletException(e);    }}

這是我們的 IGTVGController 接口：

public interface IGTVGController {    public void process(            HttpServletRequest request, HttpServletResponse response,            ServletContext servletContext, ITemplateEngine templateEngine);    }

我們現(xiàn)在要做的就是創(chuàng)建 IGTVGController 接口的實現(xiàn)，從服務中檢索數(shù)據(jù)并使用 ITemplateEngine 對象來處理模板。

但首先讓我們看看模板引擎是如何初始化的。

2. 創(chuàng)建和配置模板引擎

我們過濾器中的 process(...) 方法包含以下幾行：

ITemplateEngine templateEngine = this.application.getTemplateEngine();

這意味著 GTVGApplication 類負責創(chuàng)建和配置 Thymeleaf 應用程序中*重要的對象之一：TemplateEngine 實例（ITemplateEngine 接口的實現(xiàn)）。

我們的 org.thymeleaf.TemplateEngine 對象初始化如下：

public class GTVGApplication {    ...    private final TemplateEngine templateEngine;    ...    public GTVGApplication(final ServletContext servletContext) {        super();        ServletContextTemplateResolver templateResolver =                new ServletContextTemplateResolver(servletContext);        // HTML is the default mode, but we set it anyway for better understanding of code        templateResolver.setTemplateMode(TemplateMode.HTML);        // This will convert "home" to "/WEB-INF/templates/home.html"        templateResolver.setPrefix("/WEB-INF/templates/");        templateResolver.setSuffix(".html");        // Template cache TTL=1h. If not set, entries would be cached until expelled        templateResolver.setCacheTTLMs(Long.valueOf(3600000L));        // Cache is set to true by default. Set to false if you want templates to        // be automatically updated when modified.        templateResolver.setCacheable(true);        this.templateEngine = new TemplateEngine();        this.templateEngine.setTemplateResolver(templateResolver);        ...    }}

有很多方法可以配置 TemplateEngine 對象，但是現(xiàn)在這幾行代碼足以告訴我們所需的步驟。

3. 模板解析器

讓我們從模板解析器開始：

ServletContextTemplateResolver templateResolver =        new ServletContextTemplateResolver(servletContext);

模板解析器是一個實現(xiàn) Thymeleaf API 接口的對象，名為 org.thymeleaf.templateresolver.ITemplateResolver：

public interface ITemplateResolver {    ...    /*     * Templates are resolved by their name (or content) and also (optionally) their     * owner template in case we are trying to resolve a fragment for another template.     * Will return null if template cannot be handled by this template resolver.     */    public TemplateResolution resolveTemplate(            final IEngineConfiguration configuration,            final String ownerTemplate, final String template,            final Map templateResolutionAttributes);}

這些對象負責確定如何訪問模板。在這個 GTVG 應用程序 org.thymeleaf.templateresolver.ServletContextTemplateResolver 中，我們將從 Servlet 上下文中檢索模板文件作為資源： javax.servlet.ServletContext 存在于每個 Java Web 應用程序中 應用程序范圍的對象和資源是從 Web 應用程序根解析的.

但這并不是我們可以說的模板解析器的全部，因為我們可以在其上設置一些配置參數(shù)。一、模板模式：

templateResolver.setTemplateMode(TemplateMode.HTML);

HTML 是默認模板模式 ServletContextTemplateResolver，但*好構建它，以便我們的代碼清楚地記錄正在發(fā)生的事情。

templateResolver.setPrefix("/WEB-INF/templates/");templateResolver.setSuffix(".html");

修改前綴和后綴，我們將模板名稱傳遞給引擎，以獲取真正要使用的資源名稱。

使用此配置，模板名稱“產(chǎn)品/列表”將對應于：

servletContext.getResourceAsStream("/WEB-INF/templates/product/list.html")

（可選）在模板解析器中通過 cacheTTLMs 屬性配置解析模板可以在緩存中存活的時間量：

templateResolver.setCacheTTLMs(3600000L);

如果達到*大緩存大小并且它是當前緩存中*舊的條目，則在達到 TTL 之前，模板仍然可以從緩存中排除。

用戶可以通過實現(xiàn) ICacheManager 接口或修改 StandardCacheManager 對象來定義緩存行為和大小來管理默認緩存。

關于模板解析器還有很多需要學習，但現(xiàn)在讓我們看看模板引擎對象的創(chuàng)建。

4. 模板引擎

模板引擎對象是 org.thymeleaf.ITemplateEngine 接口的實現(xiàn)。其中一個實現(xiàn)由 Thymeleaf 核心提供：org.thymeleaf.TemplateEngine 我們在這里創(chuàng)建一個實例：

templateEngine = new TemplateEngine();templateEngine.setTemplateResolver(templateResolver);

很簡單mq翻譯主題模板中的代碼，不是嗎？我們所需要的只是創(chuàng)建一個實例并將模板解析器設置為它。

模板解析器是唯一需要的參數(shù)TemplateEngine，雖然很多其他參數(shù)（消息解析器、緩存大小等）會在后面介紹。現(xiàn)在這就是我們所需要的。

我們的模板引擎現(xiàn)已準備就緒，我們可以使用 Thymeleaf 開始創(chuàng)建頁面。

下一節(jié)：Thymeleaf 文字 Thymeleaf 教程

1. 多語言文本 我們的第一個任務是為我們的雜貨網(wǎng)站創(chuàng)建一個主頁。這個頁面的第一個版本非常簡單：只有標題和歡迎信息。這是我們的 /WEB-INF/templates/home.html 文件：