【正文】 (address,str_is_ip)元組。失敗返回 None。 internal_redirect(new_uri) 對請求進(jìn)行內(nèi)部重定向。內(nèi)部重定向?qū)?chuàng)建一個(gè)新的請求對象，并執(zhí)行所有的階段。 log_error(message[,level]) 對 apache函數(shù) ap_log_error()函數(shù)的接口。 meets_conditions() 調(diào)用 apache函數(shù) ap_meets_conditions()返回狀態(tài)碼。如果不是則簡單的返回狀態(tài)碼 status。 例如： ... [39。]=1130794f37744584a4ea0ab19e684268 [39。]=39。 [39。]=39。 status=() if status!=: return status ... 處理響應(yīng)內(nèi)容 ... requires() 返回包含 require標(biāo)志參數(shù)的元組。user joe39。validuser39。如果 len為負(fù)數(shù)(negative)或者缺省 (omitted)，則讀取所有的數(shù)據(jù)。 這個(gè)函數(shù)依賴于 (rely的復(fù)數(shù) relies)客戶端提供的 Contentlength頭。不正確的 Contentlength將會導(dǎo)致函數(shù)試圖讀取更多的數(shù)據(jù)，并且在超時(shí)到達(dá)之前一直出于阻塞狀態(tài)。注意，同 HTTP定義一樣，大多數(shù)客戶端的行結(jié)束是 39。而不是簡單的 39。 readlines([sizehint]) 讀取 sizehint字節(jié)以內(nèi)的所有行，并返回行列表。參數(shù) callable可以為任何可調(diào)用對象，可選參數(shù)data可以是任何對象，缺省為 None。 推薦傳遞請求對象作為 data，但是注意，在執(zhí)行清理行為時(shí)，請求對象的處理已經(jīng)完成，這時(shí)再對客戶端進(jìn)行寫操作是無意義的 (pointless)。除非直接影響請求處理 ，否則執(zhí)行清理中的 bug很難辨認(rèn) (spot)。 sendfile(path[,offset,len]) 發(fā)送 path文件到客戶端，開始為 offset，并發(fā)送 len字節(jié)。 返回成功發(fā)送的字節(jié)數(shù)，或者在出錯(cuò)時(shí)拋出 IOError異常。 write(string[,flush=1]) 將字符串立即 (directly)寫入客戶端，然活清空 (flush)緩存，除非flush是 0。 set_content_length(len) 設(shè)置 Contentlength頭。 ? 請求對象的成員： connection 這個(gè)請求的連接對象。只讀。查看后面的詳細(xì)介紹。 next 如果是內(nèi)部重定 向，重定向到的請求對象。 prev 如果是內(nèi)部重定向，來自重定向的請求對象。 main 如果這是一個(gè)子請求，指向主請求。 the_request 包含請求的第一行的字符串。 assbackwards 指定 HTTP/。用于兼容古老的瀏覽器。 proxyreq 代理請求。只讀。只讀。HTTP/39。只讀。只讀。只讀。只讀。200 OK39。 status 狀態(tài)， *中的一個(gè)值。GET39。HEAD39。POST39。只讀。只讀。使用允許結(jié)構(gòu)：頭響應(yīng)HTTP_METHOD_NOT_ALLOWED或 HTTP_NOT_IMPLEMENTED。需要設(shè)置則使用 ()方法。 allowed_xmethods 元組，允許的擴(kuò)展 (extension)方法。 allowed_methods 元組，允許的方法，使用 METHOD_NOT_ALLOWED的關(guān)系。只讀。只讀。只讀。只讀。只讀。Range:39。只讀。只讀。 read_length 長整數(shù)，已 經(jīng)讀取的字節(jié)數(shù)，只讀。 read_chunked 布爾值，讀取大塊數(shù)據(jù)的編碼。 expecting_100 布爾值，是否客戶端需要等待 100(HTTP_CONTINUE)響應(yīng)，只讀。 headers_out 需要發(fā)送給客戶端的頭的表格對象。 subprocess_env 包含 CGI信息的表格對象。 notes 與請求擁有共同生存期的對象，用于存儲各種信息，可以在一個(gè)請求的各個(gè)處理器之間傳遞信息。 phase 正在處理的階段，比如 39。只讀。 content_type 字符串，正文類型。發(fā)布器按照如下方式使用這個(gè)標(biāo)志：當(dāng) content_type沒有明確 (explicitly)的設(shè)置時(shí)，它依靠輸出的前幾個(gè)字節(jié)來猜測 (attempt)。用字符串列表表示正文的語言。由 mod_mime設(shè)置，而不是 mod_python處理器。mod_python39。 content_encoding 字符串，正文編碼，只讀。 user 獲取驗(yàn)證的用戶名。注意，()必須在此之前調(diào)用 (be called prior)。 no_cache 布爾值，如果為 true則沒有緩存，只讀。 unparsed_uri URI沒有經(jīng)過任何轉(zhuǎn)換，只讀。 filename 請求的文件名字符串。只讀。同 CGI PATH_INFO。 finfo 元組，文件信息結(jié)構(gòu)，類似于 POSIX狀態(tài)， URI指向的文件的信息(mode,ino,dev,nlink,uid,gid,size,atime,mtime,ctime,fname,name)。 parsed_uri 元組，被分解開的 URI： (scheme,hostinfo,user, password, hostname, port,path,query,fragment)。 used_path_info 當(dāng)前請求中被拒絕 (reject)的 path_info，只讀。 (EOS=end of stream) (mp_conn) 連接對象是 apache的 conn_rec結(jié)構(gòu)的映射。在讀到任何數(shù)據(jù)之前將會阻塞。僅可在連接處理器中使用。 readline([length]) 讀取一行，最多到 length個(gè)字節(jié)。 write(string) 向客戶端寫入字符串。 連接對象的成員： base_server 連接通過的虛擬主機(jī)，只讀。 remote_addr 客戶端地址元組 (address,port)，只讀。 remote_host 字符串，客戶端的 DNS名稱，如果沒有檢查 DNS則返回 None，如果沒有名字則返回 。 remote_logname 遠(yuǎn)程的名字，如果使用了 RFC1413識別信號 (ident)。 aborted 布爾值，如果連接被中斷則為真，只讀。 double_reverse 整數(shù)， 1代表執(zhí)行反向 DNS查詢， 0代表未啟用， 1代表查詢失敗，只讀。 local_ip 本機(jī)的服務(wù)器 IP地址，只讀。 id 長整數(shù)，一個(gè)唯一的連接 ID，只讀。 (mp_filter) 過濾器對象控制 mod_python的輸入輸出，通常用于提取信息，獲取信息并存入過濾器棧。 read([length]) 從臨近過濾 器至多讀取 length個(gè)字節(jié)的數(shù)據(jù)，返回字符串?dāng)?shù)據(jù)，如果讀取流結(jié)束則返回 None。如果未指定 length或?yàn)樨?fù)數(shù)，則讀取當(dāng)前所有有效數(shù)據(jù)。 write(string) 將字符串寫入臨近的過濾器。 close() 關(guān)閉過濾器，并發(fā)送 EOS標(biāo)志。 disable() 告知 mod_python忽略處理器并讓數(shù)據(jù)放行。 過濾器成員： closed 布爾值，指示過濾器是否關(guān)閉，只讀。 req 請求對象的引用，只讀。 handler 字符串，配置中的處理器名稱，只讀。服務(wù)器結(jié)構(gòu)描述了服務(wù)器 (也可能是虛擬服務(wù)器 )如何處理請求。 register_cleanup(request,callable[,data]) 注冊一個(gè)清除行為。這個(gè)函數(shù)需要一個(gè)額外的參數(shù) 請求對象。 defn_line_number 整數(shù)，服務(wù)器定義所在配置文件的行號，只讀。 server_hostname ServerName標(biāo)志的值，同 CGI SERVER_NAME，只讀。 wild_names 元組， ServerAlias標(biāo)志的通配服務(wù)器名，只讀。在 是顯示為 0，可以查看 。 error_fname 錯(cuò)誤日志文件的文件名，只讀。 is_virtual 布爾值，如果是一個(gè)虛擬服務(wù)器則為 True，只讀。 keep_alive_timeout 整數(shù)，保持連接的超時(shí)時(shí)間，只讀。 keep_alive 保持連接？只讀。 pathlen 整數(shù)，路徑長度，只讀。 limit_req_fieldsize 整數(shù)，請求頭的長度限制，只讀。 util模塊提供了類似于 cgi模塊的多種實(shí)用工具。 推薦的使用這個(gè)模塊的方式： from mod_python import util 參考 CGI文檔： 通過 FieldStorage類傳遞數(shù)據(jù)，這個(gè)類類似于標(biāo)準(zhǔn)模塊 cgi FieldStorage。 req是 mod_python請求對象的實(shí)例。缺省值為 False，代表忽略空值，好像他們沒有出現(xiàn)過一 樣。 初始化時(shí)， FieldStorage類讀取所有從客戶端提交的信息。你也可以嘗試在 FieldStorage實(shí)例化之前和之后訪問客戶端數(shù)據(jù)。從HTML提交的輸入類型 file，將會被以臨時(shí)文件的形式稍后提交成 Field對象的 file屬性。當(dāng)使用 映射時(shí)，鍵名是輸入字段名，返回的詞典值可能是如下的： ? StringField的實(shí)例，包含輸入值。StringField是 str的子類提供了 value屬性來兼容 cgi模塊。 ? StringField或者 /和 Field對象的列表。 注意：不同于標(biāo)準(zhǔn)庫 cgi模塊的 FieldStorage類，一個(gè) Field對象只能返回上傳文件。這意味著不需要使用 .value屬性就可以存取字段值，在大多數(shù)時(shí)候。如果具有同名的多個(gè)輸入，則列表中也會擁有多個(gè)對象。如果沒有對應(yīng)的字段則返回default指定的值。 getlist(name) 返回表單字段 name的值列表。即使只有一個(gè)值也會返回包含這個(gè)值的列表。每個(gè) Field類實(shí)例對應(yīng)一個(gè)HTML表單的輸入。這個(gè)屬性用于讀取數(shù)據(jù)上傳文件的數(shù)據(jù)。 file 類似文件對象，指向上傳的臨時(shí)文件 TemporaryFile實(shí)例。 filename 客戶端提供的文件名。 type_options 真實(shí)的內(nèi)容類型，從客戶端提交頭的 contenttype提供的。 disposition 提交頭的 contentdisposition的第一部分的值。 參考： RFC1867， HTML表單提交文件， Formbased File Upload in HTML parse_qs(qs[,keep_blank_values,strict_parsing]) 這個(gè)函數(shù)的功能等同于標(biāo)準(zhǔn)庫 cgi parse_qs，但是是用 C語言寫的，運(yùn)行更快。數(shù)據(jù)以詞典返回。 可選參數(shù) keep_blank_values是一個(gè)標(biāo)志變量 指定 URL編碼中的空值是否作為空字符串處理。缺省值是 False指定空值被忽略。 parse_qsl(qs[,keep_blank_values,strict_parsing]) 這個(gè)函數(shù)功能等同于標(biāo)準(zhǔn)庫 cgi parse_qsl，但是是用 C語言寫的，速度更快。 可選參數(shù) keep_blank_values和 strict_parsing同上。 redirect(req,location[,permanent=0,text=None]) 這是一個(gè)可以方便的重定向?yàn)g覽器到另外一個(gè)地址的函數(shù)。并發(fā)送一段簡短的文本告知瀏覽器，文檔已經(jīng)被移走(當(dāng)這個(gè)罕見的瀏覽器不支持重定向時(shí) )；提示文本可以被 text參數(shù)覆蓋。 這個(gè)函數(shù)觸發(fā) 。 Cookie模塊提供了方便的 (convenient)的方法來創(chuàng)建，分析，發(fā)送和接收 HTTP Cookies，按照 Netscape的定義。而且，很多流行的瀏覽器還是兼容 IETF標(biāo)準(zhǔn)的，而且即便聲稱 RFC兼容的。 在特殊情況下， Netscape與 RFC的 Cookie有很大的區(qū)別，比如路徑和域名。 參考： 客戶端持久化狀態(tài) HTTP Cookies RFC 2109,HTTP狀態(tài)管理機(jī)制 RFC 2964,使用 HTTP狀態(tài)管理 RFC 2965,HTTP狀態(tài)管理機(jī)制 HTTP Cookies：標(biāo)準(zhǔn)，秘密與政見 class Cookie(name,value[,attributes]) 這個(gè)類用于構(gòu)造一個(gè)單一的 cookie名為 name，值為 value。 屬性描述了 cookie的屬性，而他們的字符串將會成為 cookie的一部分。 __data__屬性是一個(gè)通用的詞典可用于存儲任意值，如果需要。 expires屬性。Wdy, DDMonYYYY HH:MM:S GMT39。無效的 expires值會拋出 ValueError異常。 注意：不像 Python標(biāo)準(zhǔn)庫 Cookie類，這個(gè)類指定單一 cookie，等同于 Python標(biāo)準(zhǔn)庫中的 Morsel。轉(zhuǎn)換過程中，屬性名將會轉(zhuǎn)換