Django中Model的使用方法教程

前言

本文主要给大家介绍了关于Django中Model使用的相关内容,分享出来供大家参考学习,下面话不多说了,来一起看看详细的介绍吧。

创建模型

使用Django的模型主要注意两个方面:字段的类型和方法的重写。这里用一个例子来说明,其中包含了常用的字段类型和如何重写方法。

from django.db import models

class School(models.Model):

pass

class Message(models.Model):

pass

class Teacher(models.Model):

pass

class Student(models.Model):

GENDER_CHOICES = (

('male', "男"),

('female', "女"),

('secret', "保密")

)

name = models.CharField(max_length=40, blank=True, verbose_name="姓名")

gender = models.CharField(max_length=6, choices=GENDER_CHOICES, default="secret", verbose_name="性别")

age = models.IntegerField(default=0, verbose_name="年龄")

rank = models.PositiveIntegerField(default=1, verbose_name="排名", unique=True)

discount = models.DecimalField(max_digits=3, decimal_places=2, verbose_name="折扣", default=1.0)

school = models.ForeignKey(to=School, verbose_name="学校", on_delete=models.CASCADE)

message = models.OneToOneField(to=Message, verbose_name="信息", on_delete=models.CASCADE)

teacher = models.ManyToManyField(verbose_name="老师", to=Teacher, blank=True)

introduce = models.TextField(blank=True, verbose_name="介绍")

grade = models.FloatField(default=0.0, verbose_name="成绩")

url = models.URLField(verbose_name="个人主页", max_length=100)

email = models.EmailField(verbose_name="邮箱")

image = models.ImageField(upload_to='img/%Y/%m/%d/', verbose_name='上传图片', null=True)

file = models.FileField(upload_to="file/%Y/%m/%d/", verbose_name="上传文件", blank=True)

is_deleted = models.BooleanField(verbose_name="已删除", default=False, blank=True)

time_added = models.DateTimeField(verbose_name="添加时间", auto_now_add=True, blank=True)

def delete(self, using=None, keep_parents=False):

self.is_deleted = True

# some actions

self.save()

def save(self, force_insert=False, force_update=False, using=None,

update_fields=None):

# some actions

self.name = self.name.capitalize() # 首字母大写

return super().save(force_insert=force_insert, force_update=force_update, using=using,

update_fields=update_fields)

def __repr__(self):

return "UserProfile:{}".format(self.name)

def __str__(self):

return self.name

class Meta:

ordering = ['-time_added']

verbose_name = "用户信息"

verbose_name_plural = verbose_name

db_table = "student_info"

字段类型

这里对常见字段中值得注意的地方作一下说明。

CharField

字符串类型值得注意的是当该字段只能在是某些指定的值时,要使用choices参数来指向预先设定的值。

IntergerField & PositiveIntegerField

整数类型和正整数类型。

DecimalField

十进制浮点数,其中,参数max_digits代表数字有多少位,decimal_places代表小数部分有多少位。

ForeignKey

使用to指向被关联的模型,使用on_delete来规定被关联对象删除时该对象的处理方式。主要有两种取值,models.CASCADE和models.SET_NULL。models.CASCADE表示当被关联对象删除时删除该对象,models.SET_NULL表示当被关联对象被删除时将该对象设置为空,此设置的前提是该字段要允许为空。

ImageField & FileField

使用upload_to参数来指定文件保存的路径。注意,该路径前面再加上 MEDIA_ROOT中设置的路径就是上传的文件真实保存路径了,如 MEDIA_ROOT的路径是'/home/media',那图片上传的路径就类似/home/media/img/2018/03/06。

BooleanField

布尔类型,可以使用default指定默认值。

DateTimeField

在Django中,代表时间字段的有三种:DateTimeField、DateField、TimeField,三种类型分别对应datetime()、date()、time(),都有auto_now和auto_now_add参数。

  • auto_now

    默认值为False,设置为True时会在每次修改该对象时自动更新为当前时间,但是无法手动修改该字段的值。

  • auto_now_add

    默认值为False,设置为True时会在创建对象时自动设置为当前时间,之后都不再修改,也不能手动修改其值。

  • 默认当前时间,又能修改

    有时候我们需要在创建对象时设置字段的值为当前时间,在后续时又能修改,使用auto_now或者auto_now_add都无法实现这一点。此时,可以使用default参数来设置默认值,如下

from django.db import models

from django.utils import timezone

class Message(models.Model):

add_date = models.DateTimeField(verbose_name='保存日期',default = timezone.now)

mod_date = models.DateTimeField(verbose_name='最后修改日期', auto_now = True)

重写方法

delete

Django默认的删除是将数据从数据库里删除,有时候我们需要软删除,保存以前的数据,这时候我们可以使用一个布尔类型的字段标识该条数据是否删除,这时需要重写delete方法实现软删除。

在delete方法中将is_deleted的值设置为True,表示该条数据已删除。此外还可以执行一些关联的动作,比如对相关字段赋值等,最后保存对象。

save

重写save方法可以让我们在保存数据时做一些相关的操作,比如保存姓名时自动设置为首字母大写,执行完之后需要调用父类的save方法进行保存。

repr & str

两者的作用是将变量或者常量转换为字符串对象,这里重写该方法使得对象实例能被转化为字符串。

class Meta

  • ordering:结果集按照何种方式排序,上面例子表示按添加时间的逆序排序
  • verbose_name:对象的名称
  • verbose_name_plural:对象复数形式的名称
  • db_table:在数据库中的表名

常用方法

在对常用方法介绍部分,由于上面的模型包含字段较多,所以不使用上面创建的模型。这里使用一些常见的模型,通过名字就可以知道代表的内容,因此就不列出模型了。

创建实例

create

使用create方法可以创建一个模型实例,将各字段在参数中设置各个字段的值。

student = Student.objects.create(name='zhangsan', gender='male')

get_or_create

get_or_create的作用是查询一个实例,当实例不存在时则创建一个实例。

obj, created = Person.objects.get_or_create(

first_name='John',

last_name='Lennon',

defaults={'birthday': date(1940, 10, 9)},

)

函数返回一个(object, created)的tuple,object是查询或者创建的对象实例,created是个布尔类型的值,表示是否是新创建的实例。在查询时使用defaults以外的参数进行查询,当实例不存在时将包含default参数一起创建一个新的实例。功能类似于如下代码:

try:

obj = Person.objects.get(first_name='John', last_name='Lennon')

except Person.DoesNotExist:

obj = Person(first_name='John', last_name='Lennon', birthday=date(1940, 10, 9))

obj.save()

update_or_create

update_or_create的作用是更新一个实例,当实力不存在时则创建一个实例。

obj, created = Person.objects.update_or_create(

first_name='John', last_name='Lennon',

defaults={'first_name': 'Bob'},

)

函数返回一个(object, created)的tuple,object是更新或者创建的对象实例,created是个布尔类型的值,表示是否是新创建的实例。在查询的对象实例存在时,使用default中的参数进行更新,当实例不存在时,创建新的对象实例,需要更新的字段的值设置为default中的值。功能类似:

defaults = {'first_name': 'Bob'}

try:

obj = Person.objects.get(first_name='John', last_name='Lennon')

for key, value in defaults.items():

setattr(obj, key, value)

obj.save()

except Person.DoesNotExist:

new_values = {'first_name': 'John', 'last_name': 'Lennon'}

new_values.update(defaults)

obj = Person(**new_values)

obj.save()

add

这里补充一下add方法,add用在多对多的关系模型上,表示添加该字段的指向对象。

>>> john = Author.objects.create(name="John")

>>> paul = Author.objects.create(name="Paul")

>>> george = Author.objects.create(name="George")

>>> ringo = Author.objects.create(name="Ringo")

>>> entry.authors.add(john, paul, george, ringo)

上面的Author表示作者模型,entry表示书籍条目,一本书可以有多个作者,采用多对多关系。add可以为书的实例添加多个作者。

查询

all

all方法查询该对象的所有实例。

all_entries = Entry.objects.all()

get

使用get查询实例,当实例不存在时会返回一个不存在异常。

>>> entry = Entry.objects.get(pk=1)

>>> cheese_blog = Blog.objects.get(name="Cheddar Talk")

filter

filter返回一个QuerySet,而不是对象实例,当查询结果不存在时返回空的QuerySet,而不是返回一场,可以对结果集作切片操作来获取实例内容。下面代码功能在有对象实例时等同于上面get的操作。

>>> entry = Entry.objects.filter(pk=1)[0]

>>> cheese_blog = Blog.objects.filter(name="Cheddar Talk")[0]

filter结果可以链式地进行操作,也就是后面可以接多个过滤条件。

Entry.objects.filter(pub_date__year=2006)

Entry.objects.all().filter(pub_date__year=2006)

Entry.objects.filter(blog__name__year="zhangsan")

上面的pub_date__year表示取出DateField类型的pub_date的年,类似的可以取出月__month,日__day。在使用外键ForeignKey时可以使用双下划线来表示被关联对象的字段。

现在来看一下链式过滤的例子。

Entry.objects.filter(

... headline__startswith='What'

... ).exclude(

... pub_date__gte=datetime.date.today()

... ).filter(

... pub_date__gte=datetime.date(2005, 1, 30)

... )

首先使用__startswith过滤标题以'What'开始的数据。然后保留让发布日期小于今天的数据,exclude表示排除条件内的那部分数据,条件使用了__gte表示大于当前日期,该部分过滤类似于filter后面使用__lte小于。最后也是使用__gte大于一个自定义的日期。

除了上面的过滤条件外,常见的还有__icontains,表示包含该内容。

Q

Q是Django自带的内容,用于查询。主要的用途是在页面的搜索框中输入内容后台查询相应的数据集。

student = student.filter(Q(name__icontains=search) |

Q(teacher__name__icontains=search) |

Q(gender__icontains=search) |

Q(url__icontains=search))

上述例子常用在一个搜索框可能搜索多个字段的内容时,各个过滤条件之间使用“|”进行或者运算。当多条件查询时,各个条件是并运算,使用“&”代替“|”。

Q可以复制给个变量,有时候我们需要对Q后面的内容先做一些处理,如将日期拼凑出来等,这时候可以先把Q赋值给一个变量,然后对变量进行“|”或者“&”操作。

query = Q(name__icontains=search)

query = query | Q(teacher__name__icontains=search)

student = student.filter(query)

总结

以上是 Django中Model的使用方法教程 的全部内容, 来源链接: utcz.com/z/319249.html

回到顶部