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

django从入门到精通（五）——表单与模型

article 2024/11/19 22:40:40

好的，下面将详细介绍 Django 的表单与模型，包括它们的定义、使用、如何在 Django Admin 中结合使用，以及相关的字段类型和验证机制。

Django 模型与表单

1. Django 模型

Django 模型是一个 Python 类，用于定义数据库中的数据结构。每个模型类对应数据库中的一张表，类的属性对应表中的字段。

1.1 定义模型

模型通常在 models.py 文件中定义。以下是一个简单的模型示例：

from django.db import models

class Blog(models.Model):
    title = models.CharField(max_length=200)  # 标题
    content = models.TextField()                # 内容
    created_at = models.DateTimeField(auto_now_add=True)  # 创建时间
    updated_at = models.DateTimeField(auto_now=True)      # 更新时间

    def __str__(self):
        return self.title

1.2 模型字段

Django 提供了多种字段类型来定义模型的属性。常用的字段类型包括：

CharField: 用于存储短字符串，必须指定 max_length。
TextField: 用于存储长文本。
IntegerField: 用于存储整数。
FloatField: 用于存储浮点数。
BooleanField: 用于存储布尔值。
DateTimeField: 用于存储日期和时间。
ForeignKey: 用于定义一对多关系。
ManyToManyField: 用于定义多对多关系。

1.3 元数据

模型的元数据通过 Meta 类定义。您可以在 Meta 类中指定表名、排序方式等。

class Blog(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()

    class Meta:
        ordering = ['created_at']  # 按创建时间排序
        verbose_name = 'Blog Post'  # 单数形式
        verbose_name_plural = 'Blog Posts'  # 复数形式

1.4 数据迁移

在定义或修改模型后，您需要创建和应用迁移，以将模型的变化应用到数据库。

python manage.py makemigrations
python manage.py migrate

2. Django 表单

Django 表单是用于处理用户输入的类。表单可以通过 forms 模块定义，通常与模型结合使用，以便于数据验证和处理。

2.1 定义表单

您可以通过继承 forms.Form 或 forms.ModelForm 来定义表单。

示例：

from django import forms
from .models import Blog

class BlogForm(forms.ModelForm):
    class Meta:
        model = Blog
        fields = ['title', 'content']  # 指定要使用的字段

2.2 表单字段类型

Django 提供了多种表单字段类型，以便于处理不同类型的数据。常用的表单字段类型包括：

CharField: 用于输入短字符串。

title = forms.CharField(max_length=100)

EmailField: 用于输入电子邮件地址，自动验证格式。
```
email = forms.EmailField()
```
IntegerField: 用于输入整数，自动验证输入是否为整数。
```
age = forms.IntegerField()
```
FloatField: 用于输入浮点数。
```
price = forms.FloatField()
```

BooleanField: 用于输入布尔值（复选框）。

is_active = forms.BooleanField(required=False)  # 可选

ChoiceField: 用于选择项，可以提供一个选项列表。

color = forms.ChoiceField(choices=[('red', 'Red'), ('blue', 'Blue')])

MultipleChoiceField: 用于选择多个项。

fruits = forms.MultipleChoiceField(choices=[('apple', 'Apple'), ('banana', 'Banana')])

DateField: 用于输入日期。

birth_date = forms.DateField(widget=forms.SelectDateWidget())

FileField: 用于上传文件。
```
file_upload = forms.FileField()
```
ImageField: 用于上传图像，自动验证文件类型。
```
image_upload = forms.ImageField()
```

2.3 在视图中使用表单

在视图中，您可以实例化表单并处理用户提交的数据。

示例：

from django.shortcuts import render, redirect
from .forms import BlogForm

def create_blog(request):
    if request.method == 'POST':
        form = BlogForm(request.POST)
        if form.is_valid():
            form.save()  # 保存有效的数据
            return redirect('blog_list')  # 重定向到博客列表页面
    else:
        form = BlogForm()
    
    return render(request, 'create_blog.html', {'form': form})

2.4 在模板中渲染表单

在模板中，您可以使用 Django 的模板语言渲染表单。

示例：

<form method="post">
    {% csrf_token %}
    {{ form.as_p }}  <!-- 以段落形式渲染表单 -->
    <button type="submit">提交</button>
</form>

2.5 调用表单方法

Django 表单提供了一些有用的方法，您可以在视图中调用它们：

is_valid(): 验证表单数据是否有效。

if form.is_valid():
    # 处理有效数据

cleaned_data: 获取经过验证和清理的数据。
```
title = form.cleaned_data['title']
```
save(): 在 ModelForm 中保存数据到数据库。
```
form.save()
```
errors: 获取表单验证错误信息。
```
if form.errors:
    print(form.errors)
```
add_error(): 向特定字段添加错误信息。
```
form.add_error('title', '标题不能为空')
```

2.6 自定义验证

您可以通过重写 clean_<fieldname>() 方法来自定义字段验证。

示例：

class BlogForm(forms.ModelForm):
    class Meta:
        model = Blog
        fields = ['title', 'content']

    def clean_title(self):
        title = self.cleaned_data.get('title')
        if 'badword' in title:
            raise forms.ValidationError("标题包含不当词汇。")
        return title

3. Django Admin 中的表单与模型

Django Admin 是一个强大的后台管理界面，允许您轻松管理模型数据。您可以通过注册模型和自定义表单来扩展 Django Admin 的功能。

3.1 注册模型

在 admin.py 文件中注册模型，以便在 Django Admin 中管理。

from django.contrib import admin
from .models import Blog

admin.site.register(Blog)

3.2 自定义 Admin 表单

您可以为 Django Admin 自定义表单，以便在管理界面中使用。

from django.contrib import admin
from .models import Blog
from .forms import BlogForm

class BlogAdmin(admin.ModelAdmin):
    form = BlogForm  # 使用自定义表单

admin.site.register(Blog, BlogAdmin)

3.3 自定义 Admin 界面

您可以通过 ModelAdmin 类自定义 Django Admin 界面的外观和行为。

class BlogAdmin(admin.ModelAdmin):
    list_display = ('title', 'created_at')  # 显示的字段
    search_fields = ('title',)  # 搜索字段
    ordering = ('-created_at',)  # 排序方式

admin.site.register(Blog, BlogAdmin)