Spring MVC 環境搭建零基礎教學：從專案建立到第一個 Controller 執行

一、建立標準 Java Web 專案結構

1. 建立 Java Project（或 Dynamic Web Project）。
2. 專案根目錄下新建 webapp（網站根目錄），其下建 WEB-INF（安全目錄，瀏覽器不可直接訪問）。
3. WEB-INF 下建立 web.xml（部署描述檔），從 Tomcat conf/web.xml 複製骨架，設定編碼 UTF-8。
4. WEB-INF 下建 jsp 資料夾放視圖，lib 放 JAR 包。

二、Spring 框架手動安裝（非 Maven 專案適用）

1. 官網下載 spring-framework-4.x.x.RELEASE-dist.zip。
2. 解壓，將 libs/ 目錄下所有 JAR 複製至專案 WEB-INF/lib。

三、核心配置：web.xml

1. 註冊 DispatcherServlet（前端控制器）

<servlet>
    <servlet-name>spring</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <load-on-startup>1</load-on-startup> <!-- 啟動時載入，優先級 1 -->
</servlet>

2. URL 映射攔截

<servlet-mapping>
    <servlet-name>spring</servlet-name>
    <url-pattern>*.do</url-pattern> <!-- 所有 .do 請求進入 Spring -->
</servlet-mapping>

3. 字元編碼過濾器（解決中文亂碼）

<filter>
    <filter-name>encodingFilter</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>encodingFilter</filter-name>
    <url-pattern>*.do</url-pattern>
</filter-mapping>

4. Spring MVC 配置檔命名慣例

WEB-INF/spring-servlet.xml（servlet-name + -servlet.xml），DispatcherServlet 啟動時自動載入。

四、spring-servlet.xml 核心配置

1. 視圖解析器

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/jsp/"/>
    <property name="suffix" value=".jsp"/>
</bean>

2. URL 映射處理器（傳統 SimpleUrlHandlerMapping）

<bean id="urlMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
    <property name="mappings">
        <props>
            <prop key="/index.do">IndexAction</prop>
        </props>
    </property>
</bean>

3. Controller Bean 定義

<bean id="IndexAction" class="com.myweb.IndexAction">
    <property name="view" value="index"/> <!-- 對應 /WEB-INF/jsp/index.jsp -->
</bean>

五、撰寫第一個 Controller

package com.myweb;

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 IndexAction implements Controller {
    private String view;
    public void setView(String view) { this.view = view; }

    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) {
        return new ModelAndView(view); // 轉發至 index.jsp
    }
}

六、必要依賴包補充

除 Spring 核心 JAR，尚需 commons-logging、servlet-api、jsp-api 等，放入 WEB-INF/lib 並加入 Build Path。

七、啟動驗證

1. 專案部署至 Tomcat，啟動伺服器。
2. 瀏覽器訪問 https://localhost:8080/專案名/index.do。
3. 正確顯示 index.jsp 內容，環境搭建成功。

遷移提示：現代專案建議使用 Maven + 註解開發

• 以 @Controller、@RequestMapping 取代 XML 映射。
• 啟用 <mvc:annotation-driven/> 簡化配置。
• 整合 Spring Boot 可進一步實現零配置、內嵌容器部署。