93.Spring Boot使用模板freemarker【从零开始学Spring Boot】

林祥纤

浏览: 3878333 次

最近访客更多访客>>

longquanhewei

淡夏的斌

Darrenda

jandroid

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

从零开始学Spring Boot

spring boot 从零开始学Spring Boot

【原创文章，转载请注明出处】

103. Spring Boot Freemarker特别篇之contextPath【从零开始学Spring Boot】

最近有好久没有更新博客了，感谢小伙伴的默默支持，不知道是谁又打赏了我一个小红包，谢谢。

今天我们讲讲怎么在Spring Boot中使用模板引擎freemarker，先看看今天的大纲：

写道

(1) freemarker介绍；
(2) 新建spring-boot-freemarker工程；
(3) 在pom.xml引入相关依赖；
(4) 编写启动类；
(5) 编写模板文件hello.ftl;
(6) 编写访问类HelloController;
(7) 测试；
(8) freemarker配置；
(9) freemarker常用语法；
(10) freemarker layout 布局

(1) freemarker介绍；

FreeMarker是一款模板引擎：即一种基于模板和要改变的数据，并用来生成输出文本（HTML网页、电子邮件、配置文件、源代码等）的通用工具。它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。

(2) 新建spring-boot-freeMarker工程；

我们新建一个maven工程，取名为：spring-boot-freemarker

(3) 在pom.xml引入相关依赖；

这里使用freeMarker需要引入相关依赖包：spring-boot-starter-freemarker，

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
 
  <groupId>com.kfit</groupId>
  <artifactId>spring-boot-velocity</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>jar</packaging>
 
  <name>spring-boot-velocity</name>
  <url>http://maven.apache.org</url>
 
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <!-- jdk版本号，angel在这里使用1.8，大家修改为大家本地配置的jdk版本号即可 -->
    <java.version>1.8</java.version>
  </properties>
 
    <!--
       spring boot 父节点依赖,
       引入这个之后相关的引入就不需要添加version配置，
       spring boot会自动选择最合适的版本进行添加。
     -->
    <parent>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-parent</artifactId>
       <version>1.4.1.RELEASE</version><!-- 1.4.1.RELEASE , 1.3.3.RELEASE-->
    </parent>
 
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <scope>test</scope>
    </dependency>
   
        <!-- spring boot web支持：mvc,aop... -->
    <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
   
    <!-- 引入freeMarker的依赖包. -->
    <dependency>   
        <groupId>org.springframework.boot</groupId>  
        <artifactId>spring-boot-starter-freemarker</artifactId>
    </dependency>
   
  </dependencies>
</project>

(4) 编写启动类；

启动类没有什么特别之处，不过多介绍，请看代码：

package com.kfit;
 
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
 
/**
 *
 * @author Angel --守护天使
 * @version v.0.1
 * @date 2016年10月4日
 */
@SpringBootApplication
public class App {
    publicstaticvoid main(String[] args) {
       SpringApplication.run(App.class, args);
    }
}

(5) 编写模板文件hello.ftl;

编写一个hello.ftl文件，此文件的路径在src/main/resources/templates下，其中hello.ftl文件的内容如下：

<html> 
<body> 
    welcome ${name}  to freemarker!
</body> 
</html>

(6) 编写访问类HelloController;

有了模板文件之后，我们需要有个Controller控制类，能够访问到hello.ftl文件，这里也很简单，具体看如下代码：

package com.kfit.demo.web;
 
import java.util.Map;
 
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
 
/**
 * 测试velocity;
 * @author Angel --守护天使
 * @version v.0.1
 * @date 2016年10月4日
 */
@Controller
public class HelloController {
   
    @RequestMapping("/hello")
    public String hello(Map<String,Object> map){
       map.put("name", "[Angel -- 守护天使]");
       return "hello";
    }
   
}

(7) 测试；

好了，到这里，我们就可以启动我们的程序进行测试了，访问地址：

http://127.0.0.1:8080/hello ，如果你在浏览器中看到如下信息：

welcome [Angel -- 守护天使] to freemarker!

那么说明你的demo ok 了。

(8) freemarker配置；

在spring boot的application.properties属性文件中为freemarker提供了一些常用的配置,如下：

########################################################

###FREEMARKER (FreeMarkerAutoConfiguration)

########################################################

spring.freemarker.allow-request-override=false

spring.freemarker.cache=true

spring.freemarker.check-template-location=true

spring.freemarker.charset=UTF-8

spring.freemarker.content-type=text/html

spring.freemarker.expose-request-attributes=false

spring.freemarker.expose-session-attributes=false

spring.freemarker.expose-spring-macro-helpers=false

#spring.freemarker.prefix=

#spring.freemarker.request-context-attribute=

#spring.freemarker.settings.*=

#spring.freemarker.suffix=.ftl

#spring.freemarker.template-loader-path=classpath:/templates/ #comma-separated list

#spring.freemarker.view-names= # whitelist of view names that can be resolved

(9) freemarker常用语法；

freemarker的语法并不是本节的重点，这里还是简单的介绍下几个常用的if else,list；

首先我们改造下HelloController的hello方法

@RequestMapping("/hello")
   public String hello(Map<String,Object> map){
       map.put("name", "[Angel -- 守护天使]");
       map.put("gender",1);//gender:性别，1：男；0：女；
      
       List<Map<String,Object>> friends =new ArrayList<Map<String,Object>>();
       Map<String,Object> friend = new HashMap<String,Object>();
       friend.put("name", "张三");
       friend.put("age", 20);
       friends.add(friend);
       friend = new HashMap<String,Object>();
       friend.put("name", "李四");
       friend.put("age", 22);
       friends.add(friend);
       map.put("friends", friends);
       return "hello";
    }

这里我们返回了gender和friends的列表；

接下来我们看看怎么在freemarker进行展示呢?

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"
      xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3">
    <head>
        <title>Hello World!</title>
    </head>
    <body>
       <p>
           welcome ${name}  to freemarker!
       </p>      
      
      
       <p>性别：
           <#if gender==0>
              女
           <#elseif gender==1>
              男
           <#else>
              保密   
           </#if>
        </p>
      
      
       <h4>我的好友：</h4>
       <#list friends as item>
           姓名：${item.name} , 年龄${item.age}
           <br>
       </#list>
      
    </body>
</html>

(10) freemarker layout

freemarker layout主要处理具有相同内容的页面，比如每个网站的header和footer页面。

freemarker 的布局主要常见的两种方式是#import(“文件路径”)和#include(“文件路径”)，其中import和include的区别在于，include常用于公共部分的页面，如果要使用<#assign username=“张三”>涉及到内部函数以及变量声明之类的，使用import进行导入，如果在import中的页面含有页面当前将不会进行渲染。我们编写一个header和footer，其中的header使用include引入，footer页面也使用include引入。（当然freemarker 还有别的布局方式，这里只是介绍一种，请自行学习研究）

header.ftl内容：

<header>
    This is a header,welcome  ${name} to my web site!
</header>
<hr>

footer.ftl内容：

<hr>
<footer>
    This is a footer,welcome  ${name} to my web site!
</footer>

修改hello.ftl：

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"
      xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3">
    <head>
        <title>Hello World!</title>
    </head>
    <body>
   
        <#include "/header.ftl" >
       
       <p>
           welcome ${name}  to freemarker!
       </p>      
      
      
       <p>性别：
           <#if gender==0>
              女
           <#elseif gender==1>
              男
           <#else>
              保密   
           </#if>
        </p>
      
      
       <h4>我的好友：</h4>
       <#list friends as item>
           姓名：${item.name} , 年龄${item.age}
           <br>
       </#list>
      
      
       <#include "/footer.ftl" >
    </body>
</html>

到这里就ok了，我们访问/hello页面，应该会看到如下图的效果：

103. Spring Boot Freemarker特别篇之contextPath【从零开始学Spring Boot】

à悟空学院：https://t.cn/Rg3fKJD

学院中有Spring Boot相关的课程！点击「阅读原文」进行查看！

SpringBoot视频：http://t.cn/A6ZagYTi

Spring Cloud视频：http://t.cn/A6ZagxSR

SpringBoot Shiro视频：http://t.cn/A6Zag7IV

SpringBoot交流平台：https://t.cn/R3QDhU0

SpringData和JPA视频：http://t.cn/A6Zad1OH

SpringSecurity5.0视频：http://t.cn/A6ZadMBe

Sharding-JDBC分库分表实战：http://t.cn/A6ZarrqS

分布式事务解决方案「手写代码」：http://t.cn/A6ZaBnIr

查看图片附件

分享到：

94.Spring Boot集成Jersey【从零开始学Spri ... | 92.Spring Boot使用模板velocity【从零开始 ...

2016-11-03 23:49
浏览 52866
评论(4)
分类:编程语言
查看更多

4 楼林祥纤 2017-08-20

ezlhq 写道

大佬，你pom.xml里面那个Maven 依赖貌似写错了

应该写成 "<artifactId>spring-boot-starter-freemarker</artifactId>" 你那个 "freemarker" 写成 "freeMarker",我找了半天。。。

感谢指出，已经修复！

3 楼 ezlhq 2017-08-20

大佬，你pom.xml里面那个Maven 依赖貌似写错了

应该写成 "<artifactId>spring-boot-starter-freemarker</artifactId>" 你那个 "freemarker" 写成 "freeMarker",我找了半天。。。

2 楼林祥纤 2016-11-04

dyj025 写道

支持作者,坚持不懈的,更新中.....精神,赞赞 ......

谢谢.

1 楼 dyj025 2016-11-04

支持作者,坚持不懈的,更新中.....精神,赞赞 ......

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论