Spring MVC的多视图解析器配置及与Freemarker的集成

一、从freemarker谈起

Freemarker使用模板技术进行视图的渲染。自从看了Struts标签、Freemarker、JSTL的性能对比后，我毅然决定放弃Struts标签了！效率太差……

Spring本身支持了对Freemarker的集成。只需要配置一个针对Freemarker的视图解析器即可。

 

二、Spring MVC视图解析器

视图解析器的工作流程大致是这样的：Controller的某个方法执行完成以后，返回一个视图（比如：listUser），视图解析器要做的工作 就是找到某个对象来完成视图的渲染，或者跳转到其他的逻辑视图。这里的渲染对象通常就是我们的jsp文件或者我们下面用的Freemarker(例如 listUser.jsp或者listUser.ftl)。渲染完成以后，将解析结果发送到客户端浏览器

下面介绍一下本文需要用到的解析器（更多解析器资料，请参考 http://e-freya.iteye.com/blog/384083 ）：

InternalResourceViewResolver：这是一个最常用的解析器。通常使用它指定渲染对象为jsp页面

FreeMarkerViewResolver：这就是Spring与Freemarker整合需要用到的解析器

 

三、配置多视图，支持freemarker

我们通常不希望所有的动态页面请求都使用Freemarker来渲染，那就需要配置多个视图解析器。网上有很多这方面的帖子。我看到很多人的做法是 在web.xml中配置两个DispatcherServlet,一个拦截*.do，一个拦截*.ftl;然后再写两个 dispatcherServlet.xml,配置两个视图解析器；jsp页面、ftl模板就各司其职。

其实没有那么复杂。

1.Web.xml

 

<?xml version="1.0" encoding="UTF-8"?>
<web-app 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">
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>

    <!-- ======================================================== -->
    <!--                  Spring MVC Config Servlet               -->
    <!-- ======================================================== -->
    <!-- JSP DispatcherServlet -->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/classes/applicationContext.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <!-- ======================================================== -->
    <!--                  Spring MVC Config Mapping               -->
    <!-- ======================================================== -->
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>*.do</url-pattern>
    </servlet-mapping>
</web-app>

 

 

2.dispatcherServlet.xml

 

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


    <!--通用视图解析器-->
    <bean id="viewResolverCommon" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/page/"/>
        <property name="suffix" value=".jsp"/><!--可为空,方便实现自已的依据扩展名来选择视图解释类的逻辑  -->
        <property name="viewClass">
            <value>org.springframework.web.servlet.view.InternalResourceView</value>
        </property>
        <property name="order" value="1"/>
    </bean>

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

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

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

    <!-- 注解支持 -->
    <mvc:annotation-driven/>

    <!-- 对包中的所有类进行扫描，以完成Bean创建和自动依赖注入的功能 -->
    <context:component-scan base-package="com.hl.usersmanager">
        <!-- 允许定义过滤器将基包下的某些类纳入或排除
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/> -->
    </context:component-scan>

</beans>

 

 

3.Controller

package com.hl.usersmanager.controller;

import java.util.List;

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.hl.usersmanager.model.Users;
import com.hl.usersmanager.service.IUserService;

@Controller
public class UserController {
//  使用注解实现自动装配 不需要再写get set方法以及在context中配置bean
    @Autowired
    private IUserService userService;

    @RequestMapping(value = "findUserByName.do")
    public String findUserByName(String name,ModelMap model) {
        Users users = userService.findUserByName(name);
        model.addAttribute("userPhone",users.getPhone());
        System.out.println("userPhone：" + users.getPhone());
        return "showUser";
    }

    @RequestMapping(value = "findAllUsers.do")
    public String findAllUsers(ModelMap model) {
        List<Users> users = userService.findAllUsers();
        model.addAttribute("users",users);
        return "listUser";
    }

    ……
}

 

 

在视图解析器中有一个<property name="order" value="orderValue"/>的配置，这个配置表示解析器的优先级别。我们将FreeMarkerViewResolver的级别设为 0,将InternalResourceViewResolver的级别设为1。这样，解析器就会优先使用 FreeMarkerViewResolver 进行解析，如果找不到相应的模板，就使用InternalResourceViewResolver进行 解析，如果还找不到页面，就会产生一个404错误！

 

在本例中，我们在/WEB-INF/page/下有一个showUser.jsp页面，在/WEB-INF/ftl/下有一个 listUser.ftl的模板文件。那么当访问findAllUsers.do的时候，Controller返回一个listUser视图，根据解析器 配置，先使用FreeMarkerViewResolver进行解析。它会根据模板路径templateLoaderPath的配置/WEB-INF /ftl/下去找是否有一个listUser并且以后缀配置suffix值.ftl，即listUser.ftl文件，如果找到则使用该模板进行解析。这 里我们实现已经创建了这个模板文件，所以user列表成功被显示出来。

当用户访问findUserByName.do的时候，返回showUser视图，毅然先使用FreeMarkerViewResolver进 行解析，结果发现在/WEB-INF/ftl/下并没有showUser.ftl这个模板文件，于是使用 InternalResourceViewResolver进行解析，于是开始寻找/WEB-INF/page/下是否有showUser.jsp文件。 由于我们已经创建了这个文件，于是最终使用showUser.jsp进行渲染。那么如果没有找到showUser.jsp，就会抛出404错误。

 

这里还要注意的是，如果Controller中返回视图加了后缀jsp或者ftl，在配置中就不要加入suffix配置，否则会找不到页面。

 

评论

9 楼 my249645546 2014-07-23   引用

xj20305 写道

我配置成功了，但是请问为什么freemarker的优先级order要小于internal的，否则就失败

因为这个order越小，表示优先级越高。所以，你如果想优先用Freemarker解析，那么它的order值就得比internal的小

8 楼 xj20305 2014-07-22   引用

我配置成功了，但是请问为什么freemarker的优先级order要小于internal的，否则就失败

7 楼 brightfox 2013-07-18   引用

brightfox 写道

my249645546 写道

brightfox 写道

楼主你好，最近我在用jeecms，根据你的这篇文章我在jeecms中配置了多视图支持，但是一直没有成功，作为一个初学者都不知道该怎么做，请问您是否在jeecms中配置过？

order 配置了吗?
现在的问题是什么,报什么错误?

没 有报错，但是访问jsp，依然是根据freemarker视图解析的。这是我在jeecms-servlet-front.xml中配置 的<bean id="jspViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
        <property name="prefix" value="/"/>
        <property name="order" value="1"/>
    </bean>

<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"/>
<property name="order" value="0"/>
</bean>

你QQ多少 我加你[/quo
1074362064

6 楼 my249645546 2013-07-18   引用

brightfox 写道

my249645546 写道

brightfox 写道

楼主你好，最近我在用jeecms，根据你的这篇文章我在jeecms中配置了多视图支持，但是一直没有成功，作为一个初学者都不知道该怎么做，请问您是否在jeecms中配置过？

order 配置了吗?
现在的问题是什么,报什么错误?

没 有报错，但是访问jsp，依然是根据freemarker视图解析的。这是我在jeecms-servlet-front.xml中配置 的<bean id="jspViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
        <property name="prefix" value="/"/>
        <property name="order" value="1"/>
    </bean>

<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"/>
<property name="order" value="0"/>
</bean>

你QQ多少 我加你

5 楼 brightfox 2013-07-18   引用

my249645546 写道

brightfox 写道

楼主你好，最近我在用jeecms，根据你的这篇文章我在jeecms中配置了多视图支持，但是一直没有成功，作为一个初学者都不知道该怎么做，请问您是否在jeecms中配置过？

order 配置了吗?
现在的问题是什么,报什么错误?

没 有报错，但是访问jsp，依然是根据freemarker视图解析的。这是我在jeecms-servlet-front.xml中配置 的<bean id="jspViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
        <property name="prefix" value="/"/>
        <property name="order" value="1"/>
    </bean>

<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"/>
<property name="order" value="0"/>
</bean>

4 楼 my249645546 2013-07-18   引用

brightfox 写道

楼主你好，最近我在用jeecms，根据你的这篇文章我在jeecms中配置了多视图支持，但是一直没有成功，作为一个初学者都不知道该怎么做，请问您是否在jeecms中配置过？

order 配置了吗?
现在的问题是什么,报什么错误?

3 楼 brightfox 2013-07-17   引用

楼主你好，最近我在用jeecms，根据你的这篇文章我在jeecms中配置了多视图支持，但是一直没有成功，作为一个初学者都不知道该怎么做，请问您是否在jeecms中配置过？

2 楼 my249645546 2013-01-21   引用

javacampo 写道

找了很多文章，还是你这篇写的有头有尾，而且原理讲起来通俗易懂！

我最近在用freemarker生成html，由于项目采用SpringMVC+Mybatis，只有部分页面需要静态化，不知道你有没有实际的这个方面的经验，求教一下，谢谢了。我的QQ：120294885 敬候佳音.

页面静态化，通常有两种方式。一种是整个页面静态化为html文件；另一种是整个页面还是动态文件，只是页面的部分栏目静态化为一个模块，然后在页面中进行include

freemarker 本身可以用来渲染动态页面。如果你是想用来进行页面静态化，也是可以的。大致原理是这样：在boss系统中的java端一旦有记录添加或者修改，就以某个 ftl文件作为模板，在某个指定的路径下生成一个指定格式（ftl、html均可）的文件。然后 前台系统页面中将这个生成的文件导入即可。
html文件 只能在shtml文件中才能导入
jsp页面 应该可以使用标签进行导入（我没有试过 应该可以）

当然，如果你是整个页面静态化 直接在boss系统中生成一个完整的文件即可 不需要导入。

1 楼 javacampo 2013-01-18   引用

找了很多文章，还是你这篇写的有头有尾，而且原理讲起来通俗易懂！

我最近在用freemarker生成html，由于项目采用SpringMVC+Mybatis，只有部分页面需要静态化，不知道你有没有实际的这个方面的经验，求教一下，谢谢了。我的QQ：120294885 敬候佳音.