jeeCmsV7-src 源码解析之五（Spring + FreeMarker的集成）

共四步

一、加载属性文件  application-context.xml下的jeecms.properties，会在第四步用到。

<web-app id="WebApp_ID" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
	<display-name>JeeCmsV7</display-name>
	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>
			<!-- 数据库相关配置并加载了hbm.xml文件 (Spring)-->
			/WEB-INF/config/application-context.xml
			<!-- 数据缓存相关配置 -->
			/WEB-INF/config/cache-context.xml
			<!-- 验证码相关配置 --> 
			/WEB-INF/config/captcha-context.xml
			 <!-- 图片，密码，文件上传等配置 --> 
			/WEB-INF/config/jeecms/jeecore-context.xml
			<!-- spring bean相关配置，如dao层的配置、图片处理，密码加密 -->
			/WEB-INF/config/jeecms/jeecms-context.xml
			<!-- 配置权限管理shiro-context.xml框架 -->
			/WEB-INF/config/shiro-context.xml
			<!-- 配置其它插件文件，暂时没有 -->
			/WEB-INF/config/plug/**/*-context.xml
			<!-- 配置定时任务 -->
			/WEB-INF/config/quartz-task.xml
		</param-value>
	</context-param>
...
</web-app>

二、前台配置：

1、配置FreeMarkerConfigurer

<!-- 配置freemaker -->
	<bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
		<!--获取标签配置-->
		<property name="freemarkerVariables" value="#{propertyUtils.getBeanMap('directive.')}"/>
		<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>-->
				<!--定义FreeMaker引入文件，index.ftl前缀为p,spring.ftl的前缀为s，这样在饮用ftl模版的宏定义时，可以简略使用-->
				<prop key="auto_import">/WEB-INF/ftl/jeecms/index.ftl as p,/WEB-INF/ftl/spring.ftl as s</prop>
			</props>
		</property>
	</bean>

2、解析 FreeMarker 视图

<!-- 解析freemaker视图 -->
	<bean id="freemarkerViewResolver" class="com.jeecms.common.web.springmvc.SimpleFreeMarkerViewResolver">
		<property name="contentType" value="text/html; charset=UTF-8"/>
		<!-- 请求属性不暴露给freemaker使用 -->
		<property name="exposeRequestAttributes" value="false"/>
		<!-- 会话属性不暴露给freemaker使用 -->
		<property name="exposeSessionAttributes" value="false"/>
		<!-- 使用宏 -->
		<property name="exposeSpringMacroHelpers" value="true"/>
	</bean>

三、后台配置

1、配置FreeMarkerConfigurer

<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"/>
				<entry key="cms_content_list" value-ref="cms_content_list"/>
				<entry key="cms_content_page" value-ref="cms_content_page"/>
			</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>
				<!--定义FreeMaker引入文件，index.ftl前缀为p,spring.ftl的前缀为s，这样在饮用ftl模版的宏定义时，可以简略使用-->
				<prop key="auto_import">/ftl/jeecms/index.ftl as p,/ftl/spring.ftl as s</prop>
			</props>
		</property>
	</bean>

2、解析 FreeMarker 视图

<!-- 视图解析器 -->
	<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"/>
		<!-- 请求属性不暴露给freemaker使用 -->
		<property name="exposeRequestAttributes" value="false"/>
		<!-- 会话属性不暴露给freemaker使用 -->
		<property name="exposeSessionAttributes" value="false"/>
		<!-- 使用宏 -->
		<property name="exposeSpringMacroHelpers" value="true"/>
	</bean>

四、注入 freeMarkerConfigurer（ jeecms-context.xml ）

<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">
				<!-- 从jeecms.properties中获取标签：directive.前缀的 -->
				<property name="freemarkerVariables" value="#{propertyUtils.getBeanMap('directive.')}"/>
				<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/jeecms/index.ftl as p,/WEB-INF/ftl/spring.ftl as s</prop>
					</props>
				</property>
			</bean>
		</property>
	</bean>