Beetl学习总结（2）——基本用法

2.1. 安装

如果使用maven，使用如下坐标

com.ibeetl

beetl

2.7.0

如果非maven工程，直接下载 http://git.oschina.net/xiandafu/beetl2.0/attach_files

2.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内置了6种，分别是

StringTemplateResourceLoader：字符串模板加载器，用于加载字符串模板，如本例所示

FileResourceLoader：文件模板加载器，需要一个根目录作为参数构造，，传入getTemplate方法的String是模板文件相对于Root目录的相对路径

ClasspathResourceLoader：文件模板加载器，模板文件位于Classpath里

WebAppResourceLoader：用于webapp集成，假定模板根目录就是WebRoot目录，参考web集成章

MapResourceLoader : 可以动态存入模板

CompositeResourceLoader 混合使用多种加载方式

代码第5行将变量name传入模板里，其值是“Beetl”。 代码第6行是渲染模板，得到输出，template提供了多种获得渲染输出的方法，如下

tempalte.render() 返回渲染结果，如本例所示

template.renderTo(Writer) 渲染结果输出到Writer里

template.renderTo(OutputStream ) 渲染结果输出到OutputStream里

关于如何使用模板资源加载器，请参考下一节

如何对模板进行配置，请参考下一节

2.3. 模板基础配置

Beetl提供不但功能齐全，而且还有很多独特功能，通过简单的配置文件，就可以定义众多的功能，默认情况下，Configuration类总是会先加载默认的配置文件（位于/org/beetl/core/beetl-default.properties，作为新手，通常只需要关注3,4,5,6行定界符的配置，以及12行模板字符集的配置就可以了，其他配置会在后面章节陆续提到）下，其内容片断如下：

#默认配置

ENGINE=org.beetl.core.engine.FastRuntimeEngine

DELIMITER_PLACEHOLDER_START=${

DELIMITER_PLACEHOLDER_END=}

DELIMITER_STATEMENT_START=

DIRECT_BYTE_OUTPUT = FALSE

HTML_TAG_SUPPORT = true

HTML_TAG_FLAG = #

HTML_TAG_BINDING_ATTRIBUTE = var

NATIVE_CALL = TRUE

TEMPLATE_CHARSET = UTF-8

ERROR_HANDLER = org.beetl.core.ConsoleErrorHandler

NATIVE_SECUARTY_MANAGER= org.beetl.core.DefaultNativeSecurityManager

MVC_STRICT = FALSE

#资源配置，resource后的属性只限于特定ResourceLoader

RESOURCE_LOADER=org.beetl.core.resource.ClasspathResourceLoader

#classpath 根路径

RESOURCE.root= /

#是否检测文件变化

RESOURCE.autoCheck= true

#自定义脚本方法文件的Root目录和后缀

RESOURCE.functionRoot = functions

RESOURCE.functionSuffix = html

#自定义标签文件Root目录和后缀

RESOURCE.tagRoot = htmltag

RESOURCE.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行指定了占位符号，默认是${ }.也可以指定为其他占位符。

第5,6行指定了语句的定界符号，默认是,也可以指定为其他定界符号

第7行指定IO输出模式，默认是FALSE,即通常的字符输出，在考虑高性能情况下，可以设置成true。详细请参考高级用法

第8,9行指定了支持HTML标签，且符号为#,默认配置下，模板引擎识别这样的类似html标签，并能调用相应的标签函数或者模板文件。你也可以指定别的符号，如bg: 则识别