freemarker.ppt

FreeMarker介绍 目录 一、freemarker简介 二、freemarker指令 什么是FreeMarker？ FreeMarker是一款模板引擎：一种基于模板的、用来生成输出文本(任何来自于HTML格式的文本用来自动生成源代码)的通用工具。 模板 + 数据模型 = 输出 模板文件同样是静态的HTML代码，但是除了这些HTML代码外，代码中还包括了一些FreeMarker指令，这些指令就能够做到动态效果。 数据模型基本结构是树状的。 标量存储单一的值，这种类型的值可以是字符串，数字，日期/时间或者是布尔值。 哈希表是存储变量和与其相关且有唯一标识名称变量的容器。 序列是存储有序变量的容器。 存储的变量可以通过数字索引来检索，索引通常从零开始。 模板文件示例 freemarker指令 使用FTL标签来调用directives指令 标签分为两种： 开始标签：#directivename parametes 结束标签：/#directivename 例：#if something.../#if 如果标签没有嵌套内容（在开始标签和结束标签之内的内容），那么可以只使用开始标签。 常用指令 if指令 list指令 include指令 macro指令 If指令 使用if指令可以有条件地跳过模板的一部分，这和程序语言中if是相似的。 格式： #if condition ... #elseif condition2 ... #elseif condition3 ... ... #else ... /#if 这里： condition，condition2等：表达式将被计算成布尔值。 list指令 list指令来处理模板的一个部分中的一个序列中包含的各个变量 格式： #list sequence as item ... /#list 这里： sequence：表达式将被算作序列或集合 item：循环变量（不是表达式）的名称 include指令 模板中插入另外一个FreeMarker模板文件（由path参数指定）。被包含模板的输出格式是在include标签出现的位置插入的 格式： #include path or #include path options path：要包含文件的路径；一个算作是字符串的表达式。（用其他话说，它不用是一个固定的字符串，它也可以是像profile.baseDir + “/menu.ftl”这样的东西。） options：一个或多个这样的选项：encoding=encoding,parse=parse encoding：算作是字符串的表达式 parse：算作是布尔值的表达式（为了向下兼容，也接受一部分字符串值） macro指令 宏变量存储模板片段（称为宏定义体）可以被用作自定义指令，调用方式为@name param1 = …/ 格式： #macro name param1 param2 ... paramN ... /#macro name：宏变量的名称，它不是表达式。 param1，param2等： 局部变量的名称，存储参数的值（不是表达式） * 数据模型示例（后台提供） 输出 *