Servlet请求处理与响应控制实战指南

1. Servlet请求处理机制深度解析

HTTP请求是Web应用的基础交互方式，Servlet作为Java EE的核心组件，其请求处理机制值得深入探讨。当浏览器发起请求时，Servlet容器（如Tomcat）会创建HttpServletRequest和HttpServletResponse对象，这两个对象贯穿整个请求生命周期。

1.1 HttpServletRequest核心方法实战

请求对象封装了客户端的所有信息，以下是开发中最常用的方法：

java复制// 获取请求参数（自动处理GET/POST）
String username = request.getParameter("username");

// 获取请求头信息
String userAgent = request.getHeader("User-Agent");

// 获取Cookie数组
Cookie[] cookies = request.getCookies();

// 获取会话对象（自动创建）
HttpSession session = request.getSession();

// 获取请求URI和URL
String uri = request.getRequestURI();  // /app/login
String url = request.getRequestURL().toString(); // http://localhost:8080/app/login

// 获取客户端IP（考虑代理情况）
String ip = request.getHeader("X-Forwarded-For");
if(ip == null) ip = request.getRemoteAddr();

重要提示：getParameter()方法对GET和POST请求都有效，但POST请求体需要满足Content-Type为application/x-www-form-urlencoded。对于JSON格式的请求体，需要手动解析输入流。

1.2 请求作用域与属性传递

请求对象提供了属性存储机制，适用于转发场景下的数据共享：

java复制// 设置请求属性
request.setAttribute("currentUser", userObj);

// 获取请求属性
User user = (User)request.getAttribute("currentUser");

// 删除属性
request.removeAttribute("currentUser");

属性传递的生命周期仅限于当前请求范围内，转发到其他Servlet后依然有效，但重定向后会丢失。这是因为重定向实际产生了新的HTTP请求。

1.3 请求参数编码处理

中文参数乱码是常见问题，需要特别注意字符编码设置：

java复制// 针对POST请求的编码设置（必须在第一次getParameter前调用）
request.setCharacterEncoding("UTF-8");

// GET请求编码处理（Tomcat8+默认UTF-8，旧版本需要配置URIEncoding）
String name = new String(request.getParameter("name").getBytes("ISO-8859-1"), "UTF-8");

对于文件上传等multipart/form-data请求，不能使用setCharacterEncoding，需要使用Apache Commons FileUpload等库处理。

2. 响应控制与输出技巧

HttpServletResponse对象控制着返回给客户端的所有内容，从状态码到响应体都需要精细控制。

2.1 响应头精准控制

java复制// 设置内容类型和编码（必须放在getWriter前）
response.setContentType("text/html;charset=UTF-8");

// 缓存控制（禁止浏览器缓存）
response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
response.setHeader("Pragma", "no-cache");
response.setHeader("Expires", "0");

// 自定义响应头
response.setHeader("X-App-Version", "1.0.0");

// 设置Cookie
Cookie cookie = new Cookie("token", "abc123");
cookie.setHttpOnly(true);
cookie.setMaxAge(3600);
cookie.setPath("/");
response.addCookie(cookie);

2.2 响应输出流选择策略

Servlet提供两种输出流，使用时需根据场景选择：

java复制// 字符输出（适合文本内容）
PrintWriter writer = response.getWriter();
writer.println("<h1>Hello World</h1>");

// 字节输出（适合文件下载）
ServletOutputStream out = response.getOutputStream();
byte[] fileBytes = Files.readAllBytes(Paths.get("/path/to/file"));
out.write(fileBytes);

关键注意：getWriter和getOutputStream不能同时调用，否则会抛出IllegalStateException。二进制输出前应设置Content-Type和Content-Length头。

2.3 状态码设置最佳实践

java复制// 成功状态
response.setStatus(HttpServletResponse.SC_OK); // 200

// 资源未找到
response.sendError(HttpServletResponse.SC_NOT_FOUND, "Page not found"); // 404

// 服务器错误
response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR); // 500

// 重定向状态码
response.setStatus(HttpServletResponse.SC_MOVED_PERMANENTLY); // 301
response.setHeader("Location", "/new-url");

对于RESTful API开发，应严格遵循HTTP状态码语义。例如：201 Created用于资源创建成功，204 No Content用于成功但无返回体的操作。

3. 转发与重定向深度对比

转发（Forward）和重定向（Redirect）是两种完全不同的跳转机制，理解它们的区别对架构设计至关重要。

3.1 转发机制内部原理

转发是在服务器内部完成的跳转，客户端感知不到：

java复制// 基本转发语法
RequestDispatcher dispatcher = request.getRequestDispatcher("/targetServlet");
dispatcher.forward(request, response);

// 带参数的转发
request.setAttribute("message", "Forward成功");
request.getRequestDispatcher("/result.jsp").forward(request, response);

转发特点：

• 浏览器URL不变
• 共享同一个request对象
• 只能跳转到同一应用内的资源
• 没有额外的网络往返

典型应用场景：

• MVC模式中的控制器到视图的跳转
• 多个Servlet协作处理复杂请求
• 统一的前置权限检查

3.2 重定向工作机制详解

重定向是通过HTTP协议实现的客户端跳转：

java复制// 基础重定向
response.sendRedirect("/newPath");

// 带参数重定向（需要URL编码）
String message = URLEncoder.encode("操作成功", "UTF-8");
response.sendRedirect("/result.jsp?msg=" + message);

// 永久重定向（301）
response.setStatus(HttpServletResponse.SC_MOVED_PERMANENTLY);
response.setHeader("Location", "/new-url");

重定向特点：

• 浏览器URL变化
• 产生两个独立的HTTP请求
• 可以跳转到任意URL（包括外部站点）
• request对象不共享

典型应用场景：

• 表单提交后防止重复提交（Post/Redirect/Get模式）
• 登录后跳转到目标页面
• 旧URL迁移到新URL
• 跨应用跳转

3.3 性能与安全性考量

转发由于没有额外的网络往返，性能更高，但需要注意：

• 转发链不宜过长，否则影响可维护性
• 转发到JSP时要避免多次转发导致路径问题

重定向虽然性能稍低，但在以下场景更安全：

• 涉及敏感操作的跳转（如支付完成）
• 需要更新浏览器地址栏的场景
• 跨域或跨应用的跳转

4. 实战中的典型问题解决方案

4.1 文件下载实现方案

java复制protected void doGet(HttpServletRequest request, HttpServletResponse response) 
    throws ServletException, IOException {
    
    String filePath = "/data/files/report.pdf";
    File file = new File(filePath);
    
    // 设置MIME类型
    String mimeType = getServletContext().getMimeType(file.getName());
    if(mimeType == null) mimeType = "application/octet-stream";
    
    response.setContentType(mimeType);
    response.setContentLength((int)file.length());
    
    // 解决中文文件名问题
    String userAgent = request.getHeader("User-Agent");
    String encodedFileName;
    if(userAgent.contains("MSIE") || userAgent.contains("Trident")) {
        encodedFileName = URLEncoder.encode(file.getName(), "UTF-8");
    } else {
        encodedFileName = new String(file.getName().getBytes("UTF-8"), "ISO-8859-1");
    }
    
    response.setHeader("Content-Disposition", 
        "attachment; filename=\"" + encodedFileName + "\"");
    
    // 使用NIO提高性能
    Files.copy(file.toPath(), response.getOutputStream());
}

4.2 防止重复提交方案

结合重定向和Token机制：

java复制// 表单页面生成token
String token = UUID.randomUUID().toString();
request.getSession().setAttribute("formToken", token);
request.setAttribute("token", token);

// 提交处理
protected void doPost(HttpServletRequest request, HttpServletResponse response) {
    String sessionToken = (String)request.getSession().getAttribute("formToken");
    String requestToken = request.getParameter("token");
    
    if(sessionToken == null || !sessionToken.equals(requestToken)) {
        response.sendError(HttpServletResponse.SC_BAD_REQUEST, "重复提交");
        return;
    }
    
    // 处理业务逻辑...
    request.getSession().removeAttribute("formToken");
    
    // PRG模式
    response.sendRedirect("/success.jsp");
}

4.3 跨请求数据传递方案

对于需要在重定向后仍然保留的数据，可以使用：

1. URL参数：适合简单数据

   java复制response.sendRedirect("/result?msg="+URLEncoder.encode(message, "UTF-8"));
   

2. Session存储：适合复杂对象

   java复制request.getSession().setAttribute("tempData", dataObj);
   response.sendRedirect("/result");
   // 在result页面中取出后立即删除
   

3. Flash属性（Spring等框架提供）

5. 性能优化与安全实践

5.1 响应输出优化技巧

java复制// 启用Gzip压缩
String acceptEncoding = request.getHeader("Accept-Encoding");
if(acceptEncoding != null && acceptEncoding.contains("gzip")) {
    response.setHeader("Content-Encoding", "gzip");
    GZIPOutputStream gzipOut = new GZIPOutputStream(response.getOutputStream());
    // 使用gzipOut输出内容...
    gzipOut.finish();
} else {
    // 普通输出...
}

// 合理设置缓存头
if(useCache) {
    response.setHeader("Cache-Control", "public, max-age=3600");
} else {
    response.setHeader("Cache-Control", "no-store");
}

5.2 安全防护措施

java复制// 防止点击劫持
response.setHeader("X-Frame-Options", "DENY");

// XSS防护
response.setHeader("X-XSS-Protection", "1; mode=block");
response.setHeader("X-Content-Type-Options", "nosniff");

// CSP策略
response.setHeader("Content-Security-Policy", 
    "default-src 'self'; script-src 'self' 'unsafe-inline'");

5.3 异步处理支持

Servlet 3.0+的异步处理能提高并发能力：

java复制@WebServlet(urlPatterns = "/async", asyncSupported = true)
public class AsyncServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) {
        AsyncContext asyncCtx = request.startAsync();
        asyncCtx.setTimeout(30000); // 30秒超时
        
        CompletableFuture.runAsync(() -> {
            try {
                // 模拟耗时操作
                Thread.sleep(2000);
                
                ServletResponse response = asyncCtx.getResponse();
                response.setContentType("text/plain");
                response.getWriter().write("Async result");
            } catch(Exception e) {
                // 错误处理
            } finally {
                asyncCtx.complete();
            }
        });
    }
}

6. 与现代Web技术的整合

6.1 返回JSON数据

java复制protected void doGet(HttpServletRequest request, HttpServletResponse response) 
    throws IOException {
    
    Map<String, Object> data = new HashMap<>();
    data.put("status", "success");
    data.put("timestamp", System.currentTimeMillis());
    
    response.setContentType("application/json;charset=UTF-8");
    new ObjectMapper().writeValue(response.getWriter(), data);
}

6.2 处理AJAX请求

java复制protected void doPost(HttpServletRequest request, HttpServletResponse response) 
    throws IOException {
    
    // 读取JSON请求体
    BufferedReader reader = request.getReader();
    Map<String, Object> input = new ObjectMapper().readValue(reader, Map.class);
    
    // 处理业务逻辑...
    
    // 返回JSON响应
    response.setContentType("application/json;charset=UTF-8");
    Map<String, Object> result = new HashMap<>();
    result.put("code", 200);
    result.put("data", processedData);
    
    String json = new ObjectMapper().writeValueAsString(result);
    response.getWriter().write(json);
}

6.3 文件上传处理

使用Apache Commons FileUpload：

java复制protected void doPost(HttpServletRequest request, HttpServletResponse response) {
    // 检查是否为multipart请求
    if(!ServletFileUpload.isMultipartContent(request)) {
        response.sendError(HttpServletResponse.SC_BAD_REQUEST);
        return;
    }

    DiskFileItemFactory factory = new DiskFileItemFactory();
    ServletFileUpload upload = new ServletFileUpload(factory);
    
    try {
        List<FileItem> items = upload.parseRequest(request);
        for(FileItem item : items) {
            if(item.isFormField()) {
                // 普通表单字段
                String fieldName = item.getFieldName();
                String value = item.getString("UTF-8");
                // 处理字段...
            } else {
                // 上传文件
                String fileName = FilenameUtils.getName(item.getName());
                InputStream fileContent = item.getInputStream();
                // 保存文件...
            }
        }
        response.sendRedirect("/success.jsp");
    } catch(Exception e) {
        response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
    }
}

在实际项目中，Servlet的这些核心功能构成了Java Web开发的基础。理解请求响应处理机制、转发重定向的区别，能够帮助开发者构建更健壮的Web应用。随着技术的发展，虽然现在有更多现代框架可用，但Servlet API仍然是这些框架的底层基础。