這篇文章主要講解了“如何使用Spring Boot+Thymeleaf技術(shù)”，文中的講解內(nèi)容簡單清晰，易于學(xué)習(xí)與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學(xué)習(xí)“如何使用Spring Boot+Thymeleaf技術(shù)”吧！

成都一家集口碑和實力的網(wǎng)站建設(shè)服務(wù)商，擁有專業(yè)的企業(yè)建站團隊和靠譜的建站技術(shù)，十余年企業(yè)及個人網(wǎng)站建設(shè)經(jīng)驗 ,為成都上千客戶提供網(wǎng)頁設(shè)計制作,網(wǎng)站開發(fā),企業(yè)網(wǎng)站制作建設(shè)等服務(wù),包括成都營銷型網(wǎng)站建設(shè)，品牌網(wǎng)站制作，同時也為不同行業(yè)的客戶提供成都網(wǎng)站設(shè)計、做網(wǎng)站的服務(wù),包括成都電商型網(wǎng)站制作建設(shè),裝修行業(yè)網(wǎng)站制作建設(shè)，傳統(tǒng)機械行業(yè)網(wǎng)站建設(shè),傳統(tǒng)農(nóng)業(yè)行業(yè)網(wǎng)站制作建設(shè)。在成都做網(wǎng)站,選網(wǎng)站制作建設(shè)服務(wù)商就選創(chuàng)新互聯(lián)。

1. Thymeleaf 簡介

Thymeleaf 是新一代 Java 模板引擎，它類似于 Velocity、FreeMarker 等傳統(tǒng) Java 模板引擎，但是與傳統(tǒng) Java 模板引擎不同的是，Thymeleaf 支持 HTML 原型。

它既可以讓前端工程師在瀏覽器中直接打開查看樣式，也可以讓后端工程師結(jié)合真實數(shù)據(jù)查看顯示效果，同時，SpringBoot 提供了 Thymeleaf 自動化配置解決方案，因此在 SpringBoot 中使用 Thymeleaf 非常方便。

事實上， Thymeleaf 除了展示基本的 HTML ，進行頁面渲染之外，也可以作為一個 HTML 片段進行渲染，例如我們在做郵件發(fā)送時，可以使用 Thymeleaf 作為郵件發(fā)送模板。

另外，由于 Thymeleaf 模板后綴為 .html，可以直接被瀏覽器打開，因此，預(yù)覽時非常方便。

2. 整合 Spring Boot

2.1 基本用法

Spring Boot 中整合 Thymeleaf 非常容易，只需要創(chuàng)建項目時添加 Thymeleaf 即可：

創(chuàng)建完成后，pom.xml 依賴如下：

    org.springframework.boot
    spring-boot-starter-thymeleaf


    org.springframework.boot
    spring-boot-starter-web

當然，Thymeleaf 不僅僅能在 Spring Boot 中使用，也可以使用在其他地方，只不過 Spring Boot 針對 Thymeleaf 提供了一整套的自動化配置方案，這一套配置類的屬性在 org.springframework.boot.autoconfigure.thymeleaf.ThymeleafProperties 中，部分源碼如下：

@ConfigurationProperties(prefix = "spring.thymeleaf")
public class ThymeleafProperties {
        private static final Charset DEFAULT_ENCODING = StandardCharsets.UTF_8;
        public static final String DEFAULT_PREFIX = "classpath:/templates/";
        public static final String DEFAULT_SUFFIX = ".html";
        private boolean checkTemplate = true;
        private boolean checkTemplateLocation = true;
        private String prefix = DEFAULT_PREFIX;
        private String suffix = DEFAULT_SUFFIX;
        private String mode = "HTML";
        private Charset encoding = DEFAULT_ENCODING;
        private boolean cache = true;
        //...
}

1. 首先通過 @ConfigurationProperties 注解，將 application.properties 前綴為 spring.thymeleaf 的配置和這個類中的屬性綁定。

2. 前三個 static 變量定義了默認的編碼格式、視圖解析器的前綴、后綴等。

3. 從前三行配置中，可以看出來，Thymeleaf 模板的默認位置在 resources/templates 目錄下，默認的后綴是 html 。

4. 這些配置，如果開發(fā)者不自己提供，則使用 默認的，如果自己提供，則在 application.properties 中以 spring.thymeleaf 開始相關(guān)的配置。

而我們剛剛提到的，Spring Boot 為 Thymeleaf 提供的自動化配置類，則是 org.springframework.boot.autoconfigure.thymeleaf.ThymeleafAutoConfiguration ，部分源碼如下：

@Configuration
@EnableConfigurationProperties(ThymeleafProperties.class)
@ConditionalOnClass({ TemplateMode.class, SpringTemplateEngine.class })
@AutoConfigureAfter({ WebMvcAutoConfiguration.class, WebFluxAutoConfiguration.class })
public class ThymeleafAutoConfiguration {
}

可以看到，在這個自動化配置類中，首先導(dǎo)入 ThymeleafProperties ，然后 @ConditionalOnClass 注解表示當當前系統(tǒng)中存在 TemplateMode 和 SpringTemplateEngine 類時，當前的自動化配置類才會生效，即只要項目中引入了 Thymeleaf 相關(guān)的依賴，這個配置就會生效。

這些默認的配置我們幾乎不需要做任何更改就可以直接使用了。如果開發(fā)者有特殊需求，則可以在 application.properties 中配置以 spring.thymeleaf 開頭的屬性即可。

接下來我們就可以創(chuàng)建 Controller 了，實際上引入 Thymeleaf 依賴之后，我們可以不做任何配置。新建的 IndexController 如下：

@Controller
public class IndexController {
    @GetMapping("/index")
    public String index(Model model) {
        List users = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            User u = new User();
            u.setId((long) i);
            u.setName("javaboy:" + i);
            u.setAddress("深圳:" + i);
            users.add(u);
        }
        model.addAttribute("users", users);
        return "index";
    }
}
public class User {
    private Long id;
    private String name;
    private String address;
    //省略 getter/setter
}

在 IndexController 中返回邏輯視圖名+數(shù)據(jù)，邏輯視圖名為 index ，意思我們需要在 resources/templates 目錄下提供一個名為 index.html 的 Thymeleaf 模板文件。

• 創(chuàng)建 Thymeleaf

    



    
        編號
        用戶名
        地址
    
    
        
        
        
    

在 Thymeleaf 中，通過 th:each 指令來遍歷一個集合，數(shù)據(jù)的展示通過 th:text 指令來實現(xiàn)，

注意 index.html 最上面引入 thymeleaf 名稱空間（最新版并無強制要求）。

配置完成后，就可以啟動項目了，訪問 /index 接口，就能看到集合中的數(shù)據(jù)了：

2.2 手動渲染

前面我們說的是返回一個 Thymeleaf 模板，我們也可以手動渲染 Thymeleaf 模板，這個一般在郵件發(fā)送時候有用，例如我在 resources/templates 目錄下新建一個郵件模板，如下：

    


hello 歡迎 加入 XXX 集團，您的入職信息如下：

    
        職位
        
    
    
        薪水
        
    

這一個 HTML 模板中，有幾個變量，我們要將這個 HTML 模板渲染成一個 String 字符串，再把這個字符串通過郵件發(fā)送出去，那么如何手動渲染呢？

@Autowired
TemplateEngine templateEngine;
@Test
public void test1() throws MessagingException {
    Context context = new Context();
    context.setVariable("username", "javaboy");
    context.setVariable("position", "Java工程師");
    context.setVariable("salary", 99999);
    String mail = templateEngine.process("mail", context);
    //省略郵件發(fā)送
}

1. 渲染時，我們需要首先注入一個 TemplateEngine 對象，這個對象就是在 Thymeleaf 的自動化配置類中配置的（即當我們引入 Thymeleaf 的依賴之后，這個實例就有了）。

2. 然后構(gòu)造一個 Context 對象用來存放變量。

3. 調(diào)用 process 方法進行渲染，該方法的返回值就是渲染后的 HTML 字符串，然后我們將這個字符串發(fā)送出去。

3. Thymeleaf 細節(jié)

前面兩個案例讓小伙伴們大致上理解了在 Spring Boot 中要如何使用 Thymeleaf，接下來，松哥將詳細介紹 Thymeleaf 本身的一些具體用法。

3.1 標準表達式語法

3.1.1 簡單表達式

${...}

直接使用 th:xx = "${}" 獲取對象屬性。這個在前面的案例中已經(jīng)演示過了，不再贅述。

*{...}

可以像 ${...} 一樣使用，也可以通過 th:object 獲取對象，然后使用 th:xx = "*{}" 獲取對象屬性，這種簡寫風(fēng)格極為清爽，推薦大家在實際項目中使用。

    用戶名
    


    地址
    

#{...}

通常的國際化屬性：#{...} 用于獲取國際化語言翻譯值。

在 resources 目錄下新建兩個文件：messages.properties 和 messages_zh_CN.properties，內(nèi)容如下：

messages.properties：

message = javaboy

messages_zh_CN.properties：

message = 江南一點雨

然后在 thymeleaf 中引用 message，系統(tǒng)會根據(jù)瀏覽器的語言環(huán)境顯示不同的值：