6.1 cgi變量概述

　　 如果你是從傳統(tǒng)的cgi編程轉(zhuǎn)而學(xué)習(xí)java servlet，或許已經(jīng)習(xí)慣了“cgi變量”這一概念。cgi變量匯集了各種有關(guān)請求的信息：

部分來自http請求命令和請求頭，例如content-length頭；
部分來自socket本身，例如主機的名字和ip地址；
也有部分與服務(wù)器安裝配置有關(guān)，例如url到實際路徑的映射。
　　 6.2 標(biāo)準(zhǔn)cgi變量的servlet等價表示

　　 下表假定request對象是提供給doget和dopost方法的httpservletrequest類型對象。 cgi變量 含義 從doget或dopost訪問
auth_type 如果提供了authorization頭，這里指定了具體的模式（basic或者digest）。 request.getauthtype()
content_length 只用于post請求，表示所發(fā)送數(shù)據(jù)的字節(jié)數(shù)。 嚴(yán)格地講，等價的表達(dá)方式應(yīng)該是string.valueof(request.getcontentlength())（返回一個字符串）。但更常見的是用request.getcontentlength()返回含義相同的整數(shù)。
content_type 如果指定的話，表示后面所跟數(shù)據(jù)的類型。 request.getcontenttype()
document_root 與http://host/對應(yīng)的路徑。 getservletcontext().getrealpath("/")
注意低版本servlet規(guī)范中的等價表達(dá)方式是request.getrealpath("/")。

http_xxx_yyy 訪問任意http頭。 request.getheader("xxx-yyy")
path_info url中的附加路徑信息，即url中servlet路徑之后、查詢字符串之前的那部分。 request.getpathinfo()
path_translated 映射到服務(wù)器實際路徑之后的路徑信息。 request.getpathtranslated()
query_string 這是字符串形式的附加到url后面的查詢字符串，數(shù)據(jù)仍舊是url編碼的。在servlet中很少需要用到未經(jīng)解碼的數(shù)據(jù)，一般使用getparameter訪問各個參數(shù)。 request.getquerystring()
remote_addr 發(fā)出請求的客戶機的ip地址。 request.getremoteaddr()
remote_host 發(fā)出請求的客戶機的完整的域名，如java.sun.com。如果不能確定該域名，則返回ip地址。 request.getremotehost()
remote_user 如果提供了authorization頭，則代表其用戶部分。它代表發(fā)出請求的用戶的名字。 request.getremoteuser()
request_method 請求類型。通常是get或者post。但偶爾也會出現(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)聽的端口。 嚴(yán)格地說，等價表達(dá)應(yīng)該是返回字符串的string.valueof(request.getserverport())。但經(jīng)常使用返回整數(shù)值的request.getserverport()。
server_protocol 請求命令中的協(xié)議名字和版本（即http/1.0或http/1.1）。 request.getprotocol()
server_software servlet引擎的名字和版本。 getservletcontext().getserverinfo()


　　 6.3 實例：讀取cgi變量

　　 下面這個servlet創(chuàng)建一個表格，顯示除了http_xxx_yyy之外的所有cgi變量。http_xxx_yyy是http請求頭信息，請參見上一節(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);
}
}