第一个 SpringMVC Controller

SpringMVC，顾名思义，整个框架都是构建在 MVC 基础之上的，不了解 MVC 的同学请自行查阅有关资料。在前面的知识准备的基础之上，我们将写出完成第一个 Controller 的编写和运行。

准备工作

首先下载 Spring-Framework 的 binary 分发版本，这里使用的是 spring-framework-4.3.8.RELEASE-dist。

然后下载 Apache 出品的 common-logging，它是 Spring 依赖的一个库，这里使用的是 common-logging-1.2。

将以上的依赖解压缩之后，把那些 jar 包加入 IDEA 的依赖路径，注意以 javadoc 和 sources 结尾的 jar 包可忽略不计。

如果使用的是 IDEA Ultimate 版本（即专业版），那么可以利用 IDEA 提供的 template 直接新建和部署项目。感兴趣的同学可以参考网上的有关博客，例如： IDEA建立Spring MVC Hello World 详细入门教程 - 小墨的童鞋 博客园

Servlet 配置

前面提到过 SpringMVC 是构建在 Servlet 基础之上的，它对外提供了一个名为 DispatchServlet 的类，这个类相当于是 SpringMVC 和 Servlet API 的一个交界点。顾名思义，它也是 SpringMVC 当中对于请求处理的一个分发器。（它将 Servlet 传递过来的请求根据 URL 分发给对应的 Controller）

在前面的内容中我们可以看到，通过在 web.xml 文件里配置 url-pattern ，也可以起到分发请求的作用。但是，如果有大量的 URL 都需要在 web.xml 进行配置时，整个 web.xml 就变成了一个灾难。因此很多 Web 框架都选择避免 web.xml，在此之上构建自己的请求分发机制。

首先我们修改 web.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">
  7.     <servlet>
  8.         <servlet-name>MyFirstServletName</servlet-name>
  9.         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  10.         <load-on-startup>1</load-on-startup>
  11.     </servlet>
  13.     <servlet-mapping>
  14.         <servlet-name>MyFirstServletName</servlet-name>
  15.         <url-pattern>/*</url-pattern>
  16.     </servlet-mapping>
  17. </web-app>

在修改 Servlet 为 Spring 提供的 DispatcherServlet 之外，还有两点需注意：

  1. 加入的 load-on-startup 参数，作用：告知 Container 在启动的时候就加载这个 Servlet（而非收到请求时才加载）
  2. 使用了 /* 的 wildcard URL，作用：符合 /* 的 web 路径（即所有的请求)都将由 DispatcherServlet 处理。

编写 Controller

相比直接使用 Servlet API，编写 Controller 更简洁方便。

我们创建一个 MyFirstSpringController 类： 

  1. package com.skyline;
  3. import org.springframework.stereotype.Controller;
  4. import org.springframework.web.bind.annotation.RequestMapping;
  5. import org.springframework.web.bind.annotation.RequestMethod;
  6. import org.springframework.web.bind.annotation.ResponseBody;
  8. @Controller
  9. public class MyFirstSpringController {
  10.     @RequestMapping(value = "/hello", method = RequestMethod.GET)
  11.     public @ResponseBody String Hello() {
  12.         return "Hello, SpringMVC.";
  13.     }
  14. }

这里使用了若干 Annotation 来简化代码。

  • 通过 @Controller 我们将一个普通 Java 类标记成一个 Controller 类。
  • 通过 @RequestMapping 和 @ResponseBody 我们将一个普通函数标记成可以处理 GET 请求，同时返回字符串的 Handler。

SpringMVC 配置

我们编写了一个 Controller 之后，怎么样让 DispatchServlet 找到我们编写的 Controller 呢？

SpringMVC 提供了使用 xml 配置的方法：

在 WEB-INF 文件夹下，也就是 web.xml 隔壁，创建一个 MyFirstServletName-servlet.xml（注意命名 -servlet.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"
  4.     xmlns:p="http://www.springframework.org/schema/p"
  5.     xmlns:context="http://www.springframework.org/schema/context"
  6.     xsi:schemaLocation="
  7.         http://www.springframework.org/schema/beans
  8.         http://www.springframework.org/schema/beans/spring-beans.xsd
  9.         http://www.springframework.org/schema/context
  10.         http://www.springframework.org/schema/context/spring-context.xsd">
  12.         <bean class="com.skyline.MyFirstSpringController"/>
  14. </beans>

上面的配置中，我们将编写的 MyFirstSpringController 加入了 beans 列表，SpringMVC 就能找到我们的 Controller 并且进行初始化了。

部署

和前面提到的 Tomcat 部署过程类似，首先我们将类生成的 class 文件拷贝到 WEB-INF/classes 下。同时，由于引入了依赖，我们还需要将 Spring 以及之前提到的 common-logging jar 包拷贝到 WEB-INF/lib 目录下。完成以上一切，然后启动 Tomcat，浏览器打开对应地址，可以看到运行的结果：

result