第三百零六节，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': '',                       #数据库密码
        'HOST': '127.0.0.1',                        #数据库链接地址
        'PORT': '',                             #数据库端口
    }
}

注意：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='', 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': '',                       #数据库密码
        'HOST': '127.0.0.1',                        #数据库链接地址
        'PORT': '',                             #数据库端口
    }
}

# 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')
)