Servlet的客户端请求

时间:2024-03-22 17:34:08

以下内容引用自http://wiki.jikexueyuan.com/project/servlet/client-request.html

当浏览器请求网页时,它会向Web服务器发送大量信息,这些信息不能被直接读取,因为这些信息是作为HTTP请求头的一部分行进的。

以下是来自浏览器端的重要的头信息,会在Web编程中频繁的使用:

头信息 描述
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 这个头信息识别发出请求的浏览器或其他客户端,并可以向不同类型的浏览器返回不同的内容。

一、读取HTTP头信息的方法

下述方法可以用于读取Servlet程序中的HTTP头信息。通过HttpServletRequest对象这些方法是可用的。

方法  描述

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()

返回接收到这个请求的端口号。

二、HTTP头信息请求实例:

下述例子使用了HttpServletRequest的getHeaderNames()方法来读取HTTP头信息。该方法返回了一个枚举,包含与当前的HTTP请求相关的头信息。

一旦得到一个枚举,可以以标准方式循环这个枚举,使用hasMoreElements()方法来确定何时停止循环,使用nextElement()方法来获取每个参数的名称。

// Import required java libraries
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
// Extend HttpServlet class
public class DisplayHeader extends HttpServlet {
// Method to handle GET method request.
public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException
{
// Set response content type
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String title = "HTTP Header Request Example";
String docType =
"<!doctype html public \"-//w3c//dtd html 4.0 " +
"transitional//en\">\n";
out.println(docType +
"<html>\n" +
"<head><title>" + title + "</title></head>\n"+
"<body bgcolor=\"#f0f0f0\">\n" +
"<h1 align=\"center\">" + title + "</h1>\n" +
"<table width=\"100%\" border=\"1\" align=\"center\">\n" +
"<tr bgcolor=\"#949494\">\n" +
"<th>Header Name</th><th>Header Value(s)</th>\n"+
"</tr>\n");
Enumeration headerNames = request.getHeaderNames();
while(headerNames.hasMoreElements()) {
String paramName = (String)headerNames.nextElement();
out.print("<tr><td>" + paramName + "</td>\n");
String paramValue = request.getHeader(paramName);
out.println("<td> " + paramValue + "</td></tr>\n");
}
out.println("</table>\n</body></html>");
}
// Method to handle POST method request.
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
doGet(request, response);
}
}

配置web.xml:

      <servlet>
<servlet-name>DisplayHeader</servlet-name>
<servlet-class>com.jsoft.testservletbasics.DisplayHeader</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>DisplayHeader</servlet-name>
<url-pattern>/DisplayHeader</url-pattern>
</servlet-mapping>

现在,调用上述Servlet会产生如下所示的结果:

Servlet的客户端请求

测试工程:https://github.com/easonjim/5_java_example/tree/master/servletbasics/test3