freemarker入门

霸气de小男生 提交于 2019-12-05 17:03:45

1.网页静态化技术Freemarker

1.1为什么要使用网页静态化技术

网页静态化解决方案在实际开发中运用比较多,例如新闻网站,门户网站中的新闻频道或者是文章类的频道。

 

 

 

对于电商网站的商品详细页来说,至少几百万个商品,每个商品又有大量的信息,这样的情况同样也适用于使用网页静态化来解决。

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

另外我们如果将网页以纯静态化的形式展现,就可以使用Nginx这样的高性能的web服务器来部署。Nginx可以承载5万的并发,而Tomcat只有几百。关于Nginx我们在后续的课程中会详细讲解。

今天我们就研究网页静态化技术----Freemarker

1.2什么是 Freemarker

FreeMarker 是一个用 Java 语言编写的模板引擎,它基于模板来生成文本输出。FreeMarkerWeb 容器无关,即在 Web 运行时,它并不知道 Servlet HTTP。它不仅可以用作表现层的实现技术,而且还可以用于生成 XMLJSP Java 等。

 

1.3 Freemarker入门小DEMO

 

1.3.1工程引入依赖

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

1.3.2创建模板文件

模板文件中四种元素

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

我们现在就创建一个简单的创建模板文件test.ftl

<html>
<head>
    <meta charset="utf-8">
    <title>Freemarker入门小DEMO </title>
</head>
<body>
<#--我只是一个注释,我不会有任何输出  -->
${name},你好。${message}<br>
<#assign age="18">
年龄:${age}<br>
<#assign info={"sex":"男","hobbys":"唱跳rap"}>
性别:${info.sex}<br>
爱好:${info.hobbys}
<#include "head.ftl">
<ul>
    无序列表的个数:${grandList?size}
<#list grandList as entity>
    <li>
    ${entity}
    </li>
</#list>
</ul>
    <h3>map集合取数据</h3>
    姓名:${person.name}  年龄:${person.age}<br>
    <h3>时间类型:</h3>
    当前日期:${date?date}<br>
    当前时间:${date?time}<br>
    时间戳:${date?datetime}<br>
    时间格式化:${date?string("yyyy/MM/dd HH:mm:ss")}
<h3>身份证号</h3>
以字符串形式输出:${id?c}
    <h3>??判断变量是否存在</h3>
    <#if aaa??>
        aaa存在
        <#else >
        aaa不存在
    </#if>
    <h3>判断变量是否存在,不存在时!赋默认值</h3>
    <#if aaa??>
        aaa存在 ${aaa}
    <#else >
        aaa不存在 ${aaa!'111'}
    </#if>
</body>
</html>

1.3.3生成文件

使用步骤:

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

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

第三步:设置模板文件使用的字符集。一般就是 utf-8.

第四步:加载一个模板,创建一个模板对象。

第五步:创建一个模板使用的数据集,可以是 pojo 也可以是 map。一般是 Map

第六步:创建一个 Writer 对象,一般创建一 FileWriter 对象,指定生成的文件名。

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

第八步:关闭流

代码:

public class FreeMarkerTest {

    @Test
    public void test01() throws IOException, TemplateException {
        //1.创建配置类
        Configuration configuration = new Configuration(Configuration.getVersion());
        //2.设置模板所在的目录
        configuration.setDirectoryForTemplateLoading(new File("D:\\wrokspace\\ideaspace\\freemarker_demo01\\src\\main\\resources\\ftl"));
        //3.设置字符集
        configuration.setDefaultEncoding("utf-8");
        //4.加载模板
        Template template = configuration.getTemplate("test.ftl");
        //5.创建数据模型
        Map map = new HashMap();
        map.put("name", "luli");
        map.put("message", "欢迎来到王者荣耀");

        //list类型
        List list = new ArrayList<>();
        list.add("a");
        list.add("b");
        list.add("c");
        list.add("d");
        map.put("grandList", list);
        //map类型
        HashMap map1 = new HashMap();
        map1.put("name", "曜");
        map1.put("age", "20");
        map.put("person", map1);
        //date类型
        map.put("date", new Date());
        //number类型处理
        map.put("id", 41038111112412L);//6.创建输出流
        FileWriter fw = new FileWriter("E:\\test.html");
        //7.输出
        template.process(map, fw);
        //8.关流
        if(fw != null){
            fw.close();
        }
    }
}

1.3.4 生成的html文件

<html>
<head>
    <meta charset="utf-8">
    <title>Freemarker入门小DEMO </title>
</head>
<body>
luli,你好。欢迎来到王者荣耀<br>
年龄:18<br>
性别:男<br>
爱好:唱跳rap
<h1>include包含页面</h1><ul>
    无序列表的个数:4
    <li>
    a
    </li>
    <li>
    b
    </li>
    <li>
    c
    </li>
    <li>
    d
    </li>
</ul>
    <h3>map集合取数据</h3>
    姓名:曜  年龄:20<br>
    <h3>时间类型:</h3>
    当前日期:2019-11-26<br>
    当前时间:11:13:56<br>
    时间戳:2019-11-26 11:13:56<br>
    时间格式化:2019/11/26 11:13:56
<h3>身份证号</h3>
以字符串形式输出:41038111112412
    <h3>??判断变量是否存在</h3>
        aaa不存在
    <h3>判断变量是否存在,不存在时!赋默认值</h3>
        aaa存在 41,038,111,112,412
</body>
</html>

1.4 FTL指令

1.4.1 assign指令

此指令用于在ftl模版页面上定义一个变量

1)定义简单类型:

<#assign linkman="周先生">

联系人:${linkman}

2)定义对象类型:

<#assign info={"mobile":"13301231212",'address':'北京市昌平区王府街'} >

电话:${info.mobile}  地址:${info.address}

运行效果:

 

1.4.2 include指令

此指令用于模板文件的嵌套

创建模板文件head.ftl

<h1>信息网</h1>

我们修改test.ftl,在模板文件中使用include指令引入刚才我们建立的模板

<#include "head.ftl">

 

1.4.3 if指令

在模板文件上添加

<#if success=true>

  你已通过实名认证

<#else>  

  你未通过实名认证

</#if>

在代码中对str变量赋值

map.put("success", true);

freemarker的判断中,可以使用= 也可以使用==

 

1.4.4 list指令

需求,实现商品价格表,如下图:

 

1)代码中对变量goodsList赋值

2)在模板文件上添加

----商品价格表----<br>

<#list goodsList as goods>

  ${goods_index+1} 商品名称: ${goods.name} 价格:${goods.price}<br>

</#list>

如果想在循环中得到索引,使用 循环变量+_index 就可以得到。

 

1.5 内建函数

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

1.5.1获取集合大小

我们通常要得到某个集合的大小,如下图:

 

我们使用size函数来实现,代码如下:

共  ${goodsList?size}  条记录

1.5.2转换JSON字符串为对象

我们通常需要将json字符串转换为对象,那如何处理呢?看代码

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

<#assign data=text?eval />

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

 

1.5.3日期格式化

代码中对变量赋值:

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

在模板文件中加入

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

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

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

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

运行效果如下:

 

1.5.4数字转换为字符串

代码中对变量赋值:

map.put("point", 102920122);

修改模板:

累计积分:${point}

页面显示:

 

我们会发现数字会以每三位一个分隔符显示,有些时候我们不需要这个分隔符,就需要将数字转换为字符串,使用内建函数c

累计积分:${point?c}

页面显示效果如下:

9

1.6空值处理运算符

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

1.6.1判断某变量是否存在:??

用法为:variable??,如果该变量存在,返回true,否则返回false  

<#if aaa??>

  aaa变量存在

<#else>

  aaa变量不存在

</#if>

 

1.6.2缺失变量默认值:!

我们除了可以判断是否为空值,也可以使用!null值做转换处理

在模板文件中加入

  ${aaa!'-'}

在代码中不对aaa赋值,也不会报错了 ,当aaanull则返回!后边的内容-

 

1.7运算符

1.7.1算术运算符

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

1.7.2逻辑运算符

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

1.7.3比较运算符

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

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

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!