Java使用Freemarker页面静态化生成的实现

2024-12-02 10:08:30

前言：

页面静态化其实就是将原来的动态网页(例如通过ajax请求动态获取数据库中的数据并展示的网页)改为通过静态化技术生成的静态网页，这样用户在访问网页时，服务器直接给用户响应静态html页面，没有了动态查询数据库的过程。

常用实现方法：Freemarker、thymeleaf等。

1、 Freemarker介绍

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

定义一个Template模板,获取FreeMarker里面的内容详细通过java传入内容详细给FreeMarker输出Template模板结合内容的完成页面 2、Freemarker入门案例 1、创建一个maven工程并导入Freemarker的maven坐标

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

2、创建模板文件

模板文件中有四种元素：

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

Freemarker的模板文件后缀可以任意，一般建议为ftl。

在D盘创建ftl目录，在ftl目录中创建名称为test.ftl的模板文件，内容如下：

<html>
<head>
	<meta charset="utf-8">
	<title>Freemarker入门</title>
</head>
<body>
    <#--我只是一个注释，我不会有任何输出  -->
    ${name}你好，${message}
</body>
</html>

创建模板文件示例

将文件保存到一个新的目录下：

3、生成文件

使用步骤：

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

public static void main(String[] args) throws Exception {
    // 1、创建freemarker的配置对象
    Configuration configuration = new Configuration(Configuration.getVersion());
    // 2、设置模板文件所在目录
    configuration.setDirectoryForTemplateLoading(new File("F:\\ftl"));
    // 3、设置字符集
    configuration.setDefaultEncoding("utf-8");
    // 4、加载模板文件
    Template template = configuration.getTemplate("test.ftl");
    // 5、准备模板文件中所需要的数据，通常是通过map进行构造
    Map map = new HashMap();
    map.put("name","Hello");
    map.put("message","freemarker");
    // 6、准备输出流对象，用于输出静态文件
    FileWriter fileWriter = new FileWriter("F:\\ftl\\test.html");
    // 7、使用模板输出静态文件
    template.process(map,fileWriter);
    // 8、关闭输出流
    fileWriter.close();
}

上面的入门案例中Configuration配置对象是自己创建的，字符集和模板文件所在目录也是在Java代码中指定的。在项目中应用时可以将Configuration对象的创建交由Spring框架来完成，并通过依赖注入方式将字符集和模板所在目录注入进去。

当程序执行完成之后，查看文件的位置就会多出与一个html的静态文件，后面的项目也可以通过这样的方式来提高访问速度

4、 Freemarker指令

4.1、assign指令

用于在页面上定义一个便变量，可以是简单类型也可以是对象类型

定义一个简单类型的变量：

<#assign linkman="周先生">
联系人：${linkman}

定义一个对象类型的变量:

<#assign info={"mobile":"13812345678",'address':'北京市昌平区'} >
电话：${info.mobile}  地址：${info.address}

4.2、include指令

用于模板文件的嵌套

创建一个公共模板:

修改test.ftl模板在里面嵌套heade.ftl公共模板

<#include "head.ftl"/>

4.3、if指令

if指令用于判断

在模板文件中使用if指令进行判断:

<#if success=true>
  你已通过实名认证
<#else>
  你未通过实名认证
</#if>

判断的变量可以在java代码中编写也可以在模板中通过<#assign linkman="success">指令来判断，如果同时设置的话，模板中的指令优先级大于java的

在java代码中为success变量赋值:

map.put("success", true);

在freemarker的判断中，可以使用= 也可以使用==

4.4、list指令

list指令用于遍历

在模板文件中使用list指令进行遍历

as是一个关键字不可以进行修改，后面是就取出来的数据作为一个变量进行获取

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

在java代码中为goodsList赋值:

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);

5、实际项目中使用Freemarker

下面我们就可以将Freemarker应用到项目中，帮我们生成移动端套餐列表静态页面和套餐详情静态页面。接下来我们需要思考几个问题：

什么时候生成静态页面比较合适呢？

应该是当套餐数据发生改变时，需要生成静态页面，即我们通过后台系统修改套餐数据（包括新增、删除、编辑）时。

将静态页面生成到什么位置呢？

如果是在开发阶段可以将文件生成到项目工程中，如果上线后可以将文件生成到移动端系统运行的tomcat中。

应该生成几个静态页面呢？

套餐列表只需要一个页面就可以了，在这个页面中展示所有的套餐列表数据即可。套餐详情页面需要有多个，即一个套餐应该对应一个静态页面。

5.1、在数据变更的业务逻辑层中定义模板消息

创建模板的存放位置
创建需要生成的模板代码，通过指令配合来接收java提供的数据来生成静态页面

5.2、配置文件

在health_service_provider工程中创建属性文件freemarker.properties

指定将静态HTML页面生成的目录位置，方便后期修改维护

out_put_path=D:/ideaProjects

在项目工程中的通过spring创建FreeMarkerConfigurer对象

当项目启动的时候就会去创建

<!--创建模板的对象-->
<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>
<!--引入输出静态模板的位置，输出文件的时候会使用到里面的key和value-->
<context:property-placeholder location="classpath:freemarker.properties"/>

5.3、生成静态页面

根据快速入门的代码来编写1即可

到此这篇关于Java使用Freemarker页面静态化生成的实现的文章就介绍到这了,更多相关Java Freemarker 内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！

Java实现用Freemarker完美导出word文档（带图片）

前言最近在项目中,因客户要求,将页面内容(如合同协议)导出成word,在网上翻了好多,感觉太乱了,不过最后还是较好解决了这个问题. 准备材料 1.word原件 2.编辑器(推荐Firstobject free XML editor) 实现步骤 1.用Microsoft Office Word打开word原件: 2.把需要动态修改的内容替换成***,如果有图片,尽量选择较小的图片几十K左右,并调整好位置: 3.另存为,选择保存类型Word 2003 XML 文档(*.xml)[这里说一下为什么用
Java操作FreeMarker模板引擎的基本用法示例小结

FreeMarker 是一个采用 Java 开发的模版引擎,是一个基于模版生成文本的通用工具. 它被设计用来生成 HTML Web 页面,特别是基于 MVC 模式的应用程序.虽然使用FreeMarker需要具有一些编程的能力,但通常由 Java 程序准备要显示的数据,由 FreeMarker 生成页面,并通过模板显示准备的数据. http://freemarker.org/ public void process(String template, Map<String, ?> data) th
基于Freemarker和xml实现Java导出word

前言最近做了一个调查问卷导出的功能,需求是将维护的题目,答案,导出成word,参考了几种方案之后,选择功能强大的freemarker+固定格式之后的wordxml实现导出功能.导出word的代码是可以直接复用的,于是在此贴出,并进行总结,方便大家拿走. 实现过程概览先在word上,调整好自己想要的样子.然后存为xml文件.保存为freemarker模板,以ftl后缀结尾.将需要替换的变量使用freemarker的语法进行替换.最终将数据准备好,和模板进行渲染,生成文件并返回给浏览器流. 详细
Java超级实用的Freemarker工具类

目录一.工具类二.测试一.工具类 public class FreemarkerUtil { /** * 根据模板,利用提供的数据,生成文件 * @param ftlNameWithPath 模板文件 * @param data 数据 * @param aimFileName 最终生成的文件 * @throws IOException * @throws TemplateException */ publ
JAVA集成Freemarker生成静态html过程解析

Springboot 1.引入Freemarker jar包 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-freemarker</artifactId> </dependency> 2.配置application.properties ### freemarker spring.freemarker.t
java Spring整合Freemarker的详细步骤

我的開發環境框架:springmvc開發工具:springsource-tool-suite-2.9.0版本:1.6.0_29tomcat版本:apache-tomcat-7.0.26前言:FreeMarker是一个用Java语言编写的模板引擎,它基于模板来生成文本输出.FreeMarker与Web容器无关,即在Web运行时,它并不知道Servlet或HTTP.它不仅可以用作表现层的实现技术,而且还可以用于生成XML,JSP或Java 等.簡而言之,Freemarker就是在Jave Web開發
java Freemarker页面静态化实例详解

Freemarker FreeMarker 是一个用 Java 语言编写的模板引擎,它基于模板来生成文本输出.FreeMarker与 Web 容器无关,即在 Web 运行时,它并不知道 Servlet 或 HTTP.它不仅可以用作表现层的实现技术,而且还可以用于生成 XML,JSP 或 Java 等. 目前企业中:主要用 Freemarker 做静态页面或是页面展示总结:freemarker 模版引擎,可以使用 Freemarker 模版生成 html 页面. Freemarker 语法 /*
在Java中FreeMarker 模板来定义字符串模板

目录问题描述代码实现问题总结问题描述一个业务需求,需要在后端通过代码渲染一个,列表如下图所示(下图只是一个示意): 这个表格的特点就是数据重复比较多,结构简单,我们可以通过 Java 代码直接拼字符串.但是这样的问题就会导致,代码非常的难看.在 Java 代码中混杂着很多样式代码,可读性和可维护性比较差.所以我就 pass 着这个方案. 于是我就想到,通过模板 + 参数的方式来实现,这样可以做到结构和参数的分离,经过比较我选择了通过 FreeMarker 模板来定义结构,最终完成字符串
使用Java进行FreeMarker的web模板开发的基础教程

一.概述 FreeMarker 是一个模板引擎,一个基于模板生成文本输出的通用工具,使用纯 Java 编写,FreeMarker 被设计用来生成 HTML Web 页面,特别是基于 MVC 模式的应用程序,虽然 FreeMarker 具有一些编程的能力,但通常由 Java 程序准备要显示的数据,由FreeMarker 生成页面,通过模板显示准备的数据(如下图) FreeMarker 不是一个 Web 应用框架,而适合作为 Web 应用框架一个组件.FreeMarker 与容器无关,因为它并不知道
基于Java的Spring框架来操作FreeMarker模板的示例

1.通过String来创建模版对象,并执行插值处理 import freemarker.template.Template; import java.io.OutputStreamWriter; import java.io.StringReader; import java.util.HashMap; import java.util.Map; /** * Freemarker最简单的例子 * * @author leizhimin 11-11-17 上午10:32 */ public cla