模型是MVC架构中访问数据的模块,Django的模型对各种数据库提供了很好的支持。这里以MySQL为例介绍Django的模型。
使用模型
启用数据库支持
在项目的 settings.py 文件中找到 DATABASES 配置项, 根据数据库配置信息:
DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'test', 'USER': 'testuser', 'PASSWORD': '123456', 'HOST': 'localhost', 'PORT': '3306', }}
Django的目录结构包括Project和App两层, 同一个Project下的不同App共享Project的数据库连接。
settins.py中INSTALLED_APPS用来维护Project中的APP包括自定义APP和插件APP.
必须在INSTALLED_APPS中添加APP的名称字符串,该APP才可以使用模型。
实现模型类
ORM (Object Relational Mapping,对象关系映射)将程序员定义的类映射为数据表。Django提供了优秀的ORM实现。
一般在model.py中定义相关模型,模型类需要继承django.db.models.Model
。
类名代表数据表名,类中的字段代表数据表中的字段, 类的一个实例表示一条数据记录。
将primary_key关键字参数置为True,即可添加主键约束。
在未指定primary_key的情况下,Django会默认创建一个id
自增字段作为主键。
示例:
from django.db import modelsclass Account(models.Model): account_name = models.CharField(max_length=20) account_id = models.IntegerField(primary_key=True) balance = models.DecimalField(max_digits=2, decimal_places=2)
同步数据库
manage.py中提供了同步数据库的命令,在项目目录下依次执行命令
python manage.py makemigrations
python manage.py migrate
在修改数据库结构后只需要重新同步数据库即可。
终端交互历史:
E:\workspace\Django\ThirdDjango>python manage.py makemigrationsMigrations for 'ModelDjango': 0001_initial.py: - Create model AccountE:\workspace\Django\ThirdDjango>python manage.py migrateOperations to perform: Apply all migrations: admin, ModelDjango, contenttypes, auth, sessionsRunning migrations: Rendering model states... DONE Applying ModelDjango.0001_initial... OK
注意在Django1.7及以后版本中python manage.py syncdb
已被移除。
字段
django.db.models
模块中定义了大量标准字段,常用的包括:
CharField
SQL中的varchar类型,max_length关键字参数指定长度。
account_name = models.CharField(max_length=20)
IntegerField
整数字段
account_id = models.IntegerField(primary_key=True)
DecimalField
decimal类型,max_digits指定总位数, decimal_places指定小数位数
balance = models.DecimalField(max_digits=2, decimal_places=2)
AutoField
从1开始自增的整型字段
id = models.AutoField()
DateTimeField
SQL中的datetime类型, 使用Python中的datetime.datetime类型表示
使用下面的构造函数构造一个datetime对象
datetime.datetime (year, month, day[ , hour[ , minute[ , second[ , microsecond[ , tzinfo]]]]])
关于Python的datetime模块详情可以参考.
可以使用auto_now=True
关键字参数使实例每次执行save()时该字段自动保存save时间,不允许手动赋值。
更多标准字段请见Django Book:
关系字段
关系字段用于保存数据表之间的关系,包括ForeignKey, ManyToManyField等。
请参见
修改数据
在建立模型后Django提供了一系列API进行数据操作,取代原始SQL语句。
添加数据记录
实例化模型类,用关键字参数对各列赋值,并调用对象的save()方法将对象写入数据库。
示例:
account_john = Account(account_name='john', accouunt_id='123', balance=0);account_john.save()
save()方法没有返回值,在显式调用save()之前不会访问数据库.Account实例的字段是可以直接访问或修改的.
或者调用model_class.objects.create()
Account.objects.create(account_name='john', accouunt_id='123', balance=0)
或者使用:
Account.objects.get_or_create(account_name='john', accouunt_id='123', balance=0)
删除数据记录
调用数据记录的delete()方法可以删除数据记录。
account.delete()
查询数据
查询数据使用QuerySet API。 QuerySet是惰性执行的,创建Query Set不会访问数据库,只有在访问具体查询结果的时候才会访问数据库。
获取数据表的全部数据记录:
Account.objects.all()
返回值可以进行切片,但不支持负索引。或者使用:
Account.objects.get(field_name=val)
示例:
Account.objects.get(account_name='john')
或者使用过滤器查询多条记录:
严格等于Account.objects.filter(accounnt_name=val)
忽略大小写Account.objects.filter(account_name__iexact=val)
名称中包含valAccount.objects.filter(account_name__contains=val)
忽略大小写,包含Account.objects.filter(account_name__icontains=val)
正则表达式Account.objects.filter(account_name__regex=val)
正则表达式,忽略大小写Account.objects.filter(account_name__iregex=val)
与filter相反exclude用于返回不满足条件的查询结果。
Account.objects.exclude(account_name__contains=val)
filter与exclude可以进行链式查询
Account.objects.exclude(account_name__contains='john').exlucde(balance=0)
对于查询结果可以使用distinct()去重或者使用order_by(field)进行排序。
Account.objects.filter(account_name__regex=val).distinct()
Account.objects.filter(account_name__regex=val).oreder_by('balance')
使用reverse()方法可以反转结果集中的元素顺序,调用两次将会恢复原顺序。
从SQL 的角度,QuerySet和SELECT 语句等价,过滤器是像WHERE 和LIMIT 一样的限制子句。
使用原生SQL
在模型查询API不够用的情况下,你可以使用原始的SQL语句。Django提供两种方法使用原始SQL进行查询。
一种是使用Model.objects.raw()方法,并进行原始查询并返回模型实例:
Account.objects.filter('select * from account')
这种方法为延迟执行,如:
for a in Account.objects.filter('select account_name, balance from account'): print(a.account_name, a.account_id)
上述语句实际上执行了3次查询,account_name在raw中被查询, account_id在打印时被查询。
另一种是完全避开模型层,直接执行自定义的SQL语句。
from django.db import connectiondef my_account_sql(self): cursor = connection.cursor() cursor.execute("UPDATE account SET account_id = 1 WHERE baz = %s", [self.baz]) cursor.execute("SELECT foo FROM bar WHERE baz = %s", [self.baz]) row = cursor.fetchone() return row
与其它数据库connection的用法非常类似。
编写原始的SQL语句时,应该格外小心。 每次使用的时候,都要确保转义了参数中任何用户可以控制的字符,以防受到SQL注入攻击。