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

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

Created with Raphaël 2.1.0客户端客户端controllercontrollerserviceserviceDAO/数据库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>

在spring容器之间可配置成父子级关系，父级容器的内容在子容器课件，子容器的内容在父容器不可见。在本例中，父容器applicationContext.xml访问不到子容器DispatcherServlet对应的spring容器servlet-context.xml中的内容。如果子容器配置了和父容器相同的内容，可能存在一个配置覆盖的问题，这个会在后面我们分析事务注入的时候再提到

一个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页面