作 者 : 仙人掌工作室
6.1 CGI變量概述
如果你是從傳統(tǒng)的CGI編程轉(zhuǎn)而學(xué)習(xí)Java Servlet,或許已經(jīng)習(xí)慣了“CGI變量”這一概念。CGI變量匯集了各種有關(guān)請(qǐng)求的信息:
部分來(lái)自HTTP請(qǐng)求命令和請(qǐng)求頭,例如Content-Length頭; 部分來(lái)自Socket本身,例如主機(jī)的名字和IP地址; 也有部分與服務(wù)器安裝配置有關(guān),例如URL到實(shí)際路徑的映射。 6.2 標(biāo)準(zhǔn)CGI變量的Servlet等價(jià)表示
下表假定request對(duì)象是提供給doGet和doPost方法的HttpServletRequest類(lèi)型對(duì)象。 CGI變量 含義 從doGet或doPost訪問(wèn) AUTH_TYPE 如果提供了Authorization頭,這里指定了具體的模式(basic或者digest)。 request.getAuthType() CONTENT_LENGTH 只用于POST請(qǐng)求,表示所發(fā)送數(shù)據(jù)的字節(jié)數(shù)。 嚴(yán)格地講,等價(jià)的表達(dá)方式應(yīng)該是String.valueOf(request.getContentLength())(返回一個(gè)字符串)。但更常見(jiàn)的是用request.getContentLength()返回含義相同的整數(shù)。 CONTENT_TYPE 如果指定的話,表示后面所跟數(shù)據(jù)的類(lèi)型。 request.getContentType() DOCUMENT_ROOT 與http://host/對(duì)應(yīng)的路徑。 getServletContext().getRealPath("/") 注意低版本Servlet規(guī)范中的等價(jià)表達(dá)方式是request.getRealPath("/")。
HTTP_XXX_YYY 訪問(wèn)任意HTTP頭。 request.getHeader("Xxx-Yyy") PATH_INFO URL中的附加路徑信息,即URL中Servlet路徑之后、查詢字符串之前的那部分。 request.getPathInfo() PATH_TRANSLATED 映射到服務(wù)器實(shí)際路徑之后的路徑信息。 request.getPathTranslated() QUERY_STRING 這是字符串形式的附加到URL后面的查詢字符串,數(shù)據(jù)仍舊是URL編碼的。在Servlet中很少需要用到未經(jīng)解碼的數(shù)據(jù),一般使用getParameter訪問(wèn)各個(gè)參數(shù)。 request.getQueryString() REMOTE_ADDR 發(fā)出請(qǐng)求的客戶機(jī)的IP地址。 request.getRemoteAddr() REMOTE_HOST 發(fā)出請(qǐng)求的客戶機(jī)的完整的域名,如java.sun.com。如果不能確定該域名,則返回IP地址。 request.getRemoteHost() REMOTE_USER 如果提供了Authorization頭,則代表其用戶部分。它代表發(fā)出請(qǐng)求的用戶的名字。 request.getRemoteUser() REQUEST_METHOD 請(qǐng)求類(lèi)型。通常是GET或者POST。但偶爾也會(huì)出現(xiàn)HEAD,PUT, DELETE,OPTIONS,或者 TRACE. request.getMethod() SCRIPT_NAME URL中調(diào)用Servlet的那一部分,不包含附加路徑信息和查詢字符串。 request.getServletPath() SERVER_NAME Web服務(wù)器名字。 request.getServerName() SERVER_PORT 服務(wù)器監(jiān)聽(tīng)的端口。 嚴(yán)格地說(shuō),等價(jià)表達(dá)應(yīng)該是返回字符串的String.valueOf(request.getServerPort())。但經(jīng)常使用返回整數(shù)值的request.getServerPort()。 SERVER_PROTOCOL 請(qǐng)求命令中的協(xié)議名字和版本(即HTTP/1.0或HTTP/1.1)。 request.getProtocol() SERVER_SOFTWARE Servlet引擎的名字和版本。 getServletContext().getServerInfo()
6.3 實(shí)例:讀取CGI變量
下面這個(gè)Servlet創(chuàng)建一個(gè)表格,顯示除了HTTP_XXX_YYY之外的所有CGI變量。HTTP_XXX_YYY是HTTP請(qǐng)求頭信息,請(qǐng)參見(jiàn)上一節(jié)介紹。
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) +"<BODY BGCOLOR=\"#FDF5E6\">\n" +"<H1 ALIGN=CENTER>" + title + "</H1>\n" +"<TABLE BORDER=1 ALIGN=CENTER>\n" +"<TR BGCOLOR=\"#FFAD00\">\n" +"<TH>CGI Variable Name<TH>Value");for(int i=0; i<variables.length; i++) {String varName = variables[i][0];String varValue = variables[i][1];if (varValue == null)varValue = "<I>Not specified</I>";out.println("<TR><TD>" + varName + "<TD>" + varValue);}out.println("</TABLE></BODY></HTML>");}
public void doPost(HttpServletRequest request,HttpServletResponse response)throws ServletException, IOException {doGet(request, response);}}
來(lái)源:http://edu.chinaz.com