Spring Framework 入門實戰 (二)：建構完整登入驗證範例

前言

承接上篇 Spring 基礎概念，本文以 Eclipse IDE、Tomcat 容器為環境，手把手建構一個基於 Spring MVC 的登入驗證完整範例，涵蓋專案結構、配置檔、Controller/Command/Validator 設計與視圖解析全流程。

一、專案目錄結構

spring/                          ← Tomcat Webapp 根目錄
├── index.jsp                    ← 登入表單頁
├── main.jsp                     ← 登入成功頁
├── loginfail.jsp                ← 登入失敗頁
└── WEB-INF/
    ├── web.xml                  ← Servlet 容器部署描述
    ├── Config.xml               ← Spring MVC 配置
    ├── classes/                 ← 編譯輸出目錄
    ├── lib/                     ← 依賴 JAR 包
    └── src/
        └── action/
            ├── LoginInfo.java   ← Command/Form Backing Object
            └── LoginAction.java ← Controller (extends SimpleFormController)

二、核心配置檔

2.1 web.xml - DispatcherServlet 啟動

<web-app version="2.4" xmlns="https://java.sun.com/xml/ns/j2ee">
  <servlet>
    <servlet-name>Dispatcher</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>/WEB-INF/Config.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>Dispatcher</servlet-name>
    <url-pattern>*.do</url-pattern>
  </servlet-mapping>
</web-app>

2.2 Config.xml - Spring MVC 核心配置

<beans>
  <!-- 視圖解析器：JSP 前綴/後綴 -->
  <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
    <property name="prefix" value="/"/>
    <property name="suffix" value=".jsp"/>
  </bean>

  <!-- URL 映射至 Controller -->
  <bean id="urlMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
    <property name="mappings">
      <props>
        <prop key="/login.do">LoginAction</prop>
      </props>
    </property>
  </bean>

  <!-- Controller 定義，注入 Command 類別與成功/失敗視圖 -->
  <bean id="LoginAction" class="action.LoginAction">
    <property name="commandClass" value="action.LoginInfo"/>
    <property name="formView" value="index"/>          <!-- GET 顯示表單 -->
    <property name="successView" value="main"/>       <!-- 成功導向 -->
    <property name="failView" value="loginfail"/>     <!-- 驗證失敗導向 -->
  </bean>
</beans>

三、Java 類別實作

3.1 LoginInfo.java - Command Object (POJO)

package action;

public class LoginInfo {
    private String username;
    private String password;

    // Getter/Setter 省略
    public String getUsername() { return username; }
    public void setUsername(String username) { this.username = username; }
    public String getPassword() { return password; }
    public void setPassword(String password) { this.password = password; }
}

3.2 LoginAction.java - Controller

package action;

import org.springframework.web.servlet.mvc.SimpleFormController;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.validation.BindException;
import java.util.HashMap;

public class LoginAction extends SimpleFormController {

    @Override
    protected ModelAndView onSubmit(Object command, BindException errors) throws Exception {
        LoginInfo loginInfo = (LoginInfo) command;

        // 簡單驗證邏輯 (實際應委託 Service 層)
        if ("qQQ".equalsIgnoreCase(loginInfo.getUsername()) && "1".equals(loginInfo.getPassword())) {
            HashMap<String, Object> model = new HashMap<>();
            model.put("loginInfo", loginInfo);
            return new ModelAndView(getSuccessView(), model);
        } else {
            return new ModelAndView(getFailView());
        }
    }
}

四、JSP 視圖頁面

4.1 index.jsp - 登入表單

<%@ page contentType="text/html; charset=gb2312" %>
<form method="post" action="login.do">
  用戶名: <input name="username"><br>
  密碼: <input type="password" name="password"><br>
  <input type="submit" value="提交"> <input type="reset" value="重置">
</form>

4.2 main.jsp / loginfail.jsp

分別顯示 Login Success!!! 與 Login failed!!!。

五、依賴 JAR 包部署

將 Spring 發行包 dist/ 下所有 JAR 複製至 WEB-INF/lib/，額外必須加入 jstl.jar 與 standard.jar，否則啟動會拋出 NoClassDefFoundError: javax/servlet/jsp/jstl/fmt/LocalizationContext。

六、啟動驗證

1. 啟動 Tomcat
2. 瀏覽器輸入 https://localhost/spring/index.jsp
3. 輸入 qQQ / 1 → 導向 main.jsp 顯示成功
4. 輸入錯誤帳密 → 導向 loginfail.jsp 顯示失敗

七、關鍵概念總結與避坑指南

八、擴展建議

• 引入 Validator 介面 分離驗證邏輯
• 導入 Service/DAO 層 完成業務邏輯與資料存取分層
• 使用 Annotation 配置 (Spring 2.5+) 取代 XML
• 整合 Spring Security 實現企業級認證授權