FreeMarker 详解(超清可复制附带页面导航)
FreeMarker 详解(超清，可复制，附带页面导航)，从基础到高级，非常好的一本书，强烈推荐。第三章配置8031基本内容8032共享变量着音8033配置信息34模板加载8335错误控制86第四章其它4.1变量9042字符集问题.9043多线程9244Bean的包装45日志4.6在 Servlet中使用 Free Marker4.7为 Free Marker配置安全策略.4.8遗留的XML包装实现∴10749和Ant一起使用 Free Marker.4.10 jython包装器112第三部分XML处理指南..::::::::.:::::::.::::::·::.114第一章揭小XML文档151.1节点树.1151.2将ML放到数据模型中………,,117第二章必要的XML处珥.…11921通过例子来学习11922形式化描述…∴4126第三章声明的XML处理.1313.1基础内容……………………………13132详细内容133第四部分参考文档..136第一章内建函数参考文档:..a:a:a::1361.1处理字符串的内建函数.13612处理数字的内建函数15013处理日期的内建函数14处理布尔值的内建函数.1581.5处理序列的内建函数15816处理哈希表的内建函数16417处理节点(XML)的内建函数…16418很少使用的和专家级的内建函数第二章指令参考文档2.1f,else, elseif指令∴17022 switch,case, default, break指令23ist, break指令24 include指令17425 import指令17726 hoarse指令17827 compress指.17928 escape, noescape指令29asgn指令210 global指令1842.11lca|指令85212 setting指令1852.13用户自定义指令(<@,>)………………………872.14 macro, nested, return指令189215 function, return指令,1932.16fush指令195217stop指令2.18ft指令……1962.19t,比t,rt指令197220nt指令∴198221 attempt, recover指令22 visit, recurse, fallback指令∴…………………200第三章特殊变量参考文档……205第四章「L中的保留名称207第五章废弃的FL结构,2085.1废弃的指令列表20852废弃的内建函数列表…D,重看自看看着120853老式的 macro和ca指令20854转换指令215.5老式FTL语法……………………………<,5.6#{-}式的数字插值212第五部分附录…………………………………………14附录.214和 Free Marker的对比2142. Velocity和 FreeMarker的对比2153.为什么 FreeMarker对nu1ls和不存在的变量很敏感,如何来处理它?….2154.文档编写」特性Ⅹ,但是好像 Free Marker并不知道它,或者它的行为和文档描述的不同,或者一个据称已经修改的BUG依然存在。2165.为什么 Freemarker打印奇怪的数字数字格式(比如100000或1000000而不是1000000?2166.为什么 Free Marker会打印不好的小数和域或分组分隔符号(比如3.14而不是3,14)2177.为什么当我想用如格式打印布尔值时, FreeMarker会抛出错误,又如何来修正呢?.2178. FreeMarker标签中的<和>混淆了编辑器或XML处理器,应该怎么做?….2179.什么是合法的变量名?21710.如何使用包含空格,或其他特殊字符的变量(宏)名?∴21811.当我试图使用JsP客户标签时为什么会得到非法参数异常:形式参数类型不匹配?21812.如何像ja9: include一样的方式引入其它的资源?3.如何给普通方法/ Template Me tho dMode1Ex/TemplatcTrans formMcdel/ TemplateDirectivoMo dc1的实现传递普通java.1ang.*/java.ui1.*对象的参数?21914.为什么在mMap[ my Rey]衣达式中不能使用非字符串的键?那现在应该怎么做?2015.当使用?keys/? values遍历Map(哈希衣)的内容吋,得到了混合真正map条日的java.uti1.Map的方法。当然,只是想获取map的条日。22116.在 Free Marker的模板中如何改变序列(ists)和哈希表(maps)?22117.关于nu1在 FreeMarker模板语言是什么样的?2228.我该怎么在表达式(作为另外一个指令参数)中使用指令(宏)的输出?22319.在输出中为什么用“?”米代替字符X?22320.在模板执行完成后,怎么在模板中获取计算过的值?,22421.我能允许用户上传模板吗?又如何保证安全呢?.22422.如何在Java语言中实现方法或宏而不是在模板语言中?∴22523.为什么 Free Marker的日志压制了我的应用程序22524.在基于 Servlet的应用程序中,如何在模板执行期间发生错误时,展示个友好的错误提示页面,而不是堆栈轨迹?……22625.我正使用一个可视化的HTML割裂模板标记的编辑器。你们可以改变模板语言的语法来兼容我的编辑器么?∴22626. FreeMarker有多快?真的是2X版本的要比1X版本(经典的 FreeMarker)的慢吗?D,看自看看着122627.我的Java类怎么才能获取到关于模板结构的信息(比如所有变量的列表)?22728.你会一直提供向后的兼容性吗?………22729.如果我们把 FreeMarker和我们的产品一起发行,我们需要发布我们产品的源代码么?…………28附录B安装 Freemarker229附录C构建 Free Marker…230附录D版本2312.318版2312317版2332316版2352315版.2362.3.142372313版23.12版…2382311版.2392310版240241238版242237版a::.2422.37RC1版.243236版24423.5版244234版245233版246232版…,247231版2.3版250228版∴12622.27版263226版263225版264224版264223版22.2版265221版.26622版…1,,着着着266215版275214版275213版∴275212版.2762.11版.:;.:...:·:.27621版277201版28120版28120RC3版.28220RC2版:.:·:::·::.::::;:::.:::::.:.:.::.::::;:.:::.·::.::::::;.::::::.:·.::·::.::::;:::::::28320RC1版284附录E许可287词汇表…前言什么是 FreeMarker?FreeMarker是一款模板引擎:即一种基于模板、用来牛成输出文本(仟何来自于HTML格式的文本用来自动生成源代码)的通用L具。它是为Java程序员提供的个开发包,或者说是一个类库。它不是面向最终用户的,而是为程序员提供的一款可以嵌入他们所开发产品的应用稈序。FreeMarker实际上是被设计用来生成HTML页面,尤其是通过实现了基于 MVC(ModeView controller,模型-视图-控制器)模式的 Java servlet应用稈序。使用MvC模式的动态页面的设计构思使得你可以将前端设计师(编写HTML页面的人员)从程序员中分离出来。那么,所有人各司其职,发挥其最擅长的一面。网页设计师可以改写页面的显示效果而不受程序员编译代码的影响,因为应用程序的逻辑(这里是Java程序)和页面设计(这里是 Freemarker模板)已经被分开了。页面模板代码不会受到复杂程序代码的影响。这种分离的思想即使对ˉ个程序员和页面设计师是同一个人的项日来说也都是非常有用的,因为分离使得代码保持简洁而且易于维护。尽管 Free Marker也拥有一些编稈能力,但是它却不像PHP那样,是的一种全面的编稈语言。反而,Java程序准备的数据来进行显示(比如sQL数据库查询), Free marker仅仅是使用模板生成文本贞面来呈现已经准各好的数据而己Template fileHe llo tonameOutputhtm>ava objectstFree Marker>Hello fred凸htm|d ata name ="fredFreeMarker不是Web开发的应用程序框架。它是一个适用于Web应用程序框架中的组件,但是FreeMarker引整本身并不知道HTTP协议或Javaservlet的存在。它仅仅来生成文本内容。既然是这样,它也非常适用于非Web应用程序的开发环境。只是要注意的是,我们使用 Free Marker作为视图层的组件,是为了给诸如 Struts这样的 Model2应用框架提供现成的解决方案。Free Marker本身是免费的,它基于BSD规则的许可协议。它也是OS认证的开源软件。oS认证是开源倡议的认证标识我们应该阅读什么内容?如果你是一名前端设计师,首先,你应该阅读的是模板开发指南部分,然后如果有需要的话,可以冉阅读参考手册来获取更多的技术细节。程序员,那么,你应该先阅读模板开发指南部分,然后是程序开发指南部分,最后如果需要的话可以阅读参考于册来获取更多技术细节。本文档规约变量名,模板代码段,Java类名等用如下格式书写,如:f◎◎如果需要具体值来代替某些内容,那么用斜体书写,如:He⊥⊥∞ yourName!模板示例如卜书写:Something数据对象示例如下书写:Something输出数据示例如下书写Something程序示例如下书写Something在面向面改计师和程序员所编写的章节中代码段给程序员这样写:这只是对程序员而言的这样来强调新名词:一些新名词联系我们获取最新版本的FreeMarker,订阅邮件请访问FreeMarker主页:http://freemarker.org如果你需要帮助或者有好的建议,可以使用邮件(邮件文件可以免费搜索)或者Wb论坛如果你想报告·个Bug,诮使用web的Bug跟踪系统或者是邮件。查阅这些内容请访问http://freemarker.org.同时,要注意我们有一个FAQ和索引,你可以使用它们。几点说明因为英文版文档的作者是匈牙利人,其母语非英语,那么在这种情况的翻译过程,可能会有错误存在,作者结合自身多年对 FreeMarker的实践力求精准,但因个人才疏学浅,水平有限,恳请读者批评指正。手册的更新根据大家的反馈随时进行,但只在有阶段性成果时公开发布修正版本,并在FreeMarker24版本研发完整后,会及时联系原作者获取新特性以便修改。本翻译是免费的,您可以自由下载和传播,不可用于任何商业行为。但文档版权归译者所有,原版归 FreeMarker项目组所有,您可以引用其中的描述,但必须指明出处。如需用于商业行为,您必须和原作者取得联系。如果你发现英文原版任何错误(包括语法错误,错别字)或者是在文档中找到一些误导或混淆错误,也可以是其他的建议,或是咨询 FreeMarker中的问题,您可以联系原作者。E-mail: ddekany@ freemail.hu关于本文档的翻译错误(包括语法错误,错别字)或中文技术交流,可以联系译者:nanlei1987@gmail.com或http://weibo.com/nanlei1987,我们共同研究,共同进步。第一部分模板开发指南第一章模板开发入门11简介本章内容是对 FreeMarker进行简略的介绍,后续章节中将会详细展开。不过没有关系,只要你阅读」本章节的内容后,你就能够编写简单,但却很有用的 FreeMarker模板程序」。1.2模板+数据模型=输出假设你在一个在线商店的应用系统中需要一个HTML页面,和下面这个页面类似:title>We l come!< /title>
Welcome Big Joe!
Our latest product:Ka href="products/greenmouse html">green mouse!