Servlet HttpServletRequest获取请求信息(请求头、请求行、参数)详解

更新时间：2026年08月01日 10:24:57 作者：吴声子夜歌

本文深入讲解了ServletAPI中的HttpServletRequest接口,详细介绍了如何通过该接口获取HTTP请求消息中的请求行、请求头和请求体信息,感兴趣的朋友跟随小编一起看看吧

HttpServletRequest对象概述

在Servlet API中，定义了一个HttpServletRequest接口，它继承自ServletReauest接口，专门用来封装HTTP请求消息。由于HTTP请求消息分为请求行、请求消息头和请求消息体三部分，因此，在HttpServletRequest接口中定义了获取请求行、请求头和请求消息体的相关方法。

我们在创建Servlet时会覆盖service()方法，或doGet()/doPost(),这些方法都有两个参数，一个为代表请求的request和代表响应response。
service方法中的request的类型是ServletRequest，而doGet/doPost方法的request的类型是HttpServletRequest，HttpServletRequest是ServletRequest的子接口，功能和方法更加强大，今天我们学习HttpServletRequest。

request的运行流程

通过抓包工具抓取HTTP请求

通过request获得请求行信息

当访问Servlet时，会在请求消息的请求行中，包含请求方法、请求资源名、请求路径等信息，为了获取这些信息，在HTTPServletRequest接口中，定义了一系列用于获取请求行的方法，如下表：

方法声明	功能描述
String getMethod\color{red}{getMethod}getMethod	该方法用于获取HTTP请求消息中的请求方式（如GET、POST等）
String getReauestURI()	该方法用于获取请求行中资源名称部分，即位于URL的主机和端口之后、参数部分之前的部分
String getQueryString()	该方法用于获取请求行中的参数部分，也就是资源路径后面问号以后的所有内容
String getProtocol()	该方法用于获取请求行中的协议名和版本，例如，HTTP/1.0 或 HTTP/1.1
String getContextPath()\color{red}{getContextPath()}getContextPath()	该方法用于获取请求URL中属于WEB应用程序的路径，这个路径以"/"开头，表示相对于整个WEB站点的根目录，路几个结尾不含“/”。如果请求URL属于web站点的根目录，那么返回结果为空字符串“”
String getServletPath()	该方法用于获取Servlet的名称或Servlet所映射的路径
String getRemoteAddr()\color{red}{getRemoteAddr()}getRemoteAddr()	该方法用于获取请求客户端的IP地址，其格式类似于"192.168.0.1"
String getRemoteHost()	该方法用于获取请求客户端的完整主机名，其格式类似于"pc1.xxxx.cn"。需要注意的是，如果无法解析出客户机的完整主机名，该方法会返回客户端的IP地址
int getRemotePort()	该方法用于获取请求客户端网络连接的端口号
String getLocalAddr()	该方法用于获取Web服务器上接收当前请求网络连接的IP地址
String getLocalName()	该方法用于获取Web服务器上接收当前网络连接IP所对应的主机名
int getLocalPort()	该方法用于获取Web服务器上接收当前网络连接的端口号
String getServerName()	该方法用于获取当前请求所指向的主机名，即HTTP请求消息中HOST头字段所对应的主机名部分
int getServerPort()	该方法用于获取当前请求所连接的服务器端口号，即如果HTTP请求消息中HOST头字段所对应的端口号部分
String getScheme()	该方法用于获取请求的协议名，例如http、https或ftp
StringBuffer getRequestURL()	该方法用于获取客户端发出请求时的完整URL，包括协议、服务器名、端口号、资源路径等信息，但不包括后面的查询参数部分。注意，getRequestRUL()方法返回的时StringBuffer类型，而不是String类型。

示例：

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        response.setContentType("text/html;charset=utf-8");
        PrintWriter out = response.getWriter();
        //获取请求行的相关信息
        out.println("getMethod:" + request.getMethod() + "
");
        out.println("getQueryString:" + request.getQueryString() + "
");
        out.println("getProtocol:" + request.getProtocol() + "
");
        out.println("getContextPath" + request.getContextPath() + "
");
        out.println("getPathInfo:" + request.getPathInfo() + "
");
        out.println("getPathTranslated:" + request.getPathTranslated() + "
");
        out.println("getServletPath:" + request.getServletPath() + "
");
        out.println("getRemoteAddr:" + request.getRemoteAddr() + "
");
        out.println("getRemoteHost:" + request.getRemoteHost() + "
");
        out.println("getRemotePort:" + request.getRemotePort() + "
");
        out.println("getLocalAddr:" + request.getLocalAddr() + "
");
        out.println("getLocalName:" + request.getLocalName() + "
");
        out.println("getLocalPort:" + request.getLocalPort() + "
");
        out.println("getServerName:" + request.getServerName() + "
");
        out.println("getServerPort:" + request.getServerPort() + "
");
        out.println("getScheme:" + request.getScheme() + "
");
        out.println("getRequestURL:" + request.getRequestURL() + "
");
    }

通过浏览器访问，页面显示：

通过request获得请求头

当请求Servlet时，需要通过请求头向服务器传递附加信息，例如，客户端可以接收的数据类型，压缩方式，语言等。为此，在HttpServletRequest接口中，定义了一系列用于获取HTTP请求头字段的方法，如下表：

方法声明	功能描述
String getHeader(String name)	该方法用于获取一个指定头字段的值，如果请求消息中没有包含指定的头字段，getHeader()方法返回null；如果请求消息中包含有多个指定名称的头字段，getHeader()方法返回其中第一个头字段的值
Enumeration getHeaders(String name)	该方法返回一个Enumeration集合对象，该集合对象由请求消息中出现的某个指定名称的所有头字段值组成。在多数情况下，一个头字段名在请求消息中只出现一次，但有时候可能会出现多次
Enumeration getheaderNames()	该方法用于获取一个包含所有请求头字段的Enumeration对象
int getIntHeader(String name)	该方法用于获取指定名称的头字段，并且将其值转换为int类型。需要注意的是，如果指定名称的头字段不存在，返回值为-1；如果获取到的头字段的值不能转为int类型，将发生NumberFormatException异常
Long getDateHeader(String name)	该方法用于获取指定头字段的值，并将其按GMT时间格式转换成一个代表日期/时间的长整数，这个长整数是自1970年1月1日0点0分0秒算起的以毫秒为单位的时间值
String getContentType()	该方法用于获取Content-Type头字段的值，结果为String类型
int getContentLength()	该方法用于获取Content-Length头字段的值，结果为int类型
String getCharacterEncoding()	该方法用于返回请求消息的实体部分的字符集编码，通常是从Content-Type头字段中进行提取，结果为String类型

示例：

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        response.setContentType("text/html;charset=utf-8");
        PrintWriter out = response.getWriter();
        //获取请求头信息
        Enumeration headerNames = request.getHeaderNames();
        //使用循环遍历请求头，并通过getHeader()方法获取一个指定名称的头字段
        while (headerNames.hasMoreElements()){
            String headerName = (String) headerNames.nextElement();
            out.println(headerName + " : " + request.getHeader(headerName) + "<br/>");
        }
    }

通过浏览器访问，页面显示：

通过request获得请求体（请求参数）

在实际开发中，经常需要获取用户提交的表单数据，例如，用户名，密码、电子邮件等，为了方便获取表单中的请求参数，在HttpServletRequest接口总，定义了一些列获取请求参数的方法，如下表所示：

方法声明	功能描述
String getParameter(String name)	该方法用于获取某个指定名称的参数值，如果请求消息中没有包含指定名称的参数，getParameter()方法返回null；如果指定名称的参数存在但没有设置值，则返回一个空串；如果请求消息中包含有多个该指定名称的参数，getParameter()方法返回第一个出现的参数值
String[] getParameterValues(String name)	HTTP请求消息中可以有多个相同名称的参数（通常由一个包含有多个同名的字段元素的FORM表单生成），如果要获得HTTP请求消息中的同一个参数名所对应的所有参数值，那么就应该使用getParameterValues()方法，该方法用于返回一个String类型的数组
Enumeration getParameterNames()	该方法用于返回一个包含请求消息中所有参数名的Enumeration对象，在此基础上，可以对请求消息中的所有参数进行遍历处理
Map getParameterMap()	个体Parameter Map()方法用于将请求消息中的所有参数名和值装入进一个Map对象中返回

示例：
创建一个带有表单的jsp页面：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>表单</title>
</head>
<body>
    <form action="/JavaEEDemo/request" method="post">
        用户名:<input type="text" name="username">
        密  码:<input type="password" name="password">
        爱  好：
        <input type="checkbox" name="hobby" value="sing">唱歌
        <input type="checkbox" name="hobby" value="dance">跳舞
        <input type="checkbox" name="hobby" value="football">足球
        <input type="submit" value="提交">
    </form>
</body>
</html>

编写Servlet的doPost方法：

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        String username = request.getParameter("username");
        String password = request.getParameter("password");
        System.out.println("用户名：" + username);
        System.out.println("密码：" + password);
        //获取参数名为hobby的值
        String[] hobbys = request.getParameterValues("hobby");
        System.out.println("爱好：");
        for (int i = 0; i < hobbys.length; i++) {
            System.out.println(hobbys[i] + ", ");
        }
    }

通过浏览器访问jsp页面：

点击提交后，控制条输出：

用户名：zhangsan
密码：123456
爱好：
sing, 
dance, 
football,

到此这篇关于Servlet HttpServletRequest获取请求信息(请求头、请求行、参数)详解的文章就介绍到这了,更多相关Servlet HttpServletRequest请求信息内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java中的异常和处理机制实例详解
这篇文章主要介绍了Java中的异常和处理机制,结合实例形式详细分析了Java异常与处理机制的相关概念、原理、用法及操作注意事项,需要的朋友可以参考下
2019-05-05
Java实现的按照顺时针或逆时针方向输出一个数字矩阵功能示例
这篇文章主要介绍了Java实现的按照顺时针或逆时针方向输出一个数字矩阵功能,涉及java基于数组遍历、运算的矩阵操作技巧,需要的朋友可以参考下
2018-01-01
java使用httpclient 发送请求的示例
HttpClient 是Apache Jakarta Common 下的子项目,可以用来提供高效的、最新的、功能丰富的支持 HTTP 协议的客户端编程工具包,并且它支持 HTTP 协议最新的版本和建议,这篇文章主要介绍了java使用httpclient 发送请求的示例,需要的朋友可以参考下
2023-10-10
Java基于线程实现带有滚动效果的Label标签实例
这篇文章主要介绍了Java基于线程实现带有滚动效果的Label标签,实例分析了java线程的使用技巧及label标签的实现方法,具有一定参考借鉴价值,需要的朋友可以参考下
2015-07-07
javacv开发详解之调用本机摄像头视频
这篇文章主要介绍了javacv开发详解之调用本机摄像头视频，对javacv感兴趣的同学，可以参考下
2021-04-04
初次体验MyBatis的注意事项
今天给大家带来的是关于MyBatis的相关知识,文章围绕着MyBatis的用法展开,文中有非常详细的介绍及代码示例,需要的朋友可以参考下
2021-06-06
Java网络编程实现多线程聊天
这篇文章主要为大家详细介绍了Java网络编程实现多线程聊天，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-07-07
如何解决EasyExcel导出文件LocalDateTime报错问题
这篇文章主要介绍了如何解决EasyExcel导出文件LocalDateTime报错问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-06-06
javabean 中使用@Transient属性处理临时字段
@Transient表示该属性并非一个到数据库表的字段的映射,ORM框架将忽略该属性,本文给大家介绍javabean 中临时字段的处理：@Transient,感兴趣的朋友跟随小编一起看看吧
2023-08-08
SpringBoot下载文件的实现及速度对比
这篇文章主要介绍了SpringBoot下载文件的实现及速度对比，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-12-12