跳到主要内容

Django 管理模型注册

介绍​

Django的管理站点是一个强大的工具，允许开发者通过一个用户友好的界面管理数据库中的数据。为了在管理站点中管理某个模型，首先需要将该模型注册到Django的管理界面中。本文将详细介绍如何在Django中注册模型，并通过实际案例展示其应用。

什么是Django管理模型注册？​

Django的管理模型注册是指将Django模型与Django管理站点关联起来的过程。通过注册模型，你可以在Django的管理界面中查看、添加、编辑和删除数据库中的记录。Django提供了一个内置的admin模块，使得模型注册变得非常简单。

如何注册模型​

要在Django管理站点中注册模型，首先需要在admin.py文件中导入模型，并使用admin.site.register()方法将其注册。

基本注册​

假设你有一个名为Book的模型，定义如下：

# models.py
from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.CharField(max_length=100)
    published_date = models.DateField()

    def __str__(self):
        return self.title

要在管理站点中注册这个模型，你需要在admin.py文件中进行如下操作：

# admin.py
from django.contrib import admin
from .models import Book

admin.site.register(Book)

自定义模型管理类​

Django允许你通过自定义模型管理类来进一步控制模型在管理站点中的显示和行为。你可以通过继承admin.ModelAdmin类来实现这一点。

# admin.py
from django.contrib import admin
from .models import Book

class BookAdmin(admin.ModelAdmin):
    list_display = ('title', 'author', 'published_date')
    list_filter = ('published_date',)
    search_fields = ('title', 'author')

admin.site.register(Book, BookAdmin)

在这个例子中，BookAdmin类定义了模型在管理站点中的显示方式。list_display指定了在列表视图中显示的字段，list_filter允许你根据某些字段进行过滤，search_fields则允许你在管理站点中进行搜索。

实际案例​

假设你正在开发一个图书馆管理系统，你需要管理书籍、作者和借阅记录。你可以通过以下步骤将这些模型注册到Django管理站点中。

定义模型​

# models.py
from django.db import models

class Author(models.Model):
    name = models.CharField(max_length=100)
    birth_date = models.DateField()

    def __str__(self):
        return self.name

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.ForeignKey(Author, on_delete=models.CASCADE)
    published_date = models.DateField()

    def __str__(self):
        return self.title

class BorrowRecord(models.Model):
    book = models.ForeignKey(Book, on_delete=models.CASCADE)
    borrower_name = models.CharField(max_length=100)
    borrow_date = models.DateField()
    return_date = models.DateField(null=True, blank=True)

    def __str__(self):
        return f"{self.borrower_name} borrowed {self.book.title}"

注册模型​

# admin.py
from django.contrib import admin
from .models import Author, Book, BorrowRecord

class AuthorAdmin(admin.ModelAdmin):
    list_display = ('name', 'birth_date')
    search_fields = ('name',)

class BookAdmin(admin.ModelAdmin):
    list_display = ('title', 'author', 'published_date')
    list_filter = ('published_date', 'author')
    search_fields = ('title', 'author__name')

class BorrowRecordAdmin(admin.ModelAdmin):
    list_display = ('book', 'borrower_name', 'borrow_date', 'return_date')
    list_filter = ('borrow_date', 'return_date')
    search_fields = ('book__title', 'borrower_name')

admin.site.register(Author, AuthorAdmin)
admin.site.register(Book, BookAdmin)
admin.site.register(BorrowRecord, BorrowRecordAdmin)

通过这种方式，你可以在Django管理站点中轻松管理图书馆系统中的书籍、作者和借阅记录。

总结​

Django的管理模型注册是一个简单但强大的功能，允许你通过Django的管理界面轻松管理数据库中的数据。通过注册模型并自定义模型管理类，你可以控制模型在管理站点中的显示和行为，从而提升开发效率。

附加资源​

练习​

  1. 创建一个新的Django项目，并定义一个Product模型，包含name、price和stock字段。
  2. 在管理站点中注册Product模型，并自定义list_display、list_filter和search_fields。
  3. 尝试在管理站点中添加、编辑和删除一些产品记录。

通过完成这些练习，你将更好地理解Django管理模型注册的概念和应用。