在 HttpRequest 對象中,屬性 GET 和 POST 得到的都是 django.http.QueryDict 所創建的實例。這是一個 django 自定義的類似字典的類,用來處理同一個鍵帶多個值的情況。 在 python 原始的字典中,當一個鍵出現多個值的時候會發生衝突,只保留最後一個值。 ...
在 HttpRequest 對象中,屬性 GET 和 POST 得到的都是 django.http.QueryDict 所創建的實例。這是一個 django 自定義的類似字典的類,用來處理同一個鍵帶多個值的情況。
在 python 原始的字典中,當一個鍵出現多個值的時候會發生衝突,只保留最後一個值。而在 HTTL 表單中,通常會發生一個鍵有多個值的情況,例如 <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/'