dep demo attach macro 使用 doctype com 地址 2016年

視頻&交流平臺：

à SpringBoot網易雲課堂視頻

http://study.163.com/course/introduction.htm?courseId=1004329008

à Spring Boot交流平臺

http://412887952-qq-com.iteye.com/blog/2321532

【原創文章，轉載請註明出處】

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，

Xml代碼

1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
2. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
3. <modelVersion>4.0.0</modelVersion>
5. <groupId>com.kfit</groupId>
6. <artifactId>spring-boot-velocity</artifactId>
7. <version>0.0.1-SNAPSHOT</version>
8. <packaging>jar</packaging>
10. <name>spring-boot-velocity</name>
11. <url>http://maven.apache.org</url>
13. <properties>
14. <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
15. <!-- jdk版本號，angel在這裏使用1.8，大家修改為大家本地配置的jdk版本號即可 -->
16. <java.version>1.8</java.version>
17. </properties>
19. <!--
20. spring boot 父節點依賴,
21. 引入這個之後相關的引入就不需要添加version配置，
22. spring boot會自動選擇最合適的版本進行添加。
23. -->
24. <parent>
25. <groupId>org.springframework.boot</groupId>
26. <artifactId>spring-boot-starter-parent</artifactId>
27. <version>1.4.1.RELEASE</version><!-- 1.4.1.RELEASE , 1.3.3.RELEASE-->
28. </parent>
30. <dependencies>
31. <dependency>
32. <groupId>junit</groupId>
33. <artifactId>junit</artifactId>
34. <scope>test</scope>
35. </dependency>
37. <!-- spring boot web支持：mvc,aop... -->
38. <dependency>
39. <groupId>org.springframework.boot</groupId>
40. <artifactId>spring-boot-starter-web</artifactId>
41. </dependency>
43. <!-- 引入freeMarker的依賴包. -->
44. <dependency>
45. <groupId>org.springframework.boot</groupId>
46. <artifactId>spring-boot-starter-freemarker</artifactId>
47. </dependency>
49. </dependencies>
50. </project>

<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) 編寫啟動類；

啟動類沒有什麽特別之處，不過多介紹，請看代碼：

Java代碼

1. package com.kfit;
3. import org.springframework.boot.SpringApplication;
4. import org.springframework.boot.autoconfigure.SpringBootApplication;
6. /**
7. *
8. * @author Angel --守護天使
9. * @version v.0.1
10. * @date 2016年10月4日
11. */
12. @SpringBootApplication
13. public class App {
14. publicstaticvoid main(String[] args) {
15. SpringApplication.run(App.class, args);
16. }
17. }

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

(5) 編寫模板文件hello.ftl;

編寫一個hello.ftl文件，此文件的路徑在src/main/resources/templates下，其中hello.ftl文件的內容如下：

Html代碼

1. <html>
2. <body>
3. welcome ${name} to freemarker!
4. </body>
5. </html>

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

(6) 編寫訪問類HelloController;

有了模板文件之後，我們需要有個Controller控制類，能夠訪問到hello.ftl文件，這裏也很簡單，具體看如下代碼：

Java代碼

1. package com.kfit.demo.web;
3. import java.util.Map;
5. import org.springframework.stereotype.Controller;
6. import org.springframework.web.bind.annotation.RequestMapping;
8. /**
9. * 測試velocity;
10. * @author Angel --守護天使
11. * @version v.0.1
12. * @date 2016年10月4日
13. */
14. @Controller
15. public class HelloController {
17. @RequestMapping("/hello")
18. public String hello(Map<String,Object> map){
19. map.put("name", "[Angel -- 守護天使]");
20. return "hello";
21. }
23. }

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日 */@Controllerpublic 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方法

Java代碼

1. @RequestMapping("/hello")
2. public String hello(Map<String,Object> map){
3. map.put("name", "[Angel -- 守護天使]");
4. map.put("gender",1);//gender:性別，1：男；0：女；
6. List<Map<String,Object>> friends =new ArrayList<Map<String,Object>>();
7. Map<String,Object> friend = new HashMap<String,Object>();
8. friend.put("name", "張三");
9. friend.put("age", 20);
10. friends.add(friend);
11. friend = new HashMap<String,Object>();
12. friend.put("name", "李四");
13. friend.put("age", 22);
14. friends.add(friend);
15. map.put("friends", friends);
16. return "hello";
17. }

@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進行展示呢?

Html代碼

1. <!DOCTYPE html>
2. <html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"
3. xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3">
4. <head>
5. <title>Hello World!</title>
6. </head>
7. <body>
8. <p>
9. welcome ${name} to freemarker!
10. </p>
13. <p>性別：
14. <#if gender==0>
15. 女
16. <#elseif gender==1>
17. 男
18. <#else>
19. 保密
20. </#if>
21. </p>
24. <h4>我的好友：</h4>
25. <#list friends as item>
26. 姓名：${item.name} , 年齡${item.age}
27. <br>
28. </#list>
30. </body>
31. </html>

<!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內容：

Html代碼

1. <header>
2. This is a header,welcome ${name} to my web site!
3. </header>
4. <hr>

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

footer.ftl內容：

Html代碼

1. <hr>
2. <footer>
3. This is a footer,welcome ${name} to my web site!
4. </footer>

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

修改hello.ftl：

Html代碼

1. <!DOCTYPE html>
2. <html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"
3. xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3">
4. <head>
5. <title>Hello World!</title>
6. </head>
7. <body>
9. <#include "/header.ftl" >
11. <p>
12. welcome ${name} to freemarker!
13. </p>
16. <p>性別：
17. <#if gender==0>
18. 女
19. <#elseif gender==1>
20. 男
21. <#else>
22. 保密
23. </#if>
24. </p>
27. <h4>我的好友：</h4>
28. <#list friends as item>
29. 姓名：${item.name} , 年齡${item.age}
30. <br>
31. </#list>
34. <#include "/footer.ftl" >
35. </body>
36. </html>

<!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】

視頻&交流平臺：

à SpringBoot網易雲課堂視頻

http://study.163.com/course/introduction.htm?courseId=1004329008

à Spring Boot交流平臺

http://412887952-qq-com.iteye.com/blog/2321532

Spring Boot使用模板freemarker【從零開始學Spring Boot(轉)