Django 学习之内置Admin

一.Admin组件

Django内置的Admin是对于model中对应的数据表进行增删改查提供的组件，使用方式有：

Django Admin内部依赖：

依赖APP：

        django.contrib.auth

        django.contrib.contenttypes

        django.contrib.messages

        django.contrib.sessions

 

    模板的context_processors：

        django.contrib.auth.context_processors.auth

        django.contrib.messages.context_processors.messages

 

    中间件：

        django.contrib.auth.middleware.AuthenticationMiddleware

        django.contrib.messages.middleware.MessageMiddleware

 

1．配置路由

通常我们在生成项目时会在 urls.py 中自动设置好。

from django.contrib import adminfrom django.urls import path

urlpatterns = [

    path('admin/', admin.site.urls),

]

 

当前配置的路由可以创建一些路由映射关系：

/admin/
/admin/login/
/admin/logout/
/admin/password_change/
/admin/password_change/done/

/admin/app名称/model名称/
/admin/app名称/model名称/add/
/admin/app名称/model名称/ID值/history/
/admin/app名称/model名称/ID值/change/
/admin/app名称/model名称/ID值/delete/

2.使用admin工具

在使用admin组件之前，需要将app下的模型类，进行注册。

app下 models.py 文件：

from django.db import models


class Book(models.Model):
    title = models.CharField(max_length=32)
    price = models.DecimalField(max_digits=5, decimal_places=2)
    pub_date = models.DateField()
    publish = models.ForeignKey("Publish", on_delete=models.CASCADE)
    authors = models.ManyToManyField("Author")

    def __str__(self):
        return self.title


class Publish(models.Model):
    name = models.CharField(max_length=32)
    city = models.CharField(max_length=64)
    email = models.EmailField()

    def __str__(self):
        return self.name


class Author(models.Model):
    name = models.CharField(max_length=32)
    age = models.SmallIntegerField()
    au_detail = models.OneToOneField("AuthorDetail", on_delete=models.CASCADE)

    def __str__(self):
        return self.name

class AuthorDetail(models.Model):
    gender_choices = (
        (0, "女"),
        (1, "男"),
        (2, "保密"),
    )
    gender = models.SmallIntegerField(choices=gender_choices)
    tel = models.CharField(max_length=32)
    addr = models.CharField(max_length=64)
    birthday = models.DateField()

启动服务器，然后在浏览器中访问 http://127.0.0.1:8000/admin/，得到登录界面。

你可以通过命令 python manage.py createsuperuser 来创建超级用户。然后，来进行登录操作。

为了让 admin 界面管理某个数据模型，我们需要先注册该数据模型到 admin。

在admin.py中只需要将Mode中的某个类注册，即可在Admin中实现增删改查的功能，如：

admin.site.register(models.Book, )

admin.site.register(models.Publish, )

admin.site.register(models.Author, )

admin.site.register(models.AuthorDetail, )

登录后显示：

这时候就已经可以进行数据的添加了。

但是，这种方式比较简单，如果想要进行更多的定制操作，需要利用ModelAdmin进行操作。

3.admin的定制

我们可以自定制类继承 admin.ModelAdmin 类，来扩展方法。有以下两种方式注册：

看下面的注册方法请注意，类的命名是固定的：models中的类名+Admin ，请注意下面的格式。

# 方式一：(注册book表)

class BookAdmin(admin.ModelAdmin):

    list_display = ('title', 'price', 'publish', 'pub_date')

 

admin.site.register(models.Book, BookAdmin)

# 方式二：(注册publish表，并显示字段)

@admin.register(models.Publish)

class PublishAdmin(admin.ModelAdmin):

    list_display = ('name', 'city', 'email')

方式一效果图：

可以显示这些列

方式二效果图：

ModelAdmin中提供了大量的可定制功能，下面我们列举一下常用的功能：

class BookAdmin(admin.ModelAdmin):

    list_display = ('title', 'price', 'publish', 'pub_date', 'show_author')  # 定制展示的列

    list_display_links = ('price',)  # 定制跳转的列

    list_filter = ('publish', 'authors')  # 定制过滤列

    search_fields = ('title', 'price')  # 定制模糊搜索列

    list_editable = ('title',)  # 定制可以直接编辑的列

    actions = ['patch_init']  # 定制批量处理方法

    ordering = ['-price']  # 通过该列进行排序，默认升序

 

    def show_author(self, obj):  # 自定制展示列

        return "|".join([i.name for i in obj.authors.all()])

    def patch_init(self, request, queryset):  # 初始化单价

        queryset.update(price=100)

 

    patch_init.short_description = "批量初始化"  # 设置操作名称

 

admin.site.register(models.Book, BookAdmin)

 

定制跳转的列

点击设置的跳转列，进入后效果（可以修改信息）

定制模糊搜索列（不能将关联的字段加到模糊搜索中）

可以通过模糊搜索，价格或出版社名：

定制可以直接编辑的列

可以直接进行修改（一般不这样用）

定制批量处理方法

通过该列进行排序，默认升序

4.1271, Illegal mix of collations for operation 'like'解决方法

在admin模糊查询中加到一定的字段，在查询中文时，出现报错：

 

(1271, "Illegal mix of collations for operation 'like'")

问题所在是：

MySQL Illegal mix of collations for operation 'like'

在 MySQL 5.5 以上, 若字段类型 Type 是 time,date,datetime

select时如果使用 like '%中文%' 会出现 Illegal mix of collations for operation 'like'

执行时可能就会出现时间字段 like '%中文%' 这种语法,旧版的 MySQL 是不会出现错误的.

升到 MySQL 5.5 以上, 必需改成 like binary '%中文%' 即可避免出现错误.

解决方法：

进入：

C:\python\py\Lib\site-packages\django\db\backends\mysql\base.py

根据情况查看自己相应的文件

C:\python\py 为我的python环境安装目录

找到对应的db路径下的base.py文件

 

'icontains': 'LIKE %s', 改为：  'icontains': 'LIKE BINARY %s',

重启后模糊查询中文可以了：