Django 之 ORM 基础

最新推荐文章于 2025-05-10 15:46:56 发布

lzyccliu

最新推荐文章于 2025-05-10 15:46:56 发布

阅读量1.6k

点赞数

分类专栏： Django 文章标签： django orm 基础自学

Django 专栏收录该内容

3 篇文章

订阅专栏

转载自：bobo0609

ORM 即关系对象映射 ( Object Relational Mapping)

两种方式：
1、DB first
2、Code first(主流)

基本步骤

创建类 app01/models.py

from django.db import models    
class UserInfo(models.Model):    
    username = models.CharField(max_length=32)
    password = models.CharField(max_length=64)

注册APP proj/settings.py

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

修改数据库引擎 settings.py
django默认使用sqlite 数据库，如需修改为其他数据库存储数据需修改数据库引擎，如 MySQL :

DATABASES = {
    'default': {
    'ENGINE': 'django.db.backends.mysql',
    'NAME':'dbname',
    'USER': 'root',
    'PASSWORD': 'xxx',
    'HOST': '',
    'PORT': '',
    }
}

PS: Django默认使用MySQLdb模块链接MySQL，但python3中还无此模块，所以需要使用pymysql来代替，在project同名文件夹下的__init__文件中添加如下代码：
　　import pymysql
　　pymysql.install_as_MySQLdb()

执行命令
python manage.py makemigrations 　　 # 找到所有的models.py, 在相应的migrations下生成 000x_initial.py 文件，记录数据库变化
python manage.py migrate 　　 # 根据000x_initial.py 文件，生成数据库表.

# 如果在model.py中修改了类，重新执行以上命令
from django.db import models    
class UserInfo(models.Model):    
    username = models.CharField(max_length=32)
    password = models.CharField(max_length=64)        
    email = models.CharField(max_length=60,null=True)  # 增加列时不允许为空，需添加null=True，否则报错

根据类自动创建数据库表 -- models.py

字段类型

字符串类型
CharField() # 字符类型
　　-参数: 必须提供max_length参数，表示字符长度如 CharField(max_length=10)
TextField() 文本类型
EmailField()　　 # Django Admin以及ModelForm中提供验证机制
IPAddressField() 　　 # Django Admin以及ModelForm中提供验证 IPV4 机制
GenericIPAddressField(Field) 　　 # Django Admin以及ModelForm中提供验证 Ipv4和Ipv6 (推荐)
URLField()　　 # Django Admin以及ModelForm中提供验证 URL
SlugField()　　 # Django Admin以及ModelForm中提供验证支持字母、数字、下划线、连接符（减号）
FilePathField() 　　 # Django Admin以及ModelForm中提供读取文件夹下文件的功能
　　- 参数：
　　　　path, 文件夹路径
　　　　match=None, 正则匹配
　　　　recursive=False, 递归下面的文件夹
　　　　allow_files=True, 允许文件
　　　　allow_folders=False, 允许文件夹
　　PS: EmailField、GenericIPAddressField、URLField等仅给django-admin使用时才有特殊功能，如果不用admin，和CharField一样都表示普通字符串

数字类型
整型
　　IntegerField(Field) - 整数列(有符号的) -2147483648 ～ 2147483647
　　PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField) - 正整数 0 ～ 2147483647
　　SmallIntegerField(IntegerField): - 小整数 -32768 ～ 32767
　　BigIntegerField(IntegerField): - 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807

浮点型
　　FloatField(Field)
　　DecimalField(Field) # 10进制小数
- 参数：
max_digits，小数总长度
decimal_places，小数位长度
BinaryField(Field) # 二进制类型

布尔值
BooleanField(Field) - 布尔值类型
NullBooleanField(Field) - 可以为空的布尔值
* 自定义自增列 (当model中如果没有自增列，则自动会创建一个列名为id的列)
　　AutoField(primary_key=True) 必须填入参数 primary_key=True

时间类型
DateTimeField(DateField) - 日期+时间格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]
DateField(DateTimeCheckMixin, Field) - 日期格式 YYYY-MM-DD
TimeField(DateTimeCheckMixin, Field) - 时间格式 HH:MM[:ss[.uuuuuu]]
DurationField(Field) - 长整数，时间间隔，数据库中按照bigint存储，ORM中获取的值为datetime.timedelta类型

字段属性
null 　　 -> db是否可以为空
default 　　 -> 默认值
primary_key　　 -> 主键
db_column='xxx'　　 -> 列名
db_index=True　　 -> 索引
unique 　　 -> 唯一索引
unique_for_date 　　 -> 数据库中字段【日期】部分是否可以建立唯一索引
unique_for_month　　-> 数据库中字段【月】部分是否可以建立唯一索引
unique_for_year　　 -> 数据库中字段【年】部分是否可以建立唯一索引
auto_now_add　　 -> 创建时，自动生成时间
auto_now　　 -> 更新时，自动更新为当前时间
choices　　 -> django admin中显示下拉框，避免连表查询(连表查询效率低)
blank　　 -> django admin是否可以为空
verbose_name 　　 -> django admin显示字段中文
editable　　 -> django admin是否可以被编辑
error_messages 　　 -> django admin 错误信息（欠）
help_text　　 -> django admin 提示

validators 　　 -> django form 自定义错误信息（欠）

示例：

from django.db import models
# Create your models here.

class UserInfo(models.Model): 
    #  生成的表名称为app01_userinfo
    #  会自动创建id列(自增，主键)   
    username = models.CharField(max_length=32,blank=True,verbose_name='用户名')        # 用户名列，字符串类型，指定长度
    password = models.CharField(max_length=60, help_text='pwd') 
    email = models.EmailField(max_length=19,null=True,error_messages={'invalid': '请输入邮箱'}
    caption = models.CharField(max_length=32,unique=True)
    user_type_choices = ((1, '超级用户'), (2, '普通用户'),(3, '临时用户'),)   # 保存在内存中
    user_type_id = models.IntegerField(choices=user_type_choices,default=1)
    ctime = models.DateTimeField(auto_now_add=True, null=True)
    mtime = models.DateTimeField(auto_now=True, null=True)
     '''
     方式一: mtime 时间不会更新
     obj=UserInfo.objects.filter(id=1).update(caption='CEO')
     方式二: mtime 时间会更新
     obj=UserInfo.objects.filter(id=1).first()
     obj.caption = 'CEO'
     obj.save()
     '''

根据类对数据库表中的数据进行各种操作 -- views.py

from app01 import models
def orm(request):
    # 增
    models.UserInfo.objects.create(username='root',password='123')

    dic = {'username': 'xxx', 'password': '666'}
    models.UserInfo.objects.create(**dic)

    obj = models.UserInfo(username='alex',password='123')
    obj.save()

    # 查
    result = models.UserInfo.objects.all()
    result = models.UserInfo.objects.filter(username='root',password='123')
    print(result)  #结果为Django的QuerySet类型 <QuerySet [<UserInfo: UserInfo object>,<UserInfo: UserInfo object>,<UserInfo: UserInfo object>]>
    for row in result:
        print(row.id,row.username,row.password)

    dic = {'name': 'xxx', 'age_gt': '19'}
    models.User.objects.filter(**dic)

    # 删
    models.UserInfo.objects.filter(id=4).delete()

    # 改
    models.UserInfo.objects.filter(id=3).update(password="69")

# models.tb.objects.filter(id__gt=1) => select * from tb where id > 1
# models.tb.objects.filter(id__gte=1) => select * from tb where id >= 1
# models.tb.objects.filter(id=1) => select * from tb where id = 1
# models.tb.objects.filter(id__lt=1) => select * from tb where id < 1
# models.tb.objects.filter(id__lte=1) => select * from tb where id <= 1

外键约束 .

ForeignKey("PrimaryTable",to_filed='xxx')

from django.db import models

# Create your models here.

class UserGroup(model s.Model):
    uid = models.AutoField(primary_key=True)  #自定义自增列，必须声明primary_key=True
    caption = models.CharField(max_length=32,unique=True)

class UserInfo(models.Model): 
    username = models.CharField(max_length=32,blank=True,verbose_name='用户名')      
　　 password = models.CharField(max_length=60, help_text='pwd')  
    email = models.CharField(max_length=60)
    user_group = models.ForeignKey("UserGroup",to_field='uid',default=1) 
    # default=1 表示默认属于哪个部门，django在数据库中将user_group存取字段为user_group_id，实际上user_group为UserGroup的对象封装了(uid,caption,ctime,uptime)

from app01 import models
def orm(request):
    models.UserInfo.objects.create(
    username='root1',
    password='123',
    email="xxx.@qq.com",
    user_group = models.UserGroup.objects.filter(id=1).first() # 或 user_group_id = 1 (推荐) 
    )


    user_list = Userinfo.objects.all()
    for row in user_list: 
        print(row.user_group) #这里 user_group代指 UserGroup 对象
        print(row.user_group.id)  # 等同于 print(row.user_group_uid)
        print(row.user_group.caption)

示例：用户管理

urls.py

from django.conf.urls import url,include
from django.contrib import admin
from app01 import views

urlpatterns = [
    url(r'^login/', views.login),
    url(r'^index/', views.index),
    url(r'^user_info/', views.user_info),
    url(r'^userdetail-(?P<nid>\d+)/', views.user_detail),
    url(r'^userdel-(?P<nid>\d+)/', views.user_del),
    url(r'^useredit-(?P<nid>\d+)/', views.user_edit),
]

view.py

from django.shortcuts import render,HttpResponse,redirect

def login(request):
    models.UserGroup.objects.create(caption='DBA')

    if request.method == "GET":
        return render(request, 'login.html')
    elif request.method == "POST":
        # 数据库中执行 select * from user where usernam='x' and password='x'
        u = request.POST.get('user')
        p = request.POST.get('pwd')
        # count = models.UserInfo.objects.filter(username=u, password=p).count()
        obj = models.UserInfo.objects.filter(username=u, password=p).first()   
        if obj:    
            return redirect('/cmdb/index/')
        else:
            return render(request, 'login.html')
    else: 
        # PUT,DELETE,HEAD,OPTION...
        return redirect('/index/')


def index(request): 
    return render(request, 'index.html')

def user_info(request):
    if request.method == "GET":
        user_list = models.UserInfo.objects.all()  # print(user_list.query)
        group_list = models.UserGroup.objects.all()
        return render(request, 'user_info.html', {'user_list': user_list, "group_list": group_list})
    elif request.method == 'POST':
        u = request.POST.get('user')
        p = request.POST.get('pwd')
        models.UserInfo.objects.create(username=u,password=p)
        return redirect('/cmdb/user_info/')


def user_detail(request, nid):
    obj = models.UserInfo.objects.filter(id=nid).first()
    # models.UserInfo.objects.get(id=nid)  # 取单条数据，但如果不存在则报错
    return render(request, 'user_detail.html', {'obj': obj})

def user_del(request, nid):
    models.UserInfo.objects.filter(id=nid).delete()
    return redirect('/cmdb/user_info/')

def user_edit(request, nid):
    if request.method == "GET":
        obj = models.UserInfo.objects.filter(id=nid).first()
        return render(request, 'user_edit.html',{'obj': obj})
    elif request.method == "POST":
        nid = request.POST.get('id')
        u = request.POST.get('username')
        p = request.POST.get('password')
        models.UserInfo.objects.filter(id=nid).update(username=u,password=p)
        return redirect('/cmdb/user_info/')

index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <style>
        body{
            margin: 0;
        }
        .menu{
            display: block;
            padding: 5px;

        }
    </style>
</head>
<body>
    <div style="height: 48px;background-color: black;color: white">
        Deployment
    </div>
    <div>
        <div style="position: absolute;top:48px;bottom: 0;left: 0;width: 200px;background-color: brown;">
            <a class="menu" href="/cmdb/user_info/">用户管理</a>
            <a class="menu" href="/cmdb/user_group/">用户组管理</a>
        </div>
        <div style="position:absolute;top:48px;left: 210px;bottom: 0;right: 0;overflow: auto">
        </div>
    </div>

</body>
</html>

user_info.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <style>
        body{
            margin: 0;
        }
        .menu{
            display: block;
            padding: 5px;

        }
    </style>
</head>
<body>
    <div style="height: 48px;background-color: black;color: white">
        Deployment
    </div>
    <div>
        <div style="position: absolute;top:48px;bottom: 0;left: 0;width: 200px;background-color: brown;">
            <a class="menu" href="/cmdb/user_info/">用户管理</a>
            <a class="menu" href="/cmdb/user_group/">用户组管理</a>
        </div>
        <div style="position:absolute;top:48px;left: 210px;bottom: 0;right: 0;overflow: auto">

            <h3>添加用户</h3>
            <form method="POST" action="/cmdb/user_info/">
                <input type="text" name="user" />
                <input type="text" name="pwd" />

                <select name="group_id">
                    {% for item in group_list %}
                        <option value="{{ item.uid }}">{{ item.caption }}</option>
                    {% endfor %}
                </select> 
 
                <input type="submit" value="添加"/>
            </form>

            <h3>用户列表</h3>
            <ul>
                {% for row in user_list %}
                    <li>
                        <a href="/cmdb/userdetail-{{ row.id }}/">{{ row.username }}</a> 
                        <span> {{ row.user_group.caption }} </span>
                        <a href="/cmdb/userdel-{{ row.id }}/">删除</a> |
                        <a href="/cmdb/useredit-{{ row.id }}/">编辑</a>
                    </li>
                {% endfor %}
            </ul>
        </div>
    </div>

</body>
</html>

user_detail.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <style>
        body{
            margin: 0;
        }
        .menu{
            display: block;
            padding: 5px;

        }
    </style>
</head>
<body>
    <div style="height: 48px;background-color: black;color: white">
        Deployment
    </div>
    <div>
        <div style="position: absolute;top:48px;bottom: 0;left: 0;width: 200px;background-color: brown;">
            <a class="menu" href="/cmdb/user_info/">用户管理</a>
            <a class="menu" href="/cmdb/user_group/">用户组管理</a>
        </div>
        <div style="position:absolute;top:48px;left: 210px;bottom: 0;right: 0;overflow: auto">

            <h1>用户详细信息</h1>

            <h5>{{ obj.id }}</h5>
            <h5>{{ obj.name }}</h5>
            <h5>{{ obj.password }}</h5>

        </div>

    </div>

</body>
</html>

user_edit.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <style>
        body{
            margin: 0;
        }
        .menu{
            display: block;
            padding: 5px;

        }
    </style>
</head>
<body>
    <div style="height: 48px;background-color: black;color: white">
        Deployment
    </div>
    <div>
        <div style="position: absolute;top:48px;bottom: 0;left: 0;width: 200px;background-color: brown;">
            <a class="menu" href="/cmdb/user_info/">用户管理</a>
            <a class="menu" href="/cmdb/user_group/">用户组管理</a>
        </div>
        <div style="position:absolute;top:48px;left: 210px;bottom: 0;right: 0;overflow: auto">

            <h1>编辑用户</h1>
            <form method="post" action="/cmdb/useredit-{{ obj.id }}/">
                <input style="display: none" type="text" name="id" value="{{ obj.id }}" />
                <input type="text" name="username" value="{{ obj.username }}" />
                <input type="text" name="password" value="{{ obj.password }}"/>
                <input type="submit" value="提交" />
            </form>

        </div>

    </div>

</body>
</html>