HTTPConnection 對象?

HTTPConnection 實(shí)例擁有以下方法：

HTTPConnection.request(method, url, body=None, headers={}, *, encode_chunked=False)?

這會(huì )使用 HTTP 請求方法 method 和選擇器 url 向服務(wù)器發(fā)送請求。

如果給定 body，那么給定的數據會(huì )在信息頭完成之后發(fā)送。它可能是一個(gè) 字符串，一個(gè) bytes-like object，一個(gè)打開(kāi)的 file object，或者 bytes 迭代器。如果 body 是字符串，它會(huì )按 HTTP 默認的 ISO-8859-1 編碼。如果是一個(gè)字節類(lèi)對象，它會(huì )按原樣發(fā)送。如果是 file object，文件的內容會(huì )被發(fā)送，這個(gè)文件對象應該至少支持``read()`` 方法。如果這個(gè)文件對象是一個(gè) io.TextIOBase 實(shí)例，由 read() 方法返回的數據會(huì )按 ISO-8859-1 編碼，否則由 read() 方法返回的數據會(huì )按原樣發(fā)送。如果 body 是一個(gè)迭代器，迭代器中的元素會(huì )被發(fā)送，直到迭代器耗盡。

headers 參數應是額外的隨請求發(fā)送的 HTTP 信息頭的字典。

如果 headers 既不包含 Content-Length 也沒(méi)有 Transfer-Encoding，但存在請求正文，那么這些頭字段中的一個(gè)會(huì )自動(dòng)設定。如果 body 是 None，那么對于要求正文的方法 (PUT，POST，和 PATCH)，Content-Length 頭會(huì )被設為 0。如果 body 是字符串或者類(lèi)似字節的對象，并且也不是 文件，Content-Length 頭會(huì )設為正文的長(cháng)度。任何其他類(lèi)型的 body （一般是文件或迭代器）會(huì )按塊編碼，這時(shí)會(huì )自動(dòng)設定 Transfer-Encoding 頭以代替 Content-Length。

在 headers 中指定 Transfer-Encoding 時(shí)， encode_chunked 是唯一相關(guān)的參數。如果 encode_chunked 為 False，HTTPConnection 對象會(huì )假定所有的編碼都由調用代碼處理。如果為 True，正文會(huì )按塊編碼。

備注

HTTP 協(xié)議在 1.1 版中添加了塊傳輸編碼。除非明確知道 HTTP 服務(wù)器可以處理 HTTP 1.1，調用者要么必須指定 Content-Length，要么必須傳入 str 或字節類(lèi)對象，注意該對象不能是表達 body 的文件。

3.2 新版功能: body 現在可以是可迭代對象了。

在 3.6 版更改: 如果 Content-Length 和 Transfer-Encoding 都沒(méi)有在 headers 中設置，文件和可迭代的 body 對象現在會(huì )按塊編碼。添加了 encode_chunked 參數。不會(huì )嘗試去確定文件對象的 Content-Length。

HTTPConnection.getresponse()?

應當在發(fā)送一個(gè)請求從服務(wù)器獲取響應時(shí)被調用。 返回一個(gè) HTTPResponse 的實(shí)例。

備注

請注意你必須在讀取了整個(gè)響應之后才能向服務(wù)器發(fā)送新的請求。

在 3.5 版更改: 如果引發(fā)了 ConnectionError 或其子類(lèi)， HTTPConnection 對象將在發(fā)送新的請求時(shí)準備好重新連接。

HTTPConnection.set_debuglevel(level)?

設置調試等級。 默認的調試等級為 0，意味著(zhù)不會(huì )打印調試輸出。 任何大于 0 的值將使得所有當前定義的調試輸出被打印到 stdout。 debuglevel 會(huì )被傳給任何新創(chuàng )建的 HTTPResponse 對象。

3.1 新版功能.

HTTPConnection.set_tunnel(host, port=None, headers=None)?

為 HTTP 連接隧道設置主機和端口。 這將允許通過(guò)代理服務(wù)器運行連接。

host 和 port 參數指明隧道連接的位置（即 CONNECT 請求所包含的地址，而 不是 代理服務(wù)器的地址）。

headers 參數應為一個(gè)隨 CONNECT 請求發(fā)送的額外 HTTP 標頭的映射。

例如，要通過(guò)一個(gè)運行于本機 8080 端口的 HTTPS 代理服務(wù)器隧道，我們應當向 HTTPSConnection 構造器傳入代理的地址，并將我們最終想要訪(fǎng)問(wèn)的主機地址傳給 set_tunnel() 方法:

>>>

>>> import http.client
>>> conn = http.client.HTTPSConnection("localhost", 8080)
>>> conn.set_tunnel("www.python.org")
>>> conn.request("HEAD","/index.html")

3.2 新版功能.

HTTPConnection.connect()?

當對象被創(chuàng )建后連接到指定的服務(wù)器。 默認情況下，如果客戶(hù)端還未建立連接，此函數會(huì )在發(fā)送請求時(shí)自動(dòng)被調用。

觸發(fā) 音頻事件 http.client.connect ，帶有 self 、host 、port 參數。

HTTPConnection.close()?

關(guān)閉到服務(wù)器的連接。

HTTPConnection.blocksize?

用于發(fā)送文件類(lèi)消息體的緩沖區大小。

3.7 新版功能.

作為對使用上述 request() 方法的替代同，你也可以通過(guò)使用下面的四個(gè)函數，分步驟發(fā)送請的請求。

HTTPConnection.putrequest(method, url, skip_host=False, skip_accept_encoding=False)?

應為連接服務(wù)器之后首先調用的函數。將向服務(wù)器發(fā)送一行數據，包含 method 字符串、url 字符串和 HTTP 版本（HTTP/1.1）。若要禁止自動(dòng)發(fā)送 Host: 或 Accept-Encoding: 頭部信息（比如需要接受其他編碼格式的內容），請將 skip_host 或 skip_accept_encoding 設為非 False 值。

HTTPConnection.putheader(header, argument[, ...])?

向服務(wù)器發(fā)送一個(gè) RFC 822 格式的頭部。將向服務(wù)器發(fā)送一行由頭、冒號和空格以及第一個(gè)參數組成的數據。 如果還給出了其他參數，將在后續行中發(fā)送，每行由一個(gè)制表符和一個(gè)參數組成。

HTTPConnection.endheaders(message_body=None, *, encode_chunked=False)?

向服務(wù)器發(fā)送一個(gè)空行，表示頭部文件結束?？蛇x的 message_body 參數可用于傳入一個(gè)與請求相關(guān)的消息體。

如果 encode_chunked 為 True，則對 message_body 的每次迭代結果將依照 RFC 7230 3.3.1 節的規范進(jìn)行分塊編碼。數據如何編碼取決于 message_body 的類(lèi)型。 如果 message_body 實(shí)現了 buffer 接口，編碼將生成一個(gè)數據塊。如果 message_body 是 collections.abc.Iterable，則 message_body 的每次迭代都會(huì )產(chǎn)生一個(gè)塊。 如果 message_body 為 file object，那么每次調用 .read() 都會(huì )產(chǎn)生一個(gè)數據塊。在 message_body 結束后，本方法立即會(huì )自動(dòng)標記分塊編碼數據的結束。

備注

由于分塊編碼的規范要求，迭代器本身產(chǎn)生的空塊將被分塊編碼器忽略。這是為了避免目標服務(wù)器因錯誤編碼而過(guò)早終止對請求的讀取。

3.6 新版功能: 支持分塊編碼。加入了 encode_chunked 參數。

HTTPConnection.send(data)?

發(fā)送數據到服務(wù)器。本函數只應在調用 endheaders() 方法之后且調用 getresponse() 之前直接調用。

觸發(fā) 音頻事件 http.client.send，參數為 self、data。

HTTPResponse 對象?

HTTPResponse 實(shí)例封裝了來(lái)自服務(wù)器的 HTTP 響應。通過(guò)它可以訪(fǎng)問(wèn)請求頭和響應體。響應是可迭代對象，可在 with 語(yǔ)句中使用。

HTTPResponse.read([amt])?

讀取并返回響應體，或后續 amt 個(gè)字節。

HTTPResponse.readinto(b)?

讀取響應體的后續 len(b) 個(gè)字節到緩沖區 b。返回讀取的字節數。

3.3 新版功能.

HTTPResponse.getheader(name, default=None)?

返回頭部信息中的 name 值，如果沒(méi)有與 name 匹配的字段，則返回*default*。如果名為 name 的字段不止一個(gè)，則返回所有字段，中間用 ', ' 連接。 如果 'default' 不是單個(gè)字符串，而是其他可迭代對象，則其元素同樣以逗號連接并返回。

HTTPResponse.getheaders()?

返回 (header, value) 元組構成的列表。

HTTPResponse.fileno()?

返回底層套接字的 fileno。

HTTPResponse.msg?

包含響應頭的 http.client.HTTPMessage 實(shí)例。http.client.HTTPMessage 是 email.message 的子類(lèi)。

HTTPResponse.version?

服務(wù)器采用的 HTTP 協(xié)議版本。10 代表 HTTP/1.0，11 代表 HTTP/1.1。

HTTPResponse.url?

已讀取資源的 URL，通常用于確定是否進(jìn)行了重定向。

HTTPResponse.headers?

響應的頭部信息，形式為 email.message.EmailMessage 的實(shí)例。

HTTPResponse.status?

由服務(wù)器返回的狀態(tài)碼。

HTTPResponse.reason?

服務(wù)器返回的原因短語(yǔ)。

HTTPResponse.debuglevel?

一個(gè)調試鉤子。如果 debuglevel 大于零，狀態(tài)信息將在讀取和解析響應數據時(shí)打印輸出到 stdout。

HTTPResponse.closed?

如果流被關(guān)閉，則為``True``。

HTTPResponse.geturl()?

3.9 版后已移除: 已棄用，建議用 url。

HTTPResponse.info()?

3.9 版后已移除: 已棄用，建議用 headers。

HTTPResponse.getstatus()?

3.9 版后已移除: 已棄用，建議用 status 。

例子?

下面是使用 GET 方法的會(huì )話(huà)示例：

>>> import http.client
>>> conn = http.client.HTTPSConnection("www.python.org")
>>> conn.request("GET", "/")
>>> r1 = conn.getresponse()
>>> print(r1.status, r1.reason)
200 OK
>>> data1 = r1.read()  # This will return entire content.
>>> # The following example demonstrates reading data in chunks.
>>> conn.request("GET", "/")
>>> r1 = conn.getresponse()
>>> while chunk := r1.read(200):
...     print(repr(chunk))
b'<!doctype html>\n<!--[if"...
...
>>> # Example of an invalid request
>>> conn = http.client.HTTPSConnection("docs.python.org")
>>> conn.request("GET", "/parrot.spam")
>>> r2 = conn.getresponse()
>>> print(r2.status, r2.reason)
404 Not Found
>>> data2 = r2.read()
>>> conn.close()

以下是使用 HEAD 方法的會(huì )話(huà)示例。 請注意，HEAD 方法從不返回任何數據。

>>> import http.client
>>> conn = http.client.HTTPSConnection("www.python.org")
>>> conn.request("HEAD", "/")
>>> res = conn.getresponse()
>>> print(res.status, res.reason)
200 OK
>>> data = res.read()
>>> print(len(data))
0
>>> data == b''
True

下面是用 POST 發(fā)送請求的會(huì )話(huà)示例：

>>> import http.client, urllib.parse
>>> params = urllib.parse.urlencode({'@number': 12524, '@type': 'issue', '@action': 'show'})
>>> 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)
302 Found
>>> data = response.read()
>>> data
b'Redirecting to <a 
>>> conn.close()

在客戶(hù)端， HTTP PUT 請求與 POST 請求非常相似。區別只在于服務(wù)器端，HTTP 服務(wù)器將允許通過(guò) PUT 請求創(chuàng )建資源。應該注意的是，自定義的 HTTP 方法也可以在 urllib.request.Request 中通過(guò)設置適當的方法屬性來(lái)進(jìn)行處理。下面是一個(gè)會(huì )話(huà)示例，演示了如何利用 http.client 發(fā)送 PUT 請求。

>>> # This creates an HTTP message
>>> # with the content of BODY as the enclosed representation
>>> # for the resource http://localhost:8080/file
...
>>> import http.client
>>> BODY = "***filecontents***"
>>> conn = http.client.HTTPConnection("localhost", 8080)
>>> conn.request("PUT", "/file", BODY)
>>> response = conn.getresponse()
>>> print(response.status, response.reason)
200, OK

HTTPMessage 對象?

http.client.HTTPMessage 的實(shí)例存有 HTTP 響應的頭部信息。利用 email.message.Message 類(lèi)實(shí)現。