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.xsdhttp://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsdhttp://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_detecttemplate_update_delay=2default_encoding=UTF-8output_encoding=UTF-8locale=zh_CNdate_format=yyyy-MM-ddtime_format=HH:mm:ssdatetime_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 *  */@Controllerpublic class LoginController {private static final Logger logger = LoggerFactory.getLogger(LoginController.class);@Autowiredprivate 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”，页面会继续向下请求页面