Spring MVC 入门示例讲解

MVC框架是什么
Dispatcher Servlet(Spring控制器)
Spring入门示例
运行时依赖库
web.xml和spring-servlet.xml文件配置
请求控制器EmployeeController.java
视图模型EmployeeVO.java
Dao类
业务层类
视图employeeListDisplay.jsp

MVC框架是什么

模型-视图-控制器（MVC）是一个众所周知的以设计界面应用程序为基础的设计模式。它主要通过分离模型、视图及控制器在应用程序中的角色将业务逻辑从界面中解耦。通常，模型负责封装应用程序数据在视图层展示。视图仅仅只是展示这些数据，不包含任何业务逻辑。控制器负责接收来自用户的请求，并调用后台服务（manager或者dao）来处理业务逻辑。处理后，后台业务层可能会返回了一些数据在视图层展示。控制器收集这些数据及准备模型在视图层展示。MVC模式的核心思想是将业务逻辑从界面中分离出来，允许它们单独改变而不会相互影响。

在Spring MVC应用程序中，模型通常由POJO对象组成，它在业务层中被处理，在持久层中被持久化。视图通常是用JSP标准标签库（JSTL）编写的JSP模板。控制器部分是由dispatcher servlet负责，在本教程中我们将会了解更多它的相关细节。
一些开发人员认为业务层和DAO层类是MVC模型组件的一部分。我对此持有不同的意见。我不认为业务层及DAO层类为MVC框架的一部分。通常一个web应用是3层架构，即数据-业务-表示。MVC实际上是表示层的一部分。

Dispatcher Servlet(Spring控制器)

在最简单的Spring MVC应用程序中，控制器是唯一的你需要在Java web部署描述文件（即web.xml文件）中配置的Servlet。Spring MVC控制器 ——通常称作Dispatcher Servlet，实现了前端控制器设计模式。并且每个web请求必须通过它以便它能够管理整个请求的生命周期。

当一个web请求发送到Spring MVC应用程序，dispatcher servlet首先接收请求。然后它组织那些在Spring web应用程序上下文配置的（例如实际请求处理控制器和视图解析器）或者使用注解配置的组件，所有的这些都需要处理该请求。

在Spring3.0中定义一个控制器类，这个类必须标有@Controller注解。当有@Controller注解的控制器收到一个请求时，它会寻找一个合适的handler方法去处理这个请求。这就需要控制器通过一个或多个handler映射去把每个请求映射到handler方法。为了这样做，一个控制器类的方法需要被@RequestMapping注解装饰，使它们成为handler方法。

handler方法处理完请求后，它把控制权委托给视图名与handler方法返回值相同的视图。为了提供一个灵活的方法，一个handler方法的返回值并不代表一个视图的实现而是一个逻辑视图，即没有任何文件扩展名。你可以将这些逻辑视图映射到正确的实现，并将这些实现写入到上下文文件，这样你就可以轻松的更改视图层代码甚至不用修改请求handler类的代码。
为一个逻辑名称匹配正确的文件是视图解析器的责任。一旦控制器类已将一个视图名称解析到一个视图实现。它会根据视图实现的设计来渲染对应对象。

Spring入门示例

在这个应用程序中，我将创建最简单的员工管理应用程序的演示，它只有一个功能，即系统提供的所有雇员的列表。让我们记下此应用程序的目录结构。

现在让我们编写所有涉及这个入门应用程序的文件。

pom.xml

以下pom.xml文件中包含spring mvc依赖及为编写jsp文件提供支持的taglib相关依赖

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54

<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/maven-v4_0_0.xsd">     <modelVersion>4.0.0</modelVersion>     <groupId>com.howtodoinjava.demo</groupId>     <artifactId>springmvcexample</artifactId>     <packaging>war</packaging>     <version>1.0-SNAPSHOT</version>     <name>springmvcexample Maven Webapp</name>     <url>http://maven.apache.org</url>     <dependencies>           <dependency>             <groupId>junit</groupId>             <artifactId>junit</artifactId>             <version>4.12</version>             <scope>test</scope>         </dependency>           <!-- Spring MVC support -->           <dependency>             <groupId>org.springframework</groupId>             <artifactId>spring-webmvc</artifactId>             <version>4.1.4.RELEASE</version>         </dependency>           <dependency>             <groupId>org.springframework</groupId>             <artifactId>spring-web</artifactId>             <version>4.1.4.RELEASE</version>         </dependency>           <!-- Tag libs support for view layer -->           <dependency>             <groupId>javax.servlet</groupId>             <artifactId>jstl</artifactId>             <version>1.2</version>             <scope>runtime</scope>         </dependency>           <dependency>             <groupId>taglibs</groupId>             <artifactId>standard</artifactId>             <version>1.1.2</version>             <scope>runtime</scope>         </dependency>       </dependencies>       <build>         <finalName>springmvcexample</finalName>     </build> </project>

web.xml

这最精简的web.xml文件声明了一个Servlet（即dispatcher servlet）来接收所有类型的请求。Dispatcher servlet在这里充当前端控制器的角色。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

<web-app id="WebApp_ID" version="2.4"     xmlns="http://java.sun.com/xml/ns/j2ee"     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee   http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">       <display-name>Spring Web MVC Hello World Application</display-name>       <servlet>         <servlet-name>spring</servlet-name>             <servlet-class>                 org.springframework.web.servlet.DispatcherServlet             </servlet-class>         <load-on-startup>1</load-on-startup>     </servlet>       <servlet-mapping>         <servlet-name>spring</servlet-name>         <url-pattern>/</url-pattern>     </servlet-mapping>   </web-app>

spring-servlet.xml（你也可以用applicationContext.xml文件）

在请求handler、业务层、dao层，我们使用带注解的类，所以我为“com.howtodoinjava.demo”包里的所有类启用了注解处理

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

<web-app id="WebApp_ID" version="2.4"     xmlns="http://java.sun.com/xml/ns/j2ee"     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee   http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">       <display-name>Spring Web MVC Hello World Application</display-name>       <servlet>         <servlet-name>spring</servlet-name>             <servlet-class>                 org.springframework.web.servlet.DispatcherServlet             </servlet-class>         <load-on-startup>1</load-on-startup>     </servlet>       <servlet-mapping>         <servlet-name>spring</servlet-name>         <url-pattern>/</url-pattern>     </servlet-mapping>   </web-app>

EmployeeController.java

注解@RequestMapping在类级别和方法级别层面确定将被调用方法的URL。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

<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"     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">       <context:component-scan base-package="com.howtodoinjava.demo" />       <bean class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping" />     <bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter" />       <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">         <property name="prefix" value="/WEB-INF/views/" />         <property name="suffix" value=".jsp" />     </bean>   </beans>

阅读更多：如何使用@Component、@Respository、@Service及@Controller注解？

EmployeeVO.java

这个类作为MVC模式的模型。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

package com.howtodoinjava.demo.model;   import java.io.Serializable;   public class EmployeeVO implements Serializable {     private static final long serialVersionUID = 1L;       private Integer id;     private String firstName;     private String lastName;       //Setters and Getters       @Override     public String toString() {         return "EmployeeVO [id=" + id + ", firstName=" + firstName                 + ", lastName=" + lastName + "]";     } }

EmployeeDAO.java

这个类位于三层架构中的第三层。负责与底层的数据库存储进行交互。

1 2 3 4 5 6 7 8

import java.util.List;   import com.howtodoinjava.demo.model.EmployeeVO;   public interface EmployeeDAO {     public List<EmployeeVO> getAllEmployees(); }

EmployeeDAOImpl.java

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

import java.util.ArrayList; import java.util.List;   import org.springframework.stereotype.Repository;   import com.howtodoinjava.demo.model.EmployeeVO;   @Repository public class EmployeeDAOImpl implements EmployeeDAO {       public List<EmployeeVO> getAllEmployees()     {         List<EmployeeVO> employees = new ArrayList<EmployeeVO>();           EmployeeVO vo1 = new EmployeeVO();         vo1.setId(1);         vo1.setFirstName("Lokesh");         vo1.setLastName("Gupta");         employees.add(vo1);           EmployeeVO vo2 = new EmployeeVO();         vo2.setId(2);         vo2.setFirstName("Raj");         vo2.setLastName("Kishore");         employees.add(vo2);           return employees;     } }

EmployeeManager.java

这个类处于三层架构中的第二层。负责与DAO层交互。

1 2 3 4 5 6 7 8

import java.util.List;   import com.howtodoinjava.demo.model.EmployeeVO;   public interface EmployeeManager {     public List<EmployeeVO> getAllEmployees(); }

EmployeeManagerImpl.java

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

import java.util.List;   import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service;   import com.howtodoinjava.demo.dao.EmployeeDAO; import com.howtodoinjava.demo.model.EmployeeVO;   @Service public class EmployeeManagerImpl implements EmployeeManager {       @Autowired     EmployeeDAO dao;       public List<EmployeeVO> getAllEmployees()     {         return dao.getAllEmployees();     } }

employeesListDisplay.jsp

这个jsp被用于显示系统中的所有员工。它循环遍历employee集合，并且在一个表中打印他们的详细信息。这符合MVC模式的视图层。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%> <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt"%>   <html> <head>     <title>Spring MVC Hello World</title> </head>   <body>     <h2>All Employees in System</h2>       <table border="1">         <tr>             <th>Employee Id</th>             <th>First Name</th>             <th>Last Name</th>         </tr>         <c:forEach items="${employees}" var="employee">             <tr>                 <td>${employee.id}</td>                 <td>${employee.firstName}</td>                 <td>${employee.lastName}</td>             </tr>         </c:forEach>     </table>   </body> </html>

现在在您的应用程序服务器（我用的是tomcat 7）部署应用程序。并点击“http://localhost:8080/springmvcexample/employee-module/getAllEmployees”。如果你已正确配置所有内容，你将会在屏幕下看到：