Spring MVC 構建入門級 Web 應用程式

在本例中，我們將使用Spring MVC框架構建一個入門級web應用程式。Spring MVC 是Spring框架最重要的的模組之一。它以強大的Spring IoC容器為基礎，並充分利用容器的特性來簡化它的配置。

目錄

• 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相關依賴

<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在這裡充當前端控制器的角色。

<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”包裡的所有類啟用了註解處理

<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。

<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模式的模型。

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

這個類位於三層架構中的第三層。負責與底層的資料庫儲存進行互動。

import java.util.List;

import com.howtodoinjava.demo.model.EmployeeVO;

public interface EmployeeDAO
{
    public List<EmployeeVO> getAllEmployees();
}

EmployeeDAOImpl.java

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層互動。

import java.util.List;

import com.howtodoinjava.demo.model.EmployeeVO;

public interface EmployeeManager
{
    public List<EmployeeVO> getAllEmployees();
}

EmployeeManagerImpl.java

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模式的檢視層。

<%@ 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”。如果你已正確配置所有內容，你將會在螢幕下看到：

原始碼下載