Django ModelForm实现数据增删改完整教程
本文详细讲解如何利用Django提供的ModelForm功能实现数据的增删改操作。通过创建继承ModelForm的表单类,自动绑定模型字段,简化视图逻辑。教程涵盖模型定义、迁移生成、表单配置、视图函数编写及URL路由设置,帮助开发者快速掌握基于模型的表单处理核心方法。
Django ModelForm数据操作概述
前文介绍了基于类视图进行数据增删改的方法,虽然实现简单,但部分新手对其底层原理可能尚显模糊。本文将演示如何使用Django内置的ModelForm来实现相同功能,这是一种直接基于现有数据模型进行增删改的高效方式。
为了便于理解,下面将通过一个具体示例进行说明。假设读者已掌握Django项目与应用创建的基础知识:
模型定义与数据库迁移
第一步,定义一个基础模型。该模型仅包含三个文本类型字段:标题(title)、内容(text)以及添加日期(date_added),具体定义如下:
# models.py
from django.db import models
from django.utils import timezone
class Article(models.Model):
title = models.CharField('标题', max_length=100)
text = models.TextField('内容')
date_added = models.DateTimeField(default=timezone.now)
def __str__(self):
return self.title
模型定义完成后,务必执行数据库迁移操作。首先运行 makemigrations 命令生成迁移文件,随后执行 migrate 命令将变更同步至数据库。
表单类配置与视图实现
第二步,在项目目录中创建 form.py 文件。以本项目名称 app1 为例,在该文件中定义一个继承自 ModelForm 的表单类 ArticleForm。该子类内置了多种方法,开发者可根据需求进行覆盖或扩展。若需深入了解,建议查阅官方文档,其中提供了详尽的说明。
官方文档参考地址:https://docs.djangoproject.com/zh-hans/2.1/topics/forms/modelforms/#django.forms.ModelForm
# form.py
from django.forms import ModelForm
from .models import Article
class ArticleForm(ModelForm): # 继承ModelForm类
class Meta:
model = Article # 具体要操作那个模型
fields = ['title', 'text', 'date_added'] # 允许编辑的字段
第三步,编写视图函数,正式开启增删改功能的实现。
# views.py
from django.shortcuts import render, redirect
from .models import Article
from .form import ArticleForm
def articles(request):
# 查询列表页面,获取Article的所有信息
articles = Article.objects.all()
return render(request, 'app1/articles.html', {'articles':articles})
# 与其对应的url,在应用中的urls.py中设置
path('article/', views.articles, name='article'),
# 添加页面
def new_article(request):
# 如果不是POST方法访问
if request.method != 'POST':
# 创建一个空表单在页面显示
form = ArticleForm()
else:
# 否则为POST方式
# request.POST方法,将会获取到表单中我们输入的数据
new_article = ArticleForm(request.POST)
# 验证其合法性,使用is_valid()方法
if new_article.is_valid():
# 验证通过,使用save()方法保存数据
new_article.save()
# 保存成功,使用redirect()跳转到指定页面
return redirect('app1:article')
return render(request, 'app1/new_article.html', {'form':form})
# 编辑修改页面
def edit_article(request, article_id):
# 查询到指定的数据
article = Article.objects.get(id=article_id)
if request.method != 'POST':
# 如果不是post,创建一个表单,并用instance=article当前数据填充表单
form = ArticleForm(instance=article)
else:
# 如果是post,instance=article当前数据填充表单,并用data=request.POST获取到表单里的内容
form = ArticleForm(instance=article, data=request.POST)
form.save() # 保存
if form.is_valid(): # 验证
return redirect('app1:article') # 成功跳转
return render(request, 'app1/edit_article.html', {'form':form,'article':article})
# 删除页面
def del_article(request, article_id):
article = Article.objects.get(id=article_id)
if request.method == 'POST':
article.delete()
return redirect('app1:article')
return render(request, 'app1/del_article.html', {'article': article})
URL路由与前端调用
第五步,配置所有视图对应的URL路由规则。
# 列表
path('article/', views.articles, name='article'),
# 添加
path('new_article/', views.new_article, name='new_article'),
# 修改
path('edit_article/<int:article_id>/', views.edit_article, name='edit_article'),
# 删除
path('del_article/<int:article_id>/', views.del_article, name='del_article'),
第六步,在前端静态页面中调用相关接口。
# articles.html
<a href="{% url 'app1:new_article' %}" rel="external nofollow" >添加</a>
{% for article in articles %}
<h1>{{ article.title }}</h1>
<p>{{ article.text }}</p>
<a href="{% url 'app1:edit_article' article.id %}" rel="external nofollow" >修改</a>
<a href="{% url 'app1:del_article' article.id %}" rel="external nofollow" >删除</a>
{% endfor %}
# new_article.html
<form action="{% url 'app1:new_article' %}" method="post">
{% csrf_token %}
{{ form.as_ul }}
<input type="submit" value="提交">
</form>
第七步,修改和删除页面的模板调用方式与 new_article.html 类似,仅需调整 action 属性中的 url 指向即可。
以上内容为本文的全部讲解,希望对各位的学习有所助益。欢迎继续支持本站获取更多技术分享。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









