由于 HTTP 是無(wú)狀態(tài)的協(xié)議帝火,同一個(gè)客戶端每個(gè)請(qǐng)求都是獨(dú)立的呛谜,上一個(gè)請(qǐng)求的任意數(shù)據(jù)都無(wú)法傳遞到下一個(gè)請(qǐng)求溶诞。為了在不同的請(qǐng)求間保存一些共同的數(shù)據(jù)(比如登錄狀態(tài)),就會(huì)用到 cookie拧篮、 session词渤。
在 requests 中要處理這種 cookie 和 session,需要用到 Session 對(duì)象(會(huì)話對(duì)象)串绩。此對(duì)象會(huì)幫助我們自動(dòng)保持類似 cookie 和 session掖肋。
這樣不用我們專門處理 cookie 和 session。畢竟我們測(cè)試的絕大部分接口赏参,都會(huì)依賴登錄后在 cookie 和 session 中儲(chǔ)存的登錄認(rèn)證信息。
通過(guò)我們的 showdoc 系統(tǒng)來(lái)演示一下:
- 登錄 showdoc
- 查看當(dāng)前用戶的項(xiàng)目列表
from urllib import parse
from pprint import pprint # => 為了讓字典打印更好看
import requests
host = 'http://127.0.0.1'
user = {
'username': 'showdoc',
'password':'123456'
}
s = requests.Session() # => 會(huì)話對(duì)象
# 登錄
login_url = parse.urljoin(host, '/showdoc/server/index.php?s=/api/user/login')
lr = s.post(login_url, data=user) # => 登錄后cookie和session都會(huì)被 s 對(duì)象保存
pprint(lr.json())
# 查看當(dāng)前用戶項(xiàng)目
mylist_url = parse.urljoin(host, '/showdoc/server/index.php?s=/api/item/myList')
mr = s.get(mylist_url) # => 通過(guò) s 對(duì)象調(diào)用后續(xù)的請(qǐng)求
pprint(mr.json())
從上面的代碼我們可以看出沿盅,先通過(guò) Session 生成會(huì)話對(duì)象把篓,通過(guò)會(huì)話對(duì)象調(diào)用 get 或者 post 方法完成請(qǐng)求。會(huì)話對(duì)象會(huì)保存這些請(qǐng)求之間的 cookie 和 session腰涧。
如果不信韧掩,你可以試試直接訪問(wèn)mylist
接口。然后再試試使用會(huì)話對(duì)象訪問(wèn)窖铡。
會(huì)話對(duì)象讓你能夠跨請(qǐng)求保持某些參數(shù)疗锐。它也會(huì)在同一個(gè) Session 實(shí)例發(fā)出的所有請(qǐng)求之間保持 cookie坊谁, 期間使用 urllib3 的 connection pooling 功能。所以如果你向同一主機(jī)發(fā)送多個(gè)請(qǐng)求滑臊,底層的 TCP 連接將會(huì)被重用口芍,從而帶來(lái)顯著的性能提升。
會(huì)話對(duì)象具有主要的 Requests API 的所有方法雇卷。