四 Django框架,models.py模块，数据库操作——创建表、数据类型、索引、admin后台，补充Django目录说明以及全局配置文件配置
Django框架,models.py模块，数据库操作——创建表、数据类型、索引、admin后台，补充Django目录说明以及全局配置文件配置
数据库配置
django默认支持sqlite，mysql, oracle,postgresql数据库。
1，django默认使用sqlite的数据库，默认自带sqlite的数据库驱动
引擎名称：django.db.backends.sqlite3
在全局配置文件settings.py可以看到确认配置使用的sqlite数据库
# Database
# https://docs.djangoproject.com/en/1.10/ref/settings/#databases
# 默认配置使用的sqlite数据库
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3', #配置数据库引擎名称
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'), #生成数据库到当前的项目文件夹里
}
}
所以我们首次运行程序时会在目录生成db.sqlite3数据库
2，MySQL数据库【重点】
mysql驱动程序
MySQLdb(mysql python)
mysqlclient
MySQL
PyMySQL(纯python的mysql驱动程序)
在django的项目中会默认使用sqlite数据库，如果要使用MySQL数据库需要重新配置MySQL数据库信息，将sqlite数据库注释掉
在settings.py配置MySQL数据库信息
#MySQL数据库
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql', #配置数据库引擎名称
'NAME': 'jxiou', #数据库名称
'USER': 'root', #数据库用户名
'PASSWORD': '279819', #数据库密码
'HOST': '127.0.0.1', #数据库链接地址
'PORT': '3306', #数据库端口
}
}
注意：NAME即数据库的名字，在mysql连接前该数据库必须已经创建，而上面的sqlite数据库下的db.sqlite3则是项目自动创建
USER和PASSWORD分别是数据库的用户名和密码。
设置完后，再启动我们的Django项目前，需要激活我们的mysql。
然后，启动项目，会报错：no module named MySQLdb
这是因为django默认你导入的驱动是MySQLdb，可是MySQLdb对于py3有很大问题，所以我们需要的驱动是PyMySQL
所以，我们只需要找到项目里的全局配置里的__init__,py配置数据库驱动
在里面写入：
import pymysql pymysql.install_as_MySQLdb()
此时django框架连接MySQL数据库配置好了
给PyCharm安装MySQL数据库管理插件
配置数据库信息
下载数据库管理插件
django创建数据库表
在操作数据库表之前，首先检查一下全局配置文件settings.py里的数据库表操作配置里是否配置了应用路径，如果没有需要加入应用路径
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'app1',
]
配置好了我们开始创建表
对数据库表的操作都是由django下db模块的models对象来操作的，所以需要导入这个对象
注意：一张表对应一个类
首先要创建一个类来操作一张表，而这个类必须继承models.Model对象
注意创建表之前，必须要先创建好数据库
from __future__ import unicode_literals
from django.db import models #导入models对象
class userinfo(models.Model): #创建类必须继承models.Model，类名将是在数据库里的表名称
#不设置主键id将自动创建
anem = models.CharField("用户名",max_length=50) #设置一个anem名称的字符串字段,最大长度50位，在django后台显示名称为：用户名
address = models.CharField("地址", max_length=50)
city = models.CharField('城市', max_length=60)
country = models.CharField(max_length=50)
class Meta:
verbose_name = '用户表' #设置表名称在django后台显示的中文名称
verbose_name_plural = verbose_name
def __str__(self): #设置在django后台显示字段名称
return self.anem
设置好操作表的类后，我们需要生成表，生成表需要在PyCharm的终端输入命令，先输入 makemigrations 然后在输入 migrate 来生成表
此时表就生成了
注意：我们已经生成了需要的表，也包含我们自定义的userinfo表，此时数据库里的django_migrations表记录了，我们生成表时的信息，
如果我们将我们的userinfo表，删除后，在执行命令重建我们的userinfo表，将无法生成，因为django_migrations表记录了你已经生成了
解决方法：
现将项目里migrations目录下的缓存删除
在重新执行命令，makemigrations 然后在输入 migrate 来生成表，会提示你已经生成了这个表
我们打开django_migrations表里找到，与现在migrations目录下缓存名称相同的记录
我们把django_migrations表里的这条记录，删除后，就可以再次生成了
重点：注意只删除django_migrations表里，与现在migrations目录下缓存名称相同的记录，否则将出问题
配置django的admin数据库管理后台
首先配置数据库后台路由映射
from django.conf.urls import url
from django.contrib import admin
from app1 import views
urlpatterns = [
url(r'admin/', admin.site.urls), #路由映射admin数据库管理
url(r'articles/', views.special) #路由映射第三个参数，额外传参，字典方式，逻辑处理函数以参数方式接收字典键
]
然后在PyCharm终端输入命令 Python manage.py createsuperuser
1、设置用户名
2、设置邮箱
3、设置密码，8位以上，不能纯数字
4、确认密码
然后用刚才设置的用户名和密码登录
只能看到刚才创建的用户登录数据，数据库数据需要在项目的admin.py里注册才能看到
admin.site.register(参数是数据库操作表的类)，注册数据库到admin数据库管理，参数是models.py里操作数据库表的类
from django.contrib import admin from app1.models import * admin.site.register(userinfo) #注册数据库到admin数据库管理，参数是models.py里操作数据库表的类
此时，可以看到admin管理页面已经出现了我们刚才创建的，用户表，显示的是中文，而且字段，也是中文，因为我们在用户表类里设置了admin显示中文的名称
from __future__ import unicode_literals
from django.db import models #导入models对象
class userinfo(models.Model): #创建类必须继承models.Model，类名将是在数据库里的表名称
#不设置主键id将自动创建
anem = models.CharField("用户名",max_length=50) #设置一个anem名称的字符串字段,最大长度50位，在django后台显示名称为：用户名
address = models.CharField("地址", max_length=50)
city = models.CharField('城市', max_length=60)
country = models.CharField(max_length=50)
class Meta:
verbose_name = '用户表' #设置表名称在django后台显示的中文名称
verbose_name_plural = verbose_name
def __str__(self): #设置在django后台显示字段名称
return self.anem
我们创建一条数据看看
此时我们看到只显示了一个字段
此时，我们需要配置admin显示所有字段
方法：找到项目应用里的admin.py文件，在注册表到admin哪里添加一个类，类继承admin.ModelAdmin类
配置好相应字段后，将类同表一起注册到admin
from django.contrib import admin
from app1.models import *
#配置userinfo表在admin的显示信息
class userinfoAdmin(admin.ModelAdmin):
# 配置显示字段,
list_display = ('anem', 'address','city','country')
# 配置查询字段
search_fields = ('anem','city')
# 配置排序字段
ordering = ('-id',)
# 配置右边是否有过滤条件字段
list_filter = ('address',)
admin.site.register(userinfo,userinfoAdmin) #注册数据库到admin数据库管理，参数是models.py里操作数据库表的类
下面介绍表的数据类型，以及参数
from __future__ import unicode_literals
from django.db import models #导入models对象
class userinfo(models.Model): #创建类必须继承models.Model，类名将是在数据库里的表名称
#不设置主键id将自动创建
anem = models.CharField("用户名",max_length=50) #设置一个anem名称的字符串字段,最大长度50位，在django后台显示名称为：用户名
address = models.CharField("地址", max_length=50)
city = models.CharField('城市', max_length=60)
country = models.CharField('性别',max_length=50)
class Meta:
verbose_name = '用户表' #设置表名称在django后台显示的中文名称
verbose_name_plural = verbose_name
def __str__(self): #设置在django后台显示字段名称
return self.anem
上面我们只用到了CharField()，也就是varchar字符串类型，参数也只用到max_length=50，最大长度50位
models对象的数据类型
AutoField(Field)
- int自增列，必须填入参数 primary_key=True
BigAutoField(AutoField)
- bigint自增列，必须填入参数 primary_key=True
注：当model中如果没有自增列，则自动会创建一个列名为id的列
from django.db import models
class UserInfo(models.Model):
# 自动创建一个列名为id的且为自增的整数列
username = models.CharField(max_length=32)
class Group(models.Model):
# 自定义自增列
nid = models.AutoField(primary_key=True)
name = models.CharField(max_length=32)
SmallIntegerField(IntegerField):
- 小整数 -32768 ～ 32767
PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
- 正小整数 0 ～ 32767
IntegerField(Field)
- 整数列(有符号的) -2147483648 ～ 2147483647
PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
- 正整数 0 ～ 2147483647
BigIntegerField(IntegerField):
- 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807
自定义无符号整数字段
class UnsignedIntegerField(models.IntegerField):
def db_type(self, connection):
return 'integer UNSIGNED'
PS: 返回值为字段在数据库中的属性，Django字段默认的值为：
'AutoField': 'integer AUTO_INCREMENT',
'BigAutoField': 'bigint AUTO_INCREMENT',
'BinaryField': 'longblob',
'BooleanField': 'bool',
'CharField': 'varchar(%(max_length)s)',
'CommaSeparatedIntegerField': 'varchar(%(max_length)s)',
'DateField': 'date',
'DateTimeField': 'datetime',
'DecimalField': 'numeric(%(max_digits)s, %(decimal_places)s)',
'DurationField': 'bigint',
'FileField': 'varchar(%(max_length)s)',
'FilePathField': 'varchar(%(max_length)s)',
'FloatField': 'double precision',
'IntegerField': 'integer',
'BigIntegerField': 'bigint',
'IPAddressField': 'char(15)',
'GenericIPAddressField': 'char(39)',
'NullBooleanField': 'bool',
'OneToOneField': 'integer',
'PositiveIntegerField': 'integer UNSIGNED',
'PositiveSmallIntegerField': 'smallint UNSIGNED',
'SlugField': 'varchar(%(max_length)s)',
'SmallIntegerField': 'smallint',
'TextField': 'longtext',
'TimeField': 'time',
'UUIDField': 'char(32)',
BooleanField(Field)
- 布尔值类型
NullBooleanField(Field):
- 可以为空的布尔值
CharField(Field)
- 字符类型
- 必须提供max_length参数， max_length表示字符长度
TextField(Field)
- 文本类型
EmailField(CharField)：
- 字符串类型，Django Admin以及ModelForm中提供验证机制
IPAddressField(Field)
- 字符串类型，Django Admin以及ModelForm中提供验证 IPV4 机制
GenericIPAddressField(Field)
- 字符串类型，Django Admin以及ModelForm中提供验证 Ipv4和Ipv6
- 参数：
protocol，用于指定Ipv4或Ipv6， 'both',"ipv4","ipv6"
unpack_ipv4， 如果指定为True，则输入::ffff:192.0.2.1时候，可解析为192.0.2.1，开启刺功能，需要protocol="both"
URLField(CharField)
- 字符串类型，Django Admin以及ModelForm中提供验证 URL
SlugField(CharField)
- 字符串类型，Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符（减号）
CommaSeparatedIntegerField(CharField)
- 字符串类型，格式必须为逗号分割的数字
UUIDField(Field)
- 字符串类型，Django Admin以及ModelForm中提供对UUID格式的验证
FilePathField(Field)
- 字符串，Django Admin以及ModelForm中提供读取文件夹下文件的功能
- 参数：
path, 文件夹路径
match=None, 正则匹配
recursive=False, 递归下面的文件夹
allow_files=True, 允许文件
allow_folders=False, 允许文件夹
FileField(Field)
- 字符串，路径保存在数据库，文件上传到指定目录
- 参数：
upload_to = "" 上传文件的保存路径
storage = None 存储组件，默认django.core.files.storage.FileSystemStorage
ImageField(FileField)
- 字符串，路径保存在数据库，文件上传到指定目录
- 参数：
upload_to = "" 上传文件的保存路径
storage = None 存储组件，默认django.core.files.storage.FileSystemStorage
width_field=None, 上传图片的高度保存的数据库字段名（字符串）
height_field=None 上传图片的宽度保存的数据库字段名（字符串）
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类型
FloatField(Field)
- 浮点型
DecimalField(Field)
- 10进制小数
- 参数：
max_digits，小数总长度
decimal_places，小数位长度
BinaryField(Field)
- 二进制类型
数据类型参数
null 数据库中字段是否可以为空
db_column 数据库中字段的列名
db_tablespace
default 数据库中字段的默认值
primary_key 数据库中字段是否为主键
auto_now 和 auto_now_add
auto_now 会自动创建时间字段，无论添加或者修改，都是系统当前时间
auto_now_add 会自动创建时间字段，永远是创建时的时间
db_index 数据库中字段是否可以建立索引
unique 数据库中字段是否可以建立唯一索引
unique_for_date 数据库中字段【日期】部分是否可以建立唯一索引
unique_for_month 数据库中字段【月】部分是否可以建立唯一索引
unique_for_year 数据库中字段【年】部分是否可以建立唯一索引
verbose_name Admin中显示的字段名称
blank Admin中是否允许用户输入为空
editable Admin中是否可以编辑
help_text Admin中该字段的提示信息
choices Admin中显示选择框的内容，用不变动的数据放在内存中从而避免跨表操作
如：gf = models.IntegerField(choices=[(0, '何穗'),(1, '大表姐'),],default=1)
error_messages 自定义错误信息（字典类型），从而定制想要显示的错误信息；
字典健：null, blank, invalid, invalid_choice, unique, and unique_for_date
如：{'null': "不能为空.", 'invalid': '格式错误'}
validators 自定义错误验证（列表类型），从而定制想要的验证规则
from django.core.validators import RegexValidator
from django.core.validators import EmailValidator,URLValidator,DecimalValidator,\
MaxLengthValidator,MinLengthValidator,MaxValueValidator,MinValueValidator
如：
test = models.CharField(
max_length=32,
error_messages={
'c1': '优先错信息1',
'c2': '优先错信息2',
'c3': '优先错信息3',
},
validators=[
RegexValidator(regex='root_\d+', message='错误了', code='c1'),
RegexValidator(regex='root_112233\d+', message='又错误了', code='c2'),
EmailValidator(message='又错误了', code='c3'), ]
)
创建表索引
普通索引，和联合普通索引
from __future__ import unicode_literals
from django.db import models #导入models对象
class yhubiao(models.Model):
id = models.AutoField('id',primary_key=True)
anem = models.CharField("用户名",max_length=50)
mim = models.CharField("地址", max_length=50)
country = models.CharField('性别',max_length=50)
class Meta:
# 联合索引
index_together = [
("anem", "mim"), #一个字段是普通索引，两个字段是联合普通索引
]
verbose_name = '用户表'
verbose_name_plural = verbose_name
def __str__(self):
return self.anem
唯一索引和联合唯一索引
from __future__ import unicode_literals
from django.db import models #导入models对象
class yhubiao(models.Model):
id = models.AutoField('id',primary_key=True)
anem = models.CharField("用户名",max_length=50)
mim = models.CharField("地址", max_length=50)
country = models.CharField('性别',max_length=50)
class Meta:
# 联合唯一索引
unique_together = (("mim", "anem"),) #一个字段是唯一索引，两个字段是联合唯一索引
verbose_name = '用户表'
verbose_name_plural = verbose_name
def __str__(self):
return self.anem
触发验证
1.触发Model中的验证和错误提示有两种方式：
a. Django Admin中的错误信息会优先根据Admiin内部的ModelForm错误信息提示，如果都成功，才来检查Model的字段并显示指定错误信息
b. 调用Model对象的 clean_fields 方法，如：
# models.py
class UserInfo(models.Model):
nid = models.AutoField(primary_key=True)
username = models.CharField(max_length=32)
email = models.EmailField(error_messages={'invalid': '格式错了.'})
# views.py
def index(request):
obj = models.UserInfo(username='11234', email='uu')
try:
print(obj.clean_fields())
except Exception as e:
print(e)
return HttpResponse('ok')
# Model的clean方法是一个钩子，可用于定制操作，如：上述的异常处理。
2.Admin中修改错误提示
# admin.py
from django.contrib import admin
from model_club import models
from django import forms
class UserInfoForm(forms.ModelForm):
username = forms.CharField(error_messages={'required': '用户名不能为空.'})
email = forms.EmailField(error_messages={'invalid': '邮箱格式错误.'})
age = forms.IntegerField(initial=1, error_messages={'required': '请输入数值.', 'invalid': '年龄必须为数值.'})
class Meta:
model = models.UserInfo
# fields = ('username',)
fields = "__all__"
class UserInfoAdmin(admin.ModelAdmin):
form = UserInfoForm
admin.site.register(models.UserInfo, UserInfoAdmin)
补充Django目录说明以及全局配置文件
Django目录说明
全局配置文件配置
"""
Django settings for Xiangmu project.
Generated by 'django-admin startproject' using Django 1.10.
For more information on this file, see
https://docs.djangoproject.com/en/1.10/topics/settings/
For the full list of settings and their values, see
https://docs.djangoproject.com/en/1.10/ref/settings/
"""
import os
# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
# Quick-start development settings - unsuitable for production
# See https://docs.djangoproject.com/en/1.10/howto/deployment/checklist/
# SECURITY WARNING: keep the secret key used in production secret!
SECRET_KEY = '!eco91o+^k9q#^j79@oymxltu-%osux)dpet_qv9kp88e)2o*7'
# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = True
ALLOWED_HOSTS = []
# Application definition
# 注册APP，也就是注册应用项目，只有注册了的应用才能操作数据库
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'app1',
]
MIDDLEWARE = [
'django.middleware.security.SecurityMiddleware',
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.common.CommonMiddleware',
# 'django.middleware.csrf.CsrfViewMiddleware',
'django.contrib.auth.middleware.AuthenticationMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
'django.middleware.clickjacking.XFrameOptionsMiddleware',
]
ROOT_URLCONF = 'Xiangmu.urls'
#配置模板
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [os.path.join(BASE_DIR, 'templates')] #配置模板文件路径，也就是html路径
,
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
},
},
]
WSGI_APPLICATION = 'Xiangmu.wsgi.application'
# Database
# https://docs.djangoproject.com/en/1.10/ref/settings/#databases
# 默认配置使用的sqlite数据库
# DATABASES = {
# 'default': {
# 'ENGINE': 'django.db.backends.sqlite3', #配置数据库引擎名称
# 'NAME': os.path.join(BASE_DIR, 'db.sqlite3'), #生成数据库到当前的项目文件夹里
# }
# }
#MySQL数据库
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql', #配置数据库引擎名称
'NAME': 'jxiou', #数据库名称
'USER': 'root', #数据库用户名
'PASSWORD': '279819', #数据库密码
'HOST': '127.0.0.1', #数据库链接地址
'PORT': '3306', #数据库端口
}
}
# Password validation
# https://docs.djangoproject.com/en/1.10/ref/settings/#auth-password-validators
AUTH_PASSWORD_VALIDATORS = [
{
'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
},
{
'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
},
{
'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
},
{
'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
},
]
# Internationalization
# https://docs.djangoproject.com/en/1.10/topics/i18n/
LANGUAGE_CODE = 'en-us'
TIME_ZONE = 'UTC'
USE_I18N = True
USE_L10N = True
USE_TZ = True
# Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/1.10/howto/static-files/
#配置静态文件前缀
STATIC_URL = '/static/'
#配置静态文件目录
STATICFILES_DIRS = (
os.path.join(BASE_DIR,'static')
)
