1.1. 什么是freemarker
FreeMarker是一个用Java语言编写的模板引擎,它基于模板来生成文本输出。FreeMarker与Web容器无关,即在Web运行时,它并不知道Servlet或HTTP。它不仅可以用作表现层的实现技术,而且还可以用于生成XML,JSP或Java 等。
目前企业中:主要用Freemarker做静态页面或是页面展示
1.2. Freemarker的使用方法
把freemarker的jar包添加到工程中。
Maven工程添加依赖
[html]view plain copy<dependency><groupId>org.freemarker</groupId><artifactId>freemarker</artifactId><version>2.3.23</version></dependency>
原理:
使用步骤:
第一步:创建一个Configuration对象,直接new一个对象。构造方法的参数就是freemarker对于的版本号。
第二步:设置模板文件所在的路径。
第三步:设置模板文件使用的字符集。一般就是utf-8.
第四步:加载一个模板,创建一个模板对象。
第五步:创建一个模板使用的数据集,可以是pojo也可以是map。一般是Map。
第六步:创建一个Writer对象,一般创建一FileWriter对象,指定生成的文件名。
第七步:调用模板对象的process方法输出文件。
第八步:关闭流。
[java]view plain copy@TestpublicvoidgenFile()throwsException{//第一步:创建一个Configuration对象,直接new一个对象。构造方法的参数就是freemarker对于的版本号。Configurationconfiguration=newConfiguration(Configuration.getVersion());//第二步:设置模板文件所在的路径。configuration.setDirectoryForTemplateLoading(newFile("D:/workspaces-itcast/term197/taotao-item-web/src/main/webapp/WEB-INF/ftl"));//第三步:设置模板文件使用的字符集。一般就是utf-8.configuration.setDefaultEncoding("utf-8");//第四步:加载一个模板,创建一个模板对象。Templatetemplate=configuration.getTemplate("hello.ftl");//第五步:创建一个模板使用的数据集,可以是pojo也可以是map。一般是Map。MapdataModel=newHashMap<>();//向数据集中添加数据dataModel.put("hello","thisismyfirstfreemarkertest.");//第六步:创建一个Writer对象,一般创建一FileWriter对象,指定生成的文件名。Writerout=newFileWriter(newFile("D:/temp/term197/out/hello.html"));//第七步:调用模板对象的process方法输出文件。template.process(dataModel,out);//第八步:关闭流。out.close();}
1.3. 模板的语法
1.3.1. 访问map中的key
${key}
1.3.2. 访问pojo中的属性
Student对象。学号、姓名、年龄
${key.property}
1.3.3. 取集合中的数据
<#liststudentListasstudent>
${student.id}/${studnet.name}
</#list>
循环使用格式:
<#list要循环的数据as循环后的数据>
</#list>
1.3.4. 取循环中的下标
<#list studentList as student>
${student_index}
</#list>
1.3.5. 判断
<#ifstudent_index % 2 == 0>
<#else>
</#if>
1.3.6. 日期类型格式化
直接取值:${date}(date是属性名)如果传来的是一个Date型数据会报错
${date?date} -9-13
${date?time} 17:53:55
${date?datetime} -9-13 17:53:55
1.3.7. Null值的处理
如果直接取一个不存在的值(值为null)时会报异常
${aaa}
处理: ${aaa!”默认值”}或者${aaa! }代表空字符串
1.3.8. Include标签
<#include “模板名称”>
(相当于jstl中的包含)
1.4. Freemarker整合spring
引入jar包:
Freemarker的jar包
1.4.1. 创建整合spring的配置文件
[html]view plain copy<?xmlversionxmlversion="1.0"encoding="UTF-8"?><beansxmlnsbeansxmlns="/schema/beans"xmlns:xsi="/2001/XMLSchema-instance"xmlns:p="/schema/p"xmlns:context="/schema/context"xmlns:dubbo="/schema/dubbo"xmlns:mvc="/schema/mvc"xsi:schemaLocation="/schema/beans/schema/beans/spring-beans.xsd/schema/mvc/schema/mvc/spring-mvc-4.2.xsd/schema/dubbo/schema/dubbo/dubbo.xsd/schema/context/schema/context/spring-context.xsd"><beanidbeanid="freemarkerConfig"class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer"><propertynamepropertyname="templateLoaderPath"value="/WEB-INF/ftl/"/><propertynamepropertyname="defaultEncoding"value="UTF-8"/></bean></beans>需要编写一Controller进行测试
1.4.2. Controller
请求的url:/genhtml
参数:无
返回值:ok (String, 需要使用@ResponseBody)
业务逻辑:
1、从spring容器中获得FreeMarkerConfigurer对象。
2、从FreeMarkerConfigurer对象中获得Configuration对象。
3、使用Configuration对象获得Template对象。
4、创建数据集
5、创建输出文件的Writer对象。
6、调用模板对象的process方法,生成文件。
7、关闭流。
加载配置文件:
[html]view plain copy@ControllerpublicclassHtmlGenController{@AutowiredprivateFreeMarkerConfigurerfreeMarkerConfigurer;@RequestMapping("/genhtml")@ResponseBodypublicStringgenHtml()throwsException{//1、从spring容器中获得FreeMarkerConfigurer对象。//2、从FreeMarkerConfigurer对象中获得Configuration对象。Configurationconfiguration=freeMarkerConfigurer.getConfiguration();//3、使用Configuration对象获得Template对象。Templatetemplate=configuration.getTemplate("hello.ftl");//4、创建数据集MapdataModel=newHashMap<>();dataModel.put("hello","1000");//5、创建输出文件的Writer对象。Writerout=newFileWriter(newFile("D:/temp/term197/out/spring-freemarker.html"));//6、调用模板对象的process方法,生成文件。template.process(dataModel,out);//7、关闭流。out.close();return"OK";}}