FreeMarker整理

字符串
html    安全输出HTML
xml     安全输出xml
cap_first   首字符大写
uncap_first   首字符小写
capitalize   每个单词的首字符大写
lower_case   小写输出字符
upper_case   大写输出字符
trim     去掉字符串前后空格
length    取得字符串长度
${str[index]}   charAt(index)
${str[first..last]}  substring(first,last)
split("str")   以str分隔字符串,返回seq
word_list   分隔单词,相当于split(" ")
index_of("str")    indexOf(str)
index_of("str",index)   indexOf(str,index)
last_index_of("str")   lastIndexOf(str)
last_index_of("str",index) lastIndexOf(str,index)
j_string      在引号前加"\"，可能在代码生成的时候使用
replace("old","new")   replaceAll
replace("old","new","规则") replaceAll，规则参数包含: i r m s c f ：i: 大小写不区分/f: 只替换第一个/r:  new是正则表达式




数字
int：取得数字的整数部分（如-1.9?int的结果是-1）
string.number
string.currency
string.percent
#{expr; format}形式可以用来格式化数字，format可以是：
          mX：小数部分最小X位
          MX：小数部分最大X位



布尔
string("yes", "no")



时间
string("yyyy-MM-dd HH:mm:ss")
date 日期
time 时间
datetime 日期+时间



==或=  比较是否相等
<#t> 去掉左右空白和回车换行
<#lt>去掉左边空白和回车换行
<#rt>去掉右边空白和回车换行
<#nt>取消上面的效果
default("default word") 如果变量为null或不存在,就输出默认值
exists 如果为null或不存在则返回true
if_exists 如果存在且不为null则输出,否则不输出
has_content 如果存在,不为null,有内容则返回true(字符串为"" 或列表size=0都表示内容为空)
${r"${foo}"}${r"C:\foo\bar"} 被认为是纯文本，其中的\和{等不具有特殊含义，该类字符串在引号前面加r



　
sequences
初始化：
1. [“you”,”me”,”he”]
2. 1..100
3. [ {“Akey”:”Avalue”},{“Akey1”:”Avalue1”},{“Bkey”:”Bvalue”},{“Bkey1”:”Bvalue1”}]
first   返回第一个值;前提条件sequence不能是null
last   返回sequence最后一个值
reverse  反转sequence的值
size   返回sequence的大小
sort   按里面的对象toString()的结果进行排序
sort_by(value) 按里面的对象的属性value进行排序



hashes
初始化：{“you”:”a”,”me”:”b”,”he”:”c”}
keys 返回hash里的所有keys, 返回结果类型sequence
values 返回hash里的所有value, 返回结果类型sequence




web中常用的几个对象
Freemarker的ftl文件中直接使用内部对象:
${Request ["a"]}
${RequestParameters["a"]}
${Session ["a"]}
${Application ["a"]}
以上的内部对象在struts2中如果result的type=freemarker,那么RequestParameters将不会存在
type=freemarker时将会有以下对象:
action 代表当前处理请求的action对象
ognl org.apache.struts2.views.jsp.ui.OgnlTool
struts org.apache.struts2.util.StrutsUtil, 可用${struts.context}得到当前contextpath
stack com.opensymphony.xwork2.util.OgnlValueStack
attr  attrorg.apache.struts2.util.AttributeMap 可得到各个作用域的属性值
application 可得到application范围内的属性值
request  org.apache.struts2.dispatcher.StrutsRequestWrapper 得不到request范围内的属性值




在模板里ftl里使用标签
<#assign bean=JspTaglibs["/WEB-INF/struts-bean.tld"]>
<@bean.message key="welcome.title"/>



配置web.xml
<servlet>
    <servlet-name>freemarker</servlet-name>
    <servlet-class>com.opensymphony.webwork.views.freemarker.FreemarkerServlet</servlet-class>
    <init-param>
      <param-name>TemplatePath</param-name>
<param-value>/</param-value>
<!—模板载入文件夹，这里相对context root，递归获取该文件夹下的所有模板-->
    </init-param>
    <init-param>
      <param-name>NoCache</param-name> <!—是否对模板缓存-->
      <param-value>true</param-value>
    </init-param>
    <init-param>
      <param-name>ContentType</param-name>
      <param-value>text/html</param-value>
    </init-param>
    <init-param>
<param-name>template_update_delay</param-name>
<!—模板更新时间,0表示每次都更新,这个适合开发时候-->
      <param-value>0</param-value>
    </init-param>
    <init-param>
      <param-name>default_encoding</param-name>
      <param-value>GBK</param-value>
    </init-param>
    <init-param>
      <param-name>number_format</param-name>
      <param-value>0.##########</param-value><!—数字显示格式-->
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>freemarker</servlet-name>
    <url-pattern>*.ftl</url-pattern>
  </servlet-mapping>



FreeMarker Tag

is_collection,  keys,  interpret,  is_macro,  matches,  sort,  html,  time,  index_of,  values,  right_pad,  xml,  date,  web_safe,  eval,  is_transform,  string, 
node_namespace,  float,  size,  cap_first,  number,  namespace,  seq_last_index_of,  j_string,  seq_index_of,  first,  new,  default,  split,  sort_by,  upper_case, 
is_number,  last_index_of,  long,  last,  is_directive,  starts_with,  capitalize,  datetime,  is_boolean,  short,  is_hash_ex,  ends_with,  is_enumerable,  chunk, 
is_date,  byte,  trim,  is_node,  c,  exists,  chop_linebreak,  double,  is_indexable,  is_string,  ancestors,  url,  replace,  uncap_first,  is_hash,  seq_contains, 
is_sequence,  contains,  substring,  left_pad,  if_exists,  length,  has_content,  int,  is_method,  rtf,  reverse,  groups,  lower_case,  node_type,  js_string,  word_list,
root,  parent,  node_name,  children