Java模版引擎之Freemarker篇

一.初识Freemarker

1.1什么是Freemarker

• Freemarker是一款模版引擎
• Freemarker不是web框架
• Freemarker官网http://http://freemarker.org

1.2 数据模型+模板输出=html（输出）

1.3前端设计师和程序员的侧重点

• MVC设计（Model,View,Controller）
• 前端设计师侧重于View（模版设计）
• 后端设计师全面掌握MVC

二.maven构建Freemarker项目

2.1 Maven构建Spring+Freemarker项目

1. Eclipse+Maven使用简介

   Maven这个项目管理和构建自动化工具，越来越多的开发人员使用它来管理项目中的jar包

2. Maven依赖Spring和FreeMarker的jar包
   pom.xml文件主要配置项目所需的jar包（这里包括spring开发所需jar包和freemarkerjar包）
   freemarker依赖如下

   
   org.freemarker
   freemarker
   2.3.20
   

3. Spring配置文件和Freemarker Servlet配置文件

   (1) Spring配置文件applicationContext.xml

   在xml配置了这个标签后，spring可以自动去扫描base-pack下面或者子包下面的Java文件，如果扫描到有@Component @Controller@Service等这些注解的类，则把这些类注册为bean

   注意：如果配置了那么标签就可以不用再xml中配置了，因为前者包含了后者。

   (2) Spring Freemarker Servlet配置文件Spring-servlet.xml

       对freemarker的配置（两种方式1：直接配置2：引入单独的文件freemark.properties）

        
            
        
    
        
            auto_detect
            0
            UTF-8
            UTF-8
            zh_CN
            true,false
            yyyy-MM-dd HH:mm:ss
            yyyy-MM-dd
            HH:mm:ss
            0.######
            true
            true
        
    

视图配置：

三.springboot集成freemarker

四.freemarker取值（插值）

4.1java中常常用的数据模型

1. 基本数据类型（比如Integer）
2. 封装的数据类型（比如User对象）
3. 集合类型：List,Map

4.2取值指令

1. 常用${var}语法进行取值
   @Controller
   @RequestMapping(“/”)
   public class FreemarkerController1 {

   //freemarker取值，插值
   @RequestMapping("/free1")
   public ModelAndView free1(){
       ModelAndView mv1 = new ModelAndView();
       mv1.addObject("intVar",100);
       mv1.addObject("LongVar",10000000000000000L);
       return mv1;
   }}
   

   整数： intVar长整数： {LongVar}

2. 对null，不存在对象取值${var！}，这样可以防止抛异常

   对于NUL或不存在的值取值时，需要${var!’默认值’}

3. 取包装对象的值，通过“点”语法：${User.name}

4. 取值的时候进行计算，赋值

   变量的赋值运算

   <#assign a=100> 声明变量a值为100.
   变量运算
   赋值： a = a显示：a=100;运算：a+100= {a + 100} 后面的表示运算 结果显示: a + 100 = 200

5. Date类型格式${date?String(‘yyyy-MM-dd’)}

   Freemarker支持的是java.sql.Date，可以直接输出，如果使用java.util.Date会报错，可以这样处理：1 使用java.sql.Date转换 2 在模板中使用?string(‘yyyy-MM-dd’)进行转换

6. 如何注意HTML内容：${var?html}

   ${(userObj.name)!}给userObj.name加括号后再加！（判空符号）表示对整体进行判空，即现对userObj判空，存在后在对name进行判空。添加?html可以输出原始字符串
   

4.3逻辑指令：if switch

4.3.1 if

if语法

if多条件判断

4.4集合List的遍历

${(userObj.name)!}给userObj.name加括号后再加！（判空符号）表示对整体进行判空，即现对userObj判空，存在后在对name进行判空。添加?html可以输出原始字符串

4.3.2 switch

每个case都要break，不然会按照顺序执行，还要有一个default，可以没有break，case还支持字符串

4.4集合Map的遍历

<#list map?keys as key>
${key}(对key取值):${map[key]（对value取值）}
<#list>

五.自定义函数简介

5.1字符串集合操作

5.1.1string基本操作指令

5.2自定义函数

使用自定义函数：

1 代码中定义：mv.addObject(“sort_int”,new SortMethod());

2 模板中使用：<#assign mylist=[1,2,3,4,5,6] />

5.3自定义指令

自定义指令用@，freemarker内敛指令用#

自定义指令在Freemarker的配置文件中配置，key为指令名称，value-ref为定义的一个bean

自定义指令需要实现TemplateDirectiveModel，重写execute方法

5.4freemarker常用内建函数

5.4.1处理字符串的内建函数

subtring：字符截取
cap_first:将字符串的第一个首字母变成大写
ends_with：以什么结尾
contains:是否包含什么
date,datetime,time 将字符串转换为date，datetime，time日期类型
stars_with:以什么开始
index_of:某个字符在某个字符串中从头（0）开始第一次出现的第几个位置（即索引）
last_index_of:某个字符在某个字符串中从尾（字符串.length-1）开始第一次出现的第几个位置（即索引)
split:以某个符号为分隔，将其结果封装成一个数组
tirm：去掉字符串首位的空格

5.4.2处理数字的内建函数

string  x?string("0.##")  对数字进行格式化
round  四舍五入
floor  把小数点去掉 
ceiling 数字进1，变成整数

5.4.3处理list的内建函数

first  取list第一个值
last  取list最后一个值
seq_contains 这个序列是否包含
seq_index_of  这个序列所在的位置
size list长度
reverse  倒序
sort  升序排序
sort_by  根据属性排序
trunk 把字符串分块处理

5.4.4其他内建函数

is函数：判断变量的类型
is_string  字符串 
is_number   整数
is_method   方法

() 对变量进行判断
hs_content 判断对象是否是空值，是不是有内容
eval 求值函数

5.5freemarker内建函数代码讲解

macro,nested,return语法

macro 代码栗子

nested 个性化设置

函数function 调用栗子

6总结