网页静态化解决方案Freemarker

时间 2019-11-06

原文原文链接

序言：html

　　沉淀了三个月，逐步将本身最近两年在公司中用到的技术和知识点，从新整理概括了下，对比之前能够发现，如今技术更新愈来愈快，也愈来愈成熟，在互联网企业，用到的技术也更先进，更领先，好比微服务、分布式和高并发等等。接下来我会将本身创业的时候在客户作项目，用到的一些技术和知识点给你们分享，供你们参考学习。下面咱们先从网页静态化技术开始，这在项目中仍是用的比较多的，若是小伙伴还有什么但愿了解的技术，能够在留言区注释，我会挑选本身擅长的地方给你们分享。下面开始今天的学习吧！java

——WZY程序员

1、什么是Freemarker?它是干什么用的?为何要使用网页静态化技术?web

　　1.什么是Freemarker:　　　　　　数据库

　　FreeMarker 是一个用 Java 语言编写的模板引擎，它基于模板来生成文本输出。FreeMarker 与 Web 容器无关，即在 Web 运行时，它并不知道 Servlet 或 HTTP。它不只能够用做表现层的实现技术，并且还能够用于生成 XML， JSP 或 Java 等。编程

　　这是什么意思呢?有的同窗可能读完，也没明白说的是啥。还记得以前，我给你们分享的mybatis的逆向工程吗？其实原理相似Freemarker。简单来讲，就是能够经过编码java代码，将固定模板和动态的参数填充到一块儿，生成所须要的文件。根据不一样的模板，能够生成不一样的文件，好比提供HTML模板，能够生成所须要的HTML文件。json

2.为何要使用Freemarker?他的使用场景是什么?　　　　　　缓存

　　网页静态化解决方案在实际开发中运用比较多，例如新闻网站，门户网站中的新闻频道或者是文章类的频道。也好比说一些电商的商品详情页面，虽然每一个商品的详情内容是不同的，可是它总体的布局是一致了，好比每一个商品都有标题，价格，图片，商品介绍等等，咱们使用Freemarker将固定不变的内容定义层模板,而后将不动态的内容去从数据库中查询出来,再绑定到模板一个一个对应位置，就能够生成，每一个商品本身的详情页了。服务器

　　那么咱们为何要使用网页静态化呢，像咱们之前那样，直接定义好页面，用户访问的时候，再将页面的动态内容查询填充展现不行吗？很显然，使用了网页静态化技术，用户访问的是生成好的静态页面，不用再直接去数据库中取查询数据。网页静态化技术和缓存技术的共同点都是为了减轻数据库的访问压力，可是具体的应用场景不一样，缓存比较适合小规模的数据，而网页静态化比较适合大规模且相对变化不太频繁的数据。mybatis

　　另外网页静态化还有利于 SEO。另外咱们若是将网页以纯静态化的形式展示，就可使用 Nginx 这样的高性能的 web服务器来部署。 Nginx 能够承载 5 万的并发，而 Tomcat 只有几百。关于 Nginx 我在后续的博客中会详细讲解。

2、了解了Freemarker的基本概念，下面咱们经过一个小案例，来具体了解下Freemarker。

　　1.使用Freemarker须要如今建立maven工程，引入依赖，还不知道如何使用maven工程的小伙伴，能够看看我以前的博客关于maven的详细介绍。

<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <version>2.3.23</version>
</dependency>

　　2.建立模板文件，这里咱们以生成html文件为例（通俗来讲模板就是用于生产的模具）。

　　先了解下模板文件中经常使用的四种元素：

　　1）、文本，直接输出的部分
　　2）、注释，即<#--...-->格式不会输出
　　3）、插值（Interpolation）：即${..}部分,将使用数据模型中的部分替代输出。
　　4）、 FTL 指令： FreeMarker 指令，和 HTML 标记相似，名字前加#予以区分，不会输出。

咱们如今就建立一个简单的建立模板文件 test.ftl （这个后缀不是非要写出ftl，可是通常都这样写）

　　　　

<html>
<head>
<meta charset="utf-8">
<title>Freemarker测试</title>
</head>
<body>
<#--我只是一个注释，我不会有任何输出 -->           跟html中的注释<-- -->是全部区别的,html中注释虽然不会再页面显示,可是仍是会显示在源代码中,而#<-- --> 仅从程序员看的,不会显示在生成的源代码中。
${name},你好。 ${message}                      ${...} 这就是插值,至关于占位置,等待数据填充。很相似之前学习的JSP页面中的{}从域中取值
</body>　　　　　　　　　　　　　　　　　　　　　　　其余地方就是文本,会直接输出到生成的源代码中。
</html>

　　3.编程代码，填充模板，生成说须要的源代码文件

　　使用步骤：　　　　　　

　　第一步：建立一个 Configuration 对象，直接 new 一个对象。构造方法的参数就是freemarker 的版本号。

　　第二步：设置模板文件所在的路径。

　　第三步：设置模板文件使用的字符集。通常就是 utf-8.

　　第四步：加载一个模板，建立一个模板对象。

　　第五步：建立一个模板使用的数据集，能够是 pojo 也能够是 map。通常是 Map。

　　第六步：建立一个 Writer 对象，通常建立一 FileWriter 对象，指定生成的文件名。

　　第七步：调用模板对象的 process 方法输出文件。

　　第八步：关闭流

//1.建立配置类,这个configuration是freemarker提供的,不要导错包了
Configuration configuration=new Configuration(Configuration.getVersion());
//2.设置模板所在的目录,这里定义的就是刚刚test.ftl所存放的真实目录
configuration.setDirectoryForTemplateLoading(new File("D:/pinyougou_work/freemarkerDemo/src/main/resources/"));  //注意这里是文件夹路径,不是文件路径
//3.设置字符集
configuration.setDefaultEncoding("utf-8");
//4.加载模板
Template template = configuration.getTemplate("test.ftl");
//5.建立数据模型,就是用来填充模板那些插值的,能够用map,也能够定义对象,通常都是map,注意的是key须要跟插值中的对应上
Map map=new HashMap();
map.put("name", "张三 ");
map.put("message", "欢迎来到Freemarker！ ");
//6.建立 Writer 对象,表明生成的源代码会存放到哪里
Writer out =new FileWriter(new File("d:\\test.html"));
//7.输出
template.process(map, out);
//8.关闭 Writer 对象,切记不要忘记关流,否则以上的数据都仍是在内存中,须要refresh才能够持久化到磁盘,这是IO流的知识点.
out.close();

　　4.这时候，D盘下就生成了一个test.html的文件了，打开看看！看到这个页面，恭喜你，成功了！

　　5.让咱们来看看生成的源代码是啥样的

<html>
<head>
<meta charset="utf-8">
<title>freemarker测试</title>
</head>
<body>
张三，你好。欢迎来到Freemarker!
</body>
</html>

　　对比模板，能够看到如咱们定义的同样。文本原样输出，注释再也不源代码，插值被填充。

3、接下来咱们让咱们学习FTL指令。

　　1.assign指令：此指令用于在页面上定义一个变量

　　1）能够直接一个简单类型，等同于给一个变量赋值

　　2）也能够定义个对象类型，取值的时候,根据对象名.属性名,跟JS中同样

（1）定义简单类型：
<#assign linkman="张三">
联系人： ${linkman}
（2）定义对象类型：
<#assign info={"mobile":"1314520",'address':'中国台湾省'} >
电话： ${info.mobile} 地址： ${info.address}

　　　　　　页面效果:

2.include指令

　　此指令用于指定模板的嵌套，相似JSP页面中引入其余JSP文件，一个道理。

建立模板文件 head.ftl
<h1>测试官网</h1>
咱们修改 test.ftl，在模板文件中使用 include 指令引入刚才咱们创建的模板
<#include "head.ftl">

3.if 指令

在模板文件上添加
<#if success=true>
你已经过实名认证
<#else>
你未经过实名认证
</#if>


在java代码中对succsee变量赋值
map.put("success", true);
在 freemarker 的判断中，可使用= 也可使用==

页面效果:

4.list 指令

　　在后台java代码中,建立一个集合

List goodsList=new ArrayList();
Map goods1=new HashMap();
goods1.put("name", "苹果");
goods1.put("price", 5.8);
Map goods2=new HashMap();
goods2.put("name", "香蕉");
goods2.put("price", 2.5);
Map goods3=new HashMap();
goods3.put("name", "橘子");
goods3.put("price", 3.2);
goodsList.add(goods1);
goodsList.add(goods2);
goodsList.add(goods3);
map.put("goodsList", goodsList);

　　　　　　　　　　在模板文件中添加:

----商品价格表----<br>
<#list goodsList as goods>
${goods_index} 商品名称： ${goods.name} 价格： ${goods.price}<br>
</#list>

页面效果:

5. 内建函数

　　语法格式:变量+?+函数名称

5.1 得到集合大小:

　　好比要得到上面goodsLIst集合的长度能够这样写

　　一共 ${goodsList?size} 条记录

页面效果:

5.2 转换JSON字符串对象

　　咱们一般须要将 json 字符串转换为对象，那如何处理呢？看代码

<#assign text="{'bank':'工商银行','account':'10101920201920212'}" />  <#-- 这里定义的是一个json字符串{}是被""包裹在 -->
<#assign data=text?eval />   <#-- 经过?eval将json字符串text转换成对象,赋值给变量data,就能够经过data取值了 -->
开户行： ${data.bank} 帐号： ${data.account}

5.3 日期格式化

　　代码中对变量赋值:map.put("taday",new Date())，而后在页面取：

当前日期： ${today?date} <br>
当前时间： ${today?time} <br>
当前日期+时间： ${today?datetime} <br>
日期格式化： ${today?string("yyyy 年 MM 月")}

页面效果：

5.4 数字转换为字符串

　　代码中对变量赋值 map.put("number",10231231);

　　那么用${number}取值页面会是 102,31,231 的这种格式

　　使用 ${number?c} 会原样输出:10231231

5.5 空值处理运算符

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

用法一:
用法为:variable??,若是该变量存在,返回 true,不然返回 false
<#if aaa??>
aaa 变量存在
<#else>
aaa 变量不存在
</#if>

用法二:
咱们除了能够判断是否为空值，也可使用!对 null 值作转换处理
在模板文件中加入
${aaa!'-'}
在代码中不对 aaa 赋值，也不会报错了 ，当 aaa 为 null 则返回！后边的内容-

5.6 运算符

　　1)算数运算符

　　FreeMarker 表达式中彻底支持算术运算,FreeMarker 支持的算术运算符包括:+, - , * , / , %
　　逻辑运算符

　　2)逻辑运算符有以下几个:
　　逻辑与:&&
　　逻辑或:||
　　逻辑非:!
　　逻辑运算符只能做用于布尔值,不然将产生错误

　　3)比较运算符

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

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

　　　　　　　　
结尾:今天Freemarker的基本入门就介绍到这里了,下一期,咱们经过实战来,深刻了解具体在项目中如何使用Freemarker!