一、GroupTemplateFactroyBean与Beetl Spring扩展类

　　本章主要介绍GroupTemplateFactroyBean及其相关的Beetl Spring扩展类，这些类的设计目的均为尽可能将Beetl所使用的各种组件对象（Function，ResourceLoader，TagFactory，甚至核心对象GroupTemplate等都交由Spring容器管理，以充分利用Spring的特性增强组件功能，这一思想是后面Beetl对Spring MVC及Spring Security整合的基础），除非有特殊需要，这些扩展并不要求Web环境，即使为普通的Spring应用程序的也能使用。

　　文中涉及的Beetl的相关概念请阅读Beetl文档：http://ibeetl.com/guide/

1.1 GroupTemplateFactroyBean

　　GroupTemplate是Beetl的核心配置和操作类，对模板的渲染以及模板配置都是以此类为中心实现的。GroupTemplateFactoryBean是一个Spring FactoryBean<GroupTemplate>，用以在指定配置后构造GroupTemplate实例。将他配置为一个Spring Bean，如下：

<bean name="groupTemplate" class="org.fox.beetl.ext.spring.GroupTemplateFactoryBean"/>

　　GroupTemplateFactoryBean的所有配置参数都是可选的，他们可以对GroupTemplate细节提供细化的配置，具体参数格式见下表：

参数名 参数类型
说明
 configFileResource  Resource

指定Beetl配置文件，这使用Spring IO包的Resource的语法来指定资源

默认情况下加载Beetl包自带的默认配置文件：

classpath:org/beetl/core/beetl-default.properties
 configProperties  Properties 用于覆盖上述配置文件中配置项的Properties
 resourceLoader  ResourceLoader

Beetl组件：资源加载器，负责按照给定path加载模板数据

默认Beetl会按照配置文件指定自己实例化资源加载器

(Beetl默认使用ClassPathResourceLoader从classpath中获取模板)
 errorHandler  ErrorHandler

Beetl组件：错误处理器，负责对Beetl模板渲染过程中出现的错误进行处理

默认Beetl会按照配置文件指定自己实例化错误处理器

(Beetl默认将错误输出到Stdout中）
 sharedVars  Map<String, Object> Beetl模板的共享变量，所有该GroupTemplate实例处理的模板都能使用该实例
 extGroupTemplateConfigs  List<ExtGroupTemplateConfig>

GroupTemplate扩展配置类，他能对本属性以下的所有属性进行额外设置，他主要为更多配置扩展进行简化的统一配置支持

默认不设置时，GroupTemplateFactoryBean会自动检测上下文中所有已经部署的ExtGroupTemplateConfig实现Bean进行配置。

注意1：本属性及本属性以上的配置不能被ExtGroupTemplateConfig设置，即configFileResource、configProperties、resourceLoader、errorHandler、sharedVars、extGroupTemplateConfigs这几个属性必须在GroupTemplateFactoryBean中设置；

注意2：配置顺序按照列表给定的顺序执行，最后是当前GroupTemplateFactoryBean的自身设置，如果配置冲突以最后配置为准。

例如Beetl Spring Security整合扩展提供预设的整合配置文件，security-ext.3.2.xml，将扩展的tag和function都配置为一个ExtGroupTemplateFactory实例，这样使用时只需要在当前配置文件中import入预设文件，将对应的ExtGroupTemplateFactory实例就

用法参考beetl-spring-web-security-example示例
 functions  Map<String, Function>

Beetl组件：自定义函数

其中key为函数名
 typeFormats  Map<Class<?>, Format>

Beetl组件：自定义类型默认格式化器

其中key为类型Class
 formats  Map<String, Format>

Beetl组件：自定义格式化器

其中key为格式化器名
 tagFactorys  Map<String, TagFactory>

Beetl组件：自定义标签（工厂）

其中key为标签名
 functionPackages  Map<String, Object>

Beetl组件：自定义函数包

其中key为函数包名
 virtualClassAttributes  Map<Class<?>, VirtualClassAttribute>

Beetl组件：为类型添加自定义虚拟属性

其中key为类型Class
 virtualAttributeEvals  List<VirtualAttributeEval>

Beetl组件：虚拟属性执行器

与virtualClassAttributes不同，他们不特定于某个类型

 1.2 SpElFunction

　　SpELFunction函数类是Beetl的一个Function扩展，执行一个SpEL表达式返回其结果，调用格式为：

Object spel(String expression)

　　SpEL表达式的相关内容请参见Spring文档，它在一般EL语法上进行扩展，允许直接调用对象函数，提供对集合类的投影，筛选操作等。特殊的可以在SpEL表达式中使用@beanName的的方式直接引用到Spring上下文中的Bean，也允许使用T(className).method()调用指定类型的静态函数。例如：

1 spel("@urlEncoder.encode(name)");
2 spel("T(java.util.UUID).randomUUID().toString()");

　　注意1：由于Beetl的限制，当前版本的SpELFunction只支持操作Beetl上下文中的共享变量和全局变量，并不支持；

　　注意2：SpELFunction必须作为Spring上下文中的受管Bean通过GroupTemplateFactoryBean提供给Beetl使用。

1.3 SpringServletContextResourceLoader

　　SpringServletContextResourceLoader使用Spring的机制获取Web环境中的ServletContext，以servletContext.getRealPath("/")获取到的文件路径为资源的根目录。这个ResourceLoader用以在Spring Web环境下替换Beetl自带的WebAppResourceLoader，以解决Beetl的jar包不在WEB-INF/lib下造成错误判定WebRoot目录的问题（例如main方法启动的Jetty服务）。

　　注意1：与一般基于File的FileResourceLoader相同，他支持设置charset和autoCheck属性，但它不支持设置root属性（只能通过beetl配置文件REOURCE.root设置）。

　　注意2：SpringServletContextResourceLoader必须作为Spring上下文中的受管Bean通过GroupTemplateFactoryBean提供给Beetl使用。

1.4 SpringBeanTagFactory

　　SpringBeanTagFactory作为一个TagFactory实现，他按照name参数的设置，从Spring上下文中获取指定name的Tag实现Bean实例返回。SpringBeanTagFactory必须作为Spring上下文中的受管Bean通过GroupTemplateFactoryBean提供给Beetl使用。并且应该保证他所引用的Tag实现Bean必须是prototype的，不能单例，否则在使用时会出现不一致的情况。

 1 <bean name="groupTemplate" ....>
 2   <property name="tagFactorys">
 3     <map>
 4       <entry key="sec.accessIf" value-ref="accessIfTagFactory"/>
 5     </map> 
 6   </property>
 7 </bean>
 8 <bean name="accessIfTagFactory" class="org.fox.beetl.ext.spring.tag.SpringBeanTagFactory">
 9     <property name="name" value="accessIfTag"/>
10 </bean>
11 <bean name="accessIfTag" class="...." scope="prototype"/>

　　截至Beetl2.0.10，SpringBeanTagFactory的使用有一些特殊问题，需要一些特殊处理技巧，详细问题描述和处理技巧参见这里：http://www.cnblogs.com/shishuifox/p/3852398.html  使用方法建议参考示例beetl-spring-web-security-example

　　简单的说，要正常使用SpringBeanTagFactory，需要保证1. 将他定义为一个公开的有确认名字的bean，不能使用匿名bean或内部bean定义。2.在应用程序上下文中注册一个ApplicationContext生命周期监听器：

<bean class="org.fox.beetl.ext.spring.utils.ApplicationContextLifecycleEventListener"/>

　　Beetl2.0.11已经修正该问题，该限制也于beetl-spring.1.0.4取消，建议升级。