FreeMarker模板

合集下载

freemarker模板转pdf

freemarker模板转pdf

freemarker模板转pdfFreeMarker 是一个用于生成文本输出(通常是基于模板)的模板引擎,而不是直接用于生成PDF 的工具。

要将FreeMarker 模板转换为PDF,你需要使用额外的库和工具。

通常,你可以采用以下步骤:1. 生成HTML 内容:使用FreeMarker 模板引擎生成HTML 内容。

在这个过程中,你会使用FreeMarker 模板文件将数据填充到模板中,生成最终的HTML。

2. 将HTML 转为PDF:使用特定的库或工具,将生成的HTML 转换为PDF。

这可以通过使用浏览器引擎(例如Puppeteer)、使用专门的HTML to PDF 转换库(例如wkhtmltopdf)或其他PDF 生成工具来完成。

以下是一个简单的Java 示例,演示如何使用FreeMarker 和Flying Saucer(一个Java 库,基于XHTML、CSS 和Flying Saucer Renderer 将HTML 转换为PDF)来将FreeMarker 模板转换为PDF:```javaimport freemarker.template.Configuration;import freemarker.template.Template;import org.xhtmlrenderer.pdf.ITextRenderer;import java.io.FileOutputStream;import java.io.OutputStream;import java.io.StringWriter;import java.util.HashMap;import java.util.Map;public class FreeMarkerToPdf {public static void main(String[] args) throws Exception {// 创建FreeMarker 配置实例Configuration cfg = new Configuration(Configuration.VERSION_2_3_31);cfg.setClassForTemplateLoading(FreeMarkerToPdf.class, "/templates");// 获取FreeMarker 模板Template template = cfg.getTemplate("your_template.ftl");// 准备数据模型Map<String, Object> dataModel = new HashMap<>();dataModel.put("name", "John Doe");// 添加其他数据...// 将模板和数据合并为HTML 字符串StringWriter stringWriter = new StringWriter();template.process(dataModel, stringWriter);String htmlContent = stringWriter.toString();// 将HTML 字符串转为PDFtry (OutputStream os = new FileOutputStream("output.pdf")) {ITextRenderer renderer = new ITextRenderer();renderer.setDocumentFromString(htmlContent);yout();renderer.createPDF(os);}}}```在这个例子中,你需要替换`"your_template.ftl"` 为你的FreeMarker 模板文件的路径。

freemarker 模板路径

freemarker 模板路径

freemarker 模板路径freemarker模板路径是指在freemarker引擎中指定模板文件所在的路径。

在使用freemarker模板进行页面渲染时,需要告诉freemarker 引擎要使用哪个模板文件来渲染页面。

因此,指定正确的模板路径非常重要,否则会导致 freemarker 引擎找不到模板文件而抛出异常。

在 freemarker 中,可以使用相对路径或绝对路径来指定模板路径。

如果使用相对路径,则相对于 freemarker 引擎当前工作目录的路径。

如果使用绝对路径,则需要指定完整的文件路径。

例如,如果我们有一个名为 'index.ftl' 的模板文件,它位于项目的根目录下的 'templates' 文件夹中,那么可以使用以下两种方式来指定模板路径:1. 使用相对路径```javaConfiguration cfg = newConfiguration(Configuration.VERSION_2_3_31);cfg.setDirectoryForTemplateLoading(newFile('templates'));Template template = cfg.getTemplate('index.ftl');```2. 使用绝对路径```javaConfiguration cfg = newConfiguration(Configuration.VERSION_2_3_31);cfg.setDirectoryForTemplateLoading(newFile('/absolute/path/to/templates'));Template template = cfg.getTemplate('index.ftl');```需要注意的是,如果使用相对路径,则需要确保 freemarker 引擎当前工作目录正确。

freemarker模板引擎 filter 方法

freemarker模板引擎 filter 方法

freemarker模板引擎 filter 方法Freemarker模板引擎——filter方法解析与应用1. 前言在Web开发领域,模板引擎是一个重要的工具,它可以将数据和页面结构进行分离,从而实现更好的代码组织和可维护性。

Freemarker作为一种强大而灵活的模板引擎,被众多开发者广泛使用。

本文将重点探讨Freemarker模板引擎中的filter方法,分析其用途和实际应用。

2. Freemarker模板引擎简介Freemarker是一款基于Java的模板引擎,旨在简化构建动态UI的过程。

它使用类似HTML的标记语法,通过预定义的指令和变量插值来生成最终的HTML、XML或其他文本输出。

作为一种非常流行的模板引擎,Freemarker提供了丰富的功能和灵活性,其中filter方法是其中一个重要的组成部分。

3. filter方法的定义与功能在Freemarker模板引擎中,filter方法用于对指定变量的值进行处理和转换,以满足特定需求。

它可以通过内置的或自定义的过滤器来实现对变量值的修改或增强。

通常,filter方法的格式如下:```${variableName?filterName}```其中,variableName表示需要处理的变量名,filterName表示所要应用的过滤器名。

通过使用filter方法,我们可以通过一条简洁的语句就完成了对变量值的转换,使得模板的编写更加简洁和易懂。

4. 内置过滤器的应用示例Freemarker模板引擎内置了许多常用的过滤器,可以直接在模板中进行使用。

下面是filter方法的几个常用过滤器实例:4.1 字符串截断过滤器```${article.content?truncate(100)}```上述代码中,我们通过truncate过滤器将article.content变量的值截断为最多100个字符的字符串,从而保证在输出时不会超出限定长度。

这样,无论内容长度如何,都能在页面上展示合适的文本长度。

freemarker 模板 语法

freemarker 模板 语法

Freemarker模板语法在现代互联网时代,全球信息湾的开发和管理变得越来越重要。

为了提供更好的用户体验,全球信息湾的前端设计和展示变得尤为关键。

而在前端设计中,模板语法是一个不可或缺的部分。

在这篇文章中,我们将深入探讨Freemarker模板语法,一种常用的模板引擎,它提供了丰富的语法和功能,用于生成动态内容。

1. 概述Freemarker是一种基于模板的通用文本生成器,它主要用于生成HTML网页、电流信箱、配置文件等。

作为一种开源软件,Freemarker具有简单、灵活、强大的特点,成为了众多开发者的首选工具之一。

2. 基本语法Freemarker模板语法主要包括标签指令、表达式和插值等。

在Freemarker模板中,可以使用<#...>标签来定义指令,通过${...}来插入变量值。

这种简洁而强大的语法使得模板的编写变得轻而易举。

3. 数据模型在Freemarker中,数据模型是一个包含所有数据的上下文环境。

它可以包含简单的数据类型,如字符串、数字,也可以包含复杂的数据结构,如列表、字典等。

通过数据模型,我们可以在模板中动态地展示不同的数据内容,实现个性化的页面展示。

4. 控制指令Freemarker提供了丰富的控制指令,如if、else、elseif、list、include等,这些指令可以让我们在模板中进行条件判断、循环遍历等操作,从而实现灵活多变的页面展示效果。

5. 自定义指令除了内置的指令之外,Freemarker还支持自定义指令的编写和使用。

通过自定义指令,我们可以更加灵活地扩展Freemarker的功能,实现更加个性化的模板设计。

6. 总结回顾通过本文的介绍,我们对Freemarker模板语法有了全面而深入的了解。

它简洁而灵活的语法,丰富而强大的功能,使其成为了前端开发中不可或缺的一部分。

在实际应用中,我们可以根据具体的需求,灵活运用Freemarker的语法和功能,实现精美而动态的页面展示效果。

freemarker模板引擎_tostring方法_概述说明

freemarker模板引擎_tostring方法_概述说明

freemarker模板引擎tostring方法概述说明1. 引言1.1 概述本文是关于freemarker模板引擎的tostring方法的概述说明。

我们将介绍freemarker模板引擎的基本概念以及tostring方法的作用和功能,同时提供使用示例和对其优缺点进行分析。

1.2 文章结构文章主要由五个部分组成:引言、freemarker模板引擎tostring方法的概述说明、tostring方法的优缺点分析、如何使用freemarker模板引擎的tostring方法实现特定需求以及结论。

每个部分将依次展开对应内容,并提供相关案例和建议。

1.3 目的本文旨在全面介绍freemarker模板引擎的tostring方法,包括其作用、功能、优缺点以及如何利用该方法实现特定需求。

通过深入理解这一特性,读者可以更好地利用freemarker模板引擎开发应用程序,并了解其未来发展和应用方向。

(注意:本段无需网址信息)2. freemarker模板引擎tostring方法概述说明2.1 freemarker模板引擎简介Freemarker是一款基于Java的模板引擎,它的主要功能是根据数据和模板生成输出文本。

作为一个开源项目,Freemarker提供了丰富的特性和灵活性,使其成为开发者们广泛采用的选择之一。

2.2 tostring方法的作用和功能在Freemarker中,tostring方法用于将数据对象转化为字符串的形式。

该方法能够将包含动态内容的模板进行解析,并根据数据对应的值生成最终的字符串结果。

tostring方法具有以下几个重要功能:a) 数据和模板结合:通过调用tostring方法,我们可以将指定的数据对象与预定义好的模板进行结合。

这样,我们就能够动态地替换模板中相应位置上的变量或表达式,并生成最终所需的输出文本。

b) 字符串拼接与格式化:tostring方法还允许我们在文本生成过程中进行字符串拼接、格式化等操作。

freemarker原理和用法

freemarker原理和用法

freemarker原理和用法Freemarker是一个模板引擎,它提供了一种用于生成动态Web页面的方式。

该引擎将模板与数据组合在一起创建HTML、XML或其他格式的输出文档。

该引擎依赖于模板中的变量,这些变量用于在合适的位置动态地生成内容。

在本文中,我们将详细讨论Freemarker的原理和用法。

一、Freemarker原理Freemarker模板引擎的原理是基于模板和数据的组合。

模板包含动态生成内容的标记和指令,而数据则存储在模板中需要显示的元素,将数据与模板组合在一起生成所需的输出文档。

1. 模板Freemarker模板是一个包含文本和标记的文件。

标记指令以$开头,被双大括号{{}}包含起来,并用于表示应该在输出文档中生成动态内容的位置。

例如,$ {}表示在输出文档中应该显示用户的名称。

2. 数据数据是用于填充模板中指令的值。

这些值可以存储在Java对象、数据库、XML文档或其他数据源中。

在合适的位置,将数据与指令组合在一起,生成所需的输出文档。

二、Freemarker用法使用Freemarker模板引擎的过程通常包含以下步骤:1. 编写模板编写一个包含Freemarker指令和标记的模板文件。

该文件必须包含正确的元数据和指令,以告诉模板引擎什么时候生成所需的动态数据。

2. 创建数据模型数据模型是用于指定需要在模板中使用的变量值和其它数据的对象。

在Java中,可以使用Map、POJO和其他对象来创建数据模型。

在数据模型中指定的变量将可供模板使用来动态生成输出文档。

3. 管理模板使用模板管理器类,可以将模板文件加载到内存中,并将其准备好在特定时刻生成所需的输出文档。

4. 处理模板使用模板引擎将模板和数据模型组合起来,生成所需的输出文档。

在处理模板时,模板引擎通常会将指令和标记替换为与其关联的数据值。

5. 输出文档生成HTML、XML或其他格式的输出文档,然后将其返回给客户端或输出到磁盘或其他位置。

使用freemarker做邮件发送模板

使用freemarker做邮件发送模板

使⽤freemarker做邮件发送模板1、解析⼯具类package com.example.springbootfreemarker.utils;import freemarker.template.Configuration;import freemarker.template.Template;import freemarker.template.TemplateException;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.ui.freemarker.FreeMarkerTemplateUtils;import java.io.File;import java.io.FileWriter;import java.io.IOException;import java.io.PrintWriter;import java.util.Map;public class FreeMarkerTemplateUtil {public String getEmailHtml(Map map, String templateName) {String htmlText = "";Configuration configuration = new Configuration(Configuration.VERSION_2_3_27);try {//加载模板路径configuration.setClassLoaderForTemplateLoading(ClassLoader.getSystemClassLoader(),"ftl");//获取对应名称的模板Template template = configuration.getTemplate(templateName);//渲染模板为htmlhtmlText = FreeMarkerTemplateUtils.processTemplateIntoString(template, map);} catch (Exception e) {e.printStackTrace();}return htmlText;}/*** 输出到控制台*/public void print(String name, Map<String, Object> root) throws TemplateException, IOException {//通过Template可以将模板⽂件输出到相应的流Template template = this.getTemplate(name);template.process(root, new PrintWriter(System.out));}/*** 获取模板信息** @param name 模板名* @return*/public Template getTemplate(String name) {//通过freemarkerd Configuration读取相应的ftlConfiguration cfg = new Configuration(Configuration.VERSION_2_3_25);//设定去哪⾥读取相应的ftl模板⽂件,指定模板路径cfg.setClassLoaderForTemplateLoading(ClassLoader.getSystemClassLoader(), "ftl");try {//在模板⽂件⽬录中找到名称为name的⽂件Template template = cfg.getTemplate(name);return template;} catch (IOException e) {e.printStackTrace();}return null;}}测试: //填充模板⽂件中的参数值Map<String, Object> root = null;FreeMarkerTemplateUtil freeMarkerTemplateUtil = null;@Beforepublic void setUp(){freeMarkerTemplateUtil = new FreeMarkerTemplateUtil();root = new HashMap<String, Object>();}@Testpublic void testCreateHtml() throws Exception{root.put("username", "admin");String emailHtml = freeMarkerTemplateUtil.getEmailHtml(root, "reg.ftl"); // System.out.println(">>>>" + emailHtml);root.put("username", "root");freeMarkerTemplateUtil.print("reg.ftl", root);}源码参照:。

freemarker的 template的txt模板

freemarker的 template的txt模板

freemarker的template的txt模板FreeMarker 是一个用于生成文本输出的模板引擎,支持在模板中插入变量、条件语句、循环语句等。

下面是一个简单的FreeMarker 模板示例,用于生成纯文本(.txt)输出。

假设有一个包含员工信息的列表,我们想要生成一个包含员工名单的纯文本报告,模板如下:```freemarker<#assign employees = [{"name": "Alice", "position": "Manager", "salary": 60000},{"name": "Bob", "position": "Developer", "salary": 50000},{"name": "Charlie", "position": "Designer", "salary": 55000}]>Employee Report:<#list employees as employee>Name: ${}Position: ${employee.position}Salary: ${employee.salary}</#list>```在这个示例中,使用`<#assign>` 定义了一个包含员工信息的列表。

然后使用`<#list>` 循环遍历每个员工,并使用`${...}` 插值语法输出员工的姓名、职位和薪水。

在实际应用中,你可以将这个模板与FreeMarker 引擎结合使用,将数据传递给模板,生成最终的文本输出。

freemarker模板解析过程

freemarker模板解析过程

freemarker模板解析过程
例如:⼀个freemarker表达式<body> ${hello} </body>,会被解析成三个部分,分别是
<body>
${hello}
</body>
前⾯和后⾯的body标签,在freemarker中被定义为TextBlock,中间的变量定义为DollarVariable。

那么⽬前的结构也就是RootExpression = TextBlock DollarVariable TextBlock。

解释器⼀进来将会对RootExpression进⾏解析,RootExpression将会依次调⽤TextBlock DollarVariable TextBlock进⾏解析。

不同类型将会做不同操作,根据传进来的Context参数进⾏相应赋值并输出等。

当Template启动解释时,由Environment进⼊调⽤根元素的访问动作,根元素会依次访问所包含的TemplateElement,直到所有叶⼦节点访问完成,这些访问动作是通过调⽤Environment的visit⽅法控制,Environment做些相关必要操作,再根据访问的节点类型调⽤相应节点的访问操作。

当访问到包含需要解释器的元素节点时,则会启动解释器做解释操作,根据Expression类型,调⽤getStringValue,并传⼊参数Environment,相应类型的表达式根据Environment解释得到输⼊字符串的值,返回并写到响应流,即解释完成。

FreeMarer模板加载,使用FreeMarker加载远程主机上模板文件

FreeMarer模板加载,使用FreeMarker加载远程主机上模板文件

FreeMarer模板加载,使⽤FreeMarker加载远程主机上模板⽂件FreeMarer 模板加载,使⽤FreeMarker加载远程主机上模板⽂件FreeMarker加载模板⽂件的三种⽅式:1、从⽂件⽬录加载2、从类路径加载3、从Servlet上下⽂加载其中第⼆个和第三个常⽤在Web开发环境中,类路径也会使⽤在普通的Java Project中,如果模板⽂件不是和应⽤程序放在同⼀台主机上,那么如何去读取和解析这些模板⽂件呢?答案是可以解决的,FreeMarker就提供给⼀种加载模板的⽅式,查看API就有URLTemplateLoader类,该类为抽象类,从名字就可以看出从给定的URL加载模板⽂件,这个URL并没有限定来源,来源可实现从FTP服务器,Hadoop,db等等。

那么可以⾃定义个加载器,从这个类继承,实现⾥⾯的getUrl⽅法即可:/*** ⾃定义远程模板加载器,⽤来加载远程机器上存放的模板⽂件.HTTP** @author wanglijun**/public class RemoteTemplateLoader extends URLTemplateLoader {// 远程模板⽂件的存储路径(⽬录)private String remotePath;private List<String> includePaths;public RemoteTemplateLoader(String remotePath) {if (remotePath == null) {throw new IllegalArgumentException("remotePath is null");}this.remotePath = canonicalizePrefix(remotePath);if (this.remotePath.indexOf('/') == 0) {this.remotePath = this.remotePath.substring(this.remotePath.indexOf('/') + 1);}}@Overridepublic Object findTemplateSource(String name) throws IOException {if(this.includePaths!=null&&this.includePaths.contains(name)){return super.findTemplateSource(name);}return null;}@Overrideprotected URL getURL(String name) {// name = name.replace("_zh", "");String fullPath = this.remotePath + name;System.out.println(fullPath);if ((this.remotePath.equals("/")) && (!isSchemeless(fullPath))) {return null;}URL url = null;try {url = new URL(fullPath);} catch (MalformedURLException e) {e.printStackTrace();}return url;}private static boolean isSchemeless(String fullPath) {int ln = fullPath.length();if ((i < ln) && (fullPath.charAt(i) == '/'))i++;while (i < ln) {char c = fullPath.charAt(i);if (c == '/')return true;if (c == ':')return false;i++;}return true;}public void setRemotePath(String remotePath) {this.remotePath = remotePath;}public List<String> getIncludePaths() {return includePaths;}public void setIncludePaths(List<String> includePaths) {this.includePaths = includePaths;}}Spring MVC配置⽂件如下:<!-- 针对free marker的视图 --><bean id="viewResolver"class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver"><property name="cache" value="false" /><property name="order" value="1" /><property name="viewClass"value="org.springframework.web.servlet.view.freemarker.FreeMarkerView" /><!-- <property name="viewNames"> <array> <value>*.ftl</value> </array></property> --><property name="requestContextAttribute" value="request" /><property name="exposeSpringMacroHelpers" value="true" /><property name="exposeRequestAttributes" value="true" /><property name="exposeSessionAttributes" value="true" /><property name="allowSessionOverride" value="true" /><!--编码 --><property name="contentType" value="text/html;charset=UTF-8" /></bean><bean id="freeMarkerConfigurer"class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer"><property name="configuration" ref="freemarkerConfiguration" /></bean><bean id="remoteTemplateLoader" class="com.saic.demo.web.RemoteTemplateLoader"> <constructor-arg name="remotePath" value="http://192.168.1.20:9090/" /><!--设置远程加载路径--><property name="includePaths"><list><value>footer.ftl</value><value>common/footer.ftl</value></list></property><util:list id="preTemplateLoaders" list-class="java.util.ArrayList"value-type="com.saic.demo.web.RemoteTemplateLoader"><ref bean="remoteTemplateLoader" /></util:list><bean id="freemarkerConfiguration"class="org.springframework.ui.freemarker.FreeMarkerConfigurationFactoryBean"><property name="postTemplateLoaders" ref="preTemplateLoaders" /><!-- 模板加载路径 --><property name="templateLoaderPaths"><list><value>/WEB-INF/views/</value><value>classpath:/views/</value></list></property><property name="defaultEncoding" value="utf-8" /></bean>需要注意的是:通过远程加载模板,FreeMarker没有check远程加载此⽂件是否存在,所以只能通过本地列表(includePaths)判断是否存在,加快模板加载速度。

freemarker 模板路径

freemarker 模板路径

freemarker 模板路径Freemarker模板路径是指在使用Freemarker进行模板渲染时,Freemarker 引擎所使用的模板文件的存储路径。

在使用 Freemarker 进行开发时,我们通常需要在项目中指定模板路径,然后利用Freemarker 引擎进行模板渲染并生成 HTML 页面。

在指定模板路径时,我们需要考虑以下几个因素:1. 存储路径:首先,我们需要确定模板文件所存储的路径,即模板文件在项目中的位置。

通常情况下,模板文件存放在项目的某个文件夹中,可以是项目的根目录下的一个文件夹,也可以是src/main/resources 下的一个文件夹。

2. 路径格式:在指定模板路径时,我们需要注意路径的格式。

不同操作系统下,文件路径的格式可能会有所不同。

在 Windows 系统下,文件路径通常以 '' 作为分隔符,而在 Linux 和 Mac OS 系统下,则是以 '/' 作为分隔符。

因此,在指定模板路径时,我们需要根据当前操作系统来选择相应的路径分隔符。

3. 模板名称:在指定模板路径时,我们还需要指定要使用的模板文件的名称。

通常情况下,模板文件的名称以 '.ftl' 或 '.html' 结尾,以表示它是一个 Freemarker 模板文件或者 HTML 文件。

例如,在一个 Spring Boot 项目中,我们可以在application.properties 文件中指定 Freemarker 模板的存储路径:spring.freemarker.template-loader-path=classpath:/templates/这里,我们将模板文件存放在 src/main/resources/templates 文件夹中,并以 classpath:/templates/ 的形式指定了模板路径。

这样,当我们在控制器中调用 Freemarker 引擎进行模板渲染时,它会自动找到该路径下的模板文件并进行渲染。

freemarker(ftl)模板开发常用方法(迭代,数值格式化等)

freemarker(ftl)模板开发常用方法(迭代,数值格式化等)

freemarker(ftl)模板开发常⽤⽅法(迭代,数值格式化等)1.if-else常⽤<#if signStatus??> //如果signStatus值存在 <#if signStatus=='2'>是<#else>否</#if> <#else> 否</#if>if-elseif-else1 <#if condition>2 ...3 <#elseif condition2>4 ...5 <#elseif condition3>6 ...7 ...8 <#else>9 ...10 </#if>2.时间格式化时间戳转⽇期 ${time?number_to_datetime} ${time?number*1000} 时间戳乘1000⽇期格式化 ${dateTime?string('yyyy-MM-dd hh:mm:ss')} 格式化为 2020-11-12 15:05:29 ${dateTime?string('yyyy-MM-dd ')} 格式化为 2020-11-123.数值格式化数值如果有⼩数保留两位⼩数,否则补0两位,例如128.81, 688则为 688.00${((totalInvoice.amount)!0)?string('###,##0.00')}特别需要注意的是 ?前⾯的数值需要括号()⽐如:${additionsTotalAmt!0?string('###,##0.00')}⽆效果,⽽正确的是 ${(additionsTotalAmt!0)?string('###,##0.00')}另外,1 ${num?string('0.00')}2如果⼩数点后不⾜两位,⽤ 0 代替34 ${num?string('#.##')}5如果⼩数点后多余两位,就只保留两位,否则输出实际值6输出为:1239765.4678 ${num?string(',###.00')}9输出为:1,239,765.4610整数部分每三位⽤ , 分割,并且保证⼩数点后保留两位,不⾜⽤ 0 代替1112 ${num?string(',###.##')}13输出为:1,239,765.4614整数部分每三位⽤ , 分割,并且⼩数点后多余两位就只保留两位,不⾜两位就取实际位数,可以不不包含⼩数点1516 ${num?string('000.00')}17输出为:012.7018整数部分如果不⾜三位(000),前⾯⽤0补齐,否则取实际的整数位1920 ${num?string('###.00')}21等价于22 ${num?string('#.00')}23输出为:12.70参考https:///qq_32534855/article/details/676317881 ${price?string.currency}23对price进⾏格式化,显⽰为货币格式。

FreeMarker使用模板生成Json数据

FreeMarker使用模板生成Json数据

FreeMarker使⽤模板⽣成Json数据⼯作中要⽤到个别字段动态变化的json数据,想到了FreeMarker + 模板来实现的⽅法,但是百度了很多内容,本地实现之后都⽆法正常运⾏。

所以研究了⼀天,才整理出来⼀份能运⾏成功的,记录⼀下:⼀、代码,这⾥我写了⼀个类FreeMarkerTemplateUtils ,放在src/test/java/路径下就⾏:package *******;import freemarker.template.Configuration;import freemarker.template.Template;import java.io.StringWriter;import java.util.HashMap;public class FreeMarkerTemplateUtils {public String getData(String filePath, HashMap<Object, Object> map) throws Exception {StringWriter writer = new StringWriter();//创建配置类Configuration cfg = new Configuration(Configuration.getVersion());// 设置类加载机制加载模板,这⾥可以参考/pgui_config_templateloading.html的内容,这是⽤的第⼆种⽅法。

cfg.setClassForTemplateLoading(this.getClass(),"/");// 设置字符集cfg.setDefaultEncoding("UTF-8");// 加载模板Template template = cfg.getTemplate(filePath);// 静态化内容template.process(map,writer);String content = writer.toString();return content;}}⼆、模板⽂件,deliverDemo.ftl,放在src/test/resources/路径下就⾏{"cityId": ${cityId},"cityName": "测试城市名","cky2": 316,"countryId": 0000}三、测试类,放在src/test/java/路径下就⾏。

freemarker !用法

freemarker !用法

freemarker !用法Freemarker是一种模板引擎,可以在Web应用中轻松地生成HTML,XML,JSON等文件。

它允许我们将数据和静态模板分离,从而使我们的代码更加清晰易读。

在这篇文章中,我们将探讨Freemarker的用法和一些最佳实践。

首先,我们需要了解Freemarker的基本语法。

Freemarker使用尖括号标记“<% %>"来定义内容块。

在这些标记内,我们可以使用变量,表达式,条件和迭代语句等。

例如,以下是一个简单的Freemarker模板:```<html><head><title>Hello, ${name}!</title></head><body><p>Welcome to our website!</p></body></html>```在这个模板中,我们使用了变量“name”。

这个变量可以在Java 代码中设置,并在生成HTML时插入到相应的位置。

为了在Java中使用Freemarker,我们需要引入Freemarker库,并创建一个Configuration对象:```Configuration cfg = newConfiguration(Configuration.VERSION_2_3_30);cfg.setClassForTemplateLoading(Main.class, "/templates"); cfg.setDefaultEncoding("UTF-8");```在这个例子中,我们设置了模板目录,并设置了默认编码为UTF-8。

然后,我们可以使用TemplateLoader从模板文件读取模板:```Template template = cfg.getTemplate("hello.ftl");```接下来,我们需要将我们的数据传递给数据模型。

freemarker的template用法

freemarker的template用法

freemarker的template用法Freemarker是一个模板引擎,主要用于生成动态内容,如HTML网页、电子邮件、配置文件等。

下面是Freemarker的一些常用模板用法:1. 变量插值:使用`${变量名}`插入变量的值。

例如:```<h1>${title}</h1>```2. 条件判断:使用`<#if>...</#if>`结构来执行条件判断。

例如:```<#if condition>...<#else>...</#if>```3. 循环迭代:使用`<#list>...</#list>`结构来进行循环迭代。

例如:```<#list items as item><li>${item}</li></#list>```4. 定义宏:使用`<#macro>...</#macro>`定义一个宏。

例如:```<#macro greet name>Hello ${name}!</#macro>```5. 调用宏:使用`<@宏名>...</@宏名>`调用一个宏。

例如:```<@greet "John" />```6. 引入外部模板:使用`<#include "模板路径">`引入外部模板。

例如:```<#include "header.ftl">```以上是Freemarker的一些常用模板用法,可以根据实际需求灵活运用。

FreeMarker模板文件的组成及基本语法详解

FreeMarker模板文件的组成及基本语法详解
${x}
</#list>
输出结果是:
星期一
星期二
星期三
星期四
星期五
星期六
星期天
除此之外,集合元素也可以是表达式,例子如下:
[2 + 2, [1, 2, 3, 4], "whatnot"]
还可以使用数字范围定义数字集合,如2..5等同于[2, 3, 4, 5],但是更有效率.注意,使用数字范围来定义集合时无需使用方括号,数字范围也支持反递增的数字范围,如5..2
1,开始标签:<#directivename parameter>
2,结束标签:</#directivename>
3,空标签:<#directivename parameter/>
实际上,使用标签时前面的符号#也可能变成@,如果该指令是一个用户指令而不是系统内建指令时,应将#符号改成@符号.
${foo?string("yes", "no")}
输出结果是:
yes
2.2 数字格式化插值
数字格式化插值可采用#{expr;format}形式来格式化数字,其中format可以是:
mX:小数部分最小X位
MX:小数部分最大X位
如下面的例子:
<#assign x=2.582/>
<#assign y=4/>
使用直接指定值语法让FreeMarker直接输出插值中的值,而不是输出变量值.直接指定值可以是字符串,数值,布尔值,集合和MAP对象.
1,字符串
直接指定字符串值使用单引号或双引号限定,如果字符串值中包含特殊字符需要转义,看下面的例子:

freemarker数据模板引擎语法

freemarker数据模板引擎语法

Freemarker数据模板引擎语法介绍一、概述1. Freemarker 是一个用Java语言编写的模板引擎。

2. 它是一个基于模板的文本生成引擎,用来生成HTML、XML、JSP等各种文本文件。

通过模板引擎,我们可以很容易地将数据和模板文件结合,生成我们想要的数据格式。

二、Freemarker语法1. 模板标签模板标签是Freemarker中最常用的语法标记,用于指定要在模板中填充的数据或进行逻辑控制。

${name}标签会被Freemarker引擎替换成name变量所代表的数据。

2. 表达式Freemarker支持丰富的表达式语法,包括数学运算、逻辑运算、字符串处理等。

${num + 1}表示将num变量的值加1。

3. 指令Freemarker提供了一系列指令用于控制模板文件的生成过程,例如条件判断、循环、导入外部文件等。

<#if condition>...</#if>指令用于条件判断。

4. 注释在Freemarker模板中,我们可以使用注释来对模板文件进行说明或标记。

<#-- This is ament -->。

三、数据模型1. 在Freemarker中,数据模型是一个数据存储对象,用于在模板中填充数据。

2. 数据模型可以是Java中的对象、集合、数组等。

3. 我们可以使用<#list>指令对数据模型进行遍历。

4. 数据模型可以通过<#assign>指令或在模板引擎中进行设置。

5. 在模板中访问数据模型的数据,通常使用${data}语法。

四、模板文件1. Freemarker使用.ftl后缀作为模板文件的标识。

2. 模板文件是一个文本文件,其中包含数据模型的填充标签、表达式、指令等。

3. 我们可以在模板文件中嵌套使用数据模型和指令,以便动态生成文本数据。

4. 模板文件一般存放在项目的特定目录,供程序在运行时读取并进行生成。

五、应用实例1. 我们可以使用Freemarker来生成Web页面,动态填充页面中的数据。

FreeMarker解析字符串模板

FreeMarker解析字符串模板
29.}
30.}
31.
32.publicvoidcloseTemplateSource(Object templateSource)
33.throwsIOException {
34.
35.}
36.
37.publicObject findTemplateSource(String name)throwsIOException {
45.return0;
46.}
47.
48.publicReader getReader(Object templateSource, String encoding)
49.throwsIOException {
50.returnnewStringReader((String) templateSource);
51.}
52.
53.}
Java代码
1.测试类:
.aweb.vote.test.other;
3.
4.importjava.io.StringWriter;
5.importjava.util.HashMap;
6.importjava.util.Map;
7.
8.importfreemarker.template.Configuration;
20.Map root =newHashMap();
21.root.put("user","lunzi");
22.
23.StringWriter writer =newStringWriter();
24.template.process(root, writer);
25.System.out.println(writer.toString());

freemarker 用法

freemarker 用法

freemarker 用法Freemarker 是一种模板引擎,广泛用于JavaWeb 开发中。

它提供了一种将数据模型与视图层分离的方式。

在使用Freemarker 进行开发时,我们首先需要了解一些基本的用法和语法规则。

本文将一步一步回答关于Freemarker 的常见问题,并介绍它的基本用法与功能。

一、什么是Freemarker?Freemarker 是一个模板引擎,它能够根据模板以及给定的数据模型生成最终的文本输出。

它使用简单明了的标记语言,允许开发者通过填充数据模型来动态生成页面内容。

二、如何引入Freemarker?要使用Freemarker,我们首先需要引入它的依赖。

通常情况下,我们可以在Maven 项目的pom.xml 文件中添加以下依赖:xml<dependency><groupId>org.freemarker</groupId><artifactId>freemarker</artifactId><version>2.3.27-incubating</version></dependency>三、如何配置Freemarker?在Spring Boot 项目中,我们可以使用`@Configuration` 注解来配置Freemarker。

通过`FreeMarkerConfigurer` 类,我们可以设置Freemarker 的一些参数,例如模板文件所在的路径、编码方式等。

java@Configurationpublic class FreemarkerConfig {@Beanpublic FreeMarkerConfigurer freeMarkerConfigurer() {FreeMarkerConfigurer configurer = new FreeMarkerConfigurer();configurer.setTemplateLoaderPath("classpath:/templates");configurer.setDefaultEncoding("UTF-8");return configurer;}}在上述代码中,我们设置了模板所在的路径为classpath:/templates,这意味着我们的模板文件将在项目resources 目录下的templates 文件夹中。

使用FreeMarker配置动态模板

使用FreeMarker配置动态模板

使⽤FreeMarker配置动态模板FreeMarker动态模板⽬录前⾔当我们开发功能时,不仅要考虑当前,也要考虑之后的迭代.对于邮件正⽂内容,有时候需要配置HTML格式,所以选择了FreeMarkerFreeMarker的依赖<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-freemarker</artifactId></dependency>其余Spring相关依赖<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>项⽬结构创建 Configuration 实例package com.lizi.util;import freemarker.template.Configuration;import freemarker.template.Template;import lombok.extern.slf4j.Slf4j;import ponent;import org.springframework.ui.freemarker.FreeMarkerTemplateUtils;import javax.annotation.PostConstruct;import java.util.Locale;/*** @author lizi* @description FreeMarkerUtil* @date 2022/01/01*/@Component@Slf4jpublic class FreeMarkerUtil {private static Configuration configuration = null;@PostConstructpublic void init() {if (null == configuration) {// 设置版本号configuration = new Configuration(Configuration.VERSION_2_3_23);// ”/template“为模板⽂件来源configuration.setClassForTemplateLoading(FreeMarkerTemplateUtils.class, "/template"); // 设置编码格式configuration.setEncoding(Locale.CHINA, "UTF-8");}}/*** @param file template⽂件路径* @param data 数据* @return String*/public static String getResult(String file, Object data) {String result = "";try {// 获取通⽤模板Template template = configuration.getTemplate(file);// 通过模板创建动态数据result = FreeMarkerTemplateUtils.processTemplateIntoString(template, data);} catch (Exception e) {log.error("processTemplateIntoString error : {} ", e.getMessage());}return result;}}package com.lizi.controller;import com.lizi.Entity.Pokemon;import com.lizi.util.FreeMarkerUtil;import org.springframework.web.bind.annotation.PostMapping;import org.springframework.web.bind.annotation.RestController;import java.util.HashMap;import java.util.Map;/*** @author lizi* @description FreeMarkerController* @date 2022/01/01*/@RestControllerpublic class FreeMarkerController {@PostMapping("/getTemplate")public String getTemplate() {// 创建数据模型Map<String, Object> dataMap = new HashMap<>(16);Map<String, Object> map = new HashMap<>(16);map.put("珍珠", "pearl");map.put("钻⽯", "diamond");Pokemon pokemon=new Pokemon();pokemon.setName("ground_dragon");pokemon.setRace("108,130,95,80,85,102");dataMap.put("strong",pokemon);dataMap.put("pokemon", map);dataMap.put("ground_dragon","108,130,95,80,85,102");return FreeMarkerUtil.getResult("template.ftl", dataMap);}}模板⽂件对于模板语⾔,可以更多的去参考官⽅⽂档,<html><#-- 传⼊类型是Map ${ground_dragon} 表⽰对Map.get("ground_dragon") --><td>${ground_dragon}</td><#-- 我传⼊的类型是Map 这⾥pokemon 表⽰Map.get("pokemon")之后获取的value 代码中也是⼀个Map --> <#if pokemon?exists><#-- list,表⽰遍历 --><#list pokemon?keys as key><tr><td>${key}</td><td>${pokemon[key]}</td></tr></#list></#if><#-- Map.get("strong") 是⼀个⾃定义类访问属性可以直接⽤.的⽅式获取 --><td>${}</td><td>${strong.race}</td></body></html>调⽤结果<html><td>108,130,95,80,85,102</td><tr><td>钻⽯</td><td>diamond</td></tr><tr><td>珍珠</td><td>pearl</td></tr><td>ground_dragon</td><td>108,130,95,80,85,102</td></body></html>1. 对于传⼊的数据模型,需要⽤Map做⼀层包装,不然会出错2. 如果对象可能不存在,需要做⼀层判断,不然会出错。

  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

下面是一个可能的数据模型: (root) |+- user = "Big Joe" | +- latestProduct | +- url = "products/greenmouse.html" |+- name = "green mouse" 数据模型类似于计算机的文件系统,latestProduct可以看作是目录,而user、url和name 看作是文件,url和name文件位于latestProduct目录中(这只是一个比喻,实际并不存在) 当FreeMarker将上面的数据模型合并到模板中,就创建了下面的输出: <html><head> <title>Welcome!</title> </head> <body> <h1>Welcome Big Joe!</h1> <p>Our latest product: <a href="products/greenmouse.html">green mouse</a>! </body> </html>
3.模板
• 在FreeMarker模板中可以包括下面三种特定部分: Ø ${…}:称为interpolations,FreeMarker会在输 出时用实际值进行替 Ø FTL标记(FreeMarker模板语言标记):类似 于HTML标记,为了与HTML标记区分,用#开始 (有些以@开始,在后面叙述) Ø 注释:包含在<#--和-->(而不是<!--和-->)之间
2.数据模型
典型的数据模型是树型结构,可以任意复杂和深层次 ,如下面的例子 (root) | +- animals| | | +- mouse | | | | பைடு நூலகம் +- size = "small" | | | | +- price = 50 | | | +- elephant| | | | | +- size = "large" | | | | | +- price = 5000 | || +- python | | | +- size = "medium" | | | +- price = 4999 | +- test = "It is a test“ |+- whatnot |+- because = "don't know"
下面是一些使用指令的例子: Ø if指令
<#if animals.python.price < animals.elephant.price> Pythons are cheaper than elephants today. <#else> Pythons are not cheaper than elephants today. </#if> Ø list指令 <p>We have these animals: <table border=1> <tr><th>Name<th>Price <#list animals as being> <tr><td>${}<td>${being.price} Euros </#list> </table> 输出为: <p>We have these animals: <table border=1> <tr><th>Name<th>Price <tr><td>mouse<td>50 Euros <tr><td>elephant<td>5000 Euros <tr><td>python<td>4999 Euros </table>
你可以在HTML(或其它要输出的文本)中加入一些特定指令, FreeMarker会在输出页面给最终用户时,用适当的数据替代这些代码 下面是一个例子: <html> <head> <title>Welcome!</title> </head> <body> <h1>Welcome ${user}!</h1> <p>Our latest product: <a href="${latestProduct.url}">${}</a>! </body> </html> 这个例子是在简单的HTML中加入了一些由${…}包围的特定代码,这些特定代码是 FreeMarker的指令,而包含FreeMarker的指令的文件就称为模板(Template ) 至于user、latestProduct.url和来自于数据模型(data model) 数据模型由程序员编程来创建,向模板提供变化的信息,这些信息来自于数据库、 文件,甚至于在程序中直接生成模板设计者不关心数据从那儿来,只知道使用已经 建立的数据模型
FreeMarker模板
1、快速入门
2、特性比较清单 、
• • • • • • • • • • • • • • • 下面是使用FreeMarker能够实现的: 能够实现的: 下面是使用 能够实现的 (1)数字和日期支持 ) l 可以对任何数字类型进行算术运算和比较, 可以对任何数字类型进行算术运算和比较,包括精度类型 l 可以比较和显示(格式化)日期/时间值 可以比较和显示(格式化)日期 时间值 (2)国际化 ) l 根据各种内建和定制的数字格式, 根据各种内建和定制的数字格式,格式化本地敏感的数字 l 根据各种内建和定制的日期格式, 根据各种内建和定制的日期格式,格式化本地敏感和时区敏感的日期 l 标识(变量名)可以包含非英语字符,如重音字符、阿拉伯字符、 标识(变量名)可以包含非英语字符,如重音字符、阿拉伯字符、中文字符等 (3)循环处理 ) l 可以跳出循环 l 可以在循环外访问循环体内的控制变量 l 可以测试是否达到最后一次循环 (4)模板级别的数组处理 ) l 可以使用类似[i]语法的索引方式访问数组元素 可以使用类似 语法的索引方式访问数组元素 l 可以查询数组长度 …...
(14)高级模板元程序 可以捕获输出的任何部分到context变量中 可以解释任何context变量,如果它是一个模板定义 上述两者的结合使用
1.模板 + 数据模型 = 输出
• FreeMarker基于设计者和程序员是具有不同专业 技能的不同个体的观念 • 他们是分工劳动的:设计者专注于表示——创建 HTML文件、图片、Web页面的其它可视化方面; 程序员创建系统,生成设计页面要显示的数据 • 经常会遇到的问题是:在Web页面(或其它类型 的文档)中显示的信息在设计页面时是无效的, 是基于动态数据的
(9)高级render控制 可以使用一组标记来封装模板的一块区域,以便在块区中所有要修改的地方应用 HTML或XML转义(或其它使用FreeMarker表达式表示的转换) FreeMarker有转换器,它们是模板的一块区域,在render时,通过转换过滤;内建 的转换器包括空白字符压缩、HTML和XML转义;你可以实现自己的转换器;当然转换器 可以嵌套 可以使用flush指令显式的flush输出 可以使用stop指令停止render (10)文字 除了通常的字符串、数字和布尔值文字,也可以在模板中定义list和map文字 支持所有的Java转义文字:\b、\t、\n、\f、\r、\”、\’、\\,也支持\xXXXX使用UNICODE 指定字符 (11)高级空白字符移除 FreeMarker坚持移除各行只包含不输出FreeMarker标记的空白字符 对于明显要整修掉不需要的空白字符的指令来说,空白字符是个大问题 (12)集成其它技术 可以在模板中使用JSP标记库 可以直接在Python工程中使用 13)强大的XML转换能力 在2.3版本中,FreeMarker具有强大的新XML转换能力,使得替代XSLT成为可能 Velocity在这方面是无法真正竞争的,除非改进核心引擎,如支持宏库映射到名字空 间,宏中支持局部变量
Ø
include指令
<html> <head> <title>Test page</title> </head> <body> <h1>Test page</h1> <p>Blah blah... <#include "/copyright_footer.html"> </body> </html> Ø 一起使用指令 <p>We have these animals: <table border=1> <tr><th>Name<th>Price <#list animals as being> <tr> <td> <#if being.size = "large"><b></#if> ${} <#if being.size = "large"></b></#if> <td>${being.price} Euros </#list> </table>
(5)宏 宏可以有局部变量 可以递归调用宏,同样可以在模板的后面定义要调用的宏 调用宏时,可以按位置或名字的方式传递参数 宏参数可以有缺省值,使得在调用时忽略参数也有效 调用的宏可以有嵌套的体内容(<@myMacro>body</@myMacro>),能够在宏被 调用时进行处理 宏是纯变量的,可以基于表达式来执行宏,或者作为参数传递给另一个宏 (6)命名空间可以对变量使用多命名空间,这对创建宏库很重要,因为这可以避免 应用程序中指定的变量和宏库中变量的名字冲突 (7)使用内建的函数/操作符维护Java无关的string、list和map可以将字符串转换成 大/小写、首字符大/小写,对HTML、XML或RTF进行转义处理,substring、split、查 询字符串长度、find/replace子串等等 通过索引访问list元素,获得子list,合并list,查询list长度,对list排序 通过key变量访问map元素,检查map是否为空. (8)揭示模板中的错误 当访问一个未定义的变量,FreeMarker不会沉默;你可以配置FreeMarker来停止 render模板显示错误信息,或者跳过错误部分;无论哪种,FreeMarker都会记录问题 (日志) 在写错指令名时,FreeMarker会抛出异常
相关文档
最新文档