FreeMarker-网页静态化


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

网页静态化技术和缓存技术的共同点都是为了减轻数据库的访问压力,但是具体的应用场景不同,缓存比较适合小规模的数据,而网页静态化比较适合大规模且相对变化不太频繁 的数据。另外网页静态化还有利于SEO。另外我们如果将网页以纯静态化的形式展现,就可以使用Nginx这样的高性能的web服务器来部署。Nginx可以承载5万的并发,而Tomcat只有几百。

一.FreeMarker简介

  FreeMarker 是一款 用 Java 语言编写的模板引擎 : 即一种基于模板和要改变的数据, 并用来生成输出文本(HTML网页, XML,JSP 或 Java 等)的通用工具。 它不是面向最终用户的,而是一个Java类库,是一款程序员可以嵌入他们所开发产品的组件。

中文在线文档: http://freemarker.foofun.cn/

二.FreeMarker使用步骤

1.第一步:工程中引入FreeMarker依赖


<dependency>
    <groupId>org.freemarkergroupId>
    <artifactId>freemarkerartifactId>
    <version>2.3.23version>
dependency> 

2.第二步:创建模板文件(test.ftl)

模板文件中有四种元素:
  • 文本,直接输出的部分

  • 注释,即<#--...-->格式不会输出

  • 插值(Interpolation):即${..}部分,将使用数据模型中的部分替代输出

  • FTL指令:FreeMarker指令,和HTML标记类似,名字前加#予以区分,不会输出


<html>
<head>
    <meta charset="utf-8">
    <title>Freemarker入门DEMO title>
head>
<body>
<#--我是一个注释,我不会有任何输出  -->
${name},你好。${message}
<#-- FTL指令,引入文件 -->
<#include "foot.ftl">
body>
html>

3.第三步:生成文件(main方法)

执行后,可生成test.html文件。

public class FreeMarkerTest{
    public static void main(String[] args) {
        //1.创建配置类,传入自身版本号
        Configuration configuration=new Configuration(Configuration.getVersion());
        //2.设置模板所在的目录 
        configuration.setDirectoryForTemplateLoading(new 
             File("D:/dintalk/freemarkerDemo/src/main/resources/"));
        //3.设置字符集
        configuration.setDefaultEncoding("utf-8");
        //4.加载模板
        Template template = configuration.getTemplate("test.ftl");
        //5.创建数据模型
        Map map=new HashMap();
        map.put("name", "song");
        map.put("message", "欢迎来到我的叮当屋");
        //6.创建Writer对象
        Writer out =new FileWriter(new File("d:\\test.html"));
        //7.输出
        template.process(map, out);
        //8.关闭Writer对象
        out.close();
    }
}

4.第三步:生成文件(Spring环境中)

4.1resources/spring下创建applicaitonContext-freemarker.xml配置文件
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
       xsi:schemaLocation="http://www.springframework.org/schema/beans 
               http://www.springframework.org/schema/beans/spring-beans.xsd
            http://code.alibabatech.com/schema/dubbo 
             http://code.alibabatech.com/schema/dubbo/dubbo.xsd">

    
    <dubbo:protocol name="dubbo" port="20885">dubbo:protocol>
    <dubbo:application name="dintalk-page-service"/>
    <dubbo:registry address="zookeeper://192.168.25.130:2181"/>
    <dubbo:annotation package="com.dintalk.page.service.impl"/>
    
    
    <bean id="freemarkerConfig"
        class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
        
        <property name="templateLoaderPath" value="/WEB-INF/ftl/"/>
        <property name="defaultEncoding" value="UTF-8"/>
    bean>

beans>
4.2编写生成页面的方法(以商城生成商品详情页为例)
/**
     * 根据商品id生成sku商品详情的静态化页面
     * @param goodsId 商品id
     * @return
     */
    @Override
    public boolean genItemHtml(Long goodsId) {
        try {
            Configuration configuration = markerConfig.getConfiguration();
            Template template = configuration.getTemplate("item.ftl");
            //1.创建数据模型
            Map dataModel = new HashMap();

            //2.加载商品数据
            TbGoods tbGoods = goodsMapper.selectByPrimaryKey(goodsId);
            dataModel.put("goods", tbGoods);

            //3.加载商品描述
            TbGoodsDesc tbGoodsDesc = goodsDescMapper.selectByPrimaryKey(goodsId);
            dataModel.put("goodsDesc", tbGoodsDesc);

            //4.加载商品详情列表
            TbItemExample example = new TbItemExample();
            example.createCriteria().andGoodsIdEqualTo(goodsId);
            example.setOrderByClause("is_default desc");
            List itemList = itemMapper.selectByExample(example);
            dataModel.put("itemList", itemList);

            //5.创建输出对象
            FileWriter fileWriter = new FileWriter(pageDir + goodsId + ".html");
            template.process(dataModel, fileWriter);

            //关闭资源
            fileWriter.close();
            return true;
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
    }

三.FreeMarker常用FTL指令及函数

1.FTL指令

assign 指令 :在页面上定义变量


<#assign linkman="宋先生">

<#assign info={"mobile":"1501****212",'address':'北京市昌平区'} >

include 指令:引入其他模板文件

<#include "head.ftl">

if 指令:做条件判断

<#if test=1>
  test=1
<#elseif test=2>  
  test=2
<#else>
  其他
#if>

list 指令:实现遍历

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

2.内建函数

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

共  ${goodsList?size}  条记录 


<#assign text="{'name':'song','sex':'man'}" />
<#assign user=text?eval />
姓名:${user.name}  性别:${user.sex}


dataModel.put("today", new Date());
当前日期:${today?date} <br>
当前时间:${today?time} <br> 
当前日期+时间:${today?datetime} <br>        
日期格式化:  ${today?string("yyyy年MM月")}


map.put("point", 102920122);
累计积分:${point}  
累计积分:${point?c}  





<#if aaa??>
  aaa变量存在
<#else>
  aaa变量不存在
#if>

 ${aaa!'-'}

3.运算符

算术运算符

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

逻辑运算符

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

比较运算符

表达式中支持的比较运算符有如下几个:

1  =或者== : 判断两个值是否相等。

2  != : 判断两个值是否不等。

3  >或者gt : 判断左边值是否大于右边值 。

4  >=或者gte : 判断左边值是否大于等于右边值 。

5  <或者lt : 判断左边值是否小于右边值。 

6  <=或者lte : 判断左边值是否小于等于右边值。 

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

关注微信公众号,随时随地学习