python Django教程 之 模型(数据库)自定义Field数据表更改QuerySet API

Posted Mr. Pan

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了python Django教程 之 模型(数据库)自定义Field数据表更改QuerySet API相关的知识，希望对你有一定的参考价值。

 　　　　　　　　　　　　　　python  Django教程  之 模型(数据库)、自定义Field、数据表更改、QuerySet API

 

 

一、Django 模型（数据库）

Django 模型是与数据库相关的，与数据库相关的代码一般写在 models.py 中，Django 支持 sqlite3, mysql, PostgreSQL等数据库，只需要在settings.py中配置即可，不用更改models.py中的代码，丰富的API极大的方便了使用。

本节的代码：（Django 1.6, Python 2.7 测试环境）

大家按照我步骤来开始做：

django-admin.py startproject learn_models # 新建一个项目
cd learn_models # 进入到该项目的文件夹
django-admin.py startapp people # 新建一个 people 应用（app)

补充：新建app也可以用 python manage.py startapp people, 需要指出的是，django-admin.py 是安装Django后多出的一个命令，并不是指一个 django-admin.py 脚本在当前目录下。

那么project和app什么关系呢，一个项目一般包含多个应用，一个应用也可以用在多个项目中。

 

将我们新建的应用（people）添加到 settings.py 中的 INSTALLED_APPS中，也就是告诉Django有这么一个应用。

INSTALLED_APPS = (
    \'django.contrib.admin\',
    \'django.contrib.auth\',
    \'django.contrib.contenttypes\',
    \'django.contrib.sessions\',
    \'django.contrib.messages\',
    \'django.contrib.staticfiles\',
    \'people\',
)

我们打开 people/models.py 文件，修改其中的代码如下：

from django.db import models
 
class Person(models.Model):
    name = models.CharField(max_length=30)
    age = models.IntegerField()

我们新建了一个Person类，继承自models.Model, 一个人有姓名和年龄。这里用到了两种Field，更多Field类型可以参考教程最后的链接。

 

我们来同步一下数据库

python manage.py syncdb # 进入 manage.py 所在的那个文件夹下输入这个命令
 
注意：Django 1.7 及以上的版本需要用以下命令
python manage.py makemigrations
python manage.py migrate

我们会看到，Django生成了一系列的表，也生成了我们新建的people_person这个表，那么如何使用这个表呢？

Django提供了丰富的API, 下面演示如何使用它。

$ python manage.py shell
 
>>> from people.models import Person
>>> Person.objects.create(name="WeizhongTu", age=24)
<Person: Person object>
>>>

我们新建了一个用户WeizhongTu 那么如何从数据库是查询到它呢？

>>> Person.objects.get(name="WeizhongTu")
<Person: Person object>
>>>

我们用了一个 .objects.get() 方法查询出来符合条件的对象，但是大家注意到了没有，查询结果中显示<Person: Person object>，这里并没有显示出与WeizhongTu的相关信息，如果用户多了就无法知道查询出来的到底是谁，查询结果是否正确，我们重新修改一下 people/models.py

name 和 age 等字段中不能有 __（双下划线，因为在Django QuerySet API中有特殊含义（用于关系，包含，不区分大小写，以什么开头或结尾，日期的大于小于，正则等）

也不能有Python中的关键字，name 是合法的，student_name 也合法，但是student__name不合法，try, class, continue 也不合法，因为它是Python的关键字( import keyword; print(keyword.kwlist) 可以打出所有的关键字)

 

from django.db import models
 
class Person(models.Model):
    name = models.CharField(max_length=30)
    age = models.IntegerField()
     
    def __unicode__(self):
    # 在Python3中使用 def __str__(self)
        return self.name

按CTRL + C退出当前的Python shell, 重复上面的操作，我们就可以看到:

新建一个对象的方法有以下几种：

  1. Person.objects.create(name=name,age=age)

  2. p = Person(name="WZ", age=23)

    p.save()

  3. p = Person(name="TWZ")

    p.age = 23

    p.save()

  4. Person.objects.get_or_create(name="WZT", age=23)

    这种方法是防止重复很好的方法，但是速度要相对慢些，返回一个元组，第一个为Person对象，第二个为True或False, 新建时返回的是True, 已经存在时返回False.

 

获取对象有以下方法：

  1. Person.objects.all()

  2. Person.objects.all()[:10] 切片操作，获取10个人，不支持负索引，切片可以节约内存

  3. Person.objects.get(name=name) 

    get是用来获取一个对象的，如果需要获取满足条件的一些人，就要用到filter

  4. Person.objects.filter(name="abc") # 等于Person.objects.filter(name__exact="abc") 名称严格等于 "abc" 的人

  5. Person.objects.filter(name__iexact="abc") # 名称为 abc 但是不区分大小写，可以找到 ABC, Abc, aBC，这些都符合条件 

  6. Person.objects.filter(name__contains="abc") # 名称中包含 "abc"的人

  7. Person.objects.filter(name__icontains="abc") #名称中包含 "abc"，且abc不区分大小写 

  8. Person.objects.filter(name__regex="^abc") # 正则表达式查询

  9. Person.objects.filter(name__iregex="^abc")# 正则表达式不区分大小写 

    filter是找出满足条件的，当然也有排除符合某条件的

  10. Person.objects.exclude(name__contains="WZ") # 排除包含 WZ 的Person对象

  11. Person.objects.filter(name__contains="abc").exclude(age=23) # 找出名称含有abc, 但是排除年龄是23岁的

 

 数据字段含义

 

1、models.AutoField　　自增列 = int(11)
　　如果没有的话，默认会生成一个名称为 id 的列，如果要显示的自定义一个自增列，必须将给列设置为主键 primary_key=True。
2、models.CharField　　字符串字段
　　必须 max_length 参数
3、models.BooleanField　　布尔类型=tinyint(1)
　　不能为空，Blank=True
4、models.ComaSeparatedIntegerField　　用逗号分割的数字=varchar
　　继承CharField，所以必须 max_lenght 参数
5、models.DateField　　日期类型 date
　　对于参数，auto_now = True 则每次更新都会更新这个时间；auto_now_add 则只是第一次创建添加，之后的更新不再改变。
6、models.DateTimeField　　日期类型 datetime
　　同DateField的参数
7、models.Decimal　　十进制小数类型 = decimal
　　必须指定整数位max_digits和小数位decimal_places
8、models.EmailField　　字符串类型（正则表达式邮箱） =varchar
　　对字符串进行正则表达式
9、models.FloatField　　浮点类型 = double
10、models.IntegerField　　整形
11、models.BigIntegerField　　长整形
　　integer_field_ranges = {
　　　　\'SmallIntegerField\': (-32768, 32767),
　　　　\'IntegerField\': (-2147483648, 2147483647),
　　　　\'BigIntegerField\': (-9223372036854775808, 9223372036854775807),
　　　　\'PositiveSmallIntegerField\': (0, 32767),
　　　　\'PositiveIntegerField\': (0, 2147483647),
　　}
12、models.IPAddressField　　字符串类型（ip4正则表达式）
13、models.GenericIPAddressField　　字符串类型（ip4和ip6是可选的）
　　参数protocol可以是：both、ipv4、ipv6
　　验证时，会根据设置报错
14、models.NullBooleanField　　允许为空的布尔类型
15、models.PositiveIntegerFiel　　正Integer
16、models.PositiveSmallIntegerField　　正smallInteger
17、models.SlugField　　减号、下划线、字母、数字
18、models.SmallIntegerField　　数字
　　数据库中的字段有：tinyint、smallint、int、bigint
19、models.TextField　　字符串=longtext
20、models.TimeField　　时间 HH:MM[:ss[.uuuuuu]]
21、models.URLField　　字符串，地址正则表达式
22、models.BinaryField　　二进制
23、models.ImageField   图片
24、models.FilePathField 文件
字段含义

 

 

字段参数

 

1、null=True
　　数据库中字段是否可以为空
2、blank=True
　　django的 Admin 中添加数据时是否可允许空值
3、primary_key = False
　　主键，对AutoField设置主键后，就会代替原来的自增 id 列
4、auto_now 和 auto_now_add
　　auto_now   自动创建---无论添加或修改，都是当前操作的时间
　　auto_now_add  自动创建---永远是创建时的时间
5、choices
GENDER_CHOICE = (
        (u\'M\', u\'Male\'),
        (u\'F\', u\'Female\'),
    )
gender = models.CharField(max_length=2,choices = GENDER_CHOICE)
6、max_length
7、default　　默认值
8、verbose_name　　Admin中字段的显示名称
9、name|db_column　　数据库中的字段名称
10、unique=True　　不允许重复
11、db_index = True　　数据库索引
12、editable=True　　在Admin里是否可编辑
13、error_messages=None　　错误提示
14、auto_created=False　　自动创建
15、help_text　　在Admin中提示帮助信息
16、validators=[]
17、upload-to
字段参数

 

 

数据库基本操作

1.基本操作

    • 增加：创建实例，并调用save
    • 更新：a.获取实例，再sava；b.update(指定列)
    • 删除：a. filter().delete(); b.all().delete()
    • 获取：a. 单个=get(id=1) ；b. 所有 = all()
    • 过滤：filter(name=\'xxx\');filter(name__contains=\'\');(id__in = [1,2,3]) ;
      icontains(大小写无关的LIKE),startswith和endswith, 还有range(SQLBETWEEN查询）\'gt\', \'in\', \'isnull\', \'endswith\', \'contains\', \'lt\', \'startswith\', \'iendswith\', \'icontains\',\'range\', \'istartswith\'
    • 排序：order_by("name") =asc ；order_by("-name")=desc
    • 返回第n-m条：第n条[0]；前两条[0:2]
    • 指定映射：values
    • 数量：count()
    • 聚合：from django.db.models import Min,Max,Sum objects.all().aggregate(Max(\'guest_id\'))
    • 原始SQL
    • cursor = connection.cursor()
cursor.execute(\'\'\'SELECT DISTINCT first_name ROM people_person WHERE last_name = %s""", [\'Lennon\'])
row = cursor.fetchone()

       

# 增
    #
    # models.Tb1.objects.create(c1=\'xx\', c2=\'oo\')  增加一条数据，可以接受字典类型数据 **kwargs

    # obj = models.Tb1(c1=\'xx\', c2=\'oo\')
    # obj.save()

    # 查
    #
    # models.Tb1.objects.get(id=123)         # 获取单条数据，不存在则报错（不建议）
    # models.Tb1.objects.all()               # 获取全部
    # models.Tb1.objects.filter(name=\'seven\') # 获取指定条件的数据

    # 删
    #
    # models.Tb1.objects.filter(name=\'seven\').delete() # 删除指定条件的数据

    # 改
    # models.Tb1.objects.filter(name=\'seven\').update(gender=\'0\')  # 将指定条件的数据更新，均支持 **kwargs
    # obj = models.Tb1.objects.get(id=1)
    # obj.c1 = \'111\'
    # obj.save()                                                 # 修改单条数据
基本操作

2、进阶操作（了不起的双下划线）

利用双下划线将字段和对应的操作连接起来

# 获取个数
    #
    # models.Tb1.objects.filter(name=\'seven\').count()

    # 大于，小于
    #
    # models.Tb1.objects.filter(id__gt=1)              # 获取id大于1的值
    # models.Tb1.objects.filter(id__lt=10)             # 获取id小于10的值
    # models.Tb1.objects.filter(id__lt=10, id__gt=1)   # 获取id大于1 且 小于10的值

    # in
    #
    # models.Tb1.objects.filter(id__in=[11, 22, 33])   # 获取id等于11、22、33的数据
    # models.Tb1.objects.exclude(id__in=[11, 22, 33])  # not in

    # contains
    #
    # models.Tb1.objects.filter(name__contains="ven")
    # models.Tb1.objects.filter(name__icontains="ven") # icontains大小写不敏感
    # models.Tb1.objects.exclude(name__icontains="ven")

    # range
    #
    # models.Tb1.objects.filter(id__range=[1, 2])   # 范围bettwen and

    # 其他类似
    #
    # startswith，istartswith, endswith, iendswith,

    # order by
    #
    # models.Tb1.objects.filter(name=\'seven\').order_by(\'id\')    # asc
    # models.Tb1.objects.filter(name=\'seven\').order_by(\'-id\')   # desc

    # limit 、offset
    #
    # models.Tb1.objects.all()[10:20]

    # group by
    from django.db.models import Count, Min, Max, Sum
    # models.Tb1.objects.filter(c1=1).values(\'id\').annotate(c=Count(\'num\'))
    # SELECT "app01_tb1"."id", COUNT("app01_tb1"."num") AS "c" FROM "app01_tb1" WHERE "app01_tb1"."c1" = 1 GROUP BY "app01_tb1"."id"
进阶操作

3、连表操作（了不起的双下划线）

利用双下划线和 _set 将表之间的操作连接起来

class UserProfile(models.Model):
    user_info = models.OneToOneField(\'UserInfo\')
    username = models.CharField(max_length=64)
    password = models.CharField(max_length=64)

    def __unicode__(self):
        return self.username


class UserInfo(models.Model):
    user_type_choice = (
        (0, u\'普通用户\'),
        (1, u\'高级用户\'),
    )
    user_type = models.IntegerField(choices=user_type_choice)
    name = models.CharField(max_length=32)
    email = models.CharField(max_length=32)
    address = models.CharField(max_length=128)

    def __unicode__(self):
        return self.name


class UserGroup(models.Model):

    caption = models.CharField(max_length=64)

    user_info = models.ManyToManyField(\'UserInfo\')

    def __unicode__(self):
        return self.caption


class Host(models.Model):
    hostname = models.CharField(max_length=64)
    ip = models.GenericIPAddressField()
    user_group = models.ForeignKey(\'UserGroup\')

    def __unicode__(self):
        return self.hostname
表结构实例
user_info_obj = models.UserInfo.objects.filter(id=1).first()
print user_info_obj.user_type
print user_info_obj.get_user_type_display()
print user_info_obj.userprofile.password
 
user_info_obj = models.UserInfo.objects.filter(id=1).values(\'email\', \'userprofile__username\').first()
print user_info_obj.keys()
print user_info_obj.values()
一对一操作
类似一对一
1、搜索条件使用 __ 连接
2、获取值时使用 .    连接
一对多
user_info_obj = models.UserInfo.objects.get(name=u\'武沛齐\')
user_info_objs = models.UserInfo.objects.all()
 
group_obj = models.UserGroup.objects.get(caption=\'CEO\')
group_objs = models.UserGroup.objects.all()
 
# 添加数据
#group_obj.user_info.add(user_info_obj)
#group_obj.user_info.add(*user_info_objs)
 
# 删除数据
#group_obj.user_info.remove(user_info_obj)
#group_obj.user_info.remove(*user_info_objs)
 
# 添加数据
#user_info_obj.usergroup_set.add(group_obj)
#user_info_obj.usergroup_set.add(*group_objs)
 
# 删除数据
#user_info_obj.usergroup_set.remove(group_obj)
#user_info_obj.usergroup_set.remove(*group_objs)
 
# 获取数据
#print group_obj.user_info.all()
#print group_obj.user_info.all().filter(id=1)
 
# 获取数据
#print user_info_obj.usergroup_set.all()
#print user_info_obj.usergroup_set.all().filter(caption=\'CEO\')
#print user_info_obj.usergroup_set.all().filter(caption=\'DBA\')
多对多
# F 使用查询条件的值
    #
    # from django.db.models import F
    # models.Tb1.objects.update(num=F(\'num\')+1)

    # Q 构建搜索条件
    from django.db.models import Q
    # con = Q()
    #
    # q1 = Q()
    # q1.connector = \'OR\'
    # q1.children.append((\'id\', 1))
    # q1.children.append((\'id\', 10))
    # q1.children.append((\'id\', 9))
    #
    # q2 = Q()
    # q2.connector = \'OR\'
    # q2.children.append((\'c1\', 1))
    # q2.children.append((\'c1\', 10))
    # q2.children.append((\'c1\', 9))
    #
    # con.add(q1, \'AND\')
    # con.add(q2, \'AND\')
    #
    # models.Tb1.objects.filter(con)

    #
    # from django.db import connection
    # cursor = connection.cursor()
    # cursor.execute("""SELECT * from tb where name = %s""", [\'Lennon\'])
    # row = cursor.fetchone()
复制代码
其他操作

注意：xx_set中的[_set]是多对多中的固定搭配

扩展：

a、自定义上传

def upload_file(request):
    if request.method == "POST":
        obj = request.FILES.get(\'fafafa\')
        f = open(obj.name, \'wb\')
        for chunk in obj.chunks():
            f.write(chunk)
        f.close()
    return render(request, \'file.html\')
自定义上传文件

b、Form上传文件实例

class FileForm(forms.Form):
    ExcelFile = forms.FileField()
From
from django.db import models

class UploadFile(models.Model):
    userid = models.CharField(max_length = 30)
    file = models.FileField(upload_to = \'./upload/\')
    date = models.DateTimeField(auto_now_add=True)
module
def UploadFile(request):
    uf = AssetForm.FileForm(request.POST,request.FILES)
    if uf.is_valid():
            upload = models.UploadFile()
            upload.userid = 1
            upload.file = uf.cleaned_data[\'ExcelFile\']
            upload.save()
            
            print upload.file
View

django中的Form一般有两种功能：

  • 输入html
  • 验证用户输入
复制代码
#!/usr/bin/env python
# -*- coding:utf-8 -*-
import re
from django import forms
from django.core.exceptions import ValidationError


def mobile_validate(value):
    mobile_re = re.compile(r\'^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$\')
    if not mobile_re.match(value):
        raise ValidationError(\'手机号码格式错误\')


class PublishForm(forms.Form):

    user_type_choice = (
        (0, u\'普通用户\'),
        (1, u\'高级用户\'),
    )

    user_type = forms.IntegerField(widget=forms.widgets.Select(choices=user_type_choice,
                                                                  attrs={\'class\': "form-control"}))

    title = forms.CharField(max_length=20,
                            min_length=5,
                            error_messages={\'required\': u\'标题不能为空\',
                                            \'min_length\': u\'标题最少为5个字符\',
                                            \'max_length\': u\'标题最多为20个字符\'},
                            widget=forms.TextInput(attrs={\'class\': "form-control",
                                                          \'placeholder\': u\'标题5-20个字符\'}))

    memo = forms.CharField(required=False,
                           max_length=256,
                           widget=forms.widgets.Textarea(attrs={\'class\': "form-control no-radius", \'placeholder\': u\'详细描述\', \'rows\': 3}))

    phone = forms.CharField(validators=[mobile_validate, ],
                            error_messages={\'required\': u\'手机不能为空\'},
                            widget=forms.TextInput(attrs={\'class\': "form-control",
                                                          \'placeholder\': u\'手机号码\'}))

    email = forms.EmailField(required=False,
                            error_messages={\'required\': u\'邮箱不能为空\',\'invalid\': u\'邮箱格式错误\'},
                            widget=forms.TextInput(attrs={\'class\': "form-control", \'placeholder\': u\'邮箱\'}))
From
def publish(request):
    ret = {\'status\': False, \'data\': \'\', \'error\': \'\', \'summary\': \'\'}
    if request.method == \'POST\':
        request_form = PublishForm(request.POST)
        if request_form.is_valid():
            request_dict = request_form.clean()
            print request_dict
            ret[\'status\'] = True
        else:
            error_msg = request_form.errors.as_json()
            ret[\'error\'] = json.loads(error_msg)
    return HttpResponse(json.dumps(ret))
View

 

 

 

二、Django 自定义Field

 

Django 的官方提供了很多的 Field，但是有时候还是不能满足我们的需求，不过Django提供了自定义 Field 的方法：

提示：如果现在用不到可以跳过这一节，不影响后面的学习，等用到的时候再来学习不迟。

来一个简单的例子吧。

1. 减少文本的长度，保存数据的时候压缩，读取的时候解压缩，如果发现压缩后更长，就用原文本直接存储：

Django 1.7 以下

from django.db import models
 
class CompressedTextField(models.TextField):
    """    model Fields for storing text in a compressed format (bz2 by default)    """
    __metaclass__ = models.SubfieldBase
 
    def to_python(self, value):
        if not value:
            return value
 
        try:
            return value.decode(\'base64\').decode(\'bz2\').decode(\'utf-8\')
        except Exception:
            return value
 
    def get_prep_value(self, value):
        if not value:
            return value
 
        try:
            value.decode(\'base64\')
            return value
        except Exception:
            try:
                tmp = value.encode(\'utf-8\').encode(\'bz2\').encode(\'base64\')
            except Exception:
                return value
            else:
                if len(tmp) > len(value):
                    return value
 
                return tmp

to_python 函数用于转化数据库中的字符到 Python的变量， get_prep_value 用于将Python变量处理后(此处为压

以上是关于python Django教程 之 模型(数据库)自定义Field数据表更改QuerySet API的主要内容，如果未能解决你的问题，请参考以下文章

Python基础之 Django模型

4Python全栈之路系列之Django模型

模型的元数据Meta -- Django从入门到精通系列教程

62django之MTV模型（urls,view）

Django项目的ORM操作之--模型类数据查询

Django视频教程 - 基于Python的Web框架（全13集)