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

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配置,否则会找不到页面。

相关推荐