封裝客戶端請求信息,是獲取用戶輸入、Header、Session、屬性的核心入口。
| 分類 | 方法 | 說明 |
|---|---|---|
| 參數獲取 | getParameter(name) | 單值參數(表單欄位、查詢字串) |
| getParameterValues(name) | 多值參數(checkbox、多選框),返回 String[] | |
| getParameterNames() | 所有參數名 Enumeration | |
| getParameterMap() | Map<String, String[]> 完整參數映射 | |
| 請求元信息 | getMethod() | HTTP 方法:GET/POST/PUT... |
| getRequestURI() / getServletPath() | 請求路徑(含/不含 Context Path) | |
| getProtocol() / getScheme() | 協議版本 / http、https | |
| 客戶端信息 | getRemoteAddr() | 客戶端 IP(注意代理需讀 X-Forwarded-For) |
| getRemoteHost() | 客戶端主機名(需 DNS 反解) | |
| getHeader(name) | 請求 Header(User-Agent、Referer、Token 等) | |
| 屬性作用域 | setAttribute(name, obj) | 設置請求屬性(轉發時傳遞數據) |
| getAttribute(name) | 獲取請求屬性 | |
| getAttributeNames() | 所有屬性名 | |
| 流讀取 | getInputStream() / getReader() | 讀取請求體原始數據(JSON、XML、文件流) |
| 路徑解析 | getRealPath(path) | 虛擬路徑轉絕對磁盤路徑(慎用,War 包內無效) |
<%@ page contentType="text/html;charset=UTF-8" %>
<% request.setCharacterEncoding("UTF-8"); %>
<html><body>
<form method="post">
用戶名:<input name="username"> 密碼:<input name="password" type="password">
擅長:<input type="checkbox" name="skill" value="Java">Java
<input type="checkbox" name="skill" value="Python">Python
<input type="checkbox" name="skill" value="Go">Go
<input type="submit">
</form>
<hr>
<%
String user = request.getParameter("username");
String pass = request.getParameter("password");
if (user != null) {
out.println("方法:" + request.getMethod() + "<br>");
out.println("路徑:" + request.getRequestURI() + "<br>");
out.println("客戶 IP:" + request.getRemoteAddr() + "<br>");
out.println("用戶名:" + user + "<br>");
String[] skills = request.getParameterValues("skill");
if (skills != null) {
for (String s : skills) out.println("技能:" + s + "<br>");
}
}
%>
</body></html>
控制響應行為:狀態碼、Header、輸出流、重定向、Cookie。
| 方法 | 用途 |
|---|---|
| setContentType(type) | 設置 MIME 型別與編碼,如 text/html;charset=UTF-8 |
| setCharacterEncoding(charset) | 設置響應字符編碼(需在 getWriter 前調用) |
| getWriter() | 獲取字符輸出流 PrintWriter |
| getOutputStream() | 獲取位元組輸出流 ServletOutputStream(下載文件、圖片) |
| sendRedirect(location) | 302 重定向,瀏覽器地址欄改變 |
| setStatus(code) | 設置 HTTP 狀態碼(404、500 等) |
| addHeader(name, value) | 添加響應 Header(Cache-Control、Set-Cookie 等) |
| addCookie(Cookie) | 發送 Cookie 到客戶端 |
| encodeURL(url) | URL 重寫(支援無 Cookie 會話追蹤) |
<%-- 文件下載 --%>
<%
response.setContentType("application/octet-stream");
response.setHeader("Content-Disposition", "attachment; filename=\"" + URLEncoder.encode("報表.xlsx", "UTF-8") + "\"");
ServletOutputStream sos = response.getOutputStream();
FileInputStream fis = new FileInputStream("/data/report.xlsx");
byte[] buf = new byte[4096]; int len;
while ((len = fis.read(buf)) > 0) sos.write(buf, 0, len);
fis.close(); sos.flush();
%>
<%-- JSON API 響應 --%>
<%
response.setContentType("application/json;charset=UTF-8");
response.getWriter().write("{\"code\":200,\"msg\":\"success\",\"data\":{\"id\":123}}");
%>
<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>request.setCharacterEncoding("UTF-8")(必須在首次 getParameter 前)response.setContentType("text/html;charset=UTF-8")(或 setCharacterEncoding)?characterEncoding=UTF-8&useUnicode=trueserver.xml Connector:URIEncoding="UTF-8"