SpringMVC+FreeMarker配置详解（验证可用）

公司技术管理中心定义了一套all in one开发环境，目前的新的项目都是采用SpringMVC+FreeMarker整合的开发环境，日志框架，异常框架，DAO层的持久化框架都是自己定义的jar包实现，其他的一些前台的展示控件，在没有特殊要求的前提下，都有自己使用的一套东西，只要引用就可以使用了，开发人员使用起来较为简单，但是环境和资源都是人家整合的，对于我等菜鸟来说知其然不知其所以然，为了了解其中较为详细的配置，花了一番功夫，记录如下：

Web容器不多说，基本一样，如下

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

	<!-- The definition of the Root Spring Container shared by all Servlets 
		and Filters -->
	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>
		classpath:spring/root-context.xml
		</param-value>
	</context-param>

	<!-- Creates the Spring Container shared by all Servlets and Filters -->
	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
	</listener>

	<!-- Processes application requests -->
	<servlet>
		<servlet-name>appServlet</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>classpath:spring/servlet-context.xml</param-value>
		</init-param>
		<load-on-startup>1</load-on-startup>
	</servlet>

	<servlet-mapping>
		<servlet-name>appServlet</servlet-name>
		<url-pattern>*.htm</url-pattern>
	</servlet-mapping>

</web-app>

上述内容较为简单不解释。servlet-mapping拦截的是*.htm，据说是便于搜索引擎收录网站，其他的静态页面采用*.html后缀即可区分了。

下面的spring核心的应用上下文配置了好长时间

<?xml version="1.0" encoding="UTF-8"?>
<beans:beans xmlns="http://www.springframework.org/schema/mvc"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:beans="http://www.springframework.org/schema/beans"
	xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd
		http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
		http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd">

	<!-- Enables the Spring MVC @Controller programming model -->
	<annotation-driven />

	<!-- Handles HTTP GET requests for /resources/** by efficiently serving 
		up static resources in the ${webappRoot}/resources directory -->
	<!-- 处理静态资源 -->
	<resources mapping="/resources/**" location="/resources/" />

	<!-- Resolves views selected for rendering by @Controllers to .jsp resources 
		in the /WEB-INF/views directory -->
	<!-- Jsp采用的默认视图解析器，order属性为1，表示在order为0的解析器解析不到时才使用此解析器 -->
	<beans:bean id="viewResolverCommon"
		class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<beans:property name="prefix" value="/WEB-INF/" />
		<beans:property name="suffix" value=".jsp" />

		<beans:property name="viewClass"
			value="org.springframework.web.servlet.view.InternalResourceView" />
		<beans:property name="order" value="1" />
	</beans:bean>

	<!-- 配置freeMarker视图解析器 -->
	<beans:bean id="viewResolver"
		class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
		<beans:property name="viewClass"
			value="org.springframework.web.servlet.view.freemarker.FreeMarkerView" />
		<beans:property name="contentType" value="text/html;charset=utf-8" />
		<beans:property name="cache" value="true" />
		<beans:property name="suffix" value=".ftl" />
		<beans:property name="order" value="0" />
	</beans:bean>

	<beans:bean id="freemarkerConfiguration"
		class="org.springframework.beans.factory.config.PropertiesFactoryBean">
		<beans:property name="location"
			value="classpath:conf/freemarker.properties" />
	</beans:bean>

	<!-- 配置freeMarker的模板路径 -->
	<beans:bean id="freemarkerConfig"
		class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
		<!--property name="freemarkerSettings" ref="freemarkerConfiguration"/ -->
		<beans:property name="templateLoaderPath">
			<beans:value>/WEB-INF/</beans:value>
		</beans:property>
		<beans:property name="freemarkerVariables">
			<beans:map>
				<beans:entry key="xml_escape" value-ref="fmXmlEscape" />
			</beans:map>
		</beans:property>
		<beans:property name="defaultEncoding">
			<beans:value>utf-8</beans:value>
		</beans:property>
		<beans:property name="freemarkerSettings">
			<beans:props>
				<beans:prop key="template_update_delay">3600</beans:prop>
			</beans:props>
		</beans:property>
	</beans:bean>

	<beans:bean id="fmXmlEscape" class="freemarker.template.utility.XmlEscape" />

	<context:component-scan base-package="com.suning.app" />

</beans:beans>

相关的说明和注意点注释里面基本说了，内容主要是先拦截freemarker的内容，拦截不到再使用jsp的视图解析器，如此这段配置实现了对.ftl和.jsp的解析。

里面的freemarker.properties配置如下即可：

tag_syntax=auto_detect
template_update_delay=2
default_encoding=UTF-8
output_encoding=UTF-8
locale=zh_CN
date_format=yyyy-MM-dd
time_format=HH:mm:ss
datetime_format=yyyy-MM-dd HH:mm:ss

controller就可以随意写了，比如如下的这样：

package com.suning.app.login.web;

import java.util.List;

import javax.servlet.http.HttpServletRequest;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.RequestMapping;

import com.suning.app.login.bean.User;
import com.suning.app.login.service.UserService;
import com.suning.common.multidatasource.DataSourceContextHolder;

/**
 * 
 * @author gg
 * 
 */
@Controller
public class LoginController {

	private static final Logger logger = LoggerFactory
			.getLogger(LoginController.class);

	@Autowired
	private UserService userService;

    @RequestMapping(value="/hello")
    public String sayHello(ModelMap map) {
        System.out.println("say Hello ……");
        map.addAttribute("name", " World!");
        return "freemarker/hello";
    }
    
	
	@RequestMapping(value="/login")
	public String login(){
		return "views/login";
	}
	
	@RequestMapping(value = "/welcome")
	public String loginPage(HttpServletRequest request,ModelMap model) {
		DataSourceContextHolder.setDataSourceContextHolder("dataSource1");
		logger.info("loginPage in process...");
		String userId=request.getParameter("userId");
		String passWd=request.getParameter("passWd");
		
		StringBuilder sb=new StringBuilder();
		sb.append("[User][").append(userId+",").append(passWd+"]");
		logger.info(sb.toString());
				
		User user=new User();
		user.setUserId(userId);
		user.setPassWd(passWd);
		//logger.info(String.valueOf(userService.hasMatchUser(user)));
		
		List<User> listUser=userService.getListUser(userId);
		
		if(userService.hasMatchUser(user)){
			logger.info("登录成功");
			model.addAttribute("listUser", listUser.get(0));
			return "views/success";
		}
		logger.info("用户名密码不存在，登录失败");
		return "views/error";
	}
}

访问http://localhost:8080/SpringMVC/hello.htm访问的是freemarker解析的页面

<html>
<body>
    <h1>say hello ${name}</h1><br/>
    ${(1 == 1)?string("yes", "no")}
</body>
</html>

访问http://localhost:8080/SpringMVC/login.htm访问的是jsp解析的页面，内容不加了，较为简单，登录后的form的action指向“welcome.htm”，页面会继续向下请求页面