django-QueryDict 對象

　　在 HttpRequest 對象中,屬性 GET 和 POST 獲得的都是 django.http.QueryDict 所建立的實例。這是一個 django 自定義的相似字典的類，用來處理同一個鍵帶多個值的狀況。

　　在 python 原始的字典中，當一個鍵出現多個值的時候會發生衝突，只保留最後一個值。而在 HTML 表單中，一般會發生一個鍵有多個值的狀況，例如 <select multiple> （多選框）就是一個很常見狀況。

　　request.POST 和request.GET 的QueryDict 在一個正常的請求/響應循環中是不可變的。若要得到可變的版本，須要使用.copy()方法。

　　下面咱們來看這個類中有什麼方法：

1.QueryDict.__init__(query_string=None, mutable=False, encoding=None)

　　這是一個構造函數，其中 query_string 須要一個字符串，例如：

>>> QueryDict('a=1&a=2&c=3')
<QueryDict: {'a': ['1', '2'], 'c': ['3']}>

 

　　若是 query_string 沒有傳入，則得到一個空的對象。

　　你所遇到的 QueryDict 對象，特別是 request.POST 和 request.GET 獲得的。若是你想本身實例化一個對象，能夠傳遞 mutable=True 使你所實例化的對象可變。固然 request.POST 和 request.GET 是django建立的，也就是說除非改 django 源碼，不然它們是不可變的。

　　對於設置的鍵和值，會從 encoding 轉碼成 Unicode。也就是說，若是傳入的字符串 query_string  是 GBK 或者是 utf-8 的編碼，將會自動轉碼成 Unicode，而後用作字典的鍵和值。若是 encoding = None，也就是沒有設定的話，將使用 DEFAULT_CHARSET 的值，默認爲：'utf-8'。

2.QueryDict.__getitem__(key)

　　返回給出的 key 的值。若是key 具備多個值，__getitem__() 返回最後（最新）的值。若是 key 不存在，則引起django.utils.datastructures.MultiValueDictKeyError。（它是Python 標準KeyError 的一個子類，因此你仍然能夠堅持捕獲KeyError。） 

 

3.QueryDict.__setitem__(key, value)

　　設置給出的 key 的值爲[value]（一個Python 列表，只有一個元素 value）。注意：只有對象是能夠改變的時候才能使用，例如經過 .copy() 方法建立的對象。

 

4.QueryDict.__contains__(key)

　　若是給出的key 已經設置，則返回True。它讓你能夠作 if "foo" in request.GET  這樣的操做。

 

5.QueryDict.get(key, default)

　　使用與上面__getitem__() 相同的邏輯，可是當key 不存在時返回一個默認值。

 

6.QueryDict.setdefault(key, default)

　　相似標準字典的setdefault() 方法，只是它在內部使用的是__setitem__()。也就是說，當key已經存在時，返回其值，key不存在時，返回default，同時添加 key 和 default到對象中。

 

7.QueryDict.update(other_dict)

　　接收一個QueryDict 或標準字典。相似標準字典的update() 方法，可是它附加到當前字典項的後面，而不是替換掉它們。

例如：

>>> q = QueryDict('a=1', mutable=True)    # 固然要可變的才能使用
>>> q.update({'a': '2'})
>>> q.getlist('a')
['1', '2']
>>> q['a'] # returns the last
['2']

 

 

8.QueryDict.items()

　　相似標準字典的items() 方法，返回一個由鍵值組成的元祖的列表。可是它使用的是和__getitem__ 同樣返回最新的值的邏輯。

例如：

>>> q = QueryDict('a=1&a=2&a=3')
>>> q.items()
[('a', '3')]

 

 

9.QueryDict.iteritems()

　　相似標準字典的iteritems() 方法，返回一個迭代對象。相似 QueryDict.items()，它使用的是和QueryDict.__getitem__() 同樣的返回最新的值的邏輯。

 

10.QueryDict.iterlists()

　　相似QueryDict.iteritems()，返回一個包含鍵值對的元祖(key, value)迭代對象 ，value 是一個包括全部 key 的值的列表。

 

11.QueryDict.values()

　　相似標準字典的values() 方法，可是它使用的是和__getitem__ 同樣返回最新的值的邏輯。也就是返回一個全部鍵對應的最新值的列表。

例如：

>>> q = QueryDict('a=1&a=2&a=3')
>>> q.values()
['3']

 

 

12.QueryDict.itervalues()

　　相似QueryDict.values()，只是它返回的是一個迭代器。

 

13.QueryDict.copy()

　　返回對象的副本，使用Python 標準庫中的copy.deepcopy()。此副本是可變的即便原始對象是不可變的。

 

14.QueryDict.getlist(key, default)

　　以Python 列表形式返回所請求的鍵的數據。若是鍵不存在而且沒有提供默認值，則返回空列表。它保證返回的是某種類型的列表，除非默認值不是列表。

 

15.QueryDict.setlist(key, list_)

　　爲給定的鍵設置list_（與__setitem__() 不一樣)，能夠設置一個多元素的列表。

 

16.QueryDict.appendlist(key, item)

　　將項追加到內部與鍵相關聯的列表中。

 

17.QueryDict.setlistdefault(key, default_list)

　　相似setdefault，除了它接受一個列表而不是單個值。

 

18.QueryDict.lists()

　　相似items，只是它將字典中的每一個成員做爲列表。也就是說，列表中的每一個元素，都是由鍵和對應的值列表組成的二元元祖。

例如：

>>> q = QueryDict('a=1&a=2&a=3')
>>> q.lists()
[('a', ['1', '2', '3'])]

 

 

19.QueryDict.pop(key)

　　返回給定鍵的值的列表，並從字典中移除它們。若是鍵不存在，將引起KeyError。

例如 ︰

>>> q = QueryDict('a=1&a=2&a=3', mutable=True)
>>> q.pop('a')
['1', '2', '3']

 

 

20.QueryDict.popitem()

　　刪除字典任意一個成員（由於沒有順序的概念），並返回二值元組，包含鍵和鍵的全部值的列表。在一個空的字典上調用時將引起KeyError。

例如 ︰

>>> q = QueryDict('a=1&a=2&a=3', mutable=True)
>>> q.popitem()
('a', ['1', '2', '3'])

 

 

21.QueryDict.dict()

　　返回QueryDict 的dict 表示形式。對於QueryDict 中的每一個(key, list)對 ，dict 將有(key, item) 對，其中item 是列表中的一個元素，使用與QueryDict.__getitem__()相同的邏輯，也就是最新的：

>>> q = QueryDict('a=1&a=3&a=5')
>>> q.dict()
{'a': '5'}

 

 

22.QueryDict.urlencode([safe])

　　從數據中返回查詢字符串格式。

例如：

>>> q = QueryDict('a=2&b=3&b=5')
>>> q.urlencode()
'a=2&b=3&b=5'

 

　　可選地，urlencode 能夠傳遞不須要編碼的字符。（這意味着要進行 url 編碼）

例如︰

>>> q = QueryDict(mutable=True)
>>> q['next'] = '/a&b/'
>>> q.urlencode(safe='/')
'next=/a%26b/'