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