一、ModelForm的介紹

ModelForm
    a.  class Meta:
            model,                           # 對應Model的
            fields=None,                     # 字段
            exclude=None,                    # 排除字段
            labels=None,                     # 提示信息
            help_texts=None,                 # 幫助提示信息
            widgets=None,                    # 自定義插件
            error_messages=None,             # 自定義錯誤信息（整體錯誤信息from django.core.exceptions import NON_FIELD_ERRORS）
            field_classes=None               # 自定義字段類 （也可以自定義字段）
            localized_fields=(‘birth_date‘,) # 本地化，如：根據不同時區顯示數據
            如：
                數據庫中
                    2016-12-27 04:10:57
                setting中的配置
                    TIME_ZONE = ‘Asia/Shanghai‘
                    USE_TZ = True
                則顯示：
                    2016-12-27 12:10:57
    b. 驗證執行過程
        is_valid -> full_clean -> 鉤子 -> 整體錯誤
 
    c. 字典字段驗證
        def clean_字段名(self):
            # 可以拋出異常
            # from django.core.exceptions import ValidationError
            return "新值"
    d. 用於驗證
        model_form_obj = XXOOModelForm()
        model_form_obj.is_valid()
        model_form_obj.errors.as_json()
        model_form_obj.clean()
        model_form_obj.cleaned_data
    e. 用於創建
        model_form_obj = XXOOModelForm(request.POST)
        #### 頁面顯示，並提交 #####
        # 默認保存多對多
            obj = form.save(commit=True)
        # 不做任何操作，內部定義 save_m2m（用於保存多對多）
            obj = form.save(commit=False)
            obj.save()      # 保存單表信息
            obj.save_m2m()  # 保存關聯多對多信息
 
    f. 用於更新和初始化
        obj = model.tb.objects.get(id=1)
        model_form_obj = XXOOModelForm(request.POST,instance=obj)
        ...
 
        PS: 單純初始化
            model_form_obj = XXOOModelForm(initial={...})

應用場景：
- ModelForm - 中小型應用程序。因為ModelForm是依賴於models的
- Form - 大型應用程序 *

註意事項：

註意事項：
            - 1. 類 
                  class Foo(ModelForm):
                    class Meta:
                        # model = models.Role
                        # fields = "__all__"
                        # fields = [‘caption‘,]
                        # exclude = [‘catpion‘]
                        model = models.UserType
                        fields = "__all__"

                        error_messages = {
                            ‘title‘:{‘required‘:‘名稱不能為空‘,‘invalid‘:‘格式錯誤‘}
                        }
                        widgets = {
                            ‘title‘:wd.TextInput(attrs={‘class‘:‘c1‘})
                        }
                
            - 2. 添加
                 GET:
                    form = Foo()
                 POST:
                    form = Foo(data=request.POST)
                    form.is_valid()
                    form.cleaned_data
                    form.erros
                    form.save()
            - 3. 修改
                 GET:
                    form = Foo(instance=obj)
                 
                 POST:
                    form = Foo(instance=obj,dat=request.POST)
                    ...
                    form.save()

二、表結構

from django.db import models

# Create your models here.
class UserInfo (models.Model):
    username = models.CharField(max_length=32)
    email = models.EmailField(max_length=32)
    ut = models.ForeignKey("UserType")

class UserType (models.Model):
    title = models.CharField(max_length=32)
    roles = models.ManyToManyField(to="Roles")
    def __str__(self):
        return self.title

class Roles(models.Model):
    caption = models.CharField(max_length=32)
    def __str__(self):
        return self.caption

三、基於Form組件的添加和編輯

添加：這只是單表的添加

from django.forms import Form, fields,widgets,ModelForm
from django.shortcuts import render,redirect,HttpResponse
from app01 import models
# Create your views here.
class RoleForm(Form):
    ‘‘‘利用Form‘‘‘
    caption = fields.CharField(required=True,error_messages={"required":True})

def role(request):
    role_obj = models.Roles.objects.all()
    print(role_obj)
    return render(request, "role.html",{"role_obj":role_obj})

# 基於Form實現的
def role_add(request):
    ‘‘‘添加角色‘‘‘
    if request.method=="GET":
        form = RoleForm()
        return render(request,"role_add.html",{"form":form})
    else:
        form = RoleForm(data=request.POST)
        if form.is_valid():
            print("zzzzz")
            caption = form.cleaned_data.get("caption")
            models.Roles.objects.create(caption=caption)
            # models.Roles.objects.create(**form.cleaned_data)
            return redirect("/role/")
        else:
            return render(request,"role_add.html",{"form":form})

編輯：單表的編輯

#基於Form實現的編輯
def role_edit(request,nid):
    obj = models.Roles.objects.filter(id=nid).first()
    print(obj.caption)
    if not obj :
        return HttpResponse("頁面不存在")
    if request.method=="GET":
        form = RoleForm(initial={"caption":obj.caption})   #編輯的時候需要一個instance，讓instance=一個你要編輯的那個對象
    else:
        form = RoleForm(data = request.POST)
        if form.is_valid():
            models.Roles.objects.filter(id=nid).update(**form.cleaned_data)
            return redirect("/role/")
    return render(request,"role_edit.html",{"form":form})

具體基於Form組件實現的一對多添加或者多對多添加編輯詳見博客http://www.cnblogs.com/haiyan123/p/7816877.html

四、基於ModelForm的添加和編輯

添加：單表的添加

# 基於ModelForm的添加
class RoleModelForm(ModelForm):
    class Meta:   #這個類必須寫，而且名字必須是這個
        model = models.Roles   #這個model也是固定的，註意不加s，
        fields = "__all__"   #代表所有的字段，但是你也可以指定單個的字段


def role_add(request):
    if request.method == "GET":
        form = RoleModelForm()
        return render(request,"role_add.html",{"form":form})
    else:
        form = RoleModelForm(data=request.POST)
        if form.is_valid():
            form.save()   #這裏直接可以用save方法，就把數據創建了
            return redirect("/role/")
        else:
            return render(request,"role_add.html",{"form":form})

添加：多對多的添加，一堆多的提添加也是一樣

# 多對多的添加
def usertype(request):
    user_type_list = models.UserType.objects.all()
    return render(request,"usertype.html",{‘user_type_list‘:user_type_list})

class UserTypeModelForm(ModelForm):
    title = fields.CharField(max_length=6,required=True,widget=widgets.Textarea)   #這個字段是臨時添加的，
    # 也就是說modelForm也可以用Form的方式。
    # 也可以以這樣的方式新增字段， 如果有就覆蓋，沒有就增加；像現在這種情況就是吧下面的給覆蓋了，當然沒有上面的這個就用下面的了

    class Meta:
        model = models.UserType
        fields = "__all__"

        error_messages = {
            "title":{"required":"用戶名不能為空","invalid":"郵箱格式不一致"}
        }
        widgets = {
            "title":widgets.TextInput(attrs={"class":"c1"})
        }

def usertype_add(request):
    ‘‘‘多對多的添加‘‘‘
    if request.method=="GET":
        modelform = UserTypeModelForm()
        return render(request,"usertype_add.html",{"modelform":modelform})
    else:
        modelform = UserTypeModelForm(data=request.POST)
        if modelform.is_valid():
            modelform.save()   #也可以用save來實現，就連關系表的字段也都添加了
            return redirect("/usertype/")
        else:
            return render(request, "usertype_add.html", {"modelform": modelform})

編輯：單表的編輯

# 基於modelForm實現的編輯
def role_edit(request,nid):
    obj = models.Roles.objects.filter(id=nid).first()
    if not obj :
        return HttpResponse("頁面不存在")
    if request.method=="GET":
        form = RoleModelForm(instance=obj)   #編輯的時候需要一個instance，讓instance=一個你要編輯的那個對象
    else:
        form = RoleModelForm(data = request.POST,instance=obj)
        if form.is_valid:
            form.save()
            return redirect("/role/")
    return render(request,"role_edit.html",{"form":form})

編輯：多對多的編輯

# 多對多的編輯
def usertype(request):
    user_type_list = models.UserType.objects.all()
    return render(request,"usertype.html",{‘user_type_list‘:user_type_list})

class UserTypeModelForm(ModelForm):
    title = fields.CharField(max_length=6,required=True,widget=widgets.Textarea)   #這個字段是臨時添加的，
    # 也就是說modelForm也可以用Form的方式。
    # 也可以以這樣的方式新增字段， 如果有就覆蓋，沒有就增加；像現在這種情況就是吧下面的給覆蓋了，當然沒有上面的這個就用下面的了

    class Meta:
        model = models.UserType
        fields = "__all__"

        error_messages = {
            "title":{"required":"用戶名不能為空","invalid":"郵箱格式不一致"}
        }
        widgets = {
            "title":widgets.TextInput(attrs={"class":"c1"})
        }


def usertype_edit(request,nid):
    #查出當前類型用戶對應的角色
    obj = models.UserType.objects.filter(id =nid).first()
    if not obj:
        return HttpResponse("頁面不存在")
    if request.method =="GET":
        form = UserTypeModelForm(instance=obj)
        return render(request,"usertype_edit.html",{"form":form})
    else:
        form = UserTypeModelForm(instance=obj,data=request.POST)
        if form.is_valid():
            form.save()
            return redirect("/usertype/")
    return render(request,"usertype_edit.html",{"form":form})

Django 【第二十二篇】ModelForm