Jeecms源码分析（三）
本节主要分析Spring + FreeMarker的集成。
先介绍一下 spring+freemarker的集成主要涉及以下配置项：
1、配置 FreeMarkerConfigurer
<bean id="freeMarkerConfigurer" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer"> …… </bean>
通过 freemarkerSettings 属性，也能够设置其他 FreeMarker 的配置。例如， FreeMarker 默认每隔 5 秒检查模板是否被更新，如果已经更新了，就会重新加载并分析模板。但经常检查模板是否更新可能比较耗时。如果你的应用运行在生产模式下，而且你预期模板不会经常更新，则可以将更新的延迟时间延长至一个小时或者更久。
可以通过为 freemarkerSettings 属性设置 template_update_delay 达到这一目的。例如：
<property name="freemarkerSettings">
<props>
<prop key="template_update_delay">3600</prop>
</props>
</property>
设置 template_update_delay 为 3600 （秒），因此 FreeMarker 只有在 1 个小时之后才检查模板是否更新。
2、解析 FreeMarker 视图
<bean id="viewResolver" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
<property name="suffix"><value>.ftl</value></property>
</bean>
将请求和会话属性作为变量暴露给 FreeMarker 模板使用。要做到这一点，可以设置 exposeRequestAttributes 或者 exposeSessionAttributes 为 true ：
<property name="exposeRequestAttributes">
<value>true</value>
</property>
<property name="exposeSessionAttributes">
<value>true</value>
</property>
使用这些宏，必须设置 FreeMarkerViewResolver 的 exposeMacroHelpers 属性为 true ：
<property name="exposeSpringMacroHelpers">
<value>true</value>
</property>
3、在 FreeMarker 中绑定表单域
<@spring.bind "command.phone" />
phone: <input type="text"
name="${spring.status.expression}"
value="${spring.status.value}">
<font color="#FF0000">${spring.status.errorMessage}</font><br>
<@spring.bind "command.email" />
email: <input type="text"
name="${spring.status.expression}"
value="${spring.status.value}">
<font color="#FF0000">${spring.status.errorMessage}</font><br>
4、最后，你还需要做一件事才能使用FreeMarker 宏
<@spring.bindEscaped>的FreeMarker模板的顶部增加以下一行： <#import "/spring.ftl" as spring />
这一行会在模板中导入Spring的FreeMarker宏。
Jeecms中相关的配置文件如下----------------->：
总体说明：
1、定义FreeMaker引入文件，index.ftl前缀为p,spring.ftl的前缀为s，这样在饮用ftl模版的宏定义时，可以简略使用。
<prop key="auto_import">/WEB-INF/ftl/pony/index.ftl as p,/WEB-INF/ftl/spring.ftl as s</prop>
在html表单中的使用，例如：
<div class="body-box"> <@p.form id="jvForm" action="o_update.do" labelWidth="12"> <@p.td 。。。。 </div>
2、在jeecms中，请求回话属性都不允许暴露给freemarker使用。。（不知道是否跟freemarker不支持集群有关系？？？？这样是否可以支持集群 ）
.... <property name="exposeRequestAttributes" value="false"/> <property name="exposeSessionAttributes" value="false"/> ....
以下是涉及到的配置文件：
- web.xml 中的配置文件
....
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>
/WEB-INF/config/application-context.xml
/WEB-INF/config/cache-context.xml
/WEB-INF/config/captcha-context.xml
/WEB-INF/config/jeecore-context.xml
/WEB-INF/config/jeecms-context.xml
</param-value>
</context-param>
....
- jeecms-context.xml
在这个配置文件中，freeMarkerConfigurer作为 StaticPageSvcImpl的一个属性，注入到这个类中。
freeMarkerConfigurer的配置包括freemarker定义的标签（见freemarkerVariables），freemarkerSettings中定义了一些详细的属性。
详见前面的描述。
<bean id="staticPageSvc" class="com.jeecms.cms.staticpage.StaticPageSvcImpl"> <property name="tplMessageSource" ref="tplMessageSource"/> <property name="freeMarkerConfigurer"> <bean class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer"> <property name="freemarkerVariables"> <map> <entry key="uuid" value-ref="uuid"/> <entry key="process_time" value-ref="process_time"/> <entry key="text_cut" value-ref="text_cut"/> <entry key="html_cut" value-ref="html_cut"/> <entry key="cms_pagination" value-ref="cms_pagination"/> <entry key="cms_channel_list" value-ref="cms_channel_list"/> <entry key="cms_channel_page" value-ref="cms_channel_page"/> <entry key="cms_channel" value-ref="cms_channel"/> <entry key="cms_content" value-ref="cms_content"/> <entry key="cms_content_list" value-ref="cms_content_list"/> <entry key="cms_content_page" value-ref="cms_content_page"/> <entry key="cms_tag_list" value-ref="cms_tag_list"/> <entry key="cms_tag_page" value-ref="cms_tag_page"/> <entry key="cms_topic_list" value-ref="cms_topic_list"/> <entry key="cms_topic_page" value-ref="cms_topic_page"/> <entry key="cms_comment_list" value-ref="cms_comment_list"/> <entry key="cms_comment_page" value-ref="cms_comment_page"/> <entry key="cms_guestbook_ctg_list" value-ref="cms_guestbook_ctg_list"/> <entry key="cms_guestbook_list" value-ref="cms_guestbook_list"/> <entry key="cms_guestbook_page" value-ref="cms_guestbook_page"/> <entry key="cms_vote" value-ref="cms_vote"/> <entry key="cms_friendlink_ctg_list" value-ref="cms_friendlink_ctg_list"/> <entry key="cms_friendlink_list" value-ref="cms_friendlink_list"/> <entry key="cms_lucene_list" value-ref="cms_lucene_list"/> <entry key="cms_lucene_page" value-ref="cms_lucene_page"/> <entry key="cms_advertising" value-ref="cms_advertising"/> </map> </property> <property name="templateLoaderPath" value=""/> <property name="freemarkerSettings"> <props> <prop key="tag_syntax">auto_detect</prop> <prop key="template_update_delay">5</prop> <prop key="defaultEncoding">UTF-8</prop> <prop key="url_escaping_charset">UTF-8</prop> <prop key="locale">zh_CN</prop> <prop key="boolean_format">true,false</prop> <prop key="datetime_format">yyyy-MM-dd HH:mm:ss</prop> <prop key="date_format">yyyy-MM-dd</prop> <prop key="time_format">HH:mm:ss</prop> <prop key="number_format">0.######</prop> <prop key="whitespace_stripping">true</prop> <prop key="auto_import">/WEB-INF/ftl/pony/index.ftl as p,/WEB-INF/ftl/spring.ftl as s</prop> </props> </property> </bean> </property> </bean>
- jeecms-servlet-admin.xml
view resolver 配置：
<bean id="freemarkerViewResolver" class="com.jeecms.common.web.springmvc.RichFreeMarkerViewResolver"> <property name="prefix" value="/jeecms_sys/"/> <property name="suffix" value=".html"/> <property name="contentType" value="text/html; charset=UTF-8"/> <property name="exposeRequestAttributes" value="false"/> <property name="exposeSessionAttributes" value="false"/> <property name="exposeSpringMacroHelpers" value="true"/> </bean>
freemarkerConfig 配置：
<bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer"> <property name="templateLoaderPath" value="/WEB-INF"/> <property name="freemarkerVariables"> <map> <!--在FCK编辑器中需要用到appBase，以确定connector路径。--> <entry key="appBase" value="/jeeadmin/jeecms"/> <!--后台管理权限控制--> <entry key="cms_perm" value-ref="cms_perm"/> <entry key="text_cut" value-ref="text_cut"/> <entry key="html_cut" value-ref="html_cut"/> </map> </property> <property name="freemarkerSettings"> <props> <prop key="template_update_delay">0</prop> <prop key="defaultEncoding">UTF-8</prop> <prop key="url_escaping_charset">UTF-8</prop> <prop key="locale">zh_CN</prop> <prop key="boolean_format">true,false</prop> <prop key="datetime_format">yyyy-MM-dd HH:mm:ss</prop> <prop key="date_format">yyyy-MM-dd</prop> <prop key="time_format">HH:mm:ss</prop> <prop key="number_format">0.######</prop> <prop key="whitespace_stripping">true</prop> <prop key="auto_import">/ftl/pony/index.ftl as p,/ftl/spring.ftl as s</prop> </props> </property> </bean>
- jeecms-servlet-front.xml ，
view resolver 配置：
<bean id="freemarkerViewResolver" class="com.jeecms.common.web.springmvc.SimpleFreeMarkerViewResolver"> <property name="contentType" value="text/html; charset=UTF-8"/> <property name="exposeRequestAttributes" value="false"/> <property name="exposeSessionAttributes" value="false"/> <property name="exposeSpringMacroHelpers" value="true"/> </bean>
freemarkerConfig 配置：参数配置与jeecms-servlet-admin.xml类似。
<bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer"> <property name="freemarkerVariables"> <map> <entry key="uuid" value-ref="uuid"/> <entry key="process_time" value-ref="process_time"/> <entry key="text_cut" value-ref="text_cut"/> <entry key="html_cut" value-ref="html_cut"/> <entry key="cms_pagination" value-ref="cms_pagination"/> <entry key="cms_channel_list" value-ref="cms_channel_list"/> <entry key="cms_channel_page" value-ref="cms_channel_page"/> <entry key="cms_channel" value-ref="cms_channel"/> <entry key="cms_content" value-ref="cms_content"/> <entry key="cms_content_list" value-ref="cms_content_list"/> <entry key="cms_content_page" value-ref="cms_content_page"/> <entry key="cms_tag_list" value-ref="cms_tag_list"/> <entry key="cms_tag_page" value-ref="cms_tag_page"/> <entry key="cms_topic_list" value-ref="cms_topic_list"/> <entry key="cms_topic_page" value-ref="cms_topic_page"/> <entry key="cms_comment_list" value-ref="cms_comment_list"/> <entry key="cms_comment_page" value-ref="cms_comment_page"/> <entry key="cms_guestbook_ctg_list" value-ref="cms_guestbook_ctg_list"/> <entry key="cms_guestbook_list" value-ref="cms_guestbook_list"/> <entry key="cms_guestbook_page" value-ref="cms_guestbook_page"/> <entry key="cms_vote" value-ref="cms_vote"/> <entry key="cms_lucene_list" value-ref="cms_lucene_list"/> <entry key="cms_lucene_page" value-ref="cms_lucene_page"/> <entry key="cms_friendlink_ctg_list" value-ref="cms_friendlink_ctg_list"/> <entry key="cms_friendlink_list" value-ref="cms_friendlink_list"/> <entry key="cms_advertising" value-ref="cms_advertising"/> </map> </property> <!-- <property name="preTemplateLoaders"> <list> <ref bean="tplMng"/> </list> </property> --> <property name="templateLoaderPath" value=""/> <property name="freemarkerSettings"> <props> <prop key="tag_syntax">auto_detect</prop> <prop key="template_update_delay">5</prop> <prop key="defaultEncoding">UTF-8</prop> <prop key="url_escaping_charset">UTF-8</prop> <prop key="locale">zh_CN</prop> <prop key="boolean_format">true,false</prop> <prop key="datetime_format">yyyy-MM-dd HH:mm:ss</prop> <prop key="date_format">yyyy-MM-dd</prop> <prop key="time_format">HH:mm:ss</prop> <prop key="number_format">0.######</prop> <prop key="whitespace_stripping">true</prop> <!--空值处理<prop key="classic_compatible">true</prop>--> <prop key="auto_import">/WEB-INF/ftl/pony/index.ftl as p,/WEB-INF/ftl/spring.ftl as s</prop> </props> </property> </bean>
至此，JeeCms中的FreeMarker的配置已经分析完毕。