Spring 2.0核心技术与最佳实践--Spring MVC基础

Spring提供了DispatcherServlet，这个类不仅负责实现请求转发，还负责启动一个WebApplicationContext容器。按照Spring一贯的IoC哲学，所有的Controller都是JavaBean，并由IoC容器统一管理。对于View，则采取了更灵活的处理方式，Spring MVC允许使用不同的View实现，除了JSP外，还可以使用Velocity、Freemaker、XSLT等多种View技术。

总的来讲，要使用Spring MVC框架，需要以下步骤。

① 在web.xml中配置DispatcherServlet及URL映射。

② 编写IoC容器需要的XML配置文件，命名为<servlet-name>-servlet.xml，放到/WEB-INF目录下。例如，如果DispatcherServlet在web.xml中的配置名称为dispatcher，则Spring将寻找dispatcher- servlet.xml配置文件。

③ 在XML配置文件中定义URL映射方式和使用哪种View技术。

我们仍以SimpleMVC为基础，用Spring MVC框架来实现这个Web应用程序。在Eclipse中创建一个SpringMVC项目，结构如图7-21所示。

/web/WEB-INF/lib目录下的jstl.jar和standard.jar是JSP标准标签库，将在JSP视图中用到，/web/WEB-INF/c.tld是标签库的声明文件，稍后我们会在JSP视图文件中用到它们。

7.3.1  配置DispatcherServlet

首先，在web.xml中配置DispatcherServlet，并将所有以“.html”结尾的URL全部映射到DispatcherServlet上，这样，用户仅从URL地址上无法得知服务器端后台使用了何种技术。

   

   

        dispatcher

        org.springframework.web.servlet.DispatcherServlet

        0

   

   

        dispatcher

        *.html

   

   

   

       

        /WEB-INF/c.tld

   

和普通的Spring应用程序稍有不同，对于Web应用程序，Spring的ApplicationContext是由DispatcherServlet加载的，它会在/WEB-INF/下查找一个名称为 -servlet.xml的XML配置文件来初始化Spring Web应用程序的ApplicationContext。对于上例，我们在web.xml中定义DispatcherServlet的名称为dispatcher，因此，相应的XML配置文件就必须是/WEB-INF/dispatcher-servlet.xml。

下一步便是编写dispatcher-servlet.xml配置文件，首先定义URL的映射方式（HandlerMapping）。Spring提供了几种常用的HandlerMapping。

1．使用SimpleUrlHandlerMapping

SimpleUrlHandlerMapping提供了最简单的URL映射，通过Properties将URL和Controller对应起来，配置示例如下。

   

       

            controllerA

            controllerB

       

   

这种方式和Struts的配置类似。当用户请求一个URL时，Spring就在SimpleUrl HandlerMapping注入的Properties中查找对应的Controller。

2．使用BeanNameUrlHandlerMapping

BeanNameUrlHandlerMapping的实现更为简单，每个Controller的URL与其name属性对应，因此，只需要对每个Controller以URL作为name，就可以实现URL映射。配置示例如下。

之所以用Bean的name作为URL而不是id，是因为XML规范不允许在id标识中使用特殊字符“/”。当用户请求一个URL时，Spring将直接查找name为URL的Controller。

使用SimpleUrlHandlerMapping的麻烦之处在于，添加或删除Controller时必须要对SimpleUrlHandlerMapping做相应的修改，而BeanNameUrlHandlerMapping则无需手工编写映射，只需要在每个Controller中仔细定义name属性。如果使用XDoclet自动生成配置文件，则可以将name在Controller的注释中定义，维护起来更加方便。因此，我们推荐首先考虑使用BeanNameUrlHandlerMapping。事实上，如果没有在XML配置文件中定义任何UrlHandlerMapping，则Spring MVC默认使用BeanNameUrlHandlerMapping。

Spring还提供了一个ControllerClassNameHandlerMapping，它和BeanName UrlHandlerMapping类似，不过是将Controller的ClassName和对应的URL关联起来，由于这种方式灵活性欠佳，实际使用较少。

也可以混合使用多种UrlHandlerMapping，但是必须为每个UrlHandlerMapping指定order属性来表示优先级，order值越小优先级越高，Spring会先查询优先级高的UrlHandlerMapping。若找到了对应的Controller，就不再继续查询，否则，按照优先级依次查询，直到找到为止。若所有的UrlHandlerMapping都无法返回一个合适的Controller，并且没有设置默认的Controller时，就会返回给客户端一个“404 Not Found”错误，表示不存在这个URL。

下一步需要为Spring MVC指定一个ViewResolver（视图解析器），指示使用何种视图技术，以及如何解析ModelAndView返回的逻辑视图名称。

这里我们直接给出使用JSP视图的配置，对于其他的视图技术将会在后面讲到。

   

   

   

prefix和suffix将和逻辑视图名称一起组合成为实际视图的路径。例如，对于上例，若返回一个new ModelAndView("test", model)，则实际的视图路径由prefix+逻辑视图名+suffix这3部分构成。

/test.jsp

定义前缀（prefix）使得视图文件无论放在何处都可以通过修改前缀来实现位置无关性（当然，必须在web目录内），许多应用程序将其放在/WEB-INF目录下，使得用户无法通过URL直接访问视图文件以保证视图文件的安全；定义后缀（suffix）可以在将来用另一种视图技术（例如，Velocity）取代现在的JSP视图，只需将后缀从“.jsp”更改为“.vm”即可，而不必更改源代码中的逻辑视图名。总之，一切目标都是为了实现最大限度的解耦。

7.3.2  实现Controller

实现了org.springframework.web.servlet.mvc.Controller接口的Bean都可以作为有效的Controller来处理用户请求。例如，一个最简单的TestController。

public class TestController implements Controller {

    public ModelAndView handleRequest(HttpServletRequest request, HttpServlet Response response) throws Exception {

        String name = request.getParameter("name");

        if(name==null)

            name = "spring";

        Map model = new HashMap();

        model.put("name", name);

        model.put("time", new Date());

        return new ModelAndView("test", model);

    }

}

注意，上例的Controller接口和返回值ModelAndView都是在Spring框架中定义的，这和SimpleMVC项目中我们自己定义的Controller接口和ModelAndView类所在的包是不同的。在SimpleMVC项目中，我们并没有使用Spring MVC，而是借用Spring MVC的概念自定义接口。在现在的SpringMVC项目中，我们没有自定义任何接口，而是直接使用Spring MVC框架来实现Web应用程序，这一点请读者务必区分清楚。

另外需要注意的是，ModelAndView返回的逻辑视图是“test”，还记得在viewResolver中定义的prefix和suffix吗？实际的视图名称由这3部分构成便是“/test.jsp”。

最后将这个TestController作为Bean定义在dispatcher-servlet.xml中，由于我们准备使用默认的BeanNameUrlHandlerMapping，因此，需要在Bean的name中指定URL。

完整的dispatcher-servlet.xml配置文件的内容如下。

       xmlns:xsi=""

       xsi:schemaLocation=" /spring-beans.xsd">

   

   

       

       

       

   

注意，我们没有指定UrlHandlerMapping，Spring会自动使用默认的BeanNameUrl HandlerMapping。

7.3.3  实现View

到目前为止，我们已经编写了Controller的实现和配置文件，最后一步是编写一个JSP文件作为视图。由于采用了MVC架构，视图的任务只有一个，就是将Controller返回的Model渲染出来。Spring MVC会将Model中的所有数据全部绑定到HttpServlet Request中，然后将其转发给JSP，JSP只需将数据显示出来即可。

通过JSTL标签库能进一步简化显示逻辑，我们看看如何显示TestController返回的Model。test.jsp文件的内容如下。

<%@ page contentType="text/html; charset=utf-8" %>

<%@ taglib prefix="c" uri="" %>

   

       

   

   

       

Hello, ,

        it is

   

现在，Spring MVC所需的所有组件都已编写并配置完毕，我们先来回顾一下Spring MVC的处理流程，如图7-22所示。

将SpringMVC工程的编译输出目录设置为/web/WEB-INF/classes，然后编译工程，打开浏览器，测试我们编写的SpringMVC，结果如图7-23所示。

图7-23

现在，读者对Spring的MVC框架应该有了一个初步的认识。实际上，除了基本的MVC标准流程外，Spring MVC还提供了相当多的功能，下面我们将逐一介绍Spring MVC提供的各种丰富的Controller、拦截器和异常处理机制。