數字 del path 日期和時間 第一個 sockets 輸入流 Language 結構

Python 標準庫 BaseHTTPServer 中文翻譯。

註意: BaseHTTPServer模塊在Python3中已被合並到http.server，當轉換你的資源為 Python3 時 2to3 工具將自己主動適配導入。

源代碼：Lib/BaseHTTPServer.py

此模塊定義了兩個類用於實現HTTP服務器(Web servers)。通常，此模塊不被直接使用。可是它用來作為基類創建功能性的Web servers。

查看 SimpleHTTPServer 和 CGIHTTPServer 模塊。

第一個類。HTTPServer，是一個 SocketServer.TCPServer

的子類。因此實現 SocketServer.BaseServer 的接口，它創建和監聽 HTTP socket。分配請求和處理，創建和執行server的代碼看起來是這種：

def run(server_class=BaseHTTPServer.HTTPServer,
        handler_class=BaseHTTPServer.BaseHTTPRequestHandler):
    server_address = (‘‘, 8000)
    httpd = server_class(server_address, handler_class)
    httpd.serve_forever()
 

Class BaseHTTPServer.HTTPServer(server_address, RequestHandlerClass)

此類建立在 TCPServer 上通過儲存服務器地址作為實例變量名為 server_name 和 server_port，
服務器可經由處理者進入。典型的是通過處理者的 server 實例變量。

class BaseHTTPServer.BaseHTTPRequestHandler(request, client_address, server)

這個類用來處理到達服務器的 HTTP 請求，通過它自身，它不能響應不論什麽實際的 HTTP 請求。

它必須子類化來處理每個請求方法(比如：GET 或 POST)。

BaseHTTPRequestHandler 提供一個若幹類和實例變量。和能夠通過子類使用的方法。

處理者將解析請求和頭信息，然後調用一個請求類型的特定方法。

方法名從請求構造。

樣例中，對於請求方法 SPAM。do_SPAM() 方法將會無參數調用。

全部相關的信息被儲存進處理者的實例變量。子類應該不須要覆寫或者擴展 __init__ 方法。

---

BaseHTTPServerHandler 有下列實例變量：

client_address

包括一個關於client地址的結構為 (host, port) 的元祖。

server

包括server實例

command

包括命令(請求類型)，樣例：‘GET‘。

path

包括請求路徑

request_version

包括請求的HTTP版本號的字符串，樣例：‘HTTP/1.0‘。

headers

擁有一個通過 MessageClass 變量指定的類實例。

這個實例解析和管理 HTTP 請求的頭信息。

rfile

包括一個輸入流 stream，放置在輸入數據選項的開始。

wfile

包括輸出流用於回復一個響應response給clientclient。當寫入這些stream時必須使用適當的HTTP協議。

---

BaseHTTPRequestHandler 有下列類變量：

server_vesion

指定服務器版本號。你或許會覆寫它。he format is multiple whitespace-separated strings, where each string is of the form name[/version]，樣例：‘BaseHTTP/0.2‘。

sys_version

包括Python版本號，通過 version_string 方法和 server_version 類變量使用。

樣例：‘Python/1.4‘。

error_message_format

指定一個格式化字符串用於創建一個錯誤響應給client。

它使用弧括號。鍵格式指定，所以格式操作數必須是一個字典。

code key 應該是一個整數。指定HTTP錯誤碼值。message 應該是一個字符串包括一個錯誤信息的細節，explain 應該是一個錯誤碼數字的解釋。缺省 message 和 explain 的值能在 responses 類變量中被找到。

error_content_type

指定錯誤響應的 Content-Type HTTP 頭發送給client，缺省值是 ‘text/html‘。

2.6新增，在曾經，內容類型總是 ‘text/html‘

protocol_version

這個指定的HTTP協議版本號用於響應，假設設置 ‘HTTP/1.1‘。服務器會執行HTTP硬連接；不管怎樣，你的服務器必須包括一個精確的 Content-Length 頭（使用 send_header()）在全部它響應的client中。

為了向後兼容，默認設置為 ‘HTTP/1.0‘。

MessageClass

指定一個 rfc822.Message-like 類來解析HTTP頭。典型的，這不用覆寫，缺省設置 mimetools.Message 。

responses

此變量包括一個錯誤碼數字和一個包括短和長信息的2元祖的映射，樣例： {code:(shrotmessage, longmessage)}。

shortmessage 通經常使用於一個錯誤響應中的 message key，longmessage用來解釋（查看 error_message_format 類變量）。

---

一個 BaseHTTPRequestHandler 實例有下面方法：

handle()

召喚一次 handle_one_request() （或者。假設硬連接是啟用的，多次召喚）來響應來到的HTTP請求。你應該永遠不須要覆寫它；反而。實現適當的 do_* 方法。

handle_one_request()

這種方法將解析和分配請求給適配的 do_* 方法，你應該不須要覆寫它。

send_error(code[, message])

發送和記錄一個完整的錯誤回復給client。

code 指定HTTP錯誤碼，message 是可選的， 很多其它特定文本。

一個完整的頭設置被發送。隨後使用 error_message_format 類變量排版文本。

send_response(code[,message])

發送一個響應頭和記錄接受的請求，HTTP響應行被發送，然後是 Server 和 Data 頭，這兩個頭的值分別從 version_string 和 dare_time_string 方法拾起。

send_header(keyword, value)

向輸出流寫入一個指定的HTTP頭，ketword 應該指定頭關鍵字，value 指定它的值。

end_headers()

發送一個空白行，表面HTTP頭響應結束。

log_request([code[,size]])

記錄和接受(成功的)請求，code 應該指定為 HTTP code 和響應通訊，假設響應大小是有效的。應該作為 size 參數。

log_error(…)

當一個請求不能被履行記錄一個錯誤，缺省， 它把信息傳給 log_message()，所以它獲得相同的參數(格式的和附加的值)。

log_message(format, …)

記錄一個隨意的信息給 sys.tederr。這是典型的覆寫來創建定制錯誤信息的原理。format參數是一個標準的 printf-style 格式化字符串，在其它參數 log_message() 被用作輸入的格式。clientip地址和當前日期和時間作為每個信息記錄(message logged)的前綴。

version_string()

返回服務器軟件版本號。這是一個 server_version 和 sys_version 類變量的組合。

date_time_string([timestamp])

返回由 timestramp 給予的日期和時間（這些必須通過 time.time() 格式返回），通過一個信息頭來格式化，假設 timestamp 被省略。它將使用當前的日期和時間。

結果看上去像 ‘Sun, 06 Nov 1994 08:49:37 GMT‘。

2.5新增 timestamp 參數。

log_date_time_string()

返回當前日期和時間。logging格式。

address_string()

返回client地址。logging格式。在clientIP地址執行一個名字查找。

---

很多其它樣例

創建一個不用一直循環執行的服務器，直到某些條件被滿足。

def run_while_true(server_class=BaseHTTPServer.HTTPServer,
                   handler_class=BaseHTTPServer.BaseHTTPRequestHandler):
    """
    This assumes that keep_running() is a function of no arguments which
    is tested initially and after each request.  If its return value
    is true, the server continues.
    """
    server_address = (‘‘, 8000)
    httpd = server_class(server_address, handler_class)
    while keep_running():
        httpd.handle_request()

附加：

模塊: CGIHTTPServer
支持CGI腳本的擴展請求處理。

模塊: SimpleHTTPServer
實際上根文檔（document root）下限制響應到文件的基礎請求處理。

Python 標準庫 BaseHTTPServer 中文翻譯