SpringMVC 快速入门

SpringMVC 快速入门

SpringMVC 简介

SpringMVC是 Spring为展示层提供的基于Web MVC设计模式的请求驱动类型的轻量级Web框架，它的功能和Struts2一样。但比Struts2更方便，更高效。是目前主流的Web框架。

模拟一个简单的业务逻辑，页面请求后跳转到HelloWorld页面。

首先创建一个SpringMVC的Maven项目。（如果不会创建Maven项目可以参考：http://blog.csdn.net/qq_19558705/article/details/49887717）

项目结构如下：

第一步：配置pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.springmvc</groupId>
  <artifactId>springmvc</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>war</packaging>  

  <properties>
    <spring.version>4.1.3.RELEASE</spring.version>
  </properties>
  <dependencies>
    <!-- spring begin -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency>    

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>${spring.version}</version>
    </dependency>    

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-aop</artifactId>
        <version>${spring.version}</version>
    </dependency>    

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>${spring.version}</version>
    </dependency>    

    <!-- spring end -->
  </dependencies>
</project>

第二步：因为这是一个web项目，我们需要配置它的web.xml文件，就像配置servlet一样配置DispatcherServlet。拦截所有请求，但这样做会拦截静态资源，后面文章会有介绍如何处理。

<?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"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
    id="WebApp_ID" version="3.0">
    <display-name>springmvc</display-name>  

    <!-- 配置 DispatcherServlet -->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 指定 SpringMVC 配置文件的位置和名称
            若SpringMVC的配置文件名的格式和位置满足: /WEB-INF/servlet-name + "-servlet.xml"
            则可以省略下面的init-param代码。这里的servlet-name是dispatcher。 即/WEB-INF/dispatcher-servlet.xml
        -->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <!-- servlet知识点：处理所有请求 -->
        <url-pattern>/</url-pattern>
    </servlet-mapping>  

</web-app>

第三步：（核心知识点）创建一个dispatcher-servlet.xml 文件，该文件名可以自定义，也可以遵守Spring的规则（第二步中注释内容有提到）。先要配置自动扫描包，使配置bean的注解生效。然后配置MVC注解驱动，使SpringMVC的注解生效。最后要配置视图解析器，将方法的返回值拼接成跳转的URL路径。

<?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: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.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">  

    <!-- 配置自动扫描的包 -->
    <context:component-scan base-package="com.itdragon.springmvc" />  

    <!-- 配置视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>  

    <!-- 配置注解驱动 -->
    <mvc:annotation-driven />  

</beans>

第四步：业务逻辑代码，这里就简单的打印和返回一个helloworld的字符串。让视图解析器配置成跳转的helloworld.jsp页面。

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;  

@Controller
public class HelloWorldController {  

    /**
     * 浏览器访问http://localhost:8080/springmvc/helloworld
     * 通过@RequestMapping 注解匹配映射请求的 URL，找到对应的方法。
     * 方法执行后返回 "helloworld"字符串 。通过 视图解析器 解析机制(prefix + returnVal + suffix)
     * 请求返回跳转页面 /WEB-INF/views/helloworld.jsp
     */
    @RequestMapping("/helloworld")
    public String helloWorld() {
        System.out.println("^^^^^^^^^^^^^^^^HelloWorld");
        return "helloworld";
    }  

}

万事俱备，项目打包编译，启动tomcat后。偶遇一个异常：

java.lang.ClassNotFoundException: org.springframework.web.servlet.DispatcherServlet

说的是DispatcherServlet类没有找到，但实际上是已经导入了jar包。其实是创建Maven项目后，需要手动把依赖jar都加进classpath下。解决方法如下：

项目右击-->properties-->Deployment Assembly-->add-->Java Build Path Entries-->导入所有依赖的Jar包，重新start tomcat即可。

再次启动tomcat后，没有问题。浏览器访问：http://localhost:8080/springmvc 回车。

控制台打印：

^^^^^^^^^^^^^^^^HelloWorld

到这里，一个简单的SpringMVC项目就搭完了。