#先來歸納一下整個流程 #(1)首先is_valid()起手,看seld.errors中是否值,只要有值就是flase #(2)接着分析errors.里面判斷_errors是都為空,如果為空返回self.full_clean(),否則返回self._errors #(3)現在就要看full_clean(),是何方神聖了,里面設置_errors和cleaned_data這兩個字典,一個存錯誤字段,一個存儲正確字段。 #(4)在full_clean最后有一句self._clean_fields(),表示校驗字段 #(5)在_clean_fields函數中開始循環校驗每個字段,真正校驗字段的是field.clean(value),怎么校驗的不管 #(6)在_clean_fields中可以看到,會將字段分別添加到_errors和cleaned_data這兩個字典中 #(7)結尾部分還設置了鈎子,找clean_XX形式的,有就執行。執行錯誤信息也會添加到_errors中 #(8)整個校驗過程完成
#下面分析form組件中is_valid校驗的流程 #在分析過程中重點關注_erroes和clean_data這兩個字典 def login(request): if request.method == "POST": form_obj = LoginForm(request.POST) if form_obj.is_valid(): #如果檢驗全部通過 print(form_obj.clean_data) #這里全部都沒問題 return HttpResponse("你好,歡迎回來!") else: #print(form_obj.clean_data) #print(form_obj.errors) return render(request, "login.html", {"form_obj": form_obj,) form_obj = LoginForm() return render(request, "login.html", {"form_obj": form_obj})
#鈎子代碼實例 def clean_user(self): val1 = self.cleaned_data.get("user") #從正確的字段字典中取值 #如果這個字符串全部都是由數組組成 if not val1.isdigit(): return val1 else: # 注意這個報錯信息已經確定了 raise ValidationError("用戶名不能全部是數字組成") #在校驗的循環中except ValidationError as e:,捕捉的就是這個異常 #所以能將錯誤信息添加到_errors中
#代碼分析部分 def is_valid(self): """ Returns True if the form has no errors. Otherwise, False. If errors are being ignored, returns False. 如果表單沒有錯誤,則返回true。否則為假。如果錯誤是被忽略,返回false。 """ return self.is_bound and not self.errors #is_bound默認有值 #只要self.errors中有一個值,not True = false,返回的就是false def errors(self): """ Returns an ErrorDict for the data provided for the form 返回一個ErrorDict在form表單存在的前提下 """ if self._errors is None: self.full_clean() return self._errors def full_clean(self): """ Cleans all of self.data and populates self._errors and self.cleaned_data. 清除所有的self.data和本地的self._errors和selif.cleaned_data """ self._errors = ErrorDict() if not self.is_bound: # Stop further processing.停止進一步的處理 return self.cleaned_data = {} """ # If the form is permitted to be empty, and none of the form data has # changed from the initial data, short circuit any validation. #如果表單允許為空,和原始數據也是空的話,允許不進行任何驗證 """ if self.empty_permitted and not self.has_changed(): return self._clean_fields() #字面意思校驗字段 self._clean_form() self._post_clean() def _clean_fields(self): #每個form組件實例化的過程中都會創建一個fields。fields實質上是一個字典。 #儲存着類似{"user":"user規則","pwd":"pwd的規則對象"} for name, field in self.fields.items(): #name是你調用的一個個規則字段,field是調用字段的規則 #items是有順序的,因為他要校驗字段的一致性 """ # value_from_datadict() gets the data from the data dictionaries. # Each widget type knows how to retrieve its own data, because some # widgets split data over several HTML fields. value_from_datadict()從數據字典中獲取數據。 每個部件類型知道如何找回自己的數據,因為有些部件拆分數據在幾個HTML字段。 """ #現在假設第一個字段是user if field.disabled: value = self.get_initial_for_field(field, name) else: value = field.widget.value_from_datadict(self.data, self.files, self.add_prefix(name)) try: if isinstance(field, FileField): #判斷是不是文件 #你是文件的時候怎么校驗 initial = self.get_initial_for_field(field, name) value = field.clean(value, initial) #filed是一個對象,field.clean才是真正的規則校驗 else: #你不是文件的時候怎么校驗 #實際中也是走的這一部,value是你輸入的字段值 #如果沒有問題,那么原樣返回 value = field.clean(value) #如果一旦出現問題,那么就會走except中的代碼 self.cleaned_data[name] = value if hasattr(self, 'clean_%s' % name): #這里找是否有clean_XX這個名字存在 value = getattr(self, 'clean_%s' % name)() #如果有執行這個函數 self.cleaned_data[name] = value #而在鈎子中必須報錯的返回值是確定的 #如果上面有問題,就又把錯誤添加到了_error中 #上面這三行代碼是我們能添加鈎子的原因,而且規定了鈎子名的格式 #如果這個值是正確的話,就會給這個字典添加一個鍵值對 #剛才在full_clean中self.cleaned_data = {}已經初始化了。 #{”pws“:123} except ValidationError as e: self.add_error(name, e) #如果出現錯誤,就會給_error這個字典添加一個鍵值對 #至於add_error這個函數如何添加這個鍵值對的,我們先不管 #鍵就是name,值就是錯誤信息e #在full_clean中已經初始化self._errors = ErrorDict() #假設現在user有問題,那么_error就是這樣{”user“:e}