Java Servlet和JSP教程(6)(轉)[@more@]
此篇是本站CnJSP小組核心成員鈍刀原創作品
6 CGI變數
6.1 CGI變數概述
如果你是從傳統的CGI程式設計轉而學習Java Servlet,或許已經習慣了“CGI變數”這一概念。CGI變數彙集了各種有關請求的資訊:
部分來自HTTP請求命令和請求頭,例如Content-Length頭;
部分來自Socket本身,例如主機的名字和IP地址;
也有部分與伺服器安裝配置有關,例如URL到實際路徑的對映。
6.2 標準CGI變數的Servlet等價表示
下表假定request物件是提供給doGet和doPost方法的HttpServletRequest型別物件。
CGI變數 含義 從doGet或doPost訪問
AUTH_TYPE 如果提供了Authorization頭,這裡指定了具體的模式(basic或者digest)。 request.getAuthType()
CONTENT_LENGTH 只用於POST請求,表示所傳送資料的位元組數 嚴格地講,等價的表達方式應該是String.valueOf (request.getContentLength())(返回一個字串)。但更??氖怯?equest.getContentLength()返回含義相同的整數
CONTENT_TYPE 如果指定的話,表示後面所跟資料的型別。 request.getContentType()
DOCUMENT_ROOT 與對應的路徑。 getServletContext().getRealPath("/")
注意低版本Servlet規範中的等價表達方式是request.getRealPath("/")。
HTTP_XXX_YYY 訪問任意HTTP頭。 request.getHeader("Xxx-Yyy")
PATH_INFO URL中的附加路徑資訊,即URL中Servlet路徑之後、查詢字串之前的那部分。 request.getPathInfo()
PATH_TRANSLATED 對映到伺服器實際路徑之後的路徑資訊。 request.getPathTranslated()
QUERY_STRING 這是字串形式的附加到URL後面的查詢字串,資料仍舊是URL編碼的。在Servlet中很少需要用到未經解碼的資料,一般使用getParameter訪問各個引數。 request.getQueryString()
REMOTE_ADDR 發出請求的客戶機的IP地址。 request.getRemoteAddr()
REMOTE_HOST 發出請求的客戶機的完整的域名,如java.sun.com。如果不能確定該域名,則返回IP地址。 request.getRemoteHost()
REMOTE_USER 如果提供了Authorization頭,則代表其使用者部分。它代表發出請求的使用者的名字。 request.getRemoteUser()
REQUEST_METHOD 請求型別。通常是GET或者POST。但偶爾也會出現HEAD,PUT, DELETE,OPTIONS,或者 TRACE. request.getMethod()
SCRIPT_NAME URL中呼叫Servlet的那一部分,不包含附加路徑資訊和查詢字串。 request.getServletPath()
SERVER_NAME Web伺服器名字。 request.getServerName()
SERVER_PORT String.valueOf伺服器監聽的埠。 嚴格地說,等價表達應該是返回字串的(request.getServerPort())。 但經常使用返回整數值的request.getServerPort()。
SERVER_PROTOCOL 請求命令中的協議名字和版本(即HTTP/1.0或HTTP/1.1) request.getProtocol()
SERVER_SOFTWARE Servlet引擎的名字和版本。 getServletContext().getServerInfo()
6.3 例項:讀取CGI變數
下面這個Servlet建立一個表格,顯示除了HTTP_XXX_YYY之外的所有CGI變數。HTTP_XXX_YYY是HTTP請求頭資訊,請參見上一節介紹。
ShowCGIVariables.java
package hall;
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
public class ShowCGIVariables extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String[][] variables =
{ { "AUTH_TYPE", request.getAuthType() },
{ "CONTENT_LENGTH", String.valueOf(request.getContentLength()) },
{ "CONTENT_TYPE", request.getContentType() },
{ "DOCUMENT_ROOT", getServletContext().getRealPath("/") },
{ "PATH_INFO", request.getPathInfo() },
{ "PATH_TRANSLATED", request.getPathTranslated() },
{ "QUERY_STRING", request.getQueryString() },
{ "REMOTE_ADDR", request.getRemoteAddr() },
{ "REMOTE_HOST", request.getRemoteHost() },
{ "REMOTE_USER", request.getRemoteUser() },
{ "REQUEST_METHOD", request.getMethod() },
{ "SCRIPT_NAME", request.getServletPath() },
{ "SERVER_NAME", request.getServerName() },
{ "SERVER_PORT", String.valueOf(request.getServerPort()) },
{ "SERVER_PROTOCOL", request.getProtocol() },
{ "SERVER_SOFTWARE", getServletContext().getServerInfo() }
};
String title = "顯示CGI變數";
out.println(ServletUtilities.headWithTitle(title) +"
" +
"
" + title + "
" +
"
" + "" + "CGI Variable Name | Value"); for(int i=0; iString varName = variables[i][0]; String varValue = variables[i][1]; if (varValue == null) varValue = "Not specified"; out.println("" + varName + " | " + varValue); } out.println(" | |