JSTL 實現 JSP 下拉列表動態綁定：從 Servlet 傳遞 List 到 <c:forEach> 渲染 <option>

下拉列表（<select>）動態綁定是 JSP 最常見場景。標準做法：Controller 查詢數據 → 放入 Request 屬性 → JSP 用 JSTL <c:forEach> 遍歷渲染 <option>。本文給出最小完整示例與進階技巧。

一、領域模型（POJO）

public class Student {
    private Integer id;
    private String name;
    // getter/setter/toString
    // 建議實現 equals/hashCode 基於 id，便於 selected 判斷
}

二、Servlet / Controller 準備數據

@WebServlet("/student/list")
public class StudentListServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        List<Student> students = studentService.findAll(); // 模擬數據
        req.setAttribute("students", students); // 關鍵：放入 Request 域
        req.getRequestDispatcher("/WEB-INF/views/student-form.jsp").forward(req, resp);
    }
}

三、JSP 頁面綁定渲染

<%@ page contentType="text/html;charset=UTF-8" %>
<%@ taglib prefix="c" uri="https://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE html>
<html>
<head><title>學生選擇</title></head>
<body>
    <form action="/submit" method="post">
        <label>學生：
            <select name="studentId">
                <option value="">-- 請選擇 --</option>
                <c:forEach items="${students}" var="stu">
                    <option value="${stu.id}" ${stu.id == param.studentId ? 'selected' : ''}>${stu.name}</option>
                </c:forEach>
            </select>
        </label>
        <button type="submit">提交</button>
    </form>
</body>
</html>

四、關鍵點解析

五、進階場景

1. 分組選項 <optgroup>

<c:forEach items="${departments}" var="dept">
    <optgroup label="${dept.name}">
        <c:forEach items="${dept.students}" var="stu">
            <option value="${stu.id}">${stu.name}</option>
        </c:forEach>
    </optgroup>
</c:forEach>

2. 多選下拉框 multiple + 數組綁定

<select name="studentIds" multiple>
    <c:forEach items="${students}" var="stu">
        <option value="${stu.id}" ${fn:contains(paramValues.studentIds, stu.id) ? 'selected' : ''}>${stu.name}</option>
    </c:forEach>
</select>
<%@ taglib prefix="fn" uri="https://java.sun.com/jsp/jstl/functions" %>

Controller 接收：String[] studentIds = req.getParameterValues("studentIds");

3. Ajax 級聯下拉（省市區）

• 首次載入省份：/api/provinces 返回 JSON 列表，JS 渲染省份 <select>。
• 省份 change 事件 → 載入城市：/api/cities?provinceId=xxx。
• JSP 只渲染首層，後續由前端 JS 接管，減少服務端模板渲染壓力。

六、避坑清單

• List 為 null：JSTL <c:forEach items="${null}"> 不報錯但不輸出，建議 Controller 保證 new ArrayList<>() 而非 null。
• POJO 無 getter：EL 訪問 ${stu.name} 會拋 PropertyNotFoundException，必須生成 getName()。
• 編碼亂碼：JSP pageEncoding=UTF-8、Servlet req.setCharacterEncoding("UTF-8")、Tomcat URIEncoding=UTF-8 三位一體。
• 大數據量下拉：> 500 條建議改用「搜索型下拉」（Select2/Chosen + Ajax 分頁查詢），避免首屏渲染巨大 DOM。

JSTL <c:forEach> + EL 表達式是 JSP 綁定集合數據的標準模式，代碼簡潔、零 Java 腳本、天然支持回顯與分組，掌握此模式即可覆蓋 90% 下拉列表場景。