SpringMVC 快速入门

SpringMVC 快速入门

SpringMVC 简介

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

模拟一个简单的业务逻辑，页面请求后跳转到HelloWorld页面。
首先创建一个SpringMVC的Maven项目。（如果不会创建Maven项目可以参考：Eclipse+Maven创建webapp项目）
项目结构如下：

第一步：配置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项目就搭完了。