栏目分类:
子分类:
返回
名师互学网用户登录
快速导航关闭
当前搜索
当前分类
子分类
实用工具
热门搜索
名师互学网 > IT > 软件开发 > 后端开发 > Java

Freemarker

Java 更新时间: 发布时间: IT归档 最新发布 模块sitemap 名妆网 法律咨询 聚返吧 英语巴士网 伯小乐 网商动力

Freemarker

1 什么是Freemarker?

FreeMarker 是一款模板引擎: 即一种基于模板和要改变的数据,并用来生成输出文本(HTML网页,电子邮件,配置文件,源代码等)的通用工具。 它不是面向最终用户的,而是一个Java类库,是一款程序员可以嵌入他们所开发产品的组件。模板编写为FreeMarker Template Language (FTL)。它是简单的,专用的语言, 不是像PHP那样成熟的编程语言。 那就意味着要准备数据在真实编程语言中来显示,比如数据库查询和业务运算,之后模板显示已经准备好的数据。在模板中,你可以专注于如何展现数据, 而在模板之外可以专注于要展示什么数据。

2 Freemarker入门 2.1 Freemarker模板文件

正如上图所显示的,模板 + 数据模型 = 输出,需要预先定义好模板文件和数据。模板中的元素包括:

2.2 Freemarker案例
  • 导入依赖

  org.freemarker
  freemarker
  2.3.23

  • 在桌面创建目录ftl,在ftl目录中创建名称为testFreemarker.ftl模板文件,内容如下:


	
	Freemarker


    <#--注释,不会有任何输出  -->
    ${name}你好,${message}


  • 生成文件,步骤如下:
    第一步:创建一个 Configuration 对象,直接 new 一个对象。构造方法的参数就是 freemarker的版本号。
    第二步:设置模板文件所在的路径。
    第三步:设置模板文件使用的字符集。一般就是 utf-8。
    第四步:加载一个模板,创建一个模板对象。
    第五步:创建一个模板使用的数据集,可以是 pojo 也可以是 map。一般是 Map。
    第六步:创建一个 Writer 对象,一般创建 FileWriter 对象,指定生成的文件名。
    第七步:调用模板对象的 process 方法输出文件。
    第八步:关闭流。
package com.hc;

import freemarker.template.Configuration;
import freemarker.template.Template;

import java.io.File;
import java.io.FileWriter;
import java.util.HashMap;
import java.util.Map;

public class TestFreemarker {
    public static void main(String[] args) throws Exception {
        // 1.创建配置类
        Configuration configuration = new Configuration(Configuration.getVersion());
        // 2.设置模板所在的目录
        configuration.setDirectoryForTemplateLoading(new File("C:\Users\HCong\Desktop"));
        // 3.设置字符集
        configuration.setDefaultEncoding("UTF-8");
        // 4.加载模板
        Template template = configuration.getTemplate("testFreemarker.ftl");
        // 5.创建数据模型
        Map map = new HashMap();
        map.put("name", "World");
        map.put("message", "Hello!");
        // 6.创建Writer对象
        FileWriter out = new FileWriter(new File("C:\Users\HCong\Desktop\testFreemarker.html"));
        // 7.输出模板文件
        template.process(map, out);
        // 8.关闭Writer对象
        out.close();
    }
}

  • 结果
2.3 Freemarker指令 2.3.1 assign指令

assign指令用于在页面上定义一个变量。



	
	Freemarker


    <#-- 注释,不会有任何输出  -->
    ${name}你好,${message}

    <#-- 定义简单变量 -->
    <#assign linkman="HC">
    联系人:${linkman}
    <#-- 定义对象 -->
    <#assign info={"mobile":"12345678910",'address':'湖北'}>
    电话:${info.mobile},地址:${info.address}


2.3.2 include指令

include指令用于模板文件的嵌套,类似于html文件中的include。新建创建模板文件Hello.ftl如下:

Hello World!

在testFreemarker.ftl模板文件中引入:



	
	Freemarker


	<#include "Hello.ftl">

    <#-- 注释,不会有任何输出  -->
    ${name}你好,${message}

    <#-- 定义简单变量 -->
    <#assign linkman="HC">
    联系人:${linkman}
    <#-- 定义对象 -->
    <#assign info={"mobile":"12345678910",'address':'湖北'}>
    电话:${info.mobile},地址:${info.address}


效果如下:

2.3.3 if指令

2.3.4 list指令

list指令用于遍历。

  • 在模板文件中使用list指令进行遍历
<#list goodsList as goods>
  商品名称: ${goods.name} 价格:${goods.price}
  • 在java代码中为goodsList赋值
package com.hc;

import freemarker.template.Configuration;
import freemarker.template.Template;

import java.io.File;
import java.io.FileWriter;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class TestFreemarker {
    public static void main(String[] args) throws Exception {
        // 1.创建配置类
        Configuration configuration = new Configuration(Configuration.getVersion());
        // 2.设置模板所在的目录
        configuration.setDirectoryForTemplateLoading(new File("C:\Users\HCong\Desktop"));
        // 3.设置字符集
        configuration.setDefaultEncoding("UTF-8");
        // 4.加载模板
        Template template = configuration.getTemplate("testFreemarker.ftl");
        // 5.创建数据模型
        Map map = new HashMap();
        map.put("name", "World");
        map.put("message", "Hello!");

        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);
        // 6.创建Writer对象
        FileWriter out = new FileWriter(new File("C:\Users\HCong\Desktop\testFreemarker.html"));
        // 7.输出模板文件
        template.process(map, out);
        // 8.关闭Writer对象
        out.close();
    }
}

  • 结果如下:
3 Freemarker应用

商品的列表和详情页面是访问量比较大的,每次都从数据库中调取数据会造成了很大的访问压力,并且数据库中的数据变化频率并不高。页面静态化其实就是将原来的动态网页(例如通过ajax请求动态获取数据库中的数据并展示的网页)改为通过静态化技术生成的静态网页,这样用户在访问网页时,服务器直接给用户响应静态html页面,没有了动态查询数据库的过程。

生成移动端静态页面的几个问题:

  • 什么时候生成静态页面比较合适呢?
    当数据发生改变时,需要生成静态页面,即我们通过后台系统修改数据(包括新增、删除、编辑)时。
  • 将静态页面生成到什么位置呢?
    如果是在开发阶段可以将文件生成到项目工程中,如果上线后可以将文件生成到移动端系统运行的tomcat中。
  • 应该生成几个静态页面呢?
    一个套餐列表页面和所有的套餐详情页面。
3.1 Spring集成Freemarker



    
    
        
        
        
        
    
    

3.2 实例
package com.hc.service.impl;

import com.alibaba.dubbo.config.annotation.Service;
import com.github.pagehelper.Page;
import com.github.pagehelper.PageHelper;
import com.hc.constant.RedisConstant;
import com.hc.dao.SetmealDao;
import com.hc.entity.PageResult;
import com.hc.entity.QueryPageBean;
import com.hc.pojo.Setmeal;
import com.hc.service.SetmealService;
import freemarker.template.Configuration;
import freemarker.template.Template;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer;
import redis.clients.jedis.JedisPool;

import java.io.*;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

@Service(interfaceClass = SetmealService.class)
@Transactional
public class SetmealServiceImpl implements SetmealService {

    @Autowired
    private SetmealDao setmealDao;

    @Autowired
    private JedisPool jedisPool;

    @Autowired
    private FreeMarkerConfigurer freeMarkerConfigurer;

    // 从freemarker.properties属性文件读取输出目录的路径
    @Value("${out_put_path}")
    private String outPutPath;

    
    @Override
    public void add(Setmeal setmeal, Integer[] checkgroupIds) {
        // 只有先添加该套餐才能知道套餐自增的id并返回
        setmealDao.add(setmeal);
        if (checkgroupIds != null && checkgroupIds.length > 0) {
            //绑定套餐和检查组的多对多关系
            setSetmealAndCheckGroup(setmeal.getId(), checkgroupIds);
        }

        // 将图片名称保存到Redis
        jedisPool.getResource().sadd(RedisConstant.SETMEAL_PIC_DB_RESOURCES, setmeal.getImg());

        // 新增套餐后需要重新生成静态页面
        generateMobileStaticHtml();
    }

    
    public void setSetmealAndCheckGroup(Integer id, Integer[] checkgroupIds) {
        for (Integer checkgroupId : checkgroupIds) {
            Map map = new HashMap<>();
            map.put("setmeal_id", id);
            map.put("checkgroup_id", checkgroupId);
            setmealDao.setSetmealAndCheckGroup(map);
        }
    }

    
    @Override
    public void delete(Integer id) {
        setmealDao.deleteAssociation(id);
        setmealDao.delete(id);
    }

    @Override
    public void edit(Setmeal setmeal, Integer[] checkgroupIds) {
        //根据检查组id删除中间表数据(清理原有关联关系)
        setmealDao.deleteAssociation(setmeal.getId());
        //更新套餐基本信息
        setmealDao.edit(setmeal);
        //重新建立关系
        setSetmealAndCheckGroup(setmeal.getId(), checkgroupIds);

        //将图片名称保存到Redis
        jedisPool.getResource().sadd(RedisConstant.SETMEAL_PIC_DB_RESOURCES, setmeal.getImg());
    }

    @Override
    public Setmeal findById(Integer id) {
        return setmealDao.findById(id);
    }

    @Override
    public List findCheckgroupIdsBySetmealId(Integer id) {
        return setmealDao.findCheckgroupIdsBySetmealId(id);
    }

    @Override
    public PageResult pageQuery(QueryPageBean queryPageBean) {
        Integer currentPage = queryPageBean.getCurrentPage();
        Integer pageSize = queryPageBean.getPageSize();
        String queryString = queryPageBean.getQueryString();

        PageHelper.startPage(currentPage, pageSize);

        Page setmeals = setmealDao.selectByCondition(queryString);
        return new PageResult(setmeals.getTotal(), setmeals.getResult());
    }

    @Override
    public List findAll() {
        return setmealDao.findAll();
    }

    // 下面配置静态页面的生成
    // ============================================================================

    //生成静态页面
    public void generateMobileStaticHtml() {
        //准备模板文件中所需的数据
        List setmealList = this.findAll();
        //生成套餐列表静态页面
        generateMobileSetmealListHtml(setmealList);
        //生成套餐详情静态页面(多个)
        generateMobileSetmealDetailHtml(setmealList);
    }

    //生成套餐列表静态页面
    public void generateMobileSetmealListHtml(List setmealList) {
        Map dataMap = new HashMap<>();
        dataMap.put("setmealList", setmealList);
        generateHtml("mobile_setmeal.ftl", "m_setmeal.html", dataMap);
    }

    //生成套餐详情静态页面(多个)
    public void generateMobileSetmealDetailHtml(List setmealList) {
        for (Setmeal setmeal : setmealList) {
            Map dataMap = new HashMap<>();
            dataMap.put("setmeal", this.findById(setmeal.getId()));
            generateHtml("mobile_setmeal_detail.ftl", "setmeal_detail_" + setmeal.getId() + ".html", dataMap);
        }
    }

    public void generateHtml(String templateName, String htmlPageName, Map dataMap) {
        Configuration configuration = freeMarkerConfigurer.getConfiguration();
        Writer out = null;
        try {
            // 加载模版文件
            Template template = configuration.getTemplate(templateName);
            File docFile = new File(outPutPath + "\" + htmlPageName);
            out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(docFile)));
            // 输出文件
            template.process(dataMap, out);
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (out != null) {
                try {
                    out.flush();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
    }
}

转载请注明:文章转载自 www.mshxw.com
本文地址:https://www.mshxw.com/it/959658.html
我们一直用心在做
关于我们 文章归档 网站地图 联系我们

版权所有 (c)2021-2022 MSHXW.COM

ICP备案号:晋ICP备2021003244-6号