Servlet 3.1 接受 HTTP 请求 - Servlet 基础教程

Java Servlet 使用 HttpServletRequest 类实例接受 HTTP 的请求

HTTP 请求

当浏览器请求网页时，它会向 Web 服务器发送 HTTP 请求头

这些请求头不能被直接读取，因为这些信息是作为 HTTP 请求的头的一部分进行传输的

可以通过我们的 HTTP 基础教程了解更多相关信息

HTTP 请求头属性

属性	描述
Accept	指定浏览器或其他客户端可以处理的 MIME 类型。值 image/png 或 image/jpeg 是最常见的两种可能值
Accept-Charset	指定浏览器可以用来显示信息的字符集。例如 ISO-8859-1
Accept-Encoding	这个头信息指定浏览器知道如何处理的编码类型。值gzip或compress是最常见的两种可能值
Accept-Language	这个头信息指定客户端的首选语言，在这种情况下，Servlet 会产生多种语言的结果。例如，en、en-us、ru 等
Authorization	这个头信息用于客户端在访问受密码保护的网页时识别自己的身份
Connection	这个头信息指示客户端是否可以处理持久 HTTP 连接。持久连接允许客户端或其他浏览器通过单个请求来检索多个文件。值Keep-Alive意味着使用了持续连接
Content-Length	这个头信息只适用于 POST 请求，并给出 POST 数据的大小（以字节为单位）
Cookie	这个头信息把之前发送到浏览器的 cookies 返回到服务器
Host	这个头信息指定原始的 URL 中的主机和端口
If-Modified-Since	这个头信息表示只有当页面在指定的日期后已更改时，客户端想要的页面。如果没有新的结果可以使用，服务器会发送一个 304 代码，表示Not Modified头信息
If-Unmodified-Since	这个头信息是 If-Modified-Since 的对立面，它指定只有当文档早于指定日期时，操作才会成功
Referer	这个头信息指示所指向的 Web 页的 URL。例如，如果您在网页 1，点击一个链接到网页 2，当浏览器请求网页 2 时，网页 1 的 URL 就会包含在 Referer 头信息中
User-Agent	这个头信息识别发出请求的浏览器或其他客户端，并可以向不同类型的浏览器返回不同的内容

Servlet 读取 HTTP 头的方法

Java Servlet 使用 HttpServletRequest 类实例接受 HTTP 的请求

HttpServletRequest 类有许多方法可以读取 HTTP 请求头属性

方法 & 描述
Cookie[] getCookies() 返回一个数组，包含客户端发送该请求的所有的 Cookie 对象
Enumeration getAttributeNames() 返回一个枚举，包含提供给该请求可用的属性名称
Enumeration getHeaderNames() 返回一个枚举，包含在该请求中包含的所有的头名
Enumeration getParameterNames() 返回一个 String 对象的枚举，包含在该请求中包含的参数的名称
HttpSession getSession() 返回与该请求关联的当前 session 会话，或者如果请求没有 session 会话，则创建一个
HttpSession getSession(boolean create) 返回与该请求关联的当前 HttpSession，或者如果没有当前会话，且创建是真的，则返回一个新的 session 会话
Locale getLocale() 基于 Accept-Language 头，返回客户端接受内容的首选的区域设置
Object getAttribute(String name) 以对象形式返回已命名属性的值，如果没有给定名称的属性存在，则返回 null
ServletInputStream getInputStream() 使用 ServletInputStream，以二进制数据形式检索请求的主体
String getAuthType() 返回用于保护 Servlet 的身份验证方案的名称，例如，"BASIC" 或 "SSL"，如果JSP没有受到保护则返回 null
String getCharacterEncoding() 返回请求主体中使用的字符编码的名称
String getContentType() 返回请求主体的 MIME 类型，如果不知道类型则返回 null
String getContextPath() 返回指示请求上下文的请求 URI 部分
String getHeader(String name) 以字符串形式返回指定的请求头的值
String getMethod() 返回请求的 HTTP 方法的名称，例如，GET、POST 或 PUT
String getParameter(String name) 以字符串形式返回请求参数的值，或者如果参数不存在则返回 null
String getPathInfo() 当请求发出时，返回与客户端发送的 URL 相关的任何额外的路径信息
String getProtocol() 返回请求协议的名称和版本
String getQueryString() 返回包含在路径后的请求 URL 中的查询字符串
String getRemoteAddr() 返回发送请求的客户端的互联网协议（IP）地址
String getRemoteHost() 返回发送请求的客户端的完全限定名称
String getRemoteUser() 如果用户已通过身份验证，则返回发出请求的登录用户，或者如果用户未通过身份验证，则返回 null
String getRequestURI() 从协议名称直到 HTTP 请求的第一行的查询字符串中，返回该请求的 URL 的一部分
String getRequestedSessionId() 返回由客户端指定的 session 会话 ID
String getServletPath() 返回调用 JSP 的请求的 URL 的一部分
String[] getParameterValues(String name) 返回一个字符串对象的数组，包含所有给定的请求参数的值，如果参数不存在则返回 null
boolean isSecure() 返回一个布尔值，指示请求是否使用安全通道，如 HTTPS
int getContentLength() 以字节为单位返回请求主体的长度，并提供输入流，或者如果长度未知则返回 -1
int getIntHeader(String name) 返回指定的请求头的值为一个 int 值
int getServerPort() 返回接收到这个请求的端口号
int getParameterMap() 将参数封装成 Map 类型

范例

HttpServletRequest 的 getHeaderNames() 方法可以读取 HTTP 头信息，该方法返回一个枚举，包含与当前的 HTTP 请求相关的头信息

然后我们就以标准方式循环枚举，使用 hasMoreElements() 方法来确定何时停止，使用 nextElement() 方法来获取每个参数的名称

// author: 简单教程(www.twle.cn)
// Copyright © 2015-2065 www.twle.cn. All rights reserved.

package cn.twle.demo;


import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import javax.servlet.annotation.WebServlet;
import java.util.Enumeration;


@WebServlet(name = "DisplayHeaderServlet", urlPatterns = {"display_header"}) 
public class DisplayHeaderServlet extends HttpServlet
{
    // 处理 GET 方法请求的方法
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException
    {
        // 设置响应内容类型
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        String title = "HTTP Header 请求实例 | 简单教程(www.twle.cn)";
        String docType = "<!DOCTYPE html>";
        out.println(docType +
            "<title>" + title + "</title>"+
            "<style>table,th,td{border:1px solid #ddd;border-collapse:collapse;text-align:left}</style>" + 
            "<body bgcolor=\"#f0f0f0\">\n" +
            "<p>" + title + "</p>\n" +
            "<table cellpadding=\"0\" cellspacing=\"0\">" +
            "<tr>\n" +
            "<th>Header 名称</th><th>Header 值</th>\n</tr>");

        Enumeration headerNames = request.getHeaderNames();
        while(headerNames.hasMoreElements())
        {
            String paramName = (String)headerNames.nextElement();
            out.print("<tr><td>" + paramName + "</td>");
            String paramValue = request.getHeader(paramName);
            out.println("<td> " + paramValue + "</td></tr>");
        }
        out.println("</table></body>");
    }
}

在浏览器上输入 http://localhost:8080/servlet/display_header 来访问网页

显示如下