【正文】 流的結(jié)束。過濾器無法控制數(shù)據(jù)的總量，也無法確定請(qǐng)求何時(shí)調(diào)用。為避免數(shù)據(jù)多次被改變，經(jīng)常的確保并不在子請(qǐng)求中，依靠 。如下例配置： PythonConnectionHandler echo 實(shí)現(xiàn)文件 ： from mod_python import apache def connectionhandler(conn): while 1: (()) return Apache內(nèi)部 apache內(nèi)部對(duì) Python的接口也恰好叫做 apache，在 mod_python包。 函數(shù) 源碼網(wǎng)整理： 源碼網(wǎng)整理： log_error(message[,level,server]) Apache函數(shù) ap_log_error()的接口， message是錯(cuò)誤信息， level是如下值： APLOG_EMERG APLOG_ALERT APLOG_CRIT APLOG_ERR APLOG_WARNING APLOG_NOTICE APLOG_INFO APLOG_DEBUG APLOG_NOERRNO server是 。 import_module(module_name[,autoreload=1,log=0,path=None]) mod_python的內(nèi)部高級(jí)特性，用于在模塊改變時(shí)自動(dòng)重新載入模塊。 path嚴(yán)格指定模塊的位置。 ，對(duì)應(yīng) 39。參數(shù)如下： M_GET M_PUT M_POST M_DELETE M_CONNECT 源碼網(wǎng)整理： 源碼網(wǎng)整理： M_OPTIONS M_TRACE M_PATCH M_PROPFIND M_PROPPATCH M_MKCOL M_COPY M_MOVE M_LOCK M_UNLOCK M_VERSION_CONTROL M_CHECKOUT M_UNCHECKOUT M_CHECKIN M_UPDATE M_LABEL M_REPORT M_MKWORKSPACE M_MKACTIVITY M_BASELINE_CONTROL M_MERGE M_INVALID exists_config_define(name) 確定 Apache是否存在一個(gè) name配置。 config_tree() 返回服務(wù)器級(jí) (serverlevel)配置樹。ServerRoot39。返回值是如下三種常量之一： AP_MPMQ_NOT_SUPPORTED=0 指 MPM 支持線程或子進(jìn)程 AP_MPMQ_STATIC=1 指 MPM 正在使用靜態(tài)守護(hù)線程 AP_MPMQ_DYNAMIC=2 指 MPM 正在使用動(dòng)態(tài)守護(hù)線程 code參數(shù)是如下值： AP_MPMQ_MAX_DAEMON_USED=1 最大允許使用的守護(hù)線程數(shù)量 AP_MPMQ_IS_THREADED=2 MPM 是否允許使用線程 AP_MPMQ_IS_FORKED=3 MPM 是否可用 fork生成子進(jìn)程 AP_MPMQ_HARD_LIMIT_DAEMONS=4 編譯時(shí)允許的最大守護(hù)進(jìn)程數(shù)量 AP_MPMQ_HARD_LIMIT_THREADS=5 編譯時(shí)允許最大線程數(shù)量 AP_MPMQ_MAX_THREADS=6 threads/child配置允許的最大線程數(shù)量 AP_MPMQ_MIN_SPARE_DAEMONS=7 最小剩余守護(hù)數(shù) AP_MPMQ_MIN_SPARE_THREADS=8 最 小剩余線程數(shù) AP_MPMQ_MAX_SPARE_DAEMONS=9 最大剩余守護(hù)數(shù) AP_MPMQ_MAX_SPARE_THREADS=10 最大剩余線程數(shù) AP_MPMQ_MAX_REQUESTS_DAEMON=11 每個(gè)守護(hù)最大允許請(qǐng)求數(shù)量 AP_MPMQ_MAX_DAEMONS=12 配置允許的最大守護(hù)數(shù)量 例如： if (): do something else: do something else 表格對(duì)象 (mp_table) class table([mappingorsequence]) 源碼網(wǎng)整理： 源碼網(wǎng)整理： 返回一個(gè)新的 mp_table表格對(duì)象。 mod_python提供的所有表格對(duì)象都是真正 (actual)映射 (mapping)到 apache結(jié)構(gòu)的，所以改變表格的值也會(huì)改變apache的表格。當(dāng)處 理器被調(diào)用時(shí)，會(huì)傳遞唯一個(gè)的一個(gè)參數(shù)就是請(qǐng)求對(duì)象。 add_handler(htype,handler[,dir]) 允許動(dòng)態(tài)注冊(cè)處理器。 handler是包含模塊 名或函數(shù)名的處理器函數(shù)。 通過這種方式添加的處理器生存期為這個(gè)請(qǐng)求。 allow_methods(methods[,reset]) 源碼網(wǎng)整理： 源碼網(wǎng)整理： 添加方法到 列表。實(shí)際的方法處理邏輯在處理器代碼中提供。 get_remote_host([type,str_is_ip]) 用于查詢客戶端的 DNS名和 IP 地址，首次調(diào)用時(shí)查詢 DNS，其后的查詢返回緩存數(shù)據(jù)。如 果曾經(jīng)執(zhí)行過查詢，則返回緩存的機(jī)器名。當(dāng) str_is_ip為非零則 address為 IP 地址字符串。 new_uri是字符串。 message是日志信息， level是日志級(jí)別標(biāo)志，可為如下值： APLOG_EMERG APLOG_ALERT 源碼網(wǎng)整理： 源碼網(wǎng)整理： APLOG_CRIT APLOG_ERR APLOG_WARNNING APLOG_NOTICE APLOG_INFO APLOG_DEBUG APLOG_NOERRNO 如果需要寫入日志而不是通過請(qǐng)求對(duì)象，可用 。注意 (prior)設(shè)置，并也會(huì)影響 的值，假如不是返回 。LastModified39。Expires39。例如如下 apache配置： AuthType Basic require user joe require validuser 函數(shù)將會(huì)返回 (39。) read([len]) 從客戶端讀取最多 len字節(jié)的數(shù)據(jù)，返回字符串?dāng)?shù)據(jù)。如果未提供這個(gè)頭，則缺省為 0。rn39。 register_cleanup(callable[,data]) 注冊(cè)一個(gè)清理行為。 如果在執(zhí)行清理時(shí)遇到 (encounter)錯(cuò)誤，將會(huì)被日志記錄。 offset缺省為 0，而 len缺省為 1，發(fā)送整個(gè) (entire)文件。 flush() 將緩存數(shù)據(jù)寫入客戶端，并清空緩存。查看后面的詳細(xì)介紹。只讀。只讀。只讀。也可以指定這個(gè)選項(xiàng)用于在重定向中避免 (avoid)發(fā)送頭。 header_only 指定 HEAD請(qǐng)求的布爾變量，反對(duì) GET。同 CGI SERVER_PROTOCOL。 hostname 字符串，由 URI或 Host:設(shè)置，頭。 status_line 狀態(tài)行，如 39。 method 包含方法的字符串，如 39。 39。 method_number 方法號(hào)，整數(shù)。這個(gè)字段是 apache內(nèi)部使用的。只讀。 sent_bodyct 整數(shù)，正文的字節(jié)數(shù)。 mtime 長(zhǎng)整數(shù)，資源的修改時(shí)間。 range 字符串 39。 clength 長(zhǎng)整數(shù)，真正的正文長(zhǎng)度。 read_body 整數(shù)，請(qǐng)求體 怎樣被讀取，只讀。 headers_in 客戶端發(fā)來的頭的表格對(duì)象。在需要信息之前需要先調(diào)用 ()方法來填充信息。PythonHandler39。 mod_python維護(hù)一個(gè)內(nèi)部標(biāo)志 ()來保持content_type的設(shè)置。 handler 當(dāng)前處理器的名字。只讀。同 CGI REMOTE_USER，只讀。 no_local_copy 布爾值，如果沒有本地副本，只讀。 canonical_filename 字符串，真實(shí)的文 件名 (，如果她們不同 )。 args 字符串，同 CGI QUERY_ARGS，只讀。模塊 apache定義了 URI*常量用于存取元組的元素，如： fname=[] 只讀。 源碼網(wǎng)整理： 源碼網(wǎng)整理： 連接對(duì)象的方法： read([length]) 從客戶端讀取最多 length字節(jié)的數(shù)據(jù)。 注意從 版本開始，這個(gè)方法的行為有所改變，在此前是阻塞讀取直到 length個(gè)字節(jié)讀取完成。僅可在連接處理器中使用。 remote_ip 客戶端的 IP 地址，同 CGI REMOTE_ADDR，只讀。同 CGI REMOTE_IDENT，只讀。 keepalives 源碼網(wǎng)整理： 源碼網(wǎng)整理： 連接被使用過 的次數(shù)，只讀。 notes 表格對(duì)象，包含各種與連接具有相同生命周期的信息。過濾器在遇到 EOS之后必須關(guān)閉。 flush() 將緩存輸出到 FLUSH緩存桶。在 mod_python內(nèi)部使用打印棧跟蹤，防止進(jìn)入死循環(huán)。 is_input 布爾值，如果是一個(gè)輸入過濾器則為 True，只讀。 服務(wù)器方法： get_config() 類似于 ()，但返回指向 servermodule_config的配置向量。 服務(wù)器成員： defn_name 字符串，配置文件中服務(wù)器定義名，只讀。 names 元組， ServerAlias標(biāo)志的列表，不包含通配符，用 wild_names 分隔，只讀。只讀。 timeout 整數(shù)， Timeout標(biāo)志的值，只讀。 path 字符串， ServerPath標(biāo)志的值，服務(wù)器路徑，只讀。 limit_req_fields 整數(shù)，請(qǐng)求頭的字段數(shù)量限制，只讀。 class FieldStorage(req[,keep_blank_values,strict_parsing]) 這個(gè)類提供了處理從客戶端提交的 HTML。 可選參數(shù) strict_parsing還沒有實(shí)現(xiàn)。 從客戶端讀取的數(shù)據(jù)將會(huì)被轉(zhuǎn)換成 Field對(duì)象，每項(xiàng)數(shù)據(jù)一個(gè)字段。僅限輸入一個(gè)值的時(shí)候。當(dāng)輸入多個(gè)值時(shí)，比如 HTML標(biāo)簽 select的元素。 除了普通的映射 對(duì)象方法 (指詞典 )， FieldStorage對(duì)象還有如下屬性： list 這是 Field對(duì)象的列表，對(duì)應(yīng)每個(gè)輸入。缺省返回None如果未指定 default。 class Field() 這個(gè)類用于 FieldStorage的內(nèi)部實(shí)現(xiàn)。但是注意處理大文件，因?yàn)檎麄€(gè)文件都會(huì)被讀入內(nèi)存。 type 客戶端提交的 contenttype內(nèi)容類型。 disposition_options 提交頭的 contentdisposition的第二部分的值，詞典。詞典的鍵名是 query變量的變量名，值是對(duì)應(yīng)變量的值的列表。 注意： strict_parsing參數(shù)尚未實(shí)現(xiàn)。 與上面函數(shù)的不同就是返回 數(shù)據(jù)的格式。 如果這個(gè)函數(shù)在響應(yīng)頭已經(jīng)被發(fā)送之后調(diào)用，會(huì)觸發(fā) IOError異常。 注意：盡管 RFC 工作組描述了如何使用 Cookie，但是實(shí)際上還是只有 Netscape原始瀏覽器支持。 Cookie模塊忽略這種引入的屬性，所以所以所有引入的 cookie以 Netscape風(fēng)格的 cookie告終，沒有屬性的定義。因此，這個(gè)模塊支持當(dāng)前范例，而不是完全 RFC 兼容的。如果不想這樣，可以在redirect之外套一個(gè) try/except塊來捕捉異常。當(dāng) permanent為 True時(shí)，MOVED_PERMANENTLY狀態(tài)被發(fā)送到客戶端，或者是 MOVED_TEMPORARILY。 源碼網(wǎng)整理： 源碼網(wǎng)整理： 轉(zhuǎn)換一個(gè) query字符串，返回一個(gè)列表的數(shù)據(jù)，變量名和變量值對(duì)。True指定空值轉(zhuǎn)換為空白字符串。 轉(zhuǎn)換一個(gè) query字符串 (URL中附加的提交數(shù)據(jù) )作為字符串參數(shù)。這是一個(gè)詞典。 (更多信息參考 python標(biāo)準(zhǔn)tempfile模塊中的 TemporaryFile類 ) 簡(jiǎn)單的來說，它是一個(gè) StringIO對(duì)象，所以你可以使用這個(gè)屬性讀取字符串值來更好的代替value屬性。 源碼網(wǎng)整理： 源碼網(wǎng)整理： Field實(shí)例包含如下屬性： name 輸入名 value 輸入值。如果沒有對(duì)應(yīng)字段則返回空列表。 FieldStorage類的方法： getfirst(name[,default]) 總是返回表單數(shù)據(jù)名 name的一個(gè)值。其他情況返回 StringField的實(shí)例。 ? Field類的實(shí)例，如果輸入是一個(gè)上傳文件。 FieldStorage類有一個(gè)映射對(duì)象接口，可以作為詞典來處理。當(dāng)所有客戶端信息處理完成時(shí)，只剩下一個(gè)對(duì)應(yīng)一個(gè)請(qǐng)求的 FieldStorage類的實(shí)例。 可選參數(shù) keep_blank_values 是一個(gè)標(biāo)志選項(xiàng)，判定是否把從數(shù)據(jù)編碼而得的 URL中的空值作為空字符串處理。 util模塊的實(shí)現(xiàn)也是非常有效率的，直接調(diào)用Apache的 API，并且通過環(huán)境變量傳遞信息。 limit_req_line 整數(shù)， HTTP請(qǐng)求行的長(zhǎng)度限制，只讀。 keep_alive_max 每個(gè)連接最大允許的請(qǐng)求數(shù)，只讀。 loglevel 整數(shù)，日志級(jí)別，只讀。 port 整數(shù)