free marker 常用

yanzhiying95599

                                                1概念
最常用的3个概念
sequence  序列，对应java里的list、数组等非键值对的集合
hash      键值对的集合
namespace 对一个ftl文件的引用,利用这个名字可以访问到该ftl文件的资源
                               
2指令
if, else, elseif
语法
  ...
  ...
  ...
...
  ...
用例
  x is 1
                               
  x is 1
  x is not 1
                               
switch, case, default, break
语法
  
    ...
   
  
    ...
   
  ...
  
    ...
   
  
    ...
                               
用例
字符串
  
     This will be processed if it is small
     
  
     This will be processed if it is medium
     
  
     This will be processed if it is large
     
  
     This will be processed if it is neither
数字
  
    1
  
    2
  
    d
                               
如果x=1 输出 1 2, x=2输出 2, x=3 输出d
                               
list, break
语法
...
...
关键字
item_index:是list当前值的下标
item_has_next:判断list是否还有值
                               
用例
  ${x_index + 1}. ${x},
                               
输出
  1. winter,
  2. spring,
  3. summer,
  4. autumn   
                               
                                               
include
语法
or
options包含两个属性
encoding=”GBK” 编码格式
parse=true 是否作为ftl语法解析,默认是true，false就是以文本方式引入.注意在ftl文件里布尔值都是直接赋值的如parse=true,而不是parse=”true”
用例
/common/copyright.ftl包含内容
Copyright 2001-2002 ${me}
All rights reserved.  
模板文件
Some test
Yeah.

输出结果
Some test
Yeah.
Copyright 2001-2002 Juila Smith
All rights reserved.  
                               
Import
语法
类似于java里的import,它导入文件，然后就可以在当前文件里使用被导入文件里的宏组件
                               
用例
                               
假设mylib.ftl里定义了宏copyright那么我们在其他模板页面里可以这样使用
                               
                               
"my"在freemarker里被称作namespace
                               
compress
语法
  ...
用来压缩空白空间和空白的行
用例
(
  1 2  3   4    5
  ${moo}
  test only
                               
  I said, test only
                               
)  
输出
(1 2 3 4 5
moo
test only
I said, test only)
escape, noescape
语法
  ...
  ...
  ...
用例
主要使用在相似的字符串变量输出，比如某一个模块的所有字符串输出都必须是html安全的，这个时候就可以使用该表达式
  First name: ${firstName}
  Last name: ${lastName}
  Maiden name: ${maidenName}
相同表达式  
  First name: ${firstName?html}
  Last name: ${lastName }
  Maiden name: ${maidenName?html}
assign
语法
or
or
or
  capture this
or
  capture this
用例
生成变量,并且给变量赋值
给seasons赋予序列值
                               
给变量test加1
                               
给my namespage 赋予一个变量bgColor,下面可以通过my.bgColor来访问这个变量
                               
将一段输出的文本作为变量保存在x里
下面的阴影部分输出的文本将被赋值给x
foo
              //这种复制方式，表示把 和
        //之间的字符串赋给变量 x
    ${n}     //这里 x 的值是： 1 foo 2 foo 3 foo
  
Number of words:${x?word_list?size}//word_list 不太理解，猜测是按照词语来处理
${x}
输出：
Number of words:
    1 foo
    2 foo
    3 foo
同时也支持中文赋值，如：
  java
${语法}
打印输出:
java
global
语法
or
or
  capture this
                               
全
局赋值语法，利用这个语法给变量赋值，那么这个变量在所有的namespace中是可见的,如果这个变量被当前的assign语法覆盖
如
在当前页面里x=2将被隐藏，或者通过${.global.x}来访问
                               
setting
语法
用来设置整个系统的一个环境
locale
number_format
boolean_format
date_format, time_format, datetime_format
time_zone
classic_compatible
用例
假如当前是匈牙利的设置，然后修改成美国
${1.2}
${1.2}  
输出
1,2
1.2
因为匈牙利是采用“,”作为十进制的分隔符，美国是用“.”
                               

                               
macro, nested, return
语法
                               
  ...
  
  ...
  
  ...
用例
  Test text, and the params: ${foo}, ${bar}, ${baaz}

输出
  Test text, and the params: a, b, 23
  Test text, and the params: a, b, -1
  Test text, and the params: a, Bar, 23
  Test text, and the params: a, Bar, -1
定义循环输出的宏
  ${title?cap_first}:
  
   
      ${x?cap_first}
   
  
输出结果  
Animals:
  
      Mouse
      Elephant
      Python
  
包含body的宏
  
   
  
  ${c}. ${halfc} Last!
/@repeat>
输出
1. 0.5
  2. 1
  3. 1.5
  4. 2 Last!
                               

                               
                                               
t, lt, rt
语法
去掉左右空白和回车换行
                               
去掉左边空白和回车换行
                               
去掉右边空白和回车换行
                               
取消上面的效果
                               
                                               
3一些常用方法或注意事项
                               
                                               
表达式转换类
${expression}计算expression并输出
#{ expression }数字计算#{ expression ;format}安格式输出数字format为M和m
M表示小数点后最多的位数,m表示小数点后最少的位数如#{121.2322;m2M2}输出121.23
                               

                               
                                               
数字循环
1..5 表示从1到5，原型number..number
对浮点取整数
${123.23?int} 输出123
给变量默认值
${var?default(“hello world
”)?html}如果var is null那么将会被hello world
替代
                               
判断对象是不是null
   
      Mouse found
也可以直接${mouse?if_exists})输出布尔形
常用格式化日期
openingTime必须是Date型,详细查看freemarker文档 Reference->build-in referece->build-in for date
                               
${openingTime?date}
${openingTime?date_time}
${openingTime?time}
                               
添加全局共享变量数据模型
在代码里的实现
    cfg = Configuration.getDefaultConfiguration();
cfg.setSharedVariable("global", "you good");
页面实现可以通过global指令,具体查看指令里的global部分
直接调用java对象的方法
${object.methed(args)}  
                               
字符串处理(内置方法)
html安全输出
“abcsdfsf”?html
返回安全的html输出,替换掉html代码
xml安全输出
var?xml   
substring的用法
${user[0]}${user[4]}
${user[1..4]}
${user[1..]}
输出 :
ho
ello  
ello jeen
类似String.split的用法
“abc;def;ghi”?split(“;”)返回sequence
将字符串按空格转化成sequence,然后取sequence的长度
     var?word_list  效果同 var?split(“ ”)
var?word_list?size
                               
取得字符串长度
var?length
                               
大写输出字符
var?upper_case
                               
小写输出字符
var?lower_case
                               
首字符大写
var?cap_first
                               
首字符小写
var?uncap_first
                               
去掉字符串前后空格
var?trim
                               
每个单词的首字符大写
var?capitalize
                               
类似String.indexof:
“babcdabcd”?index_of(“abc”) 返回1
“babcdabcd”?index_of(“abc”,2) 返回5
类似String.lastIndexOf
last_index_of和String.lastIndexOf类似,同上
                               
下面两个可能在代码生成的时候使用（在引号前加”\”）
j_string: 在字符串引号前加”\”

String BEAN_NAME = "${beanName?j_string}";
打印输出:
String BEAN_NAME = "The \"foo\" bean.";
js_string:

  alert("Welcome ${user}!");
  
打印输出
alert("Welcome Big Joe\'s \"right hand\"!");
                               
替换字符串 replace
${s?replace(‘ba’, ‘XY’ )}
${s?replace(‘ba’, ‘XY’ , ‘规则参数’)}将s里的所有的ba替换成xy 规则参数包含: i r m s c f 具体含义如下:
· i: 大小写不区分.
· f: 只替换第一个出现被替换字符串的字符串
· r:  XY是正则表达式
· m:
Multi-line mode for regular expressions. In multi-line mode the
expressions ^ and $ match just after or just before, respectively, a
line terminator or the end of the string. By default these expressions
only match at the beginning and the end of the entire string.
· s:
Enables dotall mode for regular expressions (same as Perl singe-line
mode). In dotall mode, the expression . matches any character,
including a line terminator. By default this expression does not match
line terminators.
· c: Permits whitespace and comments in regular expressions.
                               
                                               
在模板里对sequences和hashes初始化
sequences  
                               
1. [“you”,”me”,”he”]
2. 1..100
3. [ {“Akey”:”Avalue”},{“Akey1”:”Avalue1”},
{“Bkey”:”Bvalue”},{“Bkey1”:”Bvalue1”},
]
                               
                                               
hashes      {“you”:”a”,”me”:”b”,”he”:”c”}
                               
                                               
注释标志
旧版本的freemarker采用的是 注释 方法
                               
sequences内置方法
sequence?first
返回sequence的第一个值;前提条件sequence不能是null
sequence?last
返回sequence最后一个值
sequence?reverse
反转sequence的值
sequence?size
返回sequence的大小
sequence?sort
对sequence按里面的对象toString()的结果进行排序
sequence?sort_by(value)
对sequence 按里面的对象的属性value进行排序
如: sequence里面放入的是10 个user对象，user对象里面包含name,age等属性
sequence?sort_by(name) 表示所有的user按user.name进行排序
hashes内置方法
hash?keys
返回hash里的所有keys, 返回结果类型sequence
hash?values
返回hash里的所有value, 返回结果类型sequence
4 freemarker在web开发中注意事项
freemarker与webwork整合
web中常用的几个对象
Freemarker的ftl文件中直接使用内部对象:
${Request ["a"]}
${RequestParameters["a"]}
${Session ["a"]}
${Application ["a"]}
${JspTaglibs ["a"]}
                               
与webwork整合之后 通过配置的servlet 已经把request,session等对象置入了数据模型中
在view中存在下面的对象
  我们可以在ftl中${req}来打印req对象
· req - the current HttpServletRequest
· res - the current HttpServletResponse
· stack - the current OgnlValueStack
· ognl - the OgnlTool instance
· webwork - an instance of FreemarkerWebWorkUtil
· action - the current WebWork action
· exception - optional the Exception instance, if the view is a JSP exception or Servlet exception view
view中值的搜索顺序
${name}将会以下面的顺序查找name值
· freemarker variables
· value stack
· request attributes
· session attributes
· servlet context attributes
在模板里ftl里使用标签
注意，如果标签的属性值是数字，那么必须采用nubmer=123方式给属性赋值
JSP页面
                               
  
   
   
   
      Keyword:
      Exclude:
      
   
  

模板ftl页面
                               
  
   
   
   
      Keyword:
      Exclude:
      
    /@html.form>
  
  
                               
                                               
如何初始化共享变量
1． 初始化全局共享数据模型
freemark在web上使用的时候对共享数据的初始化支持的不够,不能在配置初始化的时候实现，而必须通过ftl文件来初始化全局变量。这是不能满主需求的，我们需要在servlet init的时候留出一个接口来初始化系统的共享数据
具
体到和webwork整合,因为本身webwork提供了整合servlet,如果要增加全局共享变量，可以通过修改
com.opensymphony.webwork.views.freemarker.FreemarkerServlet来实现,我们可以在这个
servlet初始化的时候来初始化全局共享变量
与webwork整合配置
配置web.xml
    freemarker
    com.opensymphony.webwork.views.freemarker.FreemarkerServlet
   
      TemplatePath
/
   
   
      NoCache
      true
   
   
      ContentType
      text/html
   
   
template_update_delay
      0
   
   
      default_encoding
      GBK
   
   
      number_format
      0.##########
   
    1
  
  
    freemarker
    *.ftl
  
                               
5高级方法
自定义方法
${timer("yyyy-MM-dd H:mm:ss", x)}
${timer("yyyy-MM-dd ", x)}
                               
在
模板中除了可以通过对象来调用方法外（${object.methed(args)}）也可以直接调用java实现的方法，java类必须实现接口
TemplateMethodModel的方法exec(List args). 下面以把毫秒的时间转换成按格式输出的时间为例子
public class LongToDate implements TemplateMethodModel {
   
public TemplateModel exec(List args) throws TemplateModelException {
SimpleDateFormat mydate = new SimpleDateFormat((String) args.get(0)));
        return mydate.format(new Date(Long.parseLong((String)args.get(1)));
    }
}  
将LongToDate对象放入到数据模型中
root.put("timer", new IndexOfMethod());
ftl模板里使用
${timer("yyyy-MM-dd H:mm:ss", x)}
${timer("yyyy-MM-dd ", x)}
                               
输出
2001-10-12 5:21:12
2001-10-12
                               
自定义 Transforms
实现自定义的文本或表达式/@transform>的功能,允许对中间的最终文本进行解析转换
                               
例子：实现str/@upcase> 将str转换成STR 的功能
                               
代码如下：
import java.io.*;
import java.util.*;
import freemarker.template.TemplateTransformModel;
                               
class UpperCaseTransform implements TemplateTransformModel {
                               
    public Writer getWriter(Writer out, Map args) {
        return new UpperCaseWriter(out);
    }
                               
    private class UpperCaseWriter extends Writer {
      
        private Writer out;
           
        UpperCaseWriter (Writer out) {
            this.out = out;
        }
                               
        public void write(char[] cbuf, int off, int len)
                throws IOException {
            out.write(new String(cbuf, off, len).toUpperCase());
        }
                               
        public void flush() throws IOException {
            out.flush();
        }
                               
        public void close() {
        }
    }
}  
然后将此对象put到数据模型中
root.put("upcase", new UpperCaseTransform());
                               
在view(ftl)页面中可以如下方式使用
                               
hello world
/@upcase>
                                打印输出:
HELLO WORLD
               
               
               
               
               
               
               
               
               

本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u2/79394/showart_1804107.html