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

一、从freemarker谈起

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

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

二、Spring MVC视图解析器

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

下面介绍一下本文需要用到的解析器（更多解析器请翻阅本博客 ）：

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

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

三、配置多视图，支持freemarker

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

其实没有那么复杂。

1.Web.xml

Xml代码  

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4. xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
  5. http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
  6. <welcome-file-list>
  7. <welcome-file>index.jsp</welcome-file>
  8. </welcome-file-list>
  9. <!-- ======================================================== -->
  10. <!--                  Spring MVC Config Servlet               -->
  11. <!-- ======================================================== -->
  12. <!-- JSP DispatcherServlet -->
  13. <servlet>
  14. <servlet-name>dispatcher</servlet-name>
  15. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  16. <init-param>
  17. <param-name>contextConfigLocation</param-name>
  18. <param-value>/WEB-INF/classes/applicationContext.xml</param-value>
  19. </init-param>
  20. <load-on-startup>1</load-on-startup>
  21. </servlet>
  22. <!-- ======================================================== -->
  23. <!--                  Spring MVC Config Mapping               -->
  24. <!-- ======================================================== -->
  25. <servlet-mapping>
  26. <servlet-name>dispatcher</servlet-name>
  27. <url-pattern>*.do</url-pattern>
  28. </servlet-mapping>
  29. </web-app>

2.dispatcherServlet.xml

Xml代码  

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop"
  4. xmlns:tx="http://www.springframework.org/schema/tx"
  5. xmlns:p="http://www.springframework.org/schema/p"
  6. xmlns:context="http://www.springframework.org/schema/context"
  7. xmlns:mvc="http://www.springframework.org/schema/mvc"
  8. xsi:schemaLocation="
  9. http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
  10. http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd
  11. http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd
  12. http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd
  13. http://www.springframework.org/schema/mvc  http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">
  14. <!--通用视图解析器-->
  15. <bean id="viewResolverCommon" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  16. <property name="prefix" value="/WEB-INF/page/"/>
  17. <property name="suffix" value=".jsp"/><!--可为空,方便实现自已的依据扩展名来选择视图解释类的逻辑  -->
  18. <property name="viewClass">
  19. <value>org.springframework.web.servlet.view.InternalResourceView</value>
  20. </property>
  21. <property name="order" value="1"/>
  22. </bean>
  23. <!-- 配置freeMarker视图解析器 -->
  24. <bean id="viewResolverFtl" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
  25. <property name="viewClass" value="org.springframework.web.servlet.view.freemarker.FreeMarkerView"/>
  26. <property name="contentType" value="text/html; charset=utf-8"/>
  27. <property name="cache" value="true" />
  28. <property name="suffix" value=".ftl" />
  29. <property name="order" value="0"/>
  30. </bean>
  31. <!-- 配置freeMarker的模板路径 -->
  32. <bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
  33. <property name="templateLoaderPath">
  34. <value>/WEB-INF/ftl/</value>
  35. </property>
  36. <property name="freemarkerVariables">
  37. <map>
  38. <entry key="xml_escape" value-ref="fmXmlEscape" />
  39. </map>
  40. </property>
  41. <property name="defaultEncoding">
  42. <value>utf-8</value>
  43. </property>
  44. <property name="freemarkerSettings">
  45. <props>
  46. <prop key="template_update_delay">3600</prop>
  47. </props>
  48. </property>
  49. </bean>
  50. <bean id="fmXmlEscape" class="freemarker.template.utility.XmlEscape"/>
  51. <!-- 注解支持 -->
  52. <mvc:annotation-driven/>
  53. <!-- 对包中的所有类进行扫描，以完成Bean创建和自动依赖注入的功能 -->
  54. <context:component-scan base-package="com.hl.usersmanager">
  55. <!-- 允许定义过滤器将基包下的某些类纳入或排除
  56. <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/> -->
  57. </context:component-scan>
  58. </beans>

3.Controller

Java代码  

  1. package com.hl.usersmanager.controller;
  2. import java.util.List;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.stereotype.Controller;
  5. import org.springframework.ui.ModelMap;
  6. import org.springframework.web.bind.annotation.RequestMapping;
  7. import com.hl.usersmanager.model.Users;
  8. import com.hl.usersmanager.service.IUserService;
  9. @Controller
  10. public class UserController {
  11. //  使用注解实现自动装配 不需要再写get set方法以及在context中配置bean
  12. @Autowired
  13. private IUserService userService;
  14. @RequestMapping(value = "findUserByName.do")
  15. public String findUserByName(String name,ModelMap model) {
  16. Users users = userService.findUserByName(name);
  17. model.addAttribute("userPhone",users.getPhone());
  18. System.out.println("userPhone：" + users.getPhone());
  19. return "showUser";
  20. }
  21. @RequestMapping(value = "findAllUsers.do")
  22. public String findAllUsers(ModelMap model) {
  23. List<Users> users = userService.findAllUsers();
  24. model.addAttribute("users",users);
  25. return "listUser";
  26. }
  27. ……
  28. }

在视图解析器中有一个<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配置，否则会找不到页面。

时间： 2024-10-22 16:51:54

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

Spring MVC资源绑定视图解析器

ResourceBundleViewResolver使用属性文件中定义的视图bean来解析视图名称. 以下示例显示如何使用Spring Web MVC框架中的ResourceBundleViewResolver. ResourceBundleViewResolver-servlet.xml 配置如下所示 - <bean class="org.springframework.web.servlet.view.ResourceBundleViewResolver"> <p

Spring Web MVC 多viewResolver视图解析器解决方案

viewResolver的定义如下: public interface ViewResolver { View resolveViewName(String viewName, Locale locale) throws Exception; } 在spring 中,常用的ViewResolver 有如下几种: InternalResourceViewResolver 将逻辑视图名字解析为一个路径 BeanNameViewResolver 将逻辑视图名字解析为bean的Name属性,从而根据na

SpringMVC与Freemarker的集成以及多视图解析器配置

一.Spring MVC视图解析器 视图解析器的工作流程大致是这样的:Controller的某个方法执行完成以后,返回一个视图(比如:listUser),视图解析器要做的工作就是找到某个对象 来完成视图的渲染,或者跳转到其他的逻辑视图.这里的渲染对象通常就是我们的jsp文件或者我们下面用的Freemarker(例如listUser.jsp或者 listUser.ftl).渲染完成以后,将解析结果发送到客户端浏览器. 下面介绍一下本文需要用到的解析器(更多解析器资料,请参考 http://e-fr

springmvc 前段控制器 处理器映射器 处理器适配器 视图视图解析器 配置

1. 前段控制器 新建项目在web.xml中配置前段控制器 <servlet> <servlet-name>springmvc</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</pa

SpringMVC视图解析器配置

<!--视图解析器--> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <!--前缀--> <property name="prefix" value="/"/> <!--后缀--> <property name="suffix" value=&q

SpringMVC视图解析器配置式开发

视图解析器分为: 默认方法名解析器 属性方法名解析器 参数方法名解析器 测试案例:创建类 package cn.happy.day03MultiAction; import org.springframework.web.servlet.ModelAndView; import org.springframework.web.servlet.mvc.multiaction.MultiActionController; import javax.servlet.http.HttpServletRe

[刘阳Java]_Spring MVC中的视图解析器_ViewResolver_第5讲

所有的We MVC框架都有一套它自己的解析视图的机制,Spring MVC也不例外,它使用ViewResolver进行视图解析,让用户在浏览器中渲染模型.ViewResolver是一种开箱即用的技术,能够解析JSP.Velocity模板和XSLT等多种视图. Spring处理视图最重要的两个接口是ViewResolver和View.ViewResolver接口提供了视图名称和真正的视图之间的映射: 而View接口则是将真正的视图呈现给用户. 常用的ViewResolver有如下几种 Intern

SpringMVC配置JSON、JSP、FreeMark多视图解析器配置

 1.web.xml内容:  <?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee"  xmlns:web="http://java.sun.com/xml/ns/jav

Spring MVC之视图解析器

Spring MVC提供的视图解析器使用ViewResolver进行视图解析,实现浏览器中渲染模型.ViewResolver能够解析JSP.Velocity模板.FreeMarker模板和XSLT等多种视图. Spring处理视图最重要的两个接口是ViewResolver和View.ViewResolver接口在视图名称和真正的视图之间提供映射关系: 而View接口则处理请求将真正的视图呈现给用户. 1.ViewResolver视图解析器 在Spring MVC控制器中,所有的请求处理方法(Ac