FreeMarker - 配置参数用法说明

【1】locale

作用:

设置默认地区,主要影响数字、日期输出格式,request中没有指定地区时模板查找的值。

值:

zh_CN,en_US

配置实例:

<prop key="locale">zh_CNprop>  

【2】classic_compatible

作用:

兼容旧版freemarker习惯,不建议使用,可能会导致一些额外的问题。如,include必须用绝对路径值。

值:

true,false /yes,no/t,f/y,n

配置实例:

<prop key="classic_compatible">falseprop>  

【3】template_exception_handler

作用:

模板异常处理器。

值:

rethrow,debug,html_debug,ignore;

etc  类名。

默认为debug

配置实例:

<prop key="template_exception_handler">debugprop>  

【4】arithmetic_engine

作用:

数学运算引擎。

值:

bigdecimal,conservative.

默认值:bigdecimal

配置实例:

<prop key="arithmetic_engine">bigdecimalprop>  

【5】object_wrapper

作用:

对象包装器。

值:

default,default_2_3_0,simple,beans,jython.

配置实例:

<prop key="object_wrapper">defaultprop>  

【6】number_format

作用:

设置默认数字输出格式。

值:

number,currency,percent,computer.

也可以使用DecimalFormat类型,比如 #.##。

配置实例:

<prop key="number_format">#.##prop>  

【7】boolean_format

作用:

设置默认布尔值输出格式。

值:

true时输出的值和false时输出的值用英文逗号分隔,如 true,false 或 是,否。

配置实例:

<prop key="boolean_format">true,falseprop>  

【8】date/time/datetime_format

作用:

设置日期,时间,日期时间的输出格式。

值:

short,medium,long,full;

也可以是表示式,如:yyyy-MM-dd HH:mm:ss

配置实例:

<prop key="date_format">yyyy-MM-ddprop>  

【9】time_zone

作用:

设置时区。

值:

GMT+8:00,Asia/Shanghai====

默认为系统时区和设置的locale无关。

【10】sql_date_and_time_time_zone

作用:

设置java.sql.Date的时区。


【11】output_encoding

作用:

设置freemarker输出的字符集。

值:

UTF-8,GB2312====

配置实例:

<prop key="output_encoding">UTF-8prop>  

【12】url_escaping_charset

作用:

设置URL转义字符集。

值:

UTF-8,GB2312,ISO-8859-1;

默认为output_encoding中的值。

配置实例:

<prop key="url_escaping_charset">UTF-8prop>  

【13】auto_flush

作用:

设置模板处理后自动刷新。

值:

true,false;

默认值为true

配置实例:

<prop key="auto_flush">falseprop>  

【14】new_builtin_class_resolver

作用:

设置’?’ , ‘new()’ 内建函数使用范围。

值:

unrestricted,safer,allows_nothing.

如果值包含冒号则使用OptInTemplateClassResolver。此时可使用allowed_classes:和trusted_templates:

默认值是safer,如果值包含点则当做类名使用。


【15】show_error_tips

作用:

控制是否显示错误提示。

值:

true,false;

默认为true

配置同上。


【16】api_builtin_enabled

作用:

控制?api内建函数是否可用。

值:

true,false;

默认为false

配置同上。


【17】auto_import

作用:

在所用模板中自动引入模板。

值:

规范:模板文件 as 命名空间;

多个引入用逗号隔开。

使用:命名空间.变量

配置实例:

<prop key="auto_import">"/ftl/form1.ftl" as f1,"/ftl/form2.ftl" as f2prop>  

【18】auto_include

作用:

在所有模板中自动包含模板。

值:

规范:模板文件,多个引入用逗号隔开;

配置实例:

"auto_include">/include/common.ftl,/include/head.ftl</prop>  

【19】default_encoding

作用:

设置默认编码。

值:

UTF-8,GB2312,ISO-8859-1;

默认值为操作系统的编码。

配置实例:

<prop key="default_encoding">UTF-8prop>  

【20】localized_lookup

作用:

控制模板本地化查找是否可用。

比如locale设置为zh_CN加载模板foo.ftl时,freemarker自动查找foo_zh_CN.ftl,foo_zh.ftl,foo.ftl,并返回找到的第一个。

值:

true,false;

默认值为true

配置实例:

<prop key="localized_lookup">falseprop>  

【21】whitespace_stripping

作用:

控制是否删除多余空格。

值:

true,false;

默认值为true

配置实例:

<prop key="whitespace_stripping">trueprop>  

【22】template_update_delay

作用:

设置模板缓存时间,没有设置单位时,单位是秒。

值:

正整数,或者带单位的正整数。

单位可以是:s ms m h 分别表示秒,毫秒,分钟,小时。

默认值为5秒。

配置实例:

<prop key="template_update_delay">3600prop>  

【23】tag_syntax

作用:

FreeMarker 支持一个替换的语法。就是在 FreeMarker 的指令和注释中用 [ 和 ] 来代替 <和 >

值:

auto_detect 

配置实例:

<prop key="tag_syntax">auto_detect prop>  

你可能感兴趣的:(#)