Django笔记（五）：模型models

首

Django中的模型对应数据库中的一张表格。

定义模型

player.py

from django.db import models

class Player(models.Model):
    idx = models.IntegerField(unique=True)

    def __str__(self):
        return str(self.id)

每个模型需要继承models类，如上Player模型定义了一个整形字段idx。常见字段类型有：

字段	描述
IntegerField	整形
FloatField	浮点型
CharField	字符串类型
TextField	长文本类型
BooleanField	布尔类型

每个字段可定义参数：

参数	取值	描述
null	True/False	是否为空
unique	True/False	字段是否唯一
default	auto	字段默认值
max_length	int	字段最大长度
primary_key	True/False	是否为主键

迁移数据

定义好模型后，需要进行迁移才能在数据库中看到表格：

python manage.py makemigrations // 生成迁移文件
python manage.py migrate // 执行迁移

后台管理

Django自带一个后台，访问localhost/admin/可以看到，如果想让自己创建的表格能够在后台可视化，需要将表格进行注册。在models所属app目录下编辑admin.py：

from django.contrib import admin
from app1.models.player import Player # 引入模型

# Register your models here.

admin.site.register(Player) # 注册模型

迁移后需要重启服务器，admin后台才能看到更新之后的自定义表格。

数据库操作

Django定义了一系列API对数据库执行操作，无需关注不同数据库间sql语句的差别，例如查询Player的所有记录：

from django.http import HttpResponse
from app1.models.player import Player

def GetPlayersView(request):
    player = Player.objects.all()
    for p in player:
        print(p.idx)
    return HttpResponse("")

查

常用查询操作如下：

方法	描述	返回
all	查询所有	查询集（可当做列表）
filter	多条查询	列表
get	单条查询	一条数据，查询失败报错
count	查询结果数	整数

一般查询不确定结果使用filter，如查询一个idx为10010的用户，可以使用

player = Player.objects.filter(idx=10010)
if player:
    print(player[0].idx)
else:
    print("no result")

这样可以避免get方法查询为空时的报错。

增

Player.objects.create(idx=1)

删

players = Player.objects.filter(status=123)
for player in players:
    player.delete()

改

# 单条修改
player = Player.objects.get(id=1)
player.status = 123
player.save()

# 批量修改
players = Player.objects.filter(id=1).update(status=123)

User模型

Django自带User模型，内置用户认证体系，开箱即用。

User模型常用字段：

字段	类型	描述
id	int	主键，用户编号
username	varchar	用户名
password	varchar	密码
is_active	tinyint	用户状态，为0则封号

常用操作：

from django.contrib.auth.models import User

# 创建user
User.objects.create_user(username="", password="")

# 修改密码
user = User.objects.get(id=1)
user.set_password(passwd)
user.save()

# 验证密码
user.check_password(passwd)

Auth模块

常见方法：

方法	描述
authenticate(username, password)	用户验证
login(HttpRequest, user)	登录
logout(request)	登出，注销会话
is_authenticated()	用户登录状态

用户登录视图：

from django.http import JsonResponse
from django.contrib.auth import authenticate, login

def signin(request):
    data = request.POST
    username = data.get("username")
    password = data.get("password")
    user = authenticate(username=username, password=password) # 验证用户
    if not user:
        return JsonResponse({
            "result": "用户名或密码错误"
        })
    if user.is_authenticated():
        return JsonResponse({
            "result": "用户已登录"
        })
    if user.is_authenticated():
        return JsonResponse({
            "result": "用户已登录"
        })
    if not user.is_active:
        return JsonResponse({
            "result": "账号被封"
        })
    # 登录用户
    login(request, user)
    return JsonResponse({
        "result": "success"
    })

扩展用户

Django自带的User未必能够满足我们所有的需求，故其提供了扩展User的方式，而个人更喜欢偷个懒，例如文章开头的Player想对User扩展，我会这样写：

from django.db import models
from django.contrib.auth.models import User

class Player(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    ...

    def __str__(self):
        return str(self.user)

将User和Player俩个表做个关联，让user成为Player的一个字段来使用。

（模型的关系除了一对一OneToOneField，还有一对多ForeignKey和多对多ManyToManyField，on_delete的参数CASCADE表级联删除，还有PROTECT和DO_NOTHING等对扩展表的操作）