文章目錄
- HTTPConnection.request ( method , url [ , body [ , headers ]] )
- HTTPConnection.getresponse ()
- HTTPConnection.connect ()
- HTTPConnection.close ()
- HTTPConnection.set_debuglevel ( level )
- HTTPResponse.read([amt])
- HTTPResponse.getheader(name[, default])
- HTTPResponse.getheaders()
- HTTPResponse.msg
- HTTPResponse.version
- HTTPResponse.status
- HTTPResponse.reason
httplib 是 python中http 協議的用戶端實現,可以使用該模組來與 HTTP 伺服器進行互動。httplib的內容不是很多,也比較簡單。以下是一個非常簡單的例子,使用httplib擷取google首頁的html:
#coding=gbk<br />import httplib<br />conn = httplib.HTTPConnection("www.google.cn")<br />conn.request('get', '/')<br />print conn.getresponse().read()<br />conn.close()
下面詳細介紹httplib提供的常用類型和方法。
httplib.HTTPConnection ( host [ , port [ , strict [ , timeout ]]] )
HTTPConnection類的建構函式,表示一次與伺服器之間的互動,即請求/響應。參數host表示伺服器主機,如:www.csdn.net;port為連接埠號碼,預設值為80; 參數strict的 預設值為false, 表示在無法解析伺服器返回的狀態行時( status line) (比較典型的狀態行如: HTTP/1.0 200 OK ),是否拋BadStatusLine 異常;選擇性參數timeout 表示逾時時間。
HTTPConnection提供的方法:
HTTPConnection.request ( method , url [ , body [ , headers ]] )
調用request 方法會向伺服器發送一次請求,method 表示請求的方法,常用有方法有get 和post ;url 表示請求的資源的url ;body 表示提交到伺服器的資料,必須是字串(如果method 是"post" ,則可以把body 理解為html 表單中的資料);headers 表示請求的http 頭。
HTTPConnection.getresponse ()
擷取Http 響應。返回的對象是HTTPResponse 的執行個體,關於HTTPResponse 在下面
會講解。
HTTPConnection.connect ()
串連到Http 伺服器。
HTTPConnection.close ()
關閉與伺服器的串連。
HTTPConnection.set_debuglevel ( level )
設定高度的層級。參數level 的預設值為0 ,表示不輸出任何調試資訊。
httplib.HTTPResponse
HTTPResponse表示伺服器對用戶端請求的響應。往往通過調用HTTPConnection.getresponse()來建立,它有如下方法和屬性:
HTTPResponse.read([amt])
擷取響應的訊息體。如果請求的是一個普通的網頁,那麼該方法返回的是頁面的html。選擇性參數amt表示從響應流中讀取指定位元組的資料。
HTTPResponse.getheader(name[, default])
擷取回應標頭。Name表示頭域(header field)名,選擇性參數default在頭網域名稱不存在的情況下作為預設值返回。
HTTPResponse.getheaders()
以列表的形式返回所有的頭資訊。
HTTPResponse.msg
擷取所有的回應標頭資訊。
HTTPResponse.version
擷取伺服器所使用的http協議版本。11表示http/1.1;10表示http/1.0。
HTTPResponse.status
擷取響應的狀態代碼。如:200表示請求成功。
HTTPResponse.reason
返回伺服器處理請求的結果說明。一般為”OK”
下面通過一個例子來熟悉HTTPResponse中的方法:
#coding=gbk<br />import httplib<br />conn = httplib.HTTPConnection("www.g.cn", 80, False)<br />conn.request('get', '/', headers = {"Host": "www.google.cn",<br /> "User-Agent": "Mozilla/5.0 (Windows; U; Windows NT 5.1; zh-CN; rv:1.9.1) Gecko/20090624 Firefox/3.5",<br /> "Accept": "text/plain"})<br />res = conn.getresponse()<br />print 'version:', res.version<br />print 'reason:', res.reason<br />print 'status:', res.status<br />print 'msg:', res.msg<br />print 'headers:', res.getheaders()<br />#html<br />#print '/n' + '-' * 50 + '/n'<br />#print res.read()<br />conn.close()
這是我用firebug跟蹤到回應標頭:
Httplib模組中還定義了許多常量,如:
Httplib. HTTP_PORT
的值為80,表示預設的連接埠號碼為80;
Httplib.OK
的值為200,表示請求成功返回;
Httplib. NOT_FOUND
的值為404,表示請求的資源不存在;
可以通過httplib.responses
查詢相關變數的含義,如:
Print httplib.responses[httplib.NOT_FOUND] #not found
更多關於httplib的資訊,請參考Python手冊httplib
模組。