摘要：系列教程接近完工，最近進(jìn)入修修補(bǔ)補(bǔ)階段。但是這里的自動(dòng)化配置只做了模板位置檢查，其他配置則是在導(dǎo)入的配置中完成的。表示當(dāng)前配置在存在和時(shí)才會(huì)生效。是的一些基本配置，例如等則是視圖解析器的基本配置，包含了等屬性?，F(xiàn)在，這些配置由幫我們完成了。

Spring Boot2 系列教程接近完工，最近進(jìn)入修修補(bǔ)補(bǔ)階段。Freemarker 整合貌似還沒和大家聊過，因此今天把這個(gè)補(bǔ)充上。

已經(jīng)完工的 Spring Boot2 教程，大家可以參考這里：

干貨|最新版 Spring Boot2.1.5 教程+案例合集

這是一個(gè)相當(dāng)老牌的開源的免費(fèi)的模版引擎。通過 Freemarker 模版，我們可以將數(shù)據(jù)渲染成 HTML 網(wǎng)頁、電子郵件、配置文件以及源代碼等。Freemarker 不是面向最終用戶的，而是一個(gè) Java 類庫，我們可以將之作為一個(gè)普通的組件嵌入到我們的產(chǎn)品中。

來看一張來自 Freemarker 官網(wǎng)的圖片：

可以看到，F(xiàn)reemarker 可以將模版和數(shù)據(jù)渲染成 HTML 。

Freemarker 模版后綴為 .ftl(FreeMarker Template Language)。FTL 是一種簡(jiǎn)單的、專用的語言，它不是像 Java 那樣成熟的編程語言。在模板中，你可以專注于如何展現(xiàn)數(shù)據(jù)， 而在模板之外可以專注于要展示什么數(shù)據(jù)。

好了，這是一個(gè)簡(jiǎn)單的介紹，接下來我們來看看 Freemarker 和 Spring Boot 的一個(gè)整合操作。

在 SSM 中整合 Freemarker ，所有的配置文件加起來，前前后后大約在 50 行左右，Spring Boot 中要幾行配置呢？ 0 行！

首先創(chuàng)建一個(gè) Spring Boot 工程，引入 Freemarker 依賴，如下圖：

    org.springframework.boot
    spring-boot-starter-freemarker


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

工程創(chuàng)建完成后，在 org.springframework.boot.autoconfigure.freemarker.FreeMarkerAutoConfiguration 類中，可以看到關(guān)于 Freemarker 的自動(dòng)化配置：

@Configuration
@ConditionalOnClass({ freemarker.template.Configuration.class, FreeMarkerConfigurationFactory.class })
@EnableConfigurationProperties(FreeMarkerProperties.class)
@Import({ FreeMarkerServletWebConfiguration.class, FreeMarkerReactiveWebConfiguration.class,
                FreeMarkerNonWebConfiguration.class })
public class FreeMarkerAutoConfiguration {
}

從這里可以看出，當(dāng) classpath 下存在 freemarker.template.Configuration 以及 FreeMarkerConfigurationFactory 時(shí)，配置才會(huì)生效，也就是說當(dāng)我們引入了 Freemarker 之后，配置就會(huì)生效。但是這里的自動(dòng)化配置只做了模板位置檢查，其他配置則是在導(dǎo)入的 FreeMarkerServletWebConfiguration 配置中完成的。那么我們?cè)賮砜纯?FreeMarkerServletWebConfiguration 類，部分源碼如下：

@Configuration
@ConditionalOnWebApplication(type = ConditionalOnWebApplication.Type.SERVLET)
@ConditionalOnClass({ Servlet.class, FreeMarkerConfigurer.class })
@AutoConfigureAfter(WebMvcAutoConfiguration.class)
class FreeMarkerServletWebConfiguration extends AbstractFreeMarkerConfiguration {
        protected FreeMarkerServletWebConfiguration(FreeMarkerProperties properties) {
                super(properties);
        }
        @Bean
        @ConditionalOnMissingBean(FreeMarkerConfig.class)
        public FreeMarkerConfigurer freeMarkerConfigurer() {
                FreeMarkerConfigurer configurer = new FreeMarkerConfigurer();
                applyProperties(configurer);
                return configurer;
        }
        @Bean
        @ConditionalOnMissingBean(name = "freeMarkerViewResolver")
        @ConditionalOnProperty(name = "spring.freemarker.enabled", matchIfMissing = true)
        public FreeMarkerViewResolver freeMarkerViewResolver() {
                FreeMarkerViewResolver resolver = new FreeMarkerViewResolver();
                getProperties().applyToMvcViewResolver(resolver);
                return resolver;
        }
}

我們來簡(jiǎn)單看下這段源碼：

@ConditionalOnWebApplication 表示當(dāng)前配置在 web 環(huán)境下才會(huì)生效。

ConditionalOnClass 表示當(dāng)前配置在存在 Servlet 和 FreeMarkerConfigurer 時(shí)才會(huì)生效。

@AutoConfigureAfter 表示當(dāng)前自動(dòng)化配置在 WebMvcAutoConfiguration 之后完成。

代碼中，主要提供了 FreeMarkerConfigurer 和 FreeMarkerViewResolver。

FreeMarkerConfigurer 是 Freemarker 的一些基本配置，例如 templateLoaderPath、defaultEncoding 等

FreeMarkerViewResolver 則是視圖解析器的基本配置，包含了viewClass、suffix、allowRequestOverride、allowSessionOverride 等屬性。

另外還有一點(diǎn)，在這個(gè)類的構(gòu)造方法中，注入了 FreeMarkerProperties：

@ConfigurationProperties(prefix = "spring.freemarker")
public class FreeMarkerProperties extends AbstractTemplateViewResolverProperties {
        public static final String DEFAULT_TEMPLATE_LOADER_PATH = "classpath:/templates/";
        public static final String DEFAULT_PREFIX = "";
        public static final String DEFAULT_SUFFIX = ".ftl";
        /**
         * Well-known FreeMarker keys which are passed to FreeMarker"s Configuration.
         */
        private Map settings = new HashMap<>();
}

FreeMarkerProperties 中則配置了 Freemarker 的基本信息，例如模板位置在 classpath:/templates/ ，再例如模板后綴為 .ftl，那么這些配置我們以后都可以在 application.properties 中進(jìn)行修改。

如果我們?cè)?SSM 的 XML 文件中自己配置 Freemarker ，也不過就是配置這些東西?，F(xiàn)在，這些配置由 FreeMarkerServletWebConfiguration? 幫我們完成了。

首先我們來創(chuàng)建一個(gè) User 類，如下：

public class User {
    private Long id;
    private String username;
    private String address;
    //省略 getter/setter
}

再來創(chuàng)建 UserController：

@Controller
public class UserController {
    @GetMapping("/index")
    public String index(Model model) {
        List users = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            User user = new User();
            user.setId((long) i);
            user.setUsername("javaboy>>>>" + i);
            user.setAddress("www.javaboy.org>>>>" + i);
            users.add(user);
        }
        model.addAttribute("users", users);
        return "index";
    }
}

最后在 freemarker 中渲染數(shù)據(jù)：

    
    



    <#list users as user>
        

    

        
用戶編號(hào)
        
用戶名稱
        
用戶地址
    

            
${user.id}
            
${user.username}
            
${user.address}
        
    

運(yùn)行效果如下：

如果我們要修改模版文件位置等，可以在 application.properties 中進(jìn)行配置：

spring.freemarker.allow-request-override=false
spring.freemarker.allow-session-override=false
spring.freemarker.cache=false
spring.freemarker.charset=UTF-8
spring.freemarker.check-template-location=true
spring.freemarker.content-type=text/html
spring.freemarker.expose-request-attributes=false
spring.freemarker.expose-session-attributes=false
spring.freemarker.suffix=.ftl
spring.freemarker.template-loader-path=classpath:/templates/

配置文件按照順序依次解釋如下：

HttpServletRequest的屬性是否可以覆蓋controller中model的同名項(xiàng)

HttpSession的屬性是否可以覆蓋controller中model的同名項(xiàng)

是否開啟緩存

模板文件編碼

是否檢查模板位置

Content-Type的值

是否將HttpServletRequest中的屬性添加到Model中

是否將HttpSession中的屬性添加到Model中

模板文件后綴

模板文件位置

好了，整合完成之后，F(xiàn)reemarker 的更多用法，就和在 SSM 中使用 Freemarker 一樣了，這里我就不再贅述。

本文和大家簡(jiǎn)單聊一聊 Spring Boot 整合 Freemarker，算是對(duì) Spring Boot2 教程的一個(gè)補(bǔ)充（后面還會(huì)有一些補(bǔ)充），有問題歡迎留言討論。

本項(xiàng)目案例，我已經(jīng)上傳到 GitHub 上，歡迎大家 star：https://github.com/lenve/javaboy-code-samples

關(guān)注公眾號(hào)【江南一點(diǎn)雨】，專注于 Spring Boot+微服務(wù)以及前后端分離等全棧技術(shù)，定期視頻教程分享，關(guān)注后回復(fù) Java ，領(lǐng)取松哥為你精心準(zhǔn)備的 Java 干貨！