Zhiqim Markup Language是知启蒙定义的、类似于JavaJavascript语法的语句和表达式,通常和XML/HTML混编在一起形成的一种新的标记语言。 ZML力求简单易用,目前支持常用的十二种标记语句和五十种表达式,在知启蒙技术体系中被用来代替JSP。
森中灵 |
整理V8 | 2年前 | |
森中灵 |
V8.0.5首次提交 | 10月前 | |
森中灵 |
替换zhiqim.jar,重新打包 | 5天前 | |
森中灵 |
修复_For和_If嵌套是有ReturnException,捕捉后转化为返回值方式 | 1年前 | |
森中灵 |
小数相加double改为Number.doubleValue() | 6天前 | |
森中灵 |
V8.0.5首次提交 | 10月前 | |
森中灵 |
整理V8 | 2年前 | |
森中灵 |
首次提交 | 6年前 | |
爱吃荔枝的圆滚滚 |
修改名称为zhiqim_zml | 5年前 | |
zlb |
修改LICENSE、README.md | 3年前 | |
zlb |
修改LICENSE、README.md | 3年前 |
什么是“ZML”?
ZML(Zhiqim Markup Language)即“知启蒙标记语言”,是知启蒙定义的、类似于Java & Javascript语法的语句和表达式,通常和XML/HTML混编在一起形成的一种新的标记语言。ZML力求简单易用,目前支持常用的十二种标记语句和五十种表达式,在知启蒙框架体系中被用来代替JSP。
什么是“ZML引擎”?
ZML引擎(ZhiqimZML)即“知启蒙标识语言引擎”,是实现ZML规范的引擎系统。支持两种ZML加载方式(按文件目录和按类路径)、能够在ZML文件改动后立即发现并在触发时重新加载、并提供详细的“表达式合并运算优先级”、“变量多维作用域”和“无障碍访问Java代码”,以及设置上下文作用域的配置模板、对模板进行缓存等特性。
“ZML引擎”有哪些优点?
1、ZhiqimZML仅依赖JDK1.7+和ZhiqimKernel。15年的坚持,值得信赖。
2、ZhiqimZML支持十二种语句和五十种表达式基本覆盖业务操作,是知启蒙WEB容器的重要组成部分,在ZhiqimDK家族中占据非常重要的位置。
3、对比国外模板引擎Freemarker和Velocity,ZhiqimZML更有优势,结合知启蒙微内核的大量工具类(如Strings/Validatest),使得ZhiqimZML可无障碍访问Java代码,称之为Java的标识语言都不为过。
4、最后自荐一下,比Spring更轻量、更齐全的J2EE框架 zhiqim 正式开源啦,不服来试用。
最简单的ZML引擎使用方法
1、准备好一段符合ZML规格的字符串,和一个变量表,即可解析出结果。 2、支持全局变量表中@AnAlias注解别名表和预定义Java类名的静态变量和静态方法调用。 3、详细见org.zhiqim.zml.Zmls静态类中的方法,如下提供的parse方法。 |
ZML支持的十二种语句 前往五十种表达式
一、变量定义语句(_Var)
<#var name = "知启蒙模板引擎"/>
表示定义变量name的值为“知启蒙模板引擎”。
二、函数定义语句(_Function)
<#function functionName(param1, param2)>
<div>param1 = ${param1}</div>
<div>param2 = ${param2}</div>
</#function>
三、文件包含语句(_Include)
<#include "/zml/inc.zml"/>
表示包含文件“/zml/inc.zml”的内容到该页面中。
四、判断语句(_If)
<#if (!Validates.isEmpty(name) && name.startWith("知启蒙"))>
${name}
</#if>
五、遍历语句(_For)
<#for (var item : list)>
<#if (Validates.isNotEmpty(item))>
${item}
</#if>
</#for>
简写:
<#for item : list>
<#if (Validates.isNotEmpty(item))>
${item}
</#if>
</#for>
六、拦截器语句(_Interceptor)
<#interceptor "chkLogin"/>
拦截器语句用于在执行之前判断是否支持定义的参数的值,如"chkLogin"表示是一个拦截器名称
七、显示结果语句(_Echo)
显示结果语句是通过连接、计算和合并的方式执行多个表达式,得到执行结果,然后把结果显示在页面上,值为(null)不显示结果,如:
<#var name = "知启蒙"/>
${name} 表示执行表达式name,得到结果“知启蒙”
${name + "引擎"} 表示执行表达式name + "引擎",得到结果“知启蒙引擎”
${functionName(name, "edf")} 表示调用函数并显示结果
${Strings.trimLeft(name, "知")} 表示类Strings的trimLeft方法,显示结果“启蒙”
八、显示格式化结果语句(_Format)
显示格式化结果语句是通过连接、计算和合并的方式执行多个表达式,得到执行结果,值为(null)不显示结果,<br>
并对其他Zmls.format(zml)格式化,对<,>,\",\',${,@{,#{格式化,保证浏览器解释成字符串而不是ZML代码,如:
<#var name = "知${abc}启蒙"/>
#{name} 表示执行表达式name,得到结果是“知${abc}启蒙”,$符号转为$
#{name + "引\"擎"} 表示执行表达式name + "引\"擎",得到结果“知${abc}启蒙引"擎”,$符号转为$,引号变成"
#{functionName(name, "edf")} 表示调用函数并显示结果
#{Strings.trimLeft(name, "知")} 表示类Strings的trimLeft方法,显示结果“${abc}启蒙”
九、调用不显示结果语句(_Call)
调用语句是通过连接、计算和合并的方式执行多个表达式,执行,但不显示结果到页面上,如:
@{System.out.println("显示信息到控制台,不是显示到页面")} 表示执行System.out.println();
十、返回语句(_Return)
返回语句应用于标识当前页执行结束,直接返回,和函数function中返回值:
<#if Validates.isEmpty(sessionKey)>
<#return/>
</#if>
<#function functionName(param1, param2)>
<#var ret = param1+param2/>
<#return ret/>
</#function>
十一、继续语句(_Continue)
继续语句应用于_For语句中,表示结束当次处理,继续下一次:
<#for item : list>
<#if (Validates.isNotEmpty(item))>
<#continue/>
</#if>
</#for>
十二、中断语句(_Break)
<#for item : list>
<#if (Validates.isNotEmpty(item))>
<#break/>
</#if>
</#for>
常用的ZML页面和ZML配置模板
强大的ZML引擎解析文件
1、支持对文件目录/类路径加载配置定义的变量和函数到上下文变量表中,支持根据path查找ZML文件加载。 2、支持多个组件加载器,依次查找组件配置模板中定义的变量和函数到上下文变量表,和根据path查找的ZML文件加载。 3、支持自定义设置全局变量。 4、支持对ZML文件监视,有变动立即知晓,并在被触发时加载文件,如是配置模板会回调通知。 5、支持对ZML文件缓存,并提供缓存参数maxIdleTime/maxKeepTime。 |
||
参数 | 参数类型 | 描述 |
notice | ZmlVarNotice | 设置模板变量变动通知,当/conf/config.zml有变动并触发时回调doUpdate方法 |
encoding | String | 模板加载编码 |
maxIdleTime | int | 模板最大空闲时长,建议1小时 |
maxKeepTime | int | 模板最大保持时长,建议24小时 |
isAscQuery | boolean | 当有组件配置模板时,是否按顺序查找 |
patterns | String | 模板匹配模式,默认*.zml,*.htm |
loader | ClassZmlLoader FileZmlLoader |
设置根配置模板加载器,类路径/目录 |
cLoaderMap | ClassZmlLoader | 组件配置模板加载器,类路径/目录,支持多个, 通过addComponentZmlLoader()添加 |
globalMap | HashMap | 全局变量表,通过addGlobalVariable添加 |
``` //先创建ZML引擎,可以保存起来 ZmlEngine engine = new ZmlEngine(); engine.setFileZmlLoader(new File("./resource")); engine.setConfigZml("/conf/config.zml"); //调用和解析ZML文件 Zml zml = engine.getZml("/zml/abc.zml"); HashMapSO variableMap = new HashMapSO(); variableMap.put("abc", "知启蒙"); variableMap.put("def", "标识语言"); variableMap.put("isAbc", false); String result = Zmls.parese(zml, variableMap); ``` |
知启蒙技术框架与交流
QQ群:加入QQ交流群,请点击【458171582】
教程:欲知更多知启蒙标识语言,【请戳这里】