看完就学会了FreeMarker 数据类型--乐字节Java

FreeMarker 数据类型

Freemarker 模板中的数据类型由如下几种：

• 布尔型：等价于 Java 的 Boolean 类型，不同的是不能直接输出，可转换为字符串输出

• 日期型：等价于 java 的 Date 类型，不同的是不能直接输出，需要转换成字符串再输出

• 数值型：等价于 java 中的 int,float,double 等数值类型

  有三种显示形式：数值型(默认)、货币型、百分比型

• 字符型：等价于 java 中的字符串，有很多内置函数

• sequence 类型：等价于 java 中的数组，list，set 等集合类型

• hash 类型：等价于 java 中的 Map 类型

布尔类型

1. 在Servlet中设置布尔类型的数据

   // 布尔类型
   request.setAttribute("flag", true);

2. 获取数据

   ```F#
   <#--
   数据类型：布尔类型
   在freemarker中布尔类型不能直接输出；如果输出要先转成字符串
   方式一：?c
   方式二：?string 或 ?string("true时的文本","false时的文本")
   -->
   ${flag?c}
   
   ${flag?string}
   
   ${flag?string("yes","no")}
   

日期类型

1. 在Servlet中设置日期类型的数据

   // 日期类型
   request.setAttribute("createDate",new Date());

2. 获取数据

   ```F#
   <#--
   数据类型：日期类型
   在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")}
      

数值类型

1. 在Servlet设置数值型的数据

   // 数值类型
   request.setAttribute("age",18); // 数值型
   request.setAttribute("salary",10000); // 数值型
   request.setAttribute("avg",0.545); // 浮点型

2. 获取数据

   ```F#
   <#--
   数据类型：数值类型
   在freemarker中数值类型可以直接输出；

   1. 转字符串
      普通字符串 ?c
      货币型字符串 ?string.currency
      百分比型字符串 ?string.percent
   2. 保留浮点型数值指定小数位（#表示一个小数位）
      ?string["0.##"]
      -->
      <#-- 直接输出数值型 -->
      ${age}
      
      ${salary}
      
      <#-- 将数值转换成字符串输出 -->
      ${salary?c}
      
      <#-- 将数值转换成货币类型的字符串输出 -->
      ${salary?string.currency}
      
      <#-- 将数值转换成百分比类型的字符串输出 -->
      ${avg?string.percent}
      
      <#-- 将浮点型数值保留指定小数位输出 （##表示保留两位小数） -->
      ${avg?string["0.##"]}
      

如有疑问，可加我私人VX[ kengwanglaoxue ],更多Java学习资料关注公众号【乐字节】获取

字符串类型

1. 在Servlet中设置字符串类型的数据

   // 字符串类型
   request.setAttribute("msg","Hello ");
   request.setAttribute("msg2","freemarker");

2. 获取数据

   ```F#
   <#--
   数据类型：字符串类型
   在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}

```F#
<#-- 如果值不存在，直接输出会报错 -->
<#--${str}-->
<#-- 使用!，当值不存在时，默认显示空字符串 -->
${str!}

<#-- 使用!"xx"，当值不存在时，默认显示指定字符串 -->
${str!"这是一个默认值"}

<#-- 使用??，判断字符串是否为空；返回布尔类型。如果想要输出，需要将布尔类型转换成字符串 -->
${(str??)?string}

### sequence 类型

1. 在Servlet中设置序列类型的数据

   ```java
   // 序列类型 （数组、List、Set）
   // 数组操作
   String[] stars = new String[]{"周杰伦","林俊杰","陈奕迅","五月天"};
   request.setAttribute("stars",stars);

   // List操作
   List citys = Arrays.asList("上海","北京","杭州","深圳");
   request.setAttribute("cityList",citys);

   // JavaBean集合
   List userList = new ArrayList<>();
   userList.add(new User(1,"zhangsan",22));
   userList.add(new User(2,"lisi",18));
   userList.add(new User(3,"wangwu",20));
   request.setAttribute("userList",userList);

2. 获取数据

   ```F#
   <#--
   数据类型：序列类型 （数组、List、Set）
   通过list指令输出序列
   <#list 序列名 as 元素名>
   ${名称}
   
   获取序列的长度 ${序列名?size}
   获取序列元素的下标 ${元素名?index}
   获取第一个元素 ${序列名?first}
   获取最后一个元素 ${序列名?last}

      倒序输出      序列名?reverse
      升序输出      序列名?sort
      降序输出      序列名?sort?reverse
      指定字段名排序    序列名?sort_by("字段名")
         注：一般是JavaBean集合，对应的字段名需要提供get方法

   -->
   <#-- 数组操作 -->
   <#list stars as star>
   下标：${star?index} -- 名字：${star}
   
   
   数组的长度：${stars?size}
   
   <#-- 获取第一个元素 -->
   第一个元素：${stars?first}
   
   <#-- 获取最后一个元素 -->
   最后一个元素：${stars?last}
   
   

   ---

   <#-- List操作 -->
   <#list cityList as city >
   ${city}
   
   
   List的size：${cityList?size}
   
   <#-- 倒序输出 -->
   <#list cityList?reverse as city >
   ${city} -
   
   
   

   <#-- 升序输出 -->
   <#list cityList?sort as city >
   ${city} -
   
   
   
   <#-- 降序输出 -->
   <#list cityList?sort?reverse as city >
   ${city} -
   
   

   ---

   <#-- JavaBean集合 -->
   <#list userList as user>
   编号：${user.userId}  
   姓名：${user.uname}  
   年龄：${user.uage}  
   
   
   

   <#-- 按照指定字段名排序 -->
   <#list userList?sort_by("uage") as user>
   ${user.uname} |
   

hash 类型

1. 在Servlet中设置hash类型的数据

   // Map操作
   Map cityMap = new HashMap<>();
   cityMap.put("sh","上海");
   cityMap.put("bj","北京");
   cityMap.put("sz","深圳");
   request.setAttribute("cityMap",cityMap);

2. 获取数据

   ```F#
   <#--
   数据类型：hash类型
   key遍历输出
   <#list hash?keys as key>
   ${key} -- ${hash[key]}
   
   value遍历输出
   <#list hash?values as value>
   ${value}
   
   -->
   <#-- key遍历输出 -->
   <#list cityMap?keys as key>
   ${key} -- ${cityMap[key]}
   
   

   <#-- value遍历输出 -->
   <#list cityMap?values as value>
   ${value} |