1、Enjoy模板引擎表达式方式和属性方法调用基本与 java相同。
2、属性访问,user.name 分别以 user.getName() user.get("uname") user.name 的优先顺序获取属性值。
3、注释,单行注释和多行注释都是三个字符。### 单行注射,#-- 多行注射。
### 这里是单行注释
#--
这里是多行注释的第一行
这里是多行注释的第二行
--#
4、原样输出,不被解析的代码块。#[[ 原样输出。
#[[
#(value)
#for(x : list)
#(x.name)
#end
]]#
5、共享方法和共享对象,共享方法使用 me.addStaredMethod(xxx) 方法,共享对象使用 me.addSharedObject() 方法。
在具体使用中方法类可以归类后共享对象的方式加入模板引擎。
Engine.addExtensionMethod() 方法扩展已知类的方法。
public void configEngine(Engine me) {
me.addSharedMethod(new com.jfinal.kit.StrKit());
}
public void configEngine(Engine me) {
me.addSharedObject("RESOURCE_HOST", "http://res.jfinal.com");
me.addSharedObject("sk", new com.jfinal.kit.StrKit());
}
Engine.addExtensionMethod(Integer.class, MyIntegerExt.class);
6、指令:常用核心指令 #if、#for、#switch、#set、#include、#define、#(…)
6.1、输出指令:?? 安全指令运算符,可在防止输出值为空是报异常,后跟参数为默认输出参数。
,逗号运算符,只输出最后一个表达式运行结果。
#(value)
#(object.field)
#(object.field ??)
#(a > b ? x : y)
#(seoTitle ?? "JFinal 俱乐部")
#(object.method(), null)
6.2、#if 指令:if指令需要一个 cond 表达式作为参数,并且以 #end 为结尾符,
#if(c1)
...
#else if(c2)
...
#else if (c3)
...
#else
...
#end
6.3、#for 指令:可以对 list 数组 map 进行迭代,Collection、Iterator、Iterable、Enumeration、null 值都支持迭代。
迭代对象为 null 时自动跳过迭代,不会报出异常。
for.outer 这个固定的用法,专门用于在内层 for 指令中引用上层for指令状态。#for 指令还支持 #else 分支语句,在for指令迭代次数为0时,将执行 #else 分支内部的语句。#for 指令还支持 #continue、#break 指令。
// 对 List、数组、Set 这类结构进行迭代
#for(x : list)
#(x.field)
#end
// 对 Map 进行迭代
#for(x : map)
#(x.key)
#(x.value)
#end
#for(x : listAaa)
#(for.size) 被迭代对象的 size 值
#(for.index) 从 0 开始的下标值
#(for.count) 从 1 开始的记数值
#(for.first) 是否为第一次迭代
#(for.last) 是否为最后一次迭代
#(for.odd) 是否为奇数次迭代
#(for.even) 是否为偶数次迭代
#(for.outer) 引用上层 #for 指令状态
#end
6.4、#switch 指令:#case 指令支持逗号隔开的多个判断条件,#case 指令也不需要使用冒号
#switch (month)
#case (1, 3, 5, 7, 8, 10, 12)
#(month) 月有 31 天
#case (2)
#(month) 月平年有28天,闰年有29天
#default
月份错误: #(month ?? "null")
#end
6.5、#set 赋值指令:支持变量声明复制,列表复制,已有变量赋值,#set 指令值接收复制表达式。#for、#include、#define 指令会开启新的变量作用域,#set 指令会从本层向上层依次寻找变量操作。#setLocal 指令声明本层作用域复制时使用,避免与其他层属性冲突。
#set(x = 123)
#set(a = 1, b = 2, c = a + b)
#set(array[0] = 123)
#set(map["key"] = 456)
#(x) #(c) #(array[0]) #(map.key) #(map["key"])
6.6、#include 包含指令:第一个参数必须为包含模板路径,若是以 / 开头则去 baseTemplatePath 路径下寻找文件,若不是则去当前路径下寻找文件。
后面可以任意个参数,用于模板中使用,实现模块化复用。
#render 指令与 #include 指令用能类似。
#include("_hot_list.html", title="热门项目", list=projectList, url="/project")
#include("_hot_list.html", title="热门新闻", list=newsList, url="/news")
6.7、#define 模板函数指令:#define FunctionName() 定义模板函数,
#@functionName() 调用模板函数。
#define layout()
<html>
<head>
<title>JFinal俱乐部</title>
</head>
<body>
#@content()
</body>
</html>
#end
#include("layout.html")
#@layout()
#define content()
<div>
这里是模板内容部分,相当于传统模板引擎的 nested 的部分
</div>
#end
6.8、#call 与 安全调用:安全调用 #@name?() ,安全带调用当模版未定义是不进行任何操作。
动态模板函数,添加 true 参数可以在模板函数不存在是忽略其存在。
#call(true, funcName, p1, p2, ..., pn)
6.9、#date 指令:格式化时间类型,默认时间格式为 yyyy-MM-dd HH:mm。
keepPara() 函数将参数保存住的时候会将时间类型保存成 String 类型,所以必须在处理一次,否则会异常。
#date(account.createAt)
#date(account.createAt, "yyyy-MM-dd HH:mm:ss")
// keepPara() 用来 keep 住所有表单提交数据,全部转换成 String 类型
keepPara();
// 再用一次带参的 keepPara,指定 createAt 域 keep 成 Date 类型
keepPara(Date.class, "createAt");
6.10、#number 指令:格式化数字类型,可以格式化 Double、Float、Integer、Long、BigDecimal 类型变量。
可以使用第二个 pattern 参数展示出各种类型的数字表达。
#number(3.1415926, "#.##")
#number(0.9518, "#.##%")
#number(300000, "光速为每秒,### 公里。")