http 模塊簡介

Python3 中的 http 包中含有幾個用來開發(fā) HTTP 協(xié)議的模塊。

• http.client 是一個底層的 HTTP 協(xié)議客戶端，被更高層的 urllib.request 模塊所使用。
• http.server 包含基于 socketserver 的基本 HTTP 服務(wù)器的類。
• http.cookies 實(shí)現(xiàn) cookie 狀態(tài)管理
• http.cookiejar 與 cookie 相關(guān)
  

http 模塊還定義了一系列的 HTTP 狀態(tài)碼。

HTTPStatus 類是在 Python 3.5 版本中新增的。

>>> from http import HTTPStatus
>>> HTTPStatus.OK<HTTPStatus.OK: 200>
>>> HTTPStatus.OK == 200True
>>> http.HTTPStatus.OK.value200
>>> HTTPStatus.OK.phrase'OK'
>>> HTTPStatus.OK.description'Request fulfilled, document follows'
>>> list(HTTPStatus)[<HTTPStatus.CONTINUE: 100>, <HTTPStatus.SWITCHING_PROTOCOLS: 101>, ...]

具體的 HTTP 狀態(tài)碼和相應(yīng)的說明可以在 Python 的官方文檔上找到： https://docs.python.org/3/library/http.html

http.client 模塊

http.client 模塊定義了實(shí)現(xiàn) http 和 https 協(xié)議客戶端的類。

該模塊通常不會直接使用，而是用封裝好的 urllib.request 模塊來使用他們處理 URL 。

常量

http 模塊中的常量：

1、http.client.HTTP_PORT

http 協(xié)議默認(rèn)的端口號，總是 80 端口

2、http.client.HTTPS_PORT

https 協(xié)議默認(rèn)的端口號，總是 443 端口

3、http.client.responses

將 HTTP 1.1 狀態(tài)碼映射到 W3C 名字的字典。

例如：

http.client.responses[http.client.NOT_FOUND] is 'Not Found'

基本類

HTTPConnection 類

http.client.HTTPConnection(host, port=None, [timeout, ]source_address=None)

HTTPConnection 實(shí)例表示與 HTTP 服務(wù)器的事務(wù)。

實(shí)例化 HTTPConnection 時應(yīng)該傳遞一個主機(jī)和可選的端口號。如果沒有傳遞端口，而主機(jī)字符串是以 host:port 的形式，則會提取出端口值，否則將使用默認(rèn)的 8- 端口。

如果給定了可選參數(shù) timeout ，阻塞操作將會在給定的時間后超時，若未給定，則使用默認(rèn)的全局 timeout 設(shè)置。

可選參數(shù) source_address 應(yīng)該以 host 和 port 的元組形式 (host,port)，用來作為 HTTP 連接的源地址。

示例代碼如下：

>>> h1 = http.client.HTTPConnection('www.python.org')
>>> h2 = http.client.HTTPConnection('www.python.org:80')>>> h3 = http.client.HTTPConnection('www.python.org', 80)
>>> h4 = http.client.HTTPConnection('www.python.org', 80, timeout=10)

source_address 是在 3.2 版本中添加的。

strict 參數(shù)在 3.4 版本中移除了。

HTTPSConnection 類

HTTPSConnection(host, port=None, key_file=None, cert_file=None, [timeout, ]source_address=None, *, context=None, check_hostname=None)

HTTPSConnection 是 HTTPConnection 的子類，使用 SSL 與安全服務(wù)器聯(lián)系。

默認(rèn)的端口是 443 端口。如果指定了 context ，必須是 ssl.SSLContext 類的實(shí)例來描述不同的 SSL 選項(xiàng)。

key_file 和 cert_file 已經(jīng)被棄用了，取而代之的是 ssl.SSLContext.load_cert_chain() ?；蛘呤褂?ssl.create_default_context() 選擇系統(tǒng)信任的 CA 證書。

check_hostname 參數(shù)也被棄用了，使用 context 的 ssl.SSLContext.check_hostname 屬性。

HTTPResponse 類

class http.client.HTTPResponse(sock, debuglevel=0, method=None, url=None)

一旦連接成功就會返回該實(shí)例，該類的對象不能由用戶直接實(shí)例化。

HTTPMessage 類

HTTPMessage 實(shí)例持有從 HTTP response 返回的頭部。

異常類

HTTPException 類

Exception 類的子類，也是 http 模塊中其他異常類的基類。
其他異常類：

• NotConnected
• InvalidURL
• UnknownProtocol
• UnknownTransferEncoding
• UnimplementedFileMode
• IncompletedRead
• ImproperConnectionState
• BadStatusLine
• LineTooLong
• CannotSendRequest
• CannotSendHeader
• ResponseNotReady
• RemoteDisconnected
  

類方法

HTTPConnection 對象方法

HTTPConnection 實(shí)例有如下的方法 ：

1、HTTPConnection.request(method, url, body=None, headers={})

使用指定的 method 方法和 url 鏈接向服務(wù)器發(fā)送請求。

如果指定 了body 部分，那么 body 部分將在 header 部分發(fā)送完之后發(fā)送過去。body 部分可以是一個字符串、字節(jié)對象、文件對象或者是字節(jié)對象的迭代器。不同的 body 類型對應(yīng)不同的要求。

header 參數(shù)應(yīng)該是 HTTP 頭部的映射，是一個字典類型。

如果 header 中不包含 Content-Length 項(xiàng)，那么會根據(jù) body 的不同來自動添加上去。

2、HTTPConnection.getresponse()

必須在請求發(fā)送后才能調(diào)用得到服務(wù)器返回的內(nèi)容，返回的是一個 HTTPResponse 實(shí)例。

3、HTTPConnection.set_debuglevel(level)

設(shè)置調(diào)試級別，默認(rèn)調(diào)試級別是 0 ，意味著沒有調(diào)試輸出。

4、HTTPConnection.set_tunnel(host, port=None, headers=None)

設(shè)置 HTTP 隧道鏈接的主機(jī)和端口，這允許連接使用代理服務(wù)器。

5、HTTPConnection.connect()

連接指定的服務(wù)器。默認(rèn)情況下，如果客戶端沒有連接，則會在 request 請求時自動調(diào)用該方法。

6、HTTPConnection.close()

關(guān)閉鏈接。

7、HTTPConnection.putrequest(request, selector, skip_host=False, skip_accept_encoding=False)

當(dāng)和服務(wù)器的鏈接成功后，應(yīng)當(dāng)首先調(diào)用該方法。

發(fā)送到服務(wù)器的內(nèi)容包括：request 字符串、selector 字符串和 HTTP 協(xié)議版本。

8、HTTPConnection.putheader(header, argument[, …])

發(fā)送 HTTP 頭部到服務(wù)器。

發(fā)送到服務(wù)器的內(nèi)容包括：header 頭部、冒號、空格和參數(shù)列表里的第一個。

9、HTTPConnection.endheaders(message_body=None)

發(fā)送一個空白行到服務(wù)器，標(biāo)識頭部的結(jié)束。

10、HTTPConnection.send(data)

發(fā)送數(shù)據(jù)到服務(wù)器。

應(yīng)該在 endheaders() 方法之后和在 getresponse() 方法之前調(diào)用。

HTTPResponse 對象方法

HTTPResponse 實(shí)例包含了從服務(wù)器返回的 HTTP 回應(yīng)。

它提供了訪問請求頭部和 body 部分的方法。

HTTPResponse 是一個可迭代的對象而且可以使用 with 語句來聲明。

HTTPResponse 實(shí)例有如下的方法 ：

1、HTTPResponse.read([amt])

讀取和返回 response 的 body 部分。

2、HTTPResponse.readinto(b)

讀取指定的字節(jié)長度 len(b)，并返回到緩沖字節(jié) b 。

函數(shù)返回讀取的字節(jié)數(shù)

3、HTTPResponse.getheader(name,default=None)

返回指定名稱 name 的 HTTP 頭部值，如果沒有相應(yīng)匹配的 name 值，則返回默認(rèn)的 None。如果有多個相匹配的，則返回所有的值，以逗號分隔。

4、HTTPResponse.getheaders()

以元組的形式返回所有的頭部信息 (header,value)。

5、HTTPResponse.fileno()

6、HTTPResponse.msg

7、HTTPResponse.version。

HTTP 協(xié)議版本

8、HTTPResponse.status

HTTP 狀態(tài)碼

9、HTTPResponse.reason

10、HTTPResponse.debuglevel

11、HTTPResponse.closed

如果為 True ，說明連接已關(guān)閉。

示例

import http.client
import urllib,parser
# # 初始化一個 https 鏈接
conn = http.client.HTTPSConnection("www.python.org")
# 指定 request 請求的方法和請求的鏈接地址
conn.request("GET","/doc/")
# 得到返回的 http response
r1 = conn.getresponse()
# HTTP 狀態(tài)碼
print(r1.status,r1.reason)
# HTTP 頭部
print(r1.getheaders())
# body 部分
print(r1.read())
# 如果連接沒有關(guān)閉,打印輸出前 200 個字節(jié)
if not r1.closed:
 print(r1.read(200))
# 關(guān)閉連接后才能重新請求
conn.close()
# 請求一個不存在的文件或地址
conn.request("GET","/parrot.spam")
r2 = conn.getresponse()
print(r2.status,r2.reason)
conn.close()
# 使用 HEAD 請求,但是不會返回任何數(shù)據(jù)
conn = http.client.HTTPSConnection("www.python.org")
conn.request("HEAD","/")
res = conn.getresponse()
print(res.status,res.reason)
data = res.read()
print(len(data))
conn.close()
# 使用 POST 請求,提交的數(shù)據(jù)放在 body 部分
params = urllib.parse.urlencode({'@number':12524,'@type':'issue','@action':'show'})
# post 請求數(shù)據(jù),要帶上 Content-type 字段,以告知消息主體以何種方式編碼
headers = {"Content-type":"application/x-www-form-urlencoded","Accept":"text/plain"}
conn = http.client.HTTPConnection("bugs.python.org")
conn.request("POST","/",params,headers)
response = conn.getresponse()
# 訪問被重定向
print(response.status,response.reason)
print(response.read().decode("utf-8"))
conn.close()

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對大家學(xué)習(xí)或者使用python能帶來一定的幫助，如果有疑問大家可以留言交流，謝謝大家對腳本之家的支持。

最新評論