以下内容引用自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会产生如下所示的结果:
测试工程:https://github.com/easonjim/5_java_example/tree/master/servletbasics/test3