springMVC4角色解析与入门配置实例

在一个web项目中，典型的MVC架构将后台分为Controller、Service、DAO三层，分别实现不同的逻辑功能，下面是一个web请求过程中，我们后台的处理过程：

Created with Raphaël 2.1.0 客户端 客户端 controller controller service service DAO/数据库 DAO/数据库 发送请求 进行业务逻辑处理 调用DAO层API访问数据库进行数据处理 返回数据封装 返回相应业务逻辑处理结果 发送响应。

springMVC就充当着其中的控制层角色，它和我们的原生servlet所起的作用基本一致，但相对原生Servlet,SpringMVC的Web转发请求处理功能就强大得多了。

1. 导入jar包

使用springMVC需导入相应的jar包，我们使用maven来管理我们的项目：

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!-- spring版本号 -->
    <spring.version>4.0.2.RELEASE</spring.version>
</properties>
<dependencies>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.10</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-api</artifactId>
        <version>1.7.5</version>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-log4j12</artifactId>
        <version>1.7.5</version>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.21</version>
    </dependency>
    <!-- 导入dbcp的jar包，用来在applicationContext.xml中配置数据库 -->
    <dependency>
        <groupId>commons-dbcp</groupId>
        <artifactId>commons-dbcp</artifactId>
        <version>1.2.2</version>
    </dependency>
    <!-- spring核心包 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-orm</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-tx</artifactId>
        <version>${spring.version}</version>
    </dependency>

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

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</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-context-support</artifactId>
        <version>${spring.version}</version>
    </dependency>

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-test</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <!-- servlet jsp -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-dbcp2</artifactId>
        <version>2.0</version>
    </dependency>
    <dependency>
        <groupId>commons-logging</groupId>
        <artifactId>commons-logging</artifactId>
        <version>1.1.1</version>
    </dependency>
    <dependency>
      <groupId>javax</groupId>
      <artifactId>javaee-api</artifactId>
      <version>7.0</version>
      <scope>provided</scope>
    </dependency>
</dependencies>

2. 配置web.xml

web.xml文件用于在web服务启动时，初始化一些配置信息，对于一般Web项目来说，web.xml文件是非必须的。但在springMVC中，我们需要通过web.xml配置servlet拦截特定url来实现控制器的功能，因而也是必须的。
下面先来看一个web.xml的实例配置

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
    <!-- 定义欢迎页，当通过跟路径/访问项目时，默认跳转到index.jsp视图中 -->
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
    <!-- 声明spring上下文配置文件所在位置，可以使用通配符*等进行模糊匹配，当有多个配置文件时，可以使用逗号间隔 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring/applicationContext.xml,classpath:spring/spring-*.xml</param-value>
    </context-param>
    <!-- 审批ringmvc的核心分发器，它会默认自动加载WEB-INF文件夹下的<servlet-names>-servlet.xml文件，在这里，我们的servlet-nane为springMVC -->
    <servlet>
        <servlet-name>springMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 如果我们的配置文件不在默认路径下，我们需要通过<init-param>配置一个contextConfigLocation指定springMVC分发器配置文件位置 -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:servlet-context.xml</param-value>
        </init-param>
        <!-- 设置当前servlet在所有servlet中第一个启动 -->
        <load-on-startup>1</load-on-startup>
    </servlet>
<!-- 配置springMVC控制器的拦截url,默认所有url都被拦截-->
    <servlet-mapping>
        <servlet-name>springMVC</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    <!-- 配置上下文载入监听器，它会在web服务启动时，根据contextConfigLocation中声明的spring配置文件位置载入配置信息 需要注意的是，它不会载入DispatcherServlet已经载入的配置文件 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <!-- 字符集处理过滤器，能够强制对所有web请求编码进行utf-8编码，从而有效避免乱码产生 -->
    <filter>
        <filter-name>characterEncodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
        <init-param>
            <param-name>forceEncoding</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>characterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>

1. 在spring容器之间可配置成父子级关系，父级容器的内容在子容器课件，子容器的内容在父容器不可见。在本例中，父容器applicationContext.xml访问不到子容器DispatcherServlet对应的spring容器servlet-context.xml中的内容。如果子容器配置了和父容器相同的内容，可能存在一个配置覆盖的问题，这个会在后面我们分析事务注入的时候再提到
2. 一个web.xml可以根据我们的项目需求配置多个DispatcherServlet，通过对应的实现对不同逻辑的请求拦截。

3. 配置springMVC核心文件servlet-context.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context" xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd ">
   <!-- 扫描com.mvc.controller包下所有的类，使spring注解生效 -->
    <context:component-scan base-package="com.mvc.controller"/>
    <!-- 定义视图解析器 -->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/"></property><!-- 前缀，在springMVC控制层处理好的请求后，转发配置目录下的视图文件 -->
        <property name="suffix" value=".jsp"></property><!-- 文件后缀，表示转发到的视图文件后缀为.jsp -->
    </bean>
</beans>

在没有引入其他配置之前，我们可以先不用配置父容器applicationContext.xml。

4. 配置控制器

接下来，我们需要配置一个从功能上相当于servlet的控制器：获取前端请求->处理请求->转发视图（view)层

package com.mvc.controller;

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

@Controller//注解为控制器，通过spring容器扫描，会注册为一个Bean
@RequestMapping("/user")//一级访问路径，对类中所有方法生效
public class UserController {
    @RequestMapping("/hello")//二级访问路径
    public String hello(){
        //返回视图文件名,和servlet-context.xml，会将请求转发到/WEB-INF/views/hello.jsp文件中
        return "hello";。
    }
}

5. 编写视图层文件

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<% String path = request.getContextPath(); String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/"; %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <base href="<%=basePath%>">
    <title>hello spring mvc</title>
  </head>
  <body>
    Hello
  </body>
</html>

6. 测试配置

至此配置已基本完成，我们可以将当前应用部署到服务器中，然后访问相应路径，这里我们的项目名为springMVC,使用tomcat服务器监控本地8080端口，于是我们的请求url是http://localhost:8080/springMVC/user/hello。访问后，游览器挑转到我们的jsp页面