Cookie 對象?

BaseCookie.value_decode(val)?

由字符串返回元組 (real_value, coded_value)。real_value 可為任意類(lèi)型。BaseCookie 中的此方法未實(shí)現任何解碼工作——只為能被子類(lèi)重寫(xiě)。

BaseCookie.value_encode(val)?

返回元組 (real_value, coded_value)。val 可為任意類(lèi)型，coded_value 則會(huì )轉換為字符串。 BaseCookie 中的此方法未實(shí)現任何編碼工作——只為能被子類(lèi)重寫(xiě)。

通常在 value_decode 的取值范圍內，value_encode() 和 value_decode() 應為可互逆操作。

BaseCookie.output(attrs=None, header='Set-Cookie:', sep='\r\n')?

返回可作為 HTTP 標頭信息發(fā)送的字符串表示。 attrs 和 header 會(huì )傳給每個(gè) Morsel 的 output() 方法。 sep 用來(lái)將標頭連接在一起，默認為 '\r\n' (CRLF) 組合。

BaseCookie.js_output(attrs=None)?

返回一段可供嵌入的 JavaScript 代碼，若在支持 JavaScript 的瀏覽器上運行，其作用如同發(fā)送 HTTP 頭部信息一樣。

attrs 的含義與 output() 的相同。

BaseCookie.load(rawdata)?

若 rawdata 為字符串，則會(huì )作為 HTTP_COOKIE 進(jìn)行解析，并將找到的值添加為 Morsel。 如果是字典值，則等價(jià)于:

for k, v in rawdata.items():
    cookie[k] = v

Morsel 對象?

class http.cookies.Morsel?

對鍵/值對的抽象，帶有 RFC 2109 的部分屬性。

morsel 對象類(lèi)似于字典，鍵的組成是常量——均為有效的 RFC 2109 屬性，包括：

• expires

• path

• comment

• domain

• max-age

• secure

• version

• httponly

• samesite

httponly 屬性指明了該 cookie 僅在 HTTP 請求中傳輸，且不能通過(guò) JavaScript 訪(fǎng)問(wèn)。這是為了減輕某些跨站腳本攻擊的危害。

samesite 屬性指明了瀏覽器不得與跨站請求一起發(fā)送該 cookie。這有助于減輕 CSRF 攻擊的危害。此屬性的有效值為 “Strict”和“Lax”。

鍵不區分大小寫(xiě)，默認值為 ''。

在 3.5 版更改: 現在，__eq__() 會(huì )同時(shí)考慮 key 和 value 。

在 3.7 版更改: Attributes key, value and coded_value are read-only. Use set() for setting them.

在 3.8 版更改: 增加對 samesite 屬性的支持。

Morsel.value?

Cookie的值。

Morsel.coded_value?

編碼后的 cookie 值——也即要發(fā)送的內容。

Morsel.key?

cookie 名稱(chēng)

Morsel.set(key, value, coded_value)?

設置 key、value 和 coded_value 屬性。

Morsel.isReservedKey(K)?

判斷 K 是否屬于 Morsel 的鍵。

Morsel.output(attrs=None, header='Set-Cookie:')?

返回 morsel 的字符串形式，適用于作為 HTTP 頭部信息進(jìn)行發(fā)送。默認包含所有屬性，除非給出 attrs 屬性列表。header 默認為 "Set-Cookie:"。

Morsel.js_output(attrs=None)?

返回一段可供嵌入的 JavaScript 代碼，若在支持 JavaScript 的瀏覽器上運行，其作用如同發(fā)送 HTTP 頭部信息一樣。

attrs 的含義與 output() 的相同。

Morsel.OutputString(attrs=None)?

返回 morsel 的字符串形式，不含 HTTP 或 JavaScript 數據。

attrs 的含義與 output() 的相同。

Morsel.update(values)?

用字典 values 中的值更新 morsel 字典中的值。若有 values 字典中的鍵不是有效的 RFC 2109 屬性，則會(huì )觸發(fā)錯誤。

在 3.5 版更改: 無(wú)效鍵會(huì )觸發(fā)錯誤。

Morsel.copy(value)?

返回 morsel 對象的淺表復制副本。

在 3.5 版更改: 返回一個(gè) morsel 對象，而非字典。

Morsel.setdefault(key, value=None)?

若 key 不是有效的 RFC 2109 屬性則觸發(fā)錯誤，否則與 dict.setdefault() 相同。

示例?

以下例子演示了 http.cookies 模塊的用法。

>>> from http import cookies
>>> C = cookies.SimpleCookie()
>>> C["fig"] = "newton"
>>> C["sugar"] = "wafer"
>>> print(C) # generate HTTP headers
Set-Cookie: fig=newton
Set-Cookie: sugar=wafer
>>> print(C.output()) # same thing
Set-Cookie: fig=newton
Set-Cookie: sugar=wafer
>>> C = cookies.SimpleCookie()
>>> C["rocky"] = "road"
>>> C["rocky"]["path"] = "/cookie"
>>> print(C.output(header="Cookie:"))
Cookie: rocky=road; Path=/cookie
>>> print(C.output(attrs=[], header="Cookie:"))
Cookie: rocky=road
>>> C = cookies.SimpleCookie()
>>> C.load("chips=ahoy; vienna=finger") # load from a string (HTTP header)
>>> print(C)
Set-Cookie: chips=ahoy
Set-Cookie: vienna=finger
>>> C = cookies.SimpleCookie()
>>> C.load('keebler="E=everybody; L=\\"Loves\\"; fudge=\\012;";')
>>> print(C)
Set-Cookie: keebler="E=everybody; L=\"Loves\"; fudge=\012;"
>>> C = cookies.SimpleCookie()
>>> C["oreo"] = "doublestuff"
>>> C["oreo"]["path"] = "/"
>>> print(C)
Set-Cookie: oreo=doublestuff; Path=/
>>> C = cookies.SimpleCookie()
>>> C["twix"] = "none for you"
>>> C["twix"].value
'none for you'
>>> C = cookies.SimpleCookie()
>>> C["number"] = 7 # equivalent to C["number"] = str(7)
>>> C["string"] = "seven"
>>> C["number"].value
'7'
>>> C["string"].value
'seven'
>>> print(C)
Set-Cookie: number=7
Set-Cookie: string=seven