java模版引擎-beetl-2.2.2-guide.pdf

知行合一Beetl2.2使用说明书201505051Beetl2.2使用说明书20150505李家智 1.什么是BeetlBeetl目前版本是2.2.0,大小690K，从开发至今有4年历史。相对于其他java模板引擎，具有功能齐全，语法直观,性能超高，以及编写的模板容易维护等特点。使得开发和维护模板有很好的体验。是新一代的模板引擎。总得来说，它的特性如下：功能完备：同主流的java模板引擎相比，Beetl具有绝大多数功能。适用于*各种应用场景*，从对响应速度有很高要求的大网站到功能繁多的CMS管理系统都适合。Beetl本身还具有很多独特功能来完成模板编写和维护，这是其他模板引擎所不具有的。非常简单：类似Javascript语法和习俗，只要半小时就能通过半学半猜完全掌握用法。拒绝其他模板引擎那种非人性化的语法和习俗。同时也能支持html 标签，使得开发CMS系统比较容易超高的性能：Beetl 远超过主流java模板引擎性能(引擎性能5-6倍与freemaker，2倍于JSP。参考附录），而且消耗较低的CPU易于整合：Beetl能很容易的与各种web框架整合，如Spring MVC，JFinal,Struts,Nutz，Jodd，Servlet等。支持模板单独开发和测试，即在MVC架构中，即使没有M和C部分，也能开发和测试模板。扩展和个性化：Beetl支持自定义方法，格式化函数，虚拟属性，标签，和HTML标签.同时Beetl也支持自定义占位符和控制语句起始符号也支持使用者完全可以打造适合自己的工具包.关于性能通过与主流模板引擎Freemaker，Vecloity以及JSP对比，Beetl均远高于前面三个，这是因为宏观上，通过了优化的渲染引擎，IO的二进制输出，字节码属性访问增强，微观上，通过一维数组保存上下文Context,静态文本合并处理，通过重复使用字节数组来防止java频繁的创建和销毁数组，还使用模板缓存，运行时优化等方法。详情参考附录Beetl2.2使用说明书20150505知行合一Beetl2.2使用说明书201505052独特功能Beetl有些功能是发展了10多年的模板引擎所不具备的，这些功能非常利于模板的开发和维护，如下1.自定义占位符和控制语句起始符号，这有利于减小模板语法对模板的倾入性，比如在html模板中，如果定义控制语句符号是,那么，大部分模板文件都能同过浏览器打开。有的使用者仅仅采用了单个符号 以及回车换号作为控制语句起始符号，这又能提高开发效率2.可单独测试的模板。无需真正的控制层和模型层，Beetl的模板就可以单独开发和测试3.同时支持较为松散的MVC和严格的MVC，如果在模板语言里嵌入计算表达式，复杂条件表达式，以及函数调用有干涉业务逻辑嫌疑，你可以禁止使用这些语法。4.强大的安全输出，通过安全输出符号！，能在模板变量，变量属性引用，for循环，占位符输出，try-catch中等各个地方提供安全输出，保证渲染正常5.模板变量：运行将模板的某一部分输出像js那样赋值个一个变量，稍后再处理。利用模板变量能完成非常复杂的页面布局（简单的布局可使用layout标签函数)6.类型推测，能在运行的时候推测模板变量类型，从而优化性能，也可以通过注解的方法显示的说明模板变量属性（这是非必须的，但有助于IDE自动提示功能）7.可插拔的设计，错误信息提示，模板引擎缓存机制，模板资源管理，本地调用的安全管理器,严格MVC限制，模板引擎本身都有默认的实现，但又完全可以自定义以适合特定需求8.增强的语法，如for-elsefor,select-case，安全输出符号!等，这些语法特别适合模板开发9.局部渲染技术，结合现在js的ajax技术。10.性能超高,具有最快的模板解释引擎，同时，又有较低的CPU消耗。5-6倍于国内使用的Freemaker。适合各类模板应用，如代码生成工具，CMS系统，普通网站，超高访问量的门户系统，和富客户端JS框架整合的后台管理应用新手如何开始需要通读基本用法，大部分都是讲解语法，而语法跟js很接近，所以可以快速预览，但Beetl是针对模板设计，所以像安全输出，标签和html标签，全局变量，临时变量和共享变量，布局技术，以及直接调用java代码等还需要认真读一遍。如果从事web开发，还需要阅读web集成里的第一节“web提供的全局变量”，如果web里还使用ajax技术，可以阅读“整合ajax的局部渲染技术”联系作者作者：闲.大赋（李家智）QQ群：219324263邮件：xiandafu mailto:xiandafuBeetl主页：源码主页：在线体验和代码分享:8080/beetlonline/如果有任何疑问或者提交bug，可以直接联系我Beetl2.2使用说明书20150505知行合一Beetl2.2使用说明书201505053资助Beetl官网有捐助账号，支付宝的，如果有大额，请直接先联系我。官网有百度联盟的广告，如果你有兴趣，点击广告，我会有5毛钱。2.基本用法从GroupTemplate开始StringTemplateResourceLoader resourceLoader=new StringTemplateResourceLoader();Configuration cfg=Configuration.defaultConfiguration();GroupTemplate gt=new GroupTemplate(resourceLoader,cfg);Template t=gt.getTemplate(hello,$name);t.binding(name,beetl);String str=t.render();System.out.println(str);Beetl的核心是GroupTemplate，创建GroupTemplate需要俩个参数，一个是模板资源加载器，一个是配置类，模板资源加载器Beetl内置了4种，分别是StringTemplateResourceLoader：字符串模板加载器，用于加载字符串模板，如本例所示FileResourceLoader：文件模板加载器，需要一个根目录作为参数构造，传入getTemplate方法的String是模板文件相对于Root目录的相对路径ClasspathResourceLoader：文件模板加载器，模板文件位于Classpath里WebAppResourceLoader：用于webapp集成，假定模板根目录就是WebRoot目录代码第5行将变量name传入模板里，其值是“Beetl”。代码第6行是渲染模板，得到输出，template提供了多种获得渲染输出的方法，如下 tempalte.render()返回渲染结果，如本例所示 template.renderTo(Writer)渲染结果输出到Writer里 template.renderTo(OutputStream)渲染结果输出到OutputStream里1.关于如何使用模板资源加载器，请参考下一节2.如何对模板进行配置，请参考下一节模板基础配置Beetl提供不但功能齐全，而且还有很多独特功能，通过简单的配置文件，就可以定义众多的功能，默认情况下，Configuration类总是会先加载默认的配置文件（位于/org/beetl/core/beetl-default.properties，作为新手，通常只需要关注3,4,5,6行定界符的配置，以及11行模板字符集的配置就可以了，其他配置会在后面章节陆续提到）下，其内容片断如下：#默认配置ENGINE=org.beetl.core.engine.FastRuntimeEngineDELIMITER_PLACEHOLDER_START=$Beetl2.2使用说明书20150505知行合一Beetl2.2使用说明书201505054DELIMITER_PLACEHOLDER_END=DELIMITER_STATEMENT_START=DIRECT_BYTE_OUTPUT=FALSEHTML_TAG_SUPPORT=trueHTML_TAG_FLAG=#HTML_TAG_BINDING_ATTRIBUTE=varNATIVE_CALL=TRUETEMPLATE_CHARSET=UTF-8ERROR_HANDLER=org.beetl.core.ConsoleErrorHandlerNATIVE_SECUARTY_MANAGER=org.beetl.core.DefaultNativeSecurityManagerMVC_STRICT=FALSE#资源配置，resource后的属性只限于特定ResourceLoaderRESOURCE_LOADER=org.beetl.core.resource.ClasspathResourceLoader#classpath 根路径RESOURCE.root=/#是否检测文件变化RESOURCE.autoCheck=true#自定义脚本方法文件的Root目录和后缀RESOURCE.functionRoot=functionsRESOURCE.functionSuffix=html#自定义标签文件Root目录和后缀RESOURCE.tagRoot=htmltagRESOURCE.tagSuffix=tag#扩展#内置的方法FN.date=org.beetl.ext.fn.DateFunction.#内置的功能包FNP.strutil=org.beetl.ext.fn.StringUtil.#内置的默认格式化函数FTC.java.util.Date=org.beetl.ext.format.DateFormat.#标签类TAG.include=org.beetl.ext.tag.IncludeTag第2行配置引擎实现类，默认即可.第3,4行指定了占位符号，默认是$.也可以指定为其他占位符。第4,5行指定了语句的定界符号，默认是,也可以指定为其他定界符号第6行指定IO输出模式，默认是FALSE,即通常的字符输出，在考虑高性能情况下，可以设置成true。详细请参考高级用法第8,9行指定了支持HTML标签，且符号为#（只能用一个符号标示），默认配置下，模板引擎识别这样的类似html标签，并能调用相应的标签函数或者模板文件。第10行 指定如果标签属性有var，则认为是需要绑定变量给模板的标签函数第11行指定允许本地Class直接调用第12行指定模板字符集是UTF-8第13行指定异常的解析类，默认是ConsoleErrorHandler，他将在render发生异常的时候在后台打印出错误信息（System.out)。Beetl2.2使用说明书20150505知行合一Beetl2.2使用说明书201505055第14行指定了本地Class调用的安全策略第15行配置了是否进行严格MVC，通常情况下，此处设置为false.第18行指定了默认使用的模板资源加载器第20到22行配置了模板资源加载器的一些属性，如设置根路径为/,即Classpath的顶级路径，并且总是检测模板是否更改第23行配置了自定义的方法所在的目录以及文件名后缀。beetl既支持通过java类定义方法，也支持通过模板文件来定义方法第26行配置了自定义的html标签所在的目录以及文件名后缀。beetl既支持通过java类定义标签，也支持通过模板文件来定义标签第31行注册了一个date方法，其实现类是org.beetl.ext.fn.DateFunction第34行注册了一个方法包strutil，其实现类org.beetl.ext.fn.StringUtil，此类的每个public方法都将注册为beetl的方法第37行注册了一个日期格式化函数第40行注册了一个include标签函数模板开发者可以创建一个beetl.properties的配置文件，此时，该配置文件将覆盖默认的配置文件属性，比如，你的定界符考虑是!-:和-,则在beetl.properties加入一行即可,并将此配置文件放入Classpath根目录下即可。Configuration.defaultConfiguration()总是先加载系统默认的，然后再加载Beetl.properties的配置属性，如果有重复，用后者代替前者的配置#自定义配置DELIMITER_STATEMENT_START=模板资源加载器资源加载器是根据String值获取Resource实例的工场类，同时资源加载器还要负责响应模板引擎询问模板是否变化的调用。对于新手来说，无需考虑模板资源加载器如何实现，只需要根据自己场景选择系统提供的三类模板资源加载器即可字符串模板加载器在创建GroupTemplate过程中，如果传入的是StringTemplateResourceLoader，则允许通过调用gt.getTemplate(String template)来获取模板实例对象，如2.1所示文件资源模板加载器更通常情况下，模板资源是以文件形式管理的，集中放在某一个文件目录下（如webapp的模板根目录就可能是WEB-INF/template里），因此，可以使用FileResourceLoader来加载模板实例，如下代码：String root=System.getProperty(user.dir)+File.separator+template;FileResourceLoader resourceLoader=new FileResourceLoader(root,utf-8);Configuration cfg=Configuration.defaultConfiguration();GroupTemplate gt=new GroupTemplate(resourceLoader,cfg);Template t=gt.getTemplate(/s01/hello.txt);String str=t.render();System.out.println(str);Beetl2.2使用说明书20150505知行合一Beetl2.2使用说明书201505056第1行代码指定了模板根目录，即位于项目工程下的template目录 第2行构造了一个资源加载器，并指定字符集为UTF-8(也可不指定，因为配置文件默认就是UTF-8);第5行通过模板的相对路径/s01/hello.txt来加载模板Classpath资源模板加载器还有种常情况下，模板资源是打包到jar文件或者同Class放在一起，因此，可以使用ClasspathResourceLoader来加载模板实例，如下代码：ClasspathResourceLoader resourceLoader=new ClasspathResourceLoader();Configuration cfg=Configuration.defaultConfiguration();GroupTemplate gt=new GroupTemplate(resourceLoader,cfg);Template t=gt.getTemplate(/org/beetl/sample/s01/hello.txt);String str=t.render();System.out.println(str);第1行代码指定了模板根目录，即搜索模板的时候从根目录开始，如果new ClasspathResourceLoader(/template),则表示搜索/template下的模板。此处用空构造函数，表示搜索路径是根路径，且字符集默认字符集UTF-8.第4行通过模板的相对路径org/beetl/sample/s01/hello.txt来加载模板WebApp资源模板加载器WebAppResourceLoader 是用于web应用的资源模板加载器，默认根路径是WebRoot目录。也可以通过制定root属性来设置相对于WebRoot的的模板根路径，从安全角考虑，建议放到WEB-INF目录下如下是Jfinal集成BeetlRenderFactory里初始化GroupTemplate的方法Configuration cfg=Configuration.defaultConfiguration();WebAppResourceLoader resourceLoader=new WebAppResourceLoader();groupTemplate=new GroupTemplate(resourceLoader,cfg);WebAppResourceLoader 假定 beetl.jar 是位于 WEB-INF/lib 目录下，因此，可以通过WebAppResourceLoader类的路径来推断出WebRoot路径从而指定模板根路径。所有线上环境一般都是如此，如果是开发环境或者其他环境不符合此假设，你需要调用resourceLoader.setRoot()来指定模板更路径自定义资源模板加载器有时候模板可能来自文件系统不同目录，或者模板一部分来自某个文件系统，另外一部分来自数据库，还有的情况模板可能是加密混淆的模板，此时需要自定义资源加载，继承ResouceLoader才能实现模板功能，这部分请参考高级部分定界符与占位符号Beetl模板语言类似JS语言和习俗，只需要将Beetl语言放入定界符号里即可，如默认的是,占位符用于静态文本里嵌入占位符用于输出，如下是正确例子hello 2+3=$result千万不要在定界符里使用占位符号，因为占位符仅仅嵌在静态文本里，如下例子是错误例子Beetl2.2使用说明书20150505知行合一Beetl2.2使用说明书201505057每次有人问我如上例子为啥不能运行的时候，我总是有点憎恶velocity 带来的这种非人性语法定界符号里是表达式，如果表达式跟定界符有冲突，可以在表达式里用“”符号，如$1,2,3/输出一个json列表$key:1,value:2 /输出一个json map，需要加上定界符和占位符 通常还有别的选择，如下定界符 和回车换行(此时,模板配置DELIMITER_STATEMENT_END=或者 DELIMITER_STATEMENT_END=null都可以)#:和回车换行!-：和-!-#和-占位符:-#-#你也可以与团队达成一致意见来选择团队喜爱择定界符号和占位符号。注释Beetl语法类似js语法，所以注释上也同js一样：单行注释采用/多行注视采用/*/第2行是一个多行注释第3行是一个单行注释第5行到第8行采用的是多行注释，因此里面有内容也是注释，模板将不予处理临时变量定义在模板中定义的变量成为临时变量，这类似js中采用var 定义的变量，如下例子全局变量定义全局变量是通过template.binding传入的变量,这些变量能在模板的任何一个地方，包括子模板都能访问到。如java代码里template.binding(list,service.getUserList();/在模板里hello,$user.name;共享变量共享变量指在所有模板中都可以引用的变量，可过groupTemplate.setSharedVars(MapsharedVars)传入的变量,这些变量能在 所有模板 的任何一个地方.GroupTemplate gt=new GroupTemplate(resourceLoader,cfg);Map shared=new HashMap();shared.put(name,beetl);gt.setSharedVars(shared);Template t=gt.getTemplate(/org/beetl/sample/s0208/t1.txt);String str=t.render();System.out.println(str);t=gt.getTemplate(/org/beetl/sample/s0208/t2.txt);str=t.render();System.out.println(str);/t1.txthi,$name/t2.txthello,$name模板变量模板变量是一种特殊的变量，即可以将模板中任何一段的输出赋值到该变量，并允许稍后在其他地方使用，如下代码Beetl2.2使用说明书20150505知行合一Beetl2.2使用说明书201505059模板其他内容：第2行定义了一个模板变量content=;此变量跟临时变量一样，可以在其他地方使用，最常见的用户是用于复杂的布局。请参考高级用法布局引用属性属性引用是模板中的重要一部分，beetl支持属性引用如果javascript的支持方式一样，如下1 Beetl支持通过”.”号来访问对象的的属性，如果javascript一样。如果User对象有个getName()方法，那么在模板中，可以通过$xxx.name来访问2 如果模板变量是数组或者List类，这可以通过 来访问，如$userList03 如果模板变量是Map类，这可以通过来访问，如$map“name”,如果key值是字符串类型，也可以使用$map.name.但不建议这么使用，因为会让模板阅读者误以为是一个Pojo对象4 Beetl也支持Generic Get方式，即如果对象有一个public Object get(String key)方法，可以通过”.”号或者来访问，譬如$activityRecord.name或者$activityRecord“name”都将调用activityRecord的 get(String key)方法。如果对象既有具体属性，又有Generic get（这种模型设计方式是不值得鼓励），则以具体属性优先级高.5 Beetl也可以通过来引用属性，如$user“name”相当于$user.name.这跟javascript保持一致。但建议不这么做，因为容易让阅读模板的人误认为这是一个Map类型6 Beetl 还可以定位额外的对象属性，而无需更改java对象，这叫着虚拟属性，如，对于所有集合，数组，都有共同的虚拟熟悉size.虚拟属性是“.”+虚拟1属性名template.binding(list,service.getUserList();template.binding(pageMap,service.getPage();/在模板里总共$list.sizehello,$user.name;当前页$pageMappage,总共$pageMaptotal算数表达式Beetl支持类似javascript的算术表达式和条件表达式，如+-*/%以及（），以及自增+，自减-Beetl2.2使用说明书20150505知行合一Beetl2.2使用说明书2015050510Beetl里定义的临时变量类型默认对应的java是Int型或者double类型，对于模板常用情况说，已经够了.如果需要定义长精度类型（对应java的BigDecimal），则需要在数字末尾加上h以表示这是长精度BigDecimal，其后的计算和输出以及逻辑表达式都将按照长精度类型来考虑。逻辑表达式Beetl支持类似Javascript,java的条件表达式 如，=,以及!,还有&和|，还有三元表达式等，如下例子三元表达式如果只考虑true条件对应的值的话，可以做简化,如下俩行效果是一样的。$a=1?ok:$a=1?ok循环语句Beetl支持丰富的循环方式，如for-in,for(exp;exp;exp)，以及while循环，以及循环控制语句break;continue;另外，如果没有进入for循环体，还可以执行elsefor指定的语句。for-infor-in循环支持遍历集合对象，对于List和数组来说以及Iterator，对象就是集合对象，对于Map来说，对象就是Map.entry,如下俩个例子第三行代码userLP是Beetl隐含定义的变量，能在循环体内使用。其命名规范是item名称后加上LP，他提供了当前循环的信息，如 userLP.index:当前的索引，从1开始 userLP.size:集合的长度 userLP.first 是否是第一个 userLP.last 是否是最后一个Beetl2.2使用说明书20150505知行合一Beetl2.2使用说明书2015050511 userLP.even 索引是否是偶数 userLP.odd 索引是否是奇数如何记住后缀是LP，有俩个诀窍，英语棒的是Loop的缩写，拼音好的是老婆的拼音缩写，这可以让程序员每次写到这的时候都会想想老婆（不管有没有，哈哈）如下是Map使用例子for(exp;exp;exp)对于渲染逻辑更为常见的是经典的for循环语句，如下例子%var a=1,2,3;for(var i=0;iwhile对于渲染逻辑同样常见的有的while循环语句，如下例子%var i=0;while(ielsefor不同于通常程序语言，如果没有进入循环体，则不需额外的处理，模板渲染逻辑更常见情况是如果没有进入循环体，还需要做点什么，因此，对于for循环来说，还有elsefor 用来表达如果循环体没有进入，则执行elsefor 后的语句条件语句if else同js一样，支持if else,如下例子switch-case同js一样，支持switch-case,如下例子switch变量可以支持任何类型，而不像js那样只能是整形select-caseselect-case 是switch case的增强版。他允许case 里有逻辑表达式，同时，也不需要每个case都break一下，默认遇到合乎条件的case执行后就退出。select 后也不需要一个变量，这样case 后的逻辑表达式将决定执行哪个case.其格式是select case boolExp,orBoolExp2:doSomething();%var b=1;select case b10:print(its out of range);break;case b=1:print(its 1);break;default:print(error);%try-catch通常模板渲染逻辑很少用到try-catch 但考虑到渲染逻辑复杂性，以及模板也有不可控的地方，所以提供try catch，在渲染失败的时候仍然能保证输出正常error代表了一个异常，你可以通过error.message 来获取可能的错误信息也可以省略catch部分，这样出现异常，不做任何操作虚拟属性虚拟属性也是对象的属性，但是虚拟的，非模型对象的真实属性，这样的好处是当模板需要额外的用于显示的属性的时候但又不想更改模型，便可以采用这种办法 如beetl内置的虚拟属性.size 针对了数组以及集合类型。Beetl2.2使用说明书20150505知行合一Beetl2.2使用说明书2015050514$user.gender$user.genderShowNamegenderShowName 是虚拟属性，其内部实现根据boolean变量gender来显示性别如何完成虚拟属性，请参考高级用法函数调用Beetl内置了少量实用函数，可以在Beetl任何地方调用。如下例子是调用date 函数，不传参数情况下，返回当前日期注意函数名支持namespace方式，因此代码第3行调用的函数是strutil.len定义beetl的方法非常容易，有三种方法实现Function类的call方法，并添加到配置文件里，或者显示的通过代码注册registerFunction(name,yourFunction)可以直接调用registerFunctionPackage(namespace,yourJavaObject),这时候yourJavaObject里的所有public方法都将注册为Beetl方法，方法名是namespace+.+方法名可以直接写模板文件并且以html作为后缀，放到root/functions目录下，这样此模板文件自动注册为一个函数，其函数名是该模板文件名。详情请参考高级用法Beetl内置函数请参考附录，以下列出了常用的函数 date 返回一个java.util.Date类型的变量，如 date()返回一个当前时间;$date(2011-1-1,yyyy-MM-dd)返回指定日期 print 打印一个对象 print(user.name);println 打印一个对象以及回车换行符号，回车换号符号使用的是模板本身的，而不是本地系统的.如果仅仅打印一个换行符，则直接调用println()即可 nvl 函数nvl，如果对象为null，则返回第二个参数，否则，返回自己 nvl(user,不存在)isEmpty 判断变量或者表达式是否为空，变量不存在，变量为null，变量是空字符串，变量是空集合，变量是空数组，此函数都将返回true has 变量名为参数，判断是否存在此全局变量，如 has(userList),类似于1.x版本的exist(userList),但不需要输入引号了 assert 如果表达式为false，则抛出异常 trunc 截取数字，保留指定的小数位，如trunc(12.456,2)输出是12.45Beetl2.2使用说明书20150505知行合一Beetl2.2使用说明书2015050515 decode 一个简化的if else 结构，如 decode(a,1,a=1,2,a=2,不知道了),如果a是1，这decode输出a=1,如果a是2，则输出a=2,如果是其他值，则输出不知道了 debug 在控制台输出debug指定的对象以及所在模板文件以及模板中的行数，如debug(1),则输出1 在3行/org/beetl/core/lab/hello.txt parseInt 将数字或者字符解析为整形 如 parseInt(123);parseDouble 将数字或者字符解析为浮点类型 如parseDouble(1.23)range 接收三个参数，初始值，结束值，还有步增（可以不需要，则默认为1），返回一个Iterator，常用于循环中，如for(var i in range(1,5)print(i),将依次打印1234.flush 强制io输出安全输出安全输出是任何一个模板引擎必须重视的问题，否则，将极大困扰模板开发者。Beetl中，如果要输出的模板变量为null，则beetl将不做输出，这点不同于JSP，JSP输出null，也不同于Feemarker，如果没有用!,它会报错.模板中还有俩种情况会导致模板输出异常有时候模板变量并不存在（譬如子模板里）模板变量为null，但输出的是此变量的一个属性，如$user.wife.name针对前俩种种情况，可以在变量引用后加上！以提醒beetl这是一个安全输出的变量。如$user.wife.name!,即使user不存在，或者user为null，或者user.wife为null，或者user.wife.name为null beetl都不将输出可以在!后增加一个常量（字符串，数字类型等），或者另外一个变量，方法，本地调用，作为默认输出，譬如：$user.wife.name!”单身”，如果user为null，或者user.wife为null，或者user.wife.name为null，输出”单身”譬如$user.birthday!System.constants.DefaultBir，表示如果user为null，或者user.birthday为null，输出System.constants.DefaultBir还有一种情况很少发生，但也有可能，输出模板变量发生的任何异常，如变量内部抛出的一个异常这需要使用格式$!(变量),这样，在变量引用发生任何异常情况下，都不作输出，譬如$!(user.name),，beetl将会调用user.getName()方法，如果发生异常，beetl将不会忽略此异常，继续渲染值得注意的是，在变量后加上!不仅仅可以应用于占位符输出(但主要是应用于占位符输出)，也可以用于表达式中，如：%$k%如果user为null，则k值将为N/ABeetl2.2使用说明书20150505知行合一Beetl2.2使用说明书2015050516在有些模板里，可能整个模板都需要安全输出，也可能模板的部分需要安全输出，使用者不必为每一个表达式使用！，可以使用beetl的安全指示符号来完成安全输出 如：$user.wife.name模板其他内容，均能安全输出Beetl不建议每一个页面都使用DIRECTIVE SAFE_OUTPUT_OPEN，这样，如果如果真有不期望的错误，不容易及时发现，其次，安全输出意味着beetl会有额外的代码检测值是否存在或者是否为null，性能会略差点。所以建议及时关闭安全输出（这不是必须的，但页面所有地方是安全输出，可能不容易发现错误）在for-in 循环中，也可以为集合变量增加安全输出指示符号，这样，如果集合变量为null，也可以不进入循环体，如：变量是否存在判断变量是否存在，可以采用内置的has或者isEmpty方法来判断，参数是变量，如如果需要判断变量是否存在，如果存在，还有其他判断条件，通常都这么写如果flag不存在，或者flag存在，但值是0，都将执行if语句但是，有更为简便的方法是直接用安全输出，如flag!0 取值是这样的，如果flag不存在，则为0，如果存在，则取值flag的值，类似三元表达式 has(flag)?falg:0安全输出表达式安全输出表达式可以包括字符串常量,如$user.count!无结果 boolean常量$user.count!false数字常量，仅限于正数，因为如果是负数，则类似减号，容易误用，因此，如果需要表示负数，请用括号，如$user.count!(-1)class直接调用，如$user.count!User.DEFAULT_NUM方法调用，如$user.count!getDefault()属性引用，如$user.count!user.maxCount 任何表达式，需要用括号格式化几乎所有的模板语言都支持格式化，Beetl也不列外，如下例子Beetl提供的内置日期格式Today is$date,dateFormat=yyyy-MM-dd.Today is$date,dateFormatsalary is$salary,numberFormat=#.#格式化函数只需要一个字符串作为参数放在=号后面，如果没有为格式化函数输入参数，则使用默认值，dateFormat格式化函数默认值是localBeetl也允许为指定的java class设定格式化函数，譬如已经内置了对java.util.Date,java.sql.Date 设置了了格式化函数，因此上面的例子可以简化为$date,“yyyy-MM-dd”.Beetl针对日期和数字类型提供的默认的格式化函数，在org/beetl/core/beetl-default.properties里，注册了#内置的格式化函数FT.dateFormat=org.beetl.ext.format.DateFormatFT.numberFormat=org.beetl.ext.format.NumberFormat#内置的默认格式化函数FTC.java.util.Date=org.beetl.ext.format.DateFormatFTC.java.sql.Date=org.beetl.ext.format.DateFormatFTC.java.sql.Time=org.beetl.ext.format.DateFormatFTC.java.sql.Timestamp=org.beetl.ext.format.DateFormatFTC.java.lang.Short=org.beetl.ext.format.NumberFormatFTC.java.lang.Long=org.beetl.ext.format.NumberFormatFTC.java.