python之路_django ModelForm组件
在前面我们介绍了过django的forms组件，他可以很方便的实现我们前端的input框渲染和数据校验，但是我们使用过会发现，models组件在定义的时候我们需要定义相应的一些字段内容，但是有时候页面的表单form类与Model类是一一对应，因此分别定义Form类和Model类会比较麻烦，最简单的方式就是通过Model来生成一个Form类，因此，Django内置的ModelForm就是为此而生的．
一、ModelForm类的定义
如下我们定义了个modelform类：
from .models import * from django.forms import ModelForm from django.forms import widgets class BookForm(ModelForm): class Meta: model=Book fields=["title","publishDate","price","publish","authors"] widgets={ "title":widgets.TextInput(attrs={"class":"form-control"}), # "publishDate":widgets.DateInput(attrs={"class":"form-control"}), "publishDate":widgets.TextInput(attrs={"class":"form-control","type":"Date"}), "price":widgets.TextInput(attrs={"class":"form-control"}), "publish":widgets.Select(attrs={"class":"form-control"}), "authors":widgets.SelectMultiple(attrs={"class":"form-control"}) }
model 文件：
from django.db import models class Book(models.Model): nid=models.AutoField(primary_key=True) title=models.CharField(max_length=32,verbose_name="书名") publishDate=models.DateField(verbose_name="出版日期") price=models.DecimalField(max_digits=5,decimal_places=2,verbose_name="价格") publish=models.ForeignKey("Publish",verbose_name="出版社") #与Publish表建立多对一关系 authors=models.ManyToManyField("Author",verbose_name="作者") #与Author表建立多对多关系 def __str__(self): return self.title class Publish(models.Model): nid=models.AutoField(primary_key=True) name=models.CharField(max_length=32) email=models.EmailField() def __str__(self): return self.name class Author(models.Model): nid=models.AutoField(primary_key=True) name=models.CharField(max_length=32) age=models.IntegerField() def __str__(self): return self.name
说明一：
（1）引入方式：from django.forms import ModelForm；
（2）model=Book：Book为model中Book类；
（3）fields=["title","publishDate","price","publish","authors"]：指定BookForm类中需要Book中字段，若fields="__all__"表示将取Book类中的所有字段；
（4）widgets：通过它补充定义相应字段在渲染出来的input标签的类型，并可以给他传一些属性。
说明二：
上述两个字段在我们Book类中是两个关联字段，分别是多对一和多对多关系，即一本书只能有一个出版社，但是有多个作者，所以对于我们将其标签类型设置为select和selectMultiple，modelform的牛逼之一就是：在页面渲染此两个标签时，不但会渲染出单选框和多选框，还能自动查询Publish和Author表，将相应的已有的对象数据渲染，供用户选择。
说明三：
另外一点，对于日期字段，无论我们将标签设置成何种类型（DateInput还是TextInput），我们看到的还是一个需要我们自己输入内容的输入框，但是如何渲染出我们可以选年月日的哪一种呢？如上，需要我们设置type:Date属性。
说明四：
如上我们定义的modelform类，我们也可以像form组件一样，继续在modelform类下定义局部钩子和全局钩子，进一步对字段做约束，方便校验。
二、ModelForm类的使用
1、添加书籍实例
视图函数：
def addbook(request): if request.method=="POST": bookForm = BookForm(data=request.POST) if bookForm.is_valid(): bookForm.save() #save方法直接将接收的数据作为一条新数据添加 return redirect("/index/") else: pass else: bookForm=BookForm() return render(request,"add_book.html",locals())
add_book.html：
方式一：
<div class="container"> <div class="row"> <div class="col-md-6 col-md-offset-3"> <form action="/add_book/" method="post"> {% csrf_token %} {% for foo in book_form %} <p> <label for="">{{ foo.label }}</label> {{ foo }} </p> {% endfor %} <input type="submit" value="submit"> </form> </div> </div> </div>
如上实例，我们在前端页面直接可以对服务器传来的modelform类实例化的对象进行循环，循环的每一个foo对象就会按照按照顺序渲染出相应字段的输入标签，但是和form组件一样，form标签和submit标签需要我们事先定义。注意一点：通过如上<label for="">{{ foo.label }}</label>可以渲染出foo对应字段中定义的verbose_name值，作为label标签的名称。如若foo对应的是title=models.CharField(max_length=32,verbose_name="书名")字段，则会渲染出相应的label标签<label for="">书名</label>。
显然一点，上述通过循环的方式，按照顺序的方式渲染对应的字段输入标签显然不是很灵活，我们是否有其他的办法来解决这个问题呢？必须的有啊。通过实例化的modelform对象直接取自己包含的字段名，就可以渲染出相应的输入标签。具体实例如下：
方式二：
<form class="form-horizontal" action="/addbook/" method="post"> {% csrf_token %} <div class="form-group"> <label for="" class="col-sm-2 control-label">{{ bookForm.title.label }}</label> <div class="col-sm-6"> {{ bookForm.title }} </div> </div> <div class="form-group"> <label for="" class="col-sm-2 control-label">{{ bookForm.price.label }}</label> <div class="col-sm-6"> {{ bookForm.price }} </div> </div> <div class="form-group"> <label for="" class="col-sm-2 control-label">{{ bookForm.publishDate.label }}</label> <div class="col-sm-6"> {{ bookForm.publishDate }} </div> </div> <div class="form-group"> <label for="" class="col-sm-2 control-label">{{ bookForm.publish.label }}</label> <div class="col-sm-6"> {{ bookForm.publish }} </div> </div> <div class="form-group"> <label for="" class="col-sm-2 control-label">{{ bookForm.authors.label }}</label> <div class="col-sm-6"> {{ bookForm.authors }} </div> </div> <div class="form-group"> <div class="col-sm-offset-2 col-sm-6"> <button type="submit" class="btn btn-success btn-lg center-block">提交</button> </div> </div> </form>
2、编辑书籍实例
视图函数：
def editbook(request,id):
book_obj=Book.objects.get(nid=id)
if request.method=="POST":
bookForm = BookForm(data=request.POST,instance=book_obj)
if bookForm.is_valid():
bookForm .save()
return redirect("/index/")
else:
bookForm = BookForm(instance=book_obj)
return render(request,"edit_book.html",locals())
我们知道，编辑一条信息和添加一条信息的不同在于，不论在渲染页面还是保存编辑后的数据，我们都需要知道是在对那一条数据进行编辑，因此在渲染编辑页面时，我们不但要渲染出相应字段的输入标签，还要渲染出各字段编辑前的数据，所以用于渲染页面的mdelform实例对象必须要有个instance参数，参数值为当前要编辑的数据对象。编辑完成后，服务器在进行数据保存时同样也要有这样的一个参数。具体见如上实例。
