网页静态化技术 Freemarker

网页静态化解决方案在实际运用中比较多，例如新闻网站，门户网站中的新闻频道或者是文章类的频道。对于电商网站的商品详细页（几百万的商品，同样的页面模板格局）来说，每个商品又有大量的信息，这样的情况同样也适用于网页静态化解决方案。

网页静态化技术和缓存技术的共同点都是为了减轻数据库的访问压力，但是具体的应用场景不同，缓存比较适合小规模的数据，而网页静态化比较适合大规模且相对变化不大频繁的数据。另外网页静态化还有利于 SEO（搜索引擎优化）

另外我们如果将网页以纯静态化的形式展现，就可以使用 Nginx这样的高性能的 Web服务器来部署。Nginx可以承载5万的并发，而 Tomcat只有几百。

一、什么是 Freemarker

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

FreeMarker最初的设计，是被用来在 MVC模式的 Web开发框架中生成 HTML页面的，没有被绑定到 Servlet或 HTML或任意 Web相关的东西上，它也可以用于非 Web应用环境中。

二、Freemarker 入门程序

【1】引入模板 Jar 包的依赖

1 <dependency>

2     <groupId>org.freemarker</groupId>

3     <artifactId>freemarker</artifactId>

4     <version>2.3.23</version>

5 </dependency>

【2】创建模板文件：在配置文件目录（/src/main/resources/）下创建 test.ftl （扩展名.ftl 没有强制的要求）

模板文件中四种元素：
    ● 文本：直接输出的部分
    ● 注释：即<#--...-->格式不会输出，注释会输入到页面。
    ● 插值（Interpolation）：即${..}部分,将使用数据模型中的部分替代输出
    ● FTL指令：FreeMarker指令，和 HTML标记类似，名字前加#予以区分，不会输出。

 1 <html>

 2 <head>

 3     <meta charset="utf-8">

 4     <title>Freemarker入门小DEMO </title>

 5 </head>

 6 <body>

 7 <#--我只是一个注释，我不会有任何输出  -->

 8 ${name},你好。${message}

 9 </body>

10 </html>

【3】Freemark 生成文件（将数据与模板进行关联）。主函数代码如下：

 1 package com.itecast.demo;

 2

 3 import java.io.File;

 4 import java.io.FileWriter;

 5 import java.io.Writer;

 6 import java.util.HashMap;

 7 import java.util.Map;

 8

 9 import freemarker.template.Configuration;

10 import freemarker.template.Template;

11

12 public class FreemarkeDemo {

13     public static void main(String[] args) throws Exception {

14         //1、创建配置类:Configuration 对象 直接new 构造方法为 freemark 的版本

15         Configuration configuration = new Configuration(Configuration.getVersion());

16         //2、通过配置获取模板路径   需要处理异常  (注意 是正斜杠)

17         configuration.setDirectoryForTemplateLoading(new File("E:/learnWorkspaces/demo/freemarkDemo/src/main/resources/"));

18         //3、设置字符集

19         configuration.setDefaultEncoding("UTF-8");

20         //4、获取模板文件  创建一个模板文件（既返回对象）

21         Template template = configuration.getTemplate("test.ftl");

22         //5、创建一个模板使用的数据集，可以是 pojo 也可以是 map,一般是map

23         Map map=new HashMap();

24         map.put("name", "郑少");

25         map.put("message", "欢迎来到品优购世界！");

26         //6、创建输入对象 writer 对象

27         Writer out = new FileWriter(new File("D:\\test.html"));

28         //7、将模板 、 数据 、输出文件 进行关联 输出

29         template.process(map, out);

30         //8、关闭文件流

31         out.close();

32     }

33 }

【4】FTL 指令：assign 指令：用于在页面上定义一个变量
① 定义简单类型：linkname 为变量

1 <#assign linkname="银通">

2 公司名称：${linkname}

② 定义对象类型

1 <#assign info={"name":"王五","age":12}>

2 姓名：${info.name}

3 年龄：${info.age}

③ 运行效果如下：

include 指令：此指令用于模板文件的嵌套，创建嵌套文件 head.ftl

<#include "head.ftl">

if 指令：在模板文件中进行逻辑判断，后台构造 success 变量的数据。

map.put("success", true);

模板中添加 if 指令：

1 <#if success=true>

2     你已通过实名认证

3 <#else>

4     你未通过实名认证

5 </#if>

list 指令：循环实现列表的展示，后台构造 list 数据：

 1 List goodsList=new ArrayList();

 2 Map goods1=new HashMap();

 3 goods1.put("name", "苹果");

 4 goods1.put("price", 5.8);

 5 Map goods2=new HashMap();

 6 goods2.put("name", "香蕉");

 7 goods2.put("price", 2.5);

 8 Map goods3=new HashMap();

 9 goods3.put("name", "橘子");

10 goods3.put("price", 3.2);

11 goodsList.add(goods1);

12 goodsList.add(goods2);

13 goodsList.add(goods3);

14 map.put("goodsList", goodsList);

模板中添加 list 指令： *_index 为freemaker的内置属性，用来获取下表，从0开始

1 <#list goodsList as goods>

2 序号：${goods_index+1}  <!--*_index 为freemaker的内置属性，用来获取下表，从0开始-->

3 名称：${goods.name}

4 价格：${goods.price}

5 </#list>

【5】内建函数：函数的语法：变量+？+函数名称
① 使用 size 函数实现 list 的长度：

一共${goodsList?size}条记录

② 转换 JSON 字符串为对象：变量=字符串+?+eval

1 <#assign text="{'bank':'工商银行','account':'10101920201920212'}"/>

2 <#assign data=text?eval/>

3 开户行：${data.bank}  账号：${data.account}

③ 日期格式转化：变量+?+date 后台数据构建如下：

map.put("today", new Date());

模板中获取日期、时间、日期时间组合和日期的格式转化，如下：

1 当前日期：${today?date} <br>

2 当前时间：${today?time} <br>

3 当前日期+时间：${today?datetime} <br>

4 日期格式化：  ${today?string("yyyy年MM月")}

④ 数字转化为字符串（模板默认将数字进行了分割符切分），后台数据组装

map.put("point", 102920122);

模板中直接展示：

累计积分：${point}

效果如下：我们会发现数字会以每三位一个分隔符显示，有些时候我们不需要这个分隔符，就需要将数字转换为字符串,使用内建函数c：${point?c}

三、空值处理运算符

如果你在模板中使用了变量但是在代码中没有对变量赋值，那么运行生成时会抛出异常。但是有些时候，有的变量确实是null，怎么解决这个问题呢？

【1】缺失变量赋值：“！”（我们除了可以判断是否为空值，也可以使用!对null值做转换处理）

<#--在代码中不对aaa赋值，也不会报错了 ，当aaa为null则返回！后边的内容-->

${aaa!'-'}

【2】用法为：variable??，如果该变量存在，返回true，否则返回false

1 <#if aaa??>

2   aaa变量存在

3 <#else>

4   aaa变量不存在

5 </#if>

四、运算符

● 算数运算符
FreeMarker表达式中完全支持算术运算,FreeMarker支持的算术运算符包括:+, - , * , / , %

●逻辑运算符：逻辑运算符有如下几个:
   逻辑与:&&
   逻辑或:||
   逻辑非:!
   逻辑运算符只能作用于布尔值,否则将产生错误

● 比较运算符：表达式中支持的比较运算符有如下几个:
   =或者==:判断两个值是否相等.
   !=:判断两个值是否不等.
   >或者gt:判断左边值是否大于右边值
   >=或者gte:判断左边值是否大于等于右边值
   <或者lt:判断左边值是否小于右边值
   <=或者lte:判断左边值是否小于等于右边值

注意： =和!=可以用于比较字符串，数值和日期是否相等,但=和!=两边必须是相同类型的值，否则会产生错误，而且FreeMarker是精确比较，"x"，"X"是不等的。其它的运行符可以作用于数字和日期，但不能作用于字符串，大部分的时候，使用gt等字母运算符代替 > 会有更好的效果，因为 FreeMarker会把 > 解释成 FTL 标签的结束字符，当然,也可以使用括号来避免这种情况，如：<#if (x>y)>

五、项目实战（spring 配置文件中注入FreeMarkerConfigurer 并配置模板的存放位置）

1 <bean id="freemarkerConfig"    class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">

2     <property name="templateLoaderPath" value="/WEB-INF/ftl/" />

3     <property name="defaultEncoding" value="UTF-8" />

4 </bean>