JSP - 客户端请求

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

此头部将 Cookie 返回给之前将其发送到浏览器的服务器。

Host

此头部指定原始 URL 中给出的主机和端口。

If-Modified-Since

此头部指示客户端仅在指定日期之后更改了页面时才需要该页面。如果没有任何更新的结果可用，服务器将发送代码 304，这意味着 **Not Modified** 头部。

If-Unmodified-Since

此头部与 **If-Modified-Since** 相反；它指定操作仅在文档早于指定日期时才应成功。

Referer

此头部指示引用网页的 URL。例如，如果您位于网页 1 并单击指向网页 2 的链接，则当浏览器请求网页 2 时，网页 1 的 URL 将包含在 Referer 头部中。

User-Agent

此头部标识发出请求的浏览器或其他客户端，可用于向不同类型的浏览器返回不同的内容。

Cookie[] getCookies()

返回一个包含客户端随此请求发送的所有 Cookie 对象的数组。

Enumeration getAttributeNames()

返回一个包含此请求可用的属性名称的枚举。

Enumeration getHeaderNames()

返回此请求包含的所有头部名称的枚举。

Enumeration getParameterNames()

返回一个包含此请求中包含的参数名称的 String 对象枚举。

HttpSession getSession()

返回与此请求关联的当前会话，或者如果请求没有会话，则创建一个新会话。

HttpSession getSession(boolean create)

返回与此请求关联的当前 HttpSession，或者如果没有当前会话且 create 为 true，则返回一个新会话。

Locale getLocale()

根据 Accept-Language 头部返回客户端将接受内容的首选区域设置。

Object getAttribute(String name)

将命名属性的值作为 Object 返回，如果不存在给定名称的属性，则返回 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 返回。

String getMethod()

返回发出此请求的 HTTP 方法的名称，例如 GET、POST 或 PUT。

String getParameter(String name)

将请求参数的值作为 String 返回，或者如果参数不存在，则返回 null。

String getPathInfo()

返回与客户端发出此请求时发送的 URL 关联的任何额外路径信息。

String getProtocol()

返回请求使用的协议的名称和版本。

String getQueryString()

返回请求 URL 中路径之后包含的查询字符串。

String getRemoteAddr()

返回发送请求的客户端的互联网协议 (IP) 地址。

String getRemoteHost()

返回发送请求的客户端的完全限定域名。

String getRemoteUser()

如果用户已通过身份验证，则返回发出此请求的用户登录名，或者如果用户未通过身份验证，则返回 null。

String getRequestURI()

返回此请求的 URL 中从协议名称到 HTTP 请求第一行中的查询字符串的部分。

String getRequestedSessionId()

返回客户端指定的会话 ID。

String getServletPath()

返回此请求的 URL 中调用 JSP 的部分。

String[] getParameterValues(String name)

返回一个包含给定请求参数具有的所有值的 String 对象数组，或者如果参数不存在，则返回 null。

boolean isSecure()

返回一个布尔值，指示此请求是否使用安全通道（例如 HTTPS）发出。

int getContentLength()

返回请求正文的长度（以字节为单位），并由输入流提供，或者如果长度未知，则返回 -1。

int getIntHeader(String name)

将指定请求头的值作为 int 返回。

int getServerPort()

返回接收此请求的端口号。