萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 與 Java 獲取表單數據完整指南:從文本框到複雜控件

表單數據獲取是 Web 開發基礎,但不同控件(單選、多選、下拉)獲取方式各異。本文系統梳理前端 JS 與後端 Java 獲取各類表單元素的標準方法,附完整代碼對照。

HTML 表單結構示例

<form id="userForm" action="/submit" method="POST">
  <!-- 文本/密碼 -->
  <input type="text" name="username" value="張三">
  <input type="password" name="password">

  <!-- 單選框:同 name,不同 value -->
  <input type="radio" name="gender" value="1"> 男
  <input type="radio" name="gender" value="2" checked> 女

  <!-- 多選框:同 name,可多選 -->
  <input type="checkbox" name="hobby" value="1"> 足球
  <input type="checkbox" name="hobby" value="2" checked> 籃球
  <input type="checkbox" name="hobby" value="3"> 游泳

  <!-- 隱藏域 -->
  <input type="hidden" name="token" value="abc123">

  <!-- 下拉選單 -->
  <select name="city" id="city">
    <option value="bj">北京</option>
    <option value="sh" selected>上海</option>
    <option value="gz">廣州</option>
  </select>

  <button type="submit">提交</button>
</form>

前端 JavaScript 獲取方案

1. 統一獲取:FormData(現代標準,推薦)


var form = document.getElementById("userForm");
var formData = new FormData(form);

// 獲取單值
formData.get("username");     // "張三"
formData.get("gender");       // "2" (單選取選中值)
formData.get("city");         // "sh"

// 獲取多值(多選框/多選下拉)
formData.getAll("hobby");     // ["2"] (只取選中的)

// 遍歷所有
for (var [key, value] of formData.entries()) {
    console.log(key, value);
}

// 直接發送 AJAX
fetch("/api/submit", {method: "POST", body: formData});

2. 傳統 DOM API 獲取(兼容舊項目)


var form = document.getElementById("userForm");

// 文本/密碼/隱藏域/單選/下拉:同 name 取首個
form.username.value;           // "張三"
form.elements["gender"].value; // "2" (單選自動取選中項)

// 多選框:需遍歷
var hobbies = [];
var checkboxes = form.elements["hobby"]; // HTMLCollection
for (var i = 0; i < checkboxes.length; i++) {
    if (checkboxes[i].checked) {
        hobbies.push(checkboxes[i].value);
    }
}
// hobbies = ["2"]

// 下拉選單:獲取文本而非值
var citySelect = form.elements["city"];
var cityText = citySelect.options[citySelect.selectedIndex].text; // "上海"

3. jQuery 簡化獲取


// 序列化為字符串:name1=val1&name2=val2...
var params = $("#userForm").serialize();
// "username=張三&gender=2&hobby=2&token=abc123&city=sh"

// 序列化為數組對象:[{name:"username",value:"張三"}, ...]
var arr = $("#userForm").serializeArray();

// 直接獲取值
$("#userForm input[name='username']").val(); // "張三"
$("#userForm input[name='gender']:checked").val(); // "2"
$("#userForm input[name='hobby']:checked").map(function() { return this.value; }).get(); // ["2"]
$("#userForm select[name='city']").val(); // "sh"
$("#userForm select[name='city'] option:selected").text(); // "上海"

後端 Java (Servlet/Spring) 獲取方案

1. 原生 Servlet API


@WebServlet("/submit")
public class FormServlet extends HttpServlet {
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) {
        // 單值:文本、密碼、隱藏域、單選、下拉(單選)
        String username = req.getParameter("username"); // "張三"
        String gender = req.getParameter("gender");     // "2"
        String city = req.getParameter("city");         // "sh"
        String token = req.getParameter("token");       // "abc123"

        // 多值:多選框、多選下拉
        String[] hobbies = req.getParameterValues("hobby"); // ["2"]
        // 若無勾選,返回 null(非空數組),需判空

        // 獲取所有參數名
        Enumeration names = req.getParameterNames();
    }
}

2. Spring MVC 綁定(推薦)


// 1. 簡單參數綁定
@PostMapping("/submit")
public Result submit(
    @RequestParam String username,
    @RequestParam String gender,
    @RequestParam(required = false) String[] hobby, // 多選框自動綁定數組
    @RequestParam String city,
    @RequestParam String token
) { ... }

// 2. 對象綁定(最常用)
@Data
public class UserForm {
    private String username;
    private String password;
    private String gender;
    private String[] hobby; // 或 List
    private String city;
    private String token;
}

@PostMapping("/submit")
public Result submit(@ModelAttribute UserForm form) {
    // 自動綁定所有字段,多選框自動轉數組/List
    // 驗證:@Valid + BindingResult
}

3. 文件上傳(Multipart)


// 表單需 enctype="multipart/form-data"
// Spring
@PostMapping("/upload")
public Result upload(@RequestParam("file") MultipartFile file, UserForm form) {
    // file.getOriginalFilename(), file.getBytes(), file.transferTo(...)
}

常見坑點對照表

控件類型JS 獲取關鍵點Java 獲取關鍵點
單選框同 name,`:checked` 獲取選中值`getParameter` 直接獲取選中值
多選框`getAll` / `:checked` 遍歷 / `serialize` 自動處理`getParameterValues` 返回數組,無選中則 null
下拉單選`.val()` 獲取 value,`option:selected` 獲取文本`getParameter` 獲取 value
下拉多選`.val()` 返回數組`getParameterValues` 返回數組
未勾選多選框JS 獲取空數組Java 返回 null (易漏判空)
禁用控件JS 可獲取Java 不會 接收 disabled 控件數據

最佳實踐建議

  1. 前端統一用 FormData:標準、簡潔、支援文件、直接配合 fetch/AJAX
  2. 後端統一用對象綁定:Spring `@ModelAttribute` 或 `@RequestBody` (JSON),減少手工參數提取
  3. 多選框必判空:Java 端 `hobbies != null ? Arrays.asList(hobbies) : Collections.emptyList()`
  4. 禁用控件需同步 hidden:若需提交禁用字段值,添加同名 hidden input
  5. 編碼一致性:頁面、JS、Java、資料庫全鏈路 UTF-8

掌握前後端表單數據流轉全鏈路,是構建健壯 Web 應用的基本功。

copyright © 萬盛學電腦網 all rights reserved