在乐字节学习的第16天,学习了挺多知识,下面就是我今天在乐字节学习的知识。
FreeMarker 数据类型
Freemarker 模板中的数据类型由如下几种:
布尔型:等价于 Java 的 Boolean 类型,不同的是不能直接输出,可转换为字符串输出
日期型:等价于 java 的 Date 类型,不同的是不能直接输出,需要转换成字符串再输出
数值型:等价于 java 中的 int,float,double 等数值类型
有三种显示形式:数值型(默认)、货币型、百分比型
字符型:等价于 java 中的字符串,有很多内置函数
sequence 类型:等价于 java 中的数组,list,set 等集合类型
hash 类型:等价于 java 中的 Map 类型
布尔类型
在Servlet中设置布尔类型的数据
// 布尔类型
request.setAttribute("flag",true);
获取数据
<#--
数据类型:布尔类型
在freemarker中布尔类型不能直接输出;如果输出要先转成字符串
方式一:?c
方式二:?string或?string("true时的文本","false时的文本")
-->
${flag?c}
${flag?string}
${flag?string("yes","no")}
日期类型
在Servlet中设置日期类型的数据
// 日期类型
request.setAttribute("createDate",newDate());
获取数据
<#--
数据类型:日期类型
在freemarker中日期类型不能直接输出;如果输出要先转成日期型或字符串
1.年月日?date
2.时分秒?time
3.年月日时分秒?datetime
4.指定格式?string("自定义格式")
y:年M:月d:日
H:时m:分s:秒
-->
<#--输出日期格式-->
${createDate?date}
<#--输出时间格式-->
${createDate?time}
<#--输出日期时间格式-->
${createDate?datetime}
<#--输出格式化日期格式-->
${createDate?string("yyyy年MM月dd日 HH:mm:ss")}
数值类型
在Servlet设置数值型的数据
// 数值类型
request.setAttribute("age",18);// 数值型
request.setAttribute("salary",10000);// 数值型
request.setAttribute("avg",0.545);// 浮点型
获取数据
<#--
数据类型:数值类型
在freemarker中数值类型可以直接输出;
1.转字符串
普通字符串?c
货币型字符串?string.currency
百分比型字符串?string.percent
2.保留浮点型数值指定小数位(#表示一个小数位)
?string["0.##"]
-->
<#--直接输出数值型-->
${age}
${salary}
<#--将数值转换成字符串输出-->
${salary?c}
<#--将数值转换成货币类型的字符串输出-->
${salary?string.currency}
<#--将数值转换成百分比类型的字符串输出-->
${avg?string.percent}
<#--将浮点型数值保留指定小数位输出(##表示保留两位小数)-->
${avg?string["0.##"]}
字符串类型
在Servlet中设置字符串类型的数据
// 字符串类型
request.setAttribute("msg","Hello ");
request.setAttribute("msg2","freemarker");
获取数据
<#--
数据类型:字符串类型
在freemarker中字符串类型可以直接输出;
1.截取字符串(左闭右开)?substring(start,end)
2.首字母小写输出?uncap_first
3.首字母大写输出?cap_first
4.字母转小写输出?lower_case
5.字母转大写输出?upper_case
6.获取字符串长度?length
7.是否以指定字符开头(boolean类型)?starts_with("xx")?string
8.是否以指定字符结尾(boolean类型)?ends_with("xx")?string
9.获取指定字符的索引?index_of("xx")
10.去除字符串前后空格?trim
11.替换指定字符串?replace("xx","xx")
-->
<#--直接输出-->
${msg}-${msg2}
${msg?string}-${msg2?string}
<#--1.截取字符串(左闭右开)?substring(start,end)-->
${msg2?substring(1,4)}
<#--2.首字母小写输出?uncap_first-->
${msg?uncap_first}
<#--3.首字母大写输出?cap_first-->
${msg2?cap_first}
<#--4.字母转小写输出?lower_case-->
${msg?lower_case}
<#--5.字母转大写输出?upper_case-->
${msg?upper_case}
<#--6.获取字符串长度?length-->
${msg?length}
<#--7.是否以指定字符开头(boolean类型)?starts_with("xx")?string-->
${msg?starts_with("H")?string}
<#--8.是否以指定字符结尾(boolean类型)?ends_with("xx")?string-->
${msg?ends_with("h")?string}
<#--9.获取指定字符的索引?index_of("xxx")-->
${msg?index_of("e")}
<#--10.去除字符串前后空格?trim-->
${msg?trim?length}
<#--11.替换指定字符串?replace("xx","xxx")-->
${msg?replace("o","a")}
字符串空值情况处理
FreeMarker 的变量必须赋值,否则就会抛出异常。而对于 FreeMarker 来说,null 值和不存在的变量是完全一样的,因为 FreeMarker 无法理解 null 值。
FreeMarker 提供两个运算符来避免空值:
① ! :指定缺失变量的默认值
${value!}:如果value值为空,则默认值是空字符串
${value!"默认值"}:如果value值为空,则默认值是字符串"默认值"
② ?? :判断变量是否存在
如果变量存在,返回 true,否则返回 false
${(value??)?string}
<#--如果值不存在,直接输出会报错-->
<#--${str}-->
<#--使用!,当值不存在时,默认显示空字符串-->
${str!}
<#--使用!"xx",当值不存在时,默认显示指定字符串-->
${str!"这是一个默认值"}
<#--使用??,判断字符串是否为空;返回布尔类型。如果想要输出,需要将布尔类型转换成字符串-->
${(str??)?string}
sequence 类型
在Servlet中设置序列类型的数据
// 序列类型 (数组、List、Set)
// 数组操作
String[]stars=newString[]{"周杰伦","林俊杰","陈奕迅","五月天"};
request.setAttribute("stars",stars);
// List操作
List
request.setAttribute("cityList",citys);
// JavaBean集合
List
userList.add(newUser(1,"zhangsan",22));
userList.add(newUser(2,"lisi",18));
userList.add(newUser(3,"wangwu",20));
request.setAttribute("userList",userList);
获取数据
<#--
数据类型:序列类型(数组、List、Set)
通过list指令输出序列
<#list序列名as元素名>
${名称}
获取序列的长度${序列名?size}
获取序列元素的下标${元素名?index}
获取第一个元素${序列名?first}
获取最后一个元素${序列名?last}
倒序输出 序列名?reverse
升序输出 序列名?sort
降序输出 序列名?sort?reverse
指定字段名排序序列名?sort_by("字段名")
注:一般是JavaBean集合,对应的字段名需要提供get方法
-->
<#--数组操作-->
<#liststarsasstar>
下标:${star?index}--名字:${star}
数组的长度:${stars?size}
<#--获取第一个元素-->
第一个元素:${stars?first}
<#--获取最后一个元素-->
最后一个元素:${stars?last}
<#--List操作-->
<#listcityListascity>
${city}
List的size:${cityList?size}
<#--倒序输出-->
<#listcityList?reverseascity>
${city}-
<#--升序输出-->
<#listcityList?sortascity>
${city}-
<#--降序输出-->
<#listcityList?sort?reverseascity>
${city}-
<#--JavaBean集合-->
<#listuserListasuser>
编号:${user.userId}
姓名:${user.uname}
年龄:${user.uage}
<#--按照指定字段名排序-->
<#listuserList?sort_by("uage")asuser>
${user.uname}|
hash 类型
在Servlet中设置hash类型的数据
// Map操作
Map
cityMap.put("sh","上海");
cityMap.put("bj","北京");
cityMap.put("sz","深圳");
request.setAttribute("cityMap",cityMap);
获取数据
<#--
数据类型:hash类型
key遍历输出
<#listhash?keysaskey>
${key}--${hash[key]}
value遍历输出
<#listhash?valuesasvalue>
${value}
-->
<#--key遍历输出-->
<#listcityMap?keysaskey>
${key}--${cityMap[key]}
<#--value遍历输出-->
<#listcityMap?valuesasvalue>
${value}|
FreeMarker 常见指令
assign 自定义变量指令
使用 assign 指令你可以创建一个新的变量, 或者替换一个已经存在的变量。
<#--
assign自定义变量指令
语法:
<#assign变量名=值>
<#assign变量名=值变量名=值>(定义多个变量)
-->
<#assignstr="hello">
${str}
<#assignnum=1names=["zhangsan","lisi","wangwu"]>
${num}--${names?join(",")}
if elseif else 逻辑判断指令
可以使用 if, elseif 和 else 指令来条件判断是否满足某些条件。
<#--
if,else,elseif逻辑判断指令
格式:
<#ifcondition>
...
<#elseifcondition2>
...
<#elseifcondition3>
...
<#else>
...
注:
1.condition,condition2等:将被计算成布尔值的表达式。
2.elseif和else指令是可选的。
-->
<#assignscore=80>
<#ifscore<60>
你个小渣渣!
<#elseifscore==60>
分不在高,及格就行!
<#elseifscoregt60&&scorelt80>
哎哟不错哦!
<#else>
你很棒棒哦!
<#--判断数据是否存在-->
<#assignlist="">
<#iflist??>
数据存在
<#else>
数据不存在
list 遍历指令
可以使用 list 指令来对序列进行遍历。
<#--
list指令
格式1:
<#listsequenceasitem>
格式2:
<#listsequenceasitem>
<#else>
当没有选项时,执行else指令
注:
1.else部分是可选的
2.sequence:想要迭代的项,可以是序列或集合的表达式
3.item:循环变量的名称
4.当没有迭代项时,才使用else指令,可以输出一些特殊的内容而不只是空在那里
-->
<#assignusers=["张三","李四","王五"]>
<#--遍历序列-->
<#listusersasuser>
${user}
<#--判断数据不为空,再执行遍历(如果序列不存在,直接遍历会报错)-->
<#ifusers2??>
<#listusers2asuser>
${user}
<#assignusers3=[]>
<#--当序列没有数据项时,使用默认信息-->
<#listusers3asuser>
${user}
<#else>
当前没有数据!
macro 自定义指令
可以使用 macro 指令来自定义一些自定义指令。
<#--
macro自定义指令(宏)
1.基本使用
格式:
<#macro指令名>
指令内容
使用:
<@指令名>
2.有参数的自定义指令
格式:
<#macro指令名参数名1参数名2>
指令内容
使用:
<@指令名参数名1=参数值1参数名2=参数值2>
注:
1.指令可以被多次使用。
2.自定义指令中可以包含字符串,也可包含内置指令
-->
<#--定义基本的自定义指令-->
<#macroaddress>
©1999–2015TheFreeMarkerProject.Allrightsreserved.
<#--使用指令-->
<@address>
<@address>
<#--定义有参数的自定义指令-->
<#macroqueryUserByNameuname>
通过用户名查询用户信息-${uname}
<#--使用指令,并传递参数-->
<@queryUserByNameuname="admin">
<#--定义有多个参数的自定义指令-->
<#macroqueryUserByParamsunameuage>
通过多个餐宿查询用户信息-${uname}-${uage}
<#--使用指令,并传递多个参数-->
<@queryUserByParamsuname="admin"uage=18>
<#--自定义指令中包含内置指令-->
<#macrocfb>
<#list1..9asi>
<#list1..iasj>
${j}*${i}=${j*i}
<@cfb>
<@cfb>
<#--动态数据-->
<#macrocfb2num>
<#list1..numasi>
<#list1..iasj>
${j}*${i}=${j*i}
<@cfb2num=5>
nested 占位指令
nested 指令执行自定义指令开始和结束标签中间的模板片段。嵌套的片段可以包含模板中任意合法的内容。
<#--
nested占位指令
nested相当于占位符,一般结合macro指令一起使用。
可以将自定义指令中的内容通过nested指令占位,当使用自定义指令时,会将占位内容显示。
-->
<#macrotest>
这是一段文本!
<#nested>
<#nested>
<@test>
这是文本后面的内容!
import 导入指令
import 指令可以引入一个库。也就是说,它创建一个新的命名空间, 然后在那个命名空间中执行给定路径的模板。可以使用引入的空间中的指令。
commons.ftl
<#macrocfb>
<#list1..9asi>
<#list1..iasj>
${j}*${i}=${j*i}
在其他ftl页面中通过import导入commons.ftl的命名空间,使用该命名空间中的指令
test.ftl
<#--导入命名空间-->
<#import"commons.ftl"ascommon>
<#--使用命名空间中的指令-->
<@common.cfb>
include 包含指令
可以使用 include 指令在你的模板中插入另外一个 FreeMarker 模板文件 。 被包含模板的输出格式是在 include 标签出现的位置插入的。 被包含的文件和包含它的模板共享变量,就像是被复制粘贴进去的一样。
<#--包含指令(引入其他页面文件)include-->
<#--html文件-->
<#include"test.html">
<#--freemarker文件-->
<#include"test.ftl">
<#--text文件-->
<#include"test.txt">
FreeMarker 页面静态化
通过上述介绍可知 Freemarker 是一种基于模板的、用来生成输出文本的通用工具,所以我们必须要定制符合自己业务的模板,然后生成自己的 html 页面。Freemarker 是通过freemarker.template.Configuration 这个对象对模板进行加载的(它也处理创建和缓存预解析模板的工作),然后我们通过 getTemplate 方法获得你想要的模板,有一点要记住freemarker.template.Configuration 在你整个应用必须保证唯一实例。
定义模板
news.ftl
<#--新闻标题-->
${title}
新闻来源:${source} 发布时间:${pubTime?sring("yyyy-MM-dd HH:mm")}
<#--新闻内容-->
${content}
加载模板
@WebServlet("/news")
publicclassNewsServletextendsHttpServlet{
@Override
protectedvoidservice(HttpServletRequestrequest,HttpServletResponseresponse)throwsServletException,IOException{
// 实例化模板配置对象
Configurationconfiguration=newConfiguration();
// 设置加载模板的上下文 以及 设置加载模板路径(模板存放的路径)
configuration.setServletContextForTemplateLoading(getServletContext(),"/template");
// 设置模板的编码格式
configuration.setDefaultEncoding("UTF-8");
// 加载模板文件,获取模板对象
Templatetemplate=configuration.getTemplate("news.ftl");
// 设置模型数据
Map
map.put("title","特别就业季:稳就业情况如何? 哪些问题待解?");
map.put("source","人民日报");
map.put("pubTime",newDate());
map.put("content","中共中央政治局常务委员会近日召开会议强调,"+
"要有针对性地开展援企、稳岗、扩就业工作,"+
"做好高校毕业生、农民工等重点群体就业工作,"+
"积极帮助个体工商户纾困。疫情期间,稳就业情况如何?还有哪些问题待解?"+
"记者采访了不同群体,记录这个特别的就业季。");
// 获取项目所在的根目录
StringbasePath=request.getServletContext().getRealPath("/");
// 设置页面存放的目录
FilehtmlFile=newFile(basePath+"/html");
// 判断目录是否存在
if(!htmlFile.exists()) {
// 如果目录不存在,则新建目录
htmlFile.mkdir();
}
// 获取文件名(随机生成不重复的文件名)
StringfileName=System.currentTimeMillis()+".html";
// 创建html文件
Filefile=newFile(htmlFile,fileName);
// 获取文件输出流
FileWriterwriter=newFileWriter(file);
try{
// 输出html 将模型数据填充到模板中
template.process(map,writer);
// 输出成功
System.out.println("新闻创建成功!");
}catch(TemplateExceptione) {
e.printStackTrace();
}finally{
writer.flush();
writer.close();
}
}
}
FreeMarker 运算符
算术运算符
<#assigna1=8a2=2>
${a1}+${a2}=${a1+a2}
${a1}-${a2}=${a1-a2}
${a1}*${a2}=${a1*a2}
${a1} / ${a2}=${a1/a2}
${a1}%${a2}=${a1%a2}
${"hello"+","+"freemarker"}
逻辑运算符
<#--
逻辑运算符
&&、||、!
-->
比较运算符
<#--
比较运算符
>(gt):大于号,推荐使用gt
<(lt):小于号,推荐使用lt
>=(gte):大于等于,推荐是用gte
<=(lte):小于等于,推荐使用lte
==:等于
!=:不等于
-->
空值运算符
<#--
空值运算符
1.??:判断是否为空,返回布尔类型
如果不为空返回false,如果为空返回true,不能直接输出
${(name??)?string}
2.!:设置默认值,如果为空,则设置默认值
1.设置默认为空字符串:
${name!}
2.设置指定默认值
${name!'zhangsan'}
-->