Spring boot整合视图技术（FreeMarker)

一时失言乱红尘 2022-12-01 05:15 174阅读 0赞

FreeMarker是非常古老的引擎，可以用在Web环境或非Web环境下，与Thymeleaf相比，FreeMarker需要经过解析才能够在浏览器中展示出来。FreeMarker不仅可以用来配置HTML页面模板，也可以作为电子邮件模板、配置文件模板及源码模板等。Spring boot整合FreeMarker步骤如下：  
1、创建项目，添加依赖

<dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-freemarker</artifactId>
    ]</dependency>

2、配置FreeMarker  
Spring boot对FreeMarker提供自动化配置类FreeMarkerProProperties

@Component
    @ConfigurationProperties(prefix = "spring.freemarker")
    public class FreeMarkerProProperties 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";
    
        protected FreeMarkerProProperties(String defaultPrefix, String defaultSuffix) { 
            super(defaultPrefix, defaultSuffix);
        }
    }

如上所示，配置模板位置和默认文件后缀是.htl  
还可以在application.properties对这些默认配置进行修改，部分配置如下：

#HTTPServletRequest的属性是否可以覆盖controller中model的网络项
    spring.freemarker.allow-session-override=false
    
    #HttpSession的属性是否可以覆盖controller中model的同名项
    spring.freemarker.allow-request-override=false
    
    #是否开启缓存
    spring.freemarker.cache=false
    
    #模板文件编码
    spring.freemarker.charset=UTF-8
    
    #是否检验模板位置
    spring.freemarker.check-template-location=true
    
    #Content-Type的值
    spring.freemarker.content-type=text/html
    
    #是否将HttpServletRequest中的属性添加到Model中
    spring.freemarker.expose-request-attributes=false
    
    #是否将HttpSession中的属性添加到Model中
    spring.freemarker.expose-session-attributes=false
    
    #模板文件后缀
    spring.freemarker.suffix=.ftl
    
    #模板文件位置
    spring.freemarker.template-loader-path=classpath:/templates/

3、配置控制类

@RestController
    public class BooksController { 
        @GetMapping("/booksFree")
        public ModelAndView books() { 
            List<BookEntity> books = new ArrayList<>();
            BookEntity b1 = new BookEntity();
            b1.setId(3);
            b1.setAuthor("吴承恩");
            b1.setName("西游记");
    
            BookEntity b2 = new BookEntity();
            b2.setId(4);
            b2.setAuthor("施耐庵");
            b2.setName("水浒传");
            books.add(b1);
            books.add(b2);
    
            ModelAndView mv = new ModelAndView();
            mv.addObject("books",books);
            mv.setViewName("books");
            return mv;
        }
    }

4、创建视图  
按照配置文件，在resources/templates目录下创建books.ftl文件，内容如下：

<!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>图书列表</title>
    </head>
    <boby>
        <table border="1">
            <tr>
                <td>图书编号</td>
                <td>图书名称</td>
                <td>图书作者</td>
            </tr>
    <#--        首先判断model中的books不为空且books中有数据，然后进行遍历-->
            <#if books ??&&(books?size>0)>
            <#list books as book>
                <tr>
                    <td>${ book.id}</td>
                    <td>${ book.name}</td>
                    <td>${ book.author}</td>
                </tr>
            </#list>
            </#if>
        </table>
    </boby>
    </html>

5、运行  
在浏览器访问http://localhost:8080/booksFree，如下所示：  
![在这里插入图片描述][20200826091949360.png_pic_center]

[20200826091949360.png_pic_center]: /images/20221123/d3a47e3729d24dce9eee2cd1391eb6cd.png