JavaEE FreeMarker

关于freemarker

(1)解决输出中文乱码问题:

freemarker乱码的原因:

*没有使用正确的编码格式读取模版文件,表现为模版中的中文为乱码

解决方法:在classpath上放置一个文件freemarker.properties,在里面写上模版文件的编码方式,比如

default_encoding=UTF-8

locale=zh_CN

注意:eclipse中除了xml文件、java文件外,默认的文件格式iso8859-1

*数据插入模版时,没有使用正确的编码,表现出模版中的新插入数据为乱码

解决方法:在result的配置中,指定charset,s2的FreemarkerResult.java会将charset传递freemarker

<actionname="ListPersons"class="ListPersons">

<resulttype="freemarker">

<paramname="location">/pages/Person/view.ftl</param>

<paramname="contentType">text/html;charset=UTF-8

</param>

</result>

</action>

(2)提高freemarker的性能

在freemarker.properties中设置:

template_update_delay=60000

避免每次请求都重新载入模版,即充分利用cached的模版

(3)尽量使用freemarker本身的提供的tag,使用S2tags的标签会在性能上有所损失

Freemarkerhassupportforiteratinglists,displayingproperties,includingothertemplates,macro's,andsoon.ThereisasmallperformancecostwhenusingtheS2tagsinsteadoftheFreemarkerequivalent(eg.<s:propertyvalue="foo"/>shouldbereplacedby${foo}).

(4)freemarker的标签种类:

o${..}:FreeMarkerwillreplaceitintheoutputwiththeactualvalueofthethinginthecurlybrackets.Theyarecalledinterpolations.

o#,代表是FTLtags(FreeMarkerTemplateLanguagetags),heyareinstructionstoFreeMarkerandwillnotbeprintedtotheoutput

+<#if...></#if>

+<#listtotalListaselementObject>...</#list>

o@,代表用户自定义的标签

o<#---->注释标签,注意不是<!---->

(5)一些特殊的指令:

or代表原样输出:${r"C:\foo\bar"}

o<#list["winter","spring","summer","autumn"]asx>${x}</#list>

o?引出内置指令

+String处理指令:

#html:特殊的html字符将会被转义,比如"<",处理后的结果是&lt;

#cap_first、lower_case、upper_case

#trim:除去字符串前后的空格

+sequences处理指令

#size:返回sequences的大小

+numbers处理指令

#int:number的整数部分,(e.g.-1.9?intis-1)

(6)对于null,或者missvalue,freemarker会报错

o!:defaultvalueoperator,语法结构为:unsafe_expr!default_expr,比如${mouse!"Nomouse."}当mouse不存在时,返回defaultvalue;

+(product.color)!"red"这种方式,能够处理product或者color为missvalue的情况;

+而product.color!"red"将只处理color为missvalue的情况

o??:Missingvaluetestoperator,测试是否为missingvalue

+unsafe_expr??:product.color??将只测试color是否为null

+(unsafe_expr)??:(product.color)??将测试product和color是否存在null

o?exists:旧版本的用法

比如:

<#ifmouse??>

Mousefound

<#else>

Nomousefound

</#if>

Creatingmouse...

<#assignmouse="Jerry">

<#ifmouse??>

Mousefound

<#else>

Nomousefound

</#if>

(7)模版值插入方式(interpolation)

o通用方式(Universalinterpolations):${expression}

+对于字符串:只是简单输出

+对于数值,会自动根据local确定格式,称为humanaudience,否则称为computeraudience,可以"?c",比如,<ahref="/shop/details?id=${product.id?c}">Details...</a>,因此这里的id是给浏览器使用的,不需要进行格式化,注意?c只对数值有效

+对于日期,会使用默认的日期格式转换,因此需要事先设置好默认的转换格式,包括date_format,time_format,atetime_format

+对于布尔值,不能输出,会报错并停止模版的执行,比如${a=2}会出错,但是可以stringbuilt-in来进行转换

数值处理,具体参考:Built-insfornumbers

http://freemarker.org/docs/ref_builtins_number.html#ref_builtin_string_for_number

数值处理的例子:

<#settingnumber_format="currency"/>

<#assignanswer=42/>

${answer}

${answer?string}<#--thesameas${answer}-->

${answer?string.number}

${answer?string.currency}

${answer?string.percent}

除了使用内置的formate,可以使用任何用Javadecimalnumberformatsyntax书写的formate,比如

<#settingnumber_format="0.###E0"/>

${1234}

${12345?string("0.####E0")}

更加方便的格式:

<#settinglocale="en_US">

USpeoplewrites:${12345678?string(",##0.00")}

<#settinglocale="hu">

Hungarianpeoplewrites:${12345678?string(",##0.00")}

日期处理,参考Built-insfordates

http://freemarker.org/docs/ref_builtins_date.html#ref_builtin_string_for_date

日期处理的例子:

${openingTime?string.short}

${openingTime?string.medium}

${openingTime?string.long}

${openingTime?string.full}

${nextDiscountDay?string.short}

${nextDiscountDay?string.medium}

${nextDiscountDay?string.long}

${nextDiscountDay?string.full}

${lastUpdated?string.short}

${lastUpdated?string.medium}

${lastUpdated?string.long}

${lastUpdated?string.full}

注意:

由于java语言中的Date类型的不足,freemarker不能根据Date变量判断出变量包含的部分(日期、时间还是全部),在这种情况下,freemarker

不能正确显示出${lastUpdated?string.short}或者simply${lastUpdated},因此,可以通过?date,?timeand?datetimebuilt-ins

来帮助freemarker来进行判断,比如${lastUpdated?datetime?string.short}

除了使用内置的日期转换格式外,可以自己指定日期的格式,使用的是Javadateformatsyntax,比如:

${lastUpdated?string("yyyy-MM-ddHH:mm:sszzzz")}

${lastUpdated?string("EEE,MMMd,''yy")}

${lastUpdated?string("EEEE,MMMMdd,yyyy,hh:mm:ssa'('zzz')'")}

o数值专用方式(Numericalinterpolations):#{expression}or#{expression;format},这是数值专用的输出方式,但是最好使用通用方式的stringbuilt-in或者number_format来完成转换,Numericalinterpolations方式将会被停用

(8)创建自定义模版

创建:

<#macrogreet>

<fontsize="+2">HelloJoe!</font>

</#macro>

相关推荐