SpringMVC 入門實戰：從零構建 HelloWorld 專案（XML 配置版）

SpringMVC 入門實戰：手把手構建第一個 Web 專案

本文將帶你從零開始，使用 XML 配置方式 搭建一個最小化的 SpringMVC 專案，體驗 DispatcherServlet 前端控制器的核心流程。適合初學者快速建立整體認知。

專案結構概覽

SpringMVC/
├── src/
│   ├── controller/
│   │   └── HelloController.java
│   └── spring-mvc.xml
├── WebContent/
│   ├── WEB-INF/
│   │   ├── web.xml
│   │   ├── jsp/
│   │   │   └── hello.jsp
│   │   └── spring-mvc.xml (或放 classpath)
│   └── index.jsp
└── lib/ (Spring 相關 JAR)

步驟 1：配置 web.xml — 註冊 DispatcherServlet

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://java.sun.com/xml/ns/javaee"
         xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://java.sun.com/xml/ns/javaee 
         https://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
         version="2.5">

    <servlet>
        <servlet-name>SpringMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring-mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>SpringMVC</servlet-name>
        <url-pattern>*.action</url-pattern>
    </servlet-mapping>
</web-app>

關鍵點：load-on-startup=1 讓容器啟動時實例化 Servlet；*.action 只攔截以 .action 結尾的請求。

步驟 2：編寫 spring-mvc.xml — 三大核心組件

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="https://www.springframework.org/schema/beans"
       xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="https://www.springframework.org/schema/beans
       https://www.springframework.org/schema/beans/spring-beans-4.0.xsd">

    <!-- 1. HandlerMapping：URL 到 Controller 的映射 -->
    <bean id="handlerMapping" 
          class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
        <property name="mappings">
            <map>
                <entry key="/hello.action" value="helloController"/>
            </map>
        </property>
    </bean>

    <!-- 2. Controller Bean -->
    <bean id="helloController" class="controller.HelloController"/>

    <!-- 3. ViewResolver：視圖解析器 -->
    <bean id="viewResolver" 
          class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

步驟 3：實現 Controller — 實現 Controller 接口

package controller;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

public class HelloController implements Controller {
    @Override
    public ModelAndView handleRequest(HttpServletRequest req, HttpServletResponse resp) throws Exception {
        System.out.println("處理 hello.action 請求");
        return new ModelAndView("hello");  // 對應 /WEB-INF/jsp/hello.jsp
    }
}

步驟 4：創建視圖頁面

/WEB-INF/jsp/hello.jsp

<%@ page contentType="text/html;charset=UTF-8" %>
<html><body>
    <h2>歡迎來到 Spring 的世界！</h2>
</body></html>

步驟 5：啟動驗證

1. 部署到 Tomcat
2. 訪問 https://localhost:8080/SpringMVC/hello.action
3. 控制台輸出「處理 hello.action 請求」，頁面顯示歡迎語

核心流程回顧

1. 請求到達 DispatcherServlet
2. HandlerMapping 根據 URL 找到 HelloController
3. Controller 處理邏輯，返回 ModelAndView
4. ViewResolver 拼接前綴後綴定位 JSP
5. 視圖渲染響應給瀏覽器

掌握這個 XML 配置版本，後續學習註解開發（@Controller、@RequestMapping）時就能輕鬆理解其底層原理。建議動手敲一遍，體會「約定優於配置」帶來的便利。