FreeMarker指南

原创 2016年08月31日 11:30:15

                  

                    一、首先了解FreeMarker

                                     FreeMarker是一个模板引擎,一个基于模板生成文本输出的通用工具,使用纯Java编写。FreeMarker被

                 设计用来生成 HTML Web页面,特别是基于MVC模式的应用程序。虽然FreeMarker具有一些编程的能力,但

                 通常由Java程序准备要显示的数据,由FreeMarker生成页面,通过模板显示准备的数据,通俗一点来讲,

                 FreeMarker就是一种基于模板的、用来生成输出文本的通用工具,基于Java的开发包和类库用来生成输出文本

                 的通用工具,基于Java的开发包和类库


                       二、FreeMarker的优点

               1.分离表现层和业务逻辑                                               
                                 使用JSP开发过程中在页面中大量的存在业务逻辑的代码,使得页面内容凌乱,在后期大量的修改

                       维护过程中就变得非常困难 。 FreeMarker根本不支持Java脚本代码,而是使用el表达式来输出展示数据。

                       FreeMarker的设计初衷就是:。模板+数据模型=输出,模板只负责数据在页面中的表现,不涉及任何的

                       逻辑代码,而所有的逻辑都是由数据模型来处理的。  用户最终看到的输出是模板和数据模型合并后创建的。                        
                        2.智能的国际化和本地化                        
                                  字符集智能化(内部使用UNICODE)、数字格式本地化敏感、日期和时间格式本地化敏感、非US

                       字符集 可以用作标识(如变量名)多种不同语言的相同模板  。

                   
                        3.提高开发效率                        
                                   在我们以往的开发中,使用的都是JSP页面来展示数据的,即所谓的表现层。我们都知道,JSP在

                        第一次执行的时候需要转换成Servlet类,开发阶段进行功能调适时,需要频繁的修改JSP,每次修改都要

                        编译和转换,那么试想一天中我们浪费在程序编译的时间有多少。 相对于JSP来说,FreeMarker模板技术

                       不存在编译和转换的问题,所以就不会存在上述问题。而且开发过程中,  我们在不必在等待界面设计开发

                      人员完成页面原形后,我们再来开发程序。                        
                        
                       4. 分工明确                        
                                   以往用JSP展现数据时,程序员并不熟悉界面设计技术,反之界面开发人员,也并不熟悉程序语言。

                       协调工作很困难 ,使用FreeMarker后,作为界面开发人员,只专心创建HTML文件、图像以及Web页面的其

                       他可视化方面,不用理会数据;而程序开发人员则专注于系统实现,负责为页面准备要显示的数据。


               三、FreeMarker的常用指令        
            
                       1、if指令
            
                            <#if(columns?size>10)> 
                             <#ifpo_index%2==0> 
                                 …. 
                             </#if> 
                             <#else> 
                                 … 
                              </#if> 
           
                        2、switch、case、default、break指令
            
                                      虽然FreeMarker提供了switch指令,但它并不推荐使用switch指令来控制也输出,而是推荐使用

                           FreeMarker的if..elseif..else指令来替代它。
            
                        3、list、break指令
            
                                       list指令时一个典型的迭代输出指令,用于迭代输出数据模型中的集合。list指令的语法格式如下:
            
                                              <#list sequenceas item> 
                                                ... 
                                              </#list> 
            
                         除此之外,迭代集合对象时,还包括两个特殊的循环变量:
                                       a、item_index:当前变量的索引值。
                                       b、item_has_next:是否存在下一个对象也可以使用<#break>指令跳出迭代
            
                        4、include指令
            
                                  include指令的作用类似于JSP的包含指令,用于包含指定页,include指令的语法格式如下
            
                                          <#include filename [options]
            
                             在上面的语法格式中,两个参数的解释如下
            
                                      a、filename:该参数指定被包含的模板文件
            
                                      b、options:该参数可以省略,指定包含时的选项,包含encoding和parse两个选项,

                                           encoding指定包含页面时所使用的解码集,而parse指定被 包含是否作为FTL文件来解析。

                                            如果省略了parse选项值,则该选项值默认是true
            
                       5、 import指令
            
                              该指令用于导入FreeMarker模板中的所有变量,并将该变量放置在指定的Map对象中,import指令的

                  语法格式如下:
            
                                           <#import path as mapObject>
            
                               在上面的语法格式中,path指定要被导入的模板文件,而mapObject是一个Map对象名,通过这行代码,

                    将导致path模板中的所有变量都被放置 在mapObject中
            
                                            <#import "/lib/common.ftl"as com>
            
                       6、noparse指令
            
                                 noparse指令指定FreeMarker不处理该指令里包含的内容,该指令的语法格式如下:
            
                                              <#noparse> 
                                                  ... 
                                              </#noparse> 
            
                       7、assign指令
            
                                   它用于为该模板页面创建或替换一个顶层变量
                  
                       8、setting指令
            
                                 该指令用于设置FreeMarker的运行环境,该指令的语法格式如下:
            
                                         <#setting name = value>
            
                                  name的取值范围包括如下几个:
            
                                              locale:该选项指定该模板所用的国家/语言选项
            
                                              number_format:该选项指定格式化输出数字的格式
            
                                              boolean_format:该选项指定两个布尔值的语法格式,默认值是"true、false"
            
                                              date_format,time_format,datetime_format:该选项指定格式化输出日期的格式
            
                                              time_zone: 设置格式化输出日期时所使用的时区

            四、java代码+测试

               1、创建Java项目

                    


                    2、导所需jar包


                                      

                                


                                3、1  创建模板目录

                         

                    3、2   在目录下创建模板文件

                         

                  4、Java代码

                        4.1 创建一个包以及一个class类

                               package com.java.fm;                    
                            
                               import java.io.File;                    
                               import java.io.OutputStreamWriter;                    
                               import java.io.Writer;                    
                               import java.util.HashMap;                    
                               import java.util.Map;                    
                            
                              import freemarker.template.Configuration;                    
                              import freemarker.template.Template;                    
                            
                    
                           public class TestFreeMarker {                    
                            
                            
                                   @SuppressWarnings("test_FM")                    
                                   public static void main(String[] args) throws Exception {                    
                            
                            
                                           //创建freemarker配置实例                    
                                           Configuration cfg = new Configuration();                    
                            
                                           //设置模板加载的目录                    
                                           cfg.setDirectoryForTemplateLoading(new File("test_fm"));                    
                            
                                          //创建数据模型                    
                                          Map<String,Object> map = new HashMap<String,Object>();                    
                                               map.put("user", "张三");                    
                            
                                          //加载模板文件                    
                                          Template template = cfg.getTemplate("test.ftl");                    
                            
                                         //显示生成数据                    
                                        Writer out = new OutputStreamWriter(System.out);                    
                                          template.process(map, out);                    
                            
                                          out.flush();                    
                                          out.close();                    
                            
                                } 
 
  

                        4.2 、在模板中写测试代码

                               
                         4.3、测试    run  or  debug

                                

相关文章推荐

FreeMarker设计指南3-模板

整体结构模板使用FTL(FreeMarker模板语言)编写,是下面各部分的一个组合: 文本:直接输出 Interpolation:由${和},或#{和}来限定,计算值替代输出 FTL标记:FreeM...
  • bwf1234
  • bwf1234
  • 2015年10月22日 15:10
  • 99

Web前端:FreeMarker技术指南

一、什么是模板引擎,为什么要用模板引擎 在B/S程式设计中,常常有美工和程序员二个角色,他们具有不同专业技能:美工专注于表现——创建页面、风格、布局、效果等等可视元素;而程序员则忙于创建程式的商业流...

FreeMarker指南

  • 2016年05月11日 18:11
  • 139KB
  • 下载

java使用freemarker模板导出word(带有合并单元格)文档

前言:最近要做一个导出word功能,其实网上有很多的例子,但是我需要的是合并单元格的,可是查了好久都没有自己想要的。研究了几天其实挺简单的,在这儿我就简单的介绍一下吧!(此方法只是一种思路,借鉴者还有...

FreeMarker设计指南

  • 2008年10月28日 08:14
  • 28KB
  • 下载

Freemarker 设计指南

  • 2008年03月09日 17:56
  • 173KB
  • 下载

淘淘商城系列——spring与freemarker的整合

spring要与freemarker整合的话,需要两个包,一个是freemarker的jar包,另一个是spring-context-support的jar包。所以我们需要在taotao-item-w...

FreeMarker设计指南(PDF版)

  • 2008年12月16日 09:22
  • 270KB
  • 下载

FreeMarker设计指南

  • 2007年11月01日 17:20
  • 26KB
  • 下载
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:FreeMarker指南
举报原因:
原因补充:

(最多只允许输入30个字)