当前位置：首页 > news >正文

Django Form 与 ModelForm 实战：从留言板 Demo 到图书登记系统

news 2026/4/21 2:27:27

作业背景：第四次作业要求使用 Form 或 ModelForm 完善 quickstart 项目功能。本文基于课程留言板 Demo，扩展实现一个图书登记系统，使用 ModelForm 完成数据验证与数据库存储。

一、前置说明

课程 Demo 中实现了基于forms.Form的留言板功能，包含标题、内容、邮箱三个字段，通过form.cleaned_data手动提取数据。本次作业在此基础上，改用forms.ModelForm实现图书登记功能，体会两者的核心差异。

ModelForm 的核心优势在于字段自动生成、验证规则与模型同步、支持form.save()直接持久化到数据库。

二、项目结构

在原有项目基础上新增library应用，最终目录结构如下：

mysite/ ├── library/ │ ├── __init__.py │ ├── admin.py │ ├── apps.py │ ├── forms.py # 新增：ModelForm 定义 │ ├── models.py # 新增：Book 模型 │ ├── urls.py # 新增：应用路由 │ └── views.py # 新增：图书登记视图 ├── mysite/ │ ├── __init__.py │ ├── settings.py # 修改：注册应用、配置模板 │ ├── urls.py # 修改：包含 library 路由 │ └── wsgi.py ├── templates/ │ └── book_form.html # 新增：模板文件 ├── manage.py └── db.sqlite3

三、详细操作步骤

步骤 1：创建应用

在项目根目录下执行：

cd mysite python manage.py startapp library

步骤 2：注册应用并配置模板目录

修改mysite/settings.py，在INSTALLED_APPS列表末尾追加'library'：

INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'library', ]

确认TEMPLATES配置中DIRS包含全局模板路径：

TEMPLATES = [ { 'BACKEND': 'django.template.backends.django.DjangoTemplates', 'DIRS': [BASE_DIR / 'templates'], 'APP_DIRS': True, 'OPTIONS': { 'context_processors': [ 'django.template.context_processors.debug', 'django.template.context_processors.request', 'django.contrib.auth.context_processors.auth', 'django.contrib.messages.context_processors.messages', ], }, }, ]

步骤 3：定义数据模型

修改library/models.py，定义Book模型：

from django.db import models class Book(models.Model): title = models.CharField(max_length=100, verbose_name='书名') author = models.CharField(max_length=50, verbose_name='作者') publish_date = models.DateField(verbose_name='出版日期') price = models.DecimalField(max_digits=10, decimal_places=2, verbose_name='价格') introduction = models.TextField(blank=True, verbose_name='简介') contact_email = models.EmailField(verbose_name='联系邮箱') created_at = models.DateTimeField(auto_now_add=True, verbose_name='登记时间') class Meta: verbose_name = '图书' verbose_name_plural = '图书' ordering = ['-created_at'] def __str__(self): return self.title

执行数据库迁移命令：

python manage.py makemigrations python manage.py migrate

步骤 4：创建 ModelForm

在library目录下新建forms.py：

from django import forms from .models import Book class BookForm(forms.ModelForm): class Meta: model = Book fields = ['title', 'author', 'publish_date', 'price', 'introduction', 'contact_email'] labels = { 'title': '图书名称', 'author': '作者姓名', 'publish_date': '出版日期', 'price': '定价 (元)', 'introduction': '内容简介', 'contact_email': '联系邮箱', } error_messages = { 'title': { 'required': '书名不能为空', 'max_length': '书名最长不能超过100个字符', }, 'author': { 'required': '请填写作者姓名', }, 'price': { 'required': '请输入图书价格', 'invalid': '请输入有效的数字', }, 'contact_email': { 'required': '请填写联系邮箱', 'invalid': '邮箱格式不正确', } } widgets = { 'publish_date': forms.DateInput(attrs={'type': 'date', 'class': 'form-control'}), 'introduction': forms.Textarea(attrs={'rows': 4, 'placeholder': '请输入图书简介...', 'class': 'form-control'}), 'title': forms.TextInput(attrs={'class': 'form-control', 'placeholder': '请输入书名'}), 'author': forms.TextInput(attrs={'class': 'form-control', 'placeholder': '请输入作者'}), 'price': forms.NumberInput(attrs={'class': 'form-control', 'step': '0.01'}), 'contact_email': forms.EmailInput(attrs={'class': 'form-control', 'placeholder': 'example@email.com'}), } def clean_price(self): price = self.cleaned_data.get('price') if price is not None and price < 0: raise forms.ValidationError('价格不能为负数') return price

步骤 5：编写视图

修改library/views.py：

from django.shortcuts import render from django.http import HttpResponse from django.views.decorators.http import require_http_methods from .forms import BookForm @require_http_methods(['GET', 'POST']) def book_register(request): if request.method == 'GET': form = BookForm() return render(request, 'book_form.html', context={'form': form}) else: form = BookForm(request.POST) if form.is_valid(): book = form.save() return HttpResponse( f"图书登记成功<br>" f"书名：《{book.title}》<br>" f"作者：{book.author}<br>" f"价格：¥{book.price}<br>" f"邮箱：{book.contact_email}" ) else: return render(request, 'book_form.html', context={'form': form})

步骤 6：配置路由

修改项目级路由mysite/urls.py：

from django.contrib import admin from django.urls import path, include urlpatterns = [ path('admin/', admin.site.urls), path('book/', include('library.urls')), ]

在library目录下新建urls.py：

from django.urls import path from . import views urlpatterns = [ path('', views.book_register, name='book_register'), ]

步骤 7：编写模板

在项目根目录（与manage.py同级）创建templates文件夹，并在其中新建book_form.html：

<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title>图书登记</title> <style> body { font-family: "Microsoft YaHei", Arial, sans-serif; max-width: 500px; margin: 50px auto; background: #f5f5f5; } .container { background: white; padding: 30px; border-radius: 8px; box-shadow: 0 2px 10px rgba(0,0,0,0.1); } h2 { text-align: center; color: #333; margin-bottom: 25px; } .form-group { margin-bottom: 18px; } label { display: block; margin-bottom: 6px; font-weight: bold; color: #555; } input, textarea { width: 100%; padding: 10px; border: 1px solid #ddd; border-radius: 4px; box-sizing: border-box; } input:focus, textarea:focus { border-color: #4CAF50; outline: none; } .errorlist { color: #d32f2f; margin: 5px 0 0 0; padding: 0; list-style: none; font-size: 13px; } button { width: 100%; padding: 12px; background: #4CAF50; color: white; border: none; border-radius: 4px; font-size: 16px; cursor: pointer; margin-top: 10px; } button:hover { background: #45a049; } </style> </head> <body> <div class="container"> <h2>图书登记系统</h2> <form method="post" action=""> {% csrf_token %} {% for field in form %} <div class="form-group"> {{ field.label_tag }} {{ field }} {% if field.errors %} <ul class="errorlist"> {% for error in field.errors %} <li>{{ error }}</li> {% endfor %} </ul> {% endif %} </div> {% endfor %} <button type="submit">提交登记</button> </form> </div> </body> </html>