python 模型 ORM简介

Django之ORM (Object Relational Mapping(ORM)
一.ORM介绍
1.ORM概念
    对象关系映射模式是一种为了解决面向对象与关系数据库存在的互不匹配的现象的技术.
2.ORM由来
    让我们从O/R开始。字母O起源于"对象"(Object)，而R则来自于"关系"(Relational)。
    几乎所有的软件开发过程中都会涉及到对象和关系数据库。在用户层面和业务逻辑层面，我们是面向对象的。
    当对象的信息发生变化的时候，我们就需要把对象的信息保存在关系数据库中。
    按照之前的方式来进行开发就会出现程序员会在自己的业务逻辑代码中夹杂很多SQL语句用来增加、读取、修改、删除相关数据，
    而这些代码通常都是极其相似或者重复的。
3.ORM的优势
    ORM解决的主要问题是对象和关系的映射,它通常将一个类和一张表一一对应,类的每个对象对应表中的一条记录,类的每个属性
    对应表中的每个字段.
    ORM提供了对数据库的映射,不用直接编写SQL代码,只需操作对象就能对数据库的数据进行操作.
    让开发人员专注于业务逻辑的处理,提高了开发效率.
4.ORM的劣势
    在一定程度上牺牲程序的执行效率.
    ORM的操作是有限的，也就是ORM定义好的操作是可以完成的，一些复杂的查询操作是完成不了。不能建数据库和删除数据库.
    ORM用多了SQL语句就不会写了，关系数据库相关技能退化...
5.ORM总结
    ORM只是一种工具，工具确实能解决一些重复，简单的劳动,
    但我们不能指望某个工具能一劳永逸地解决所有问题，一些特殊问题还是需要特殊处理的。
    但是在整个软件开发过程中需要特殊处理的情况应该都是很少的，否则所谓的工具也就失去了它存在的意义。
二.Django中的ORM
(一).Django项目使用MySQL数据库
1.在Django 项目的settings.py文件中,配置数据库连接信息:
    DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.mysql",
        "NAME": "你的数据库名称",  # 需要自己手动创建数据库
        "USER": "数据库用户名",
        "PASSWORD": "数据库密码",
        "HOST": "数据库IP",
        "POST": 3306
    }
}
2.在与Django 项目同名的目录下的__init__.py 文件中写下如下代码,告诉Django 使用pymysql模块连接MySQL数据库:
   import pymysql
    pymysql.install_as_MySQLdb()
3.数据库迁移的时候出现一个警告
    WARNINGS:
?: (mysql.W002) MySQL Strict Mode is not set for database connection 'default'
HINT: MySQL's Strict Mode fixes many data integrity problems in MySQL, such as data truncation upon insertion, by escalating warnings into errors. It is strongly recommended you activate it.
    解决方案:
    在配置中多加一个OPTIONS参数
    'OPTIONS': {
    'init_command': "SET sql_mode='STRICT_TRANS_TABLES'"},
(二).Model
    在Django中model是你数据的单一、明确的信息来源。它包含了你存储的数据的重要字段和行为。通常，一个模型（model）
    映射到一个数据库表。
    基本情况:
    每个模型都是一个Python类,它是django.db.models.Model的子类,
    模型的每个属性都代表一个数据库字段.
    Django为您提供了一个自动生成的数据库访问API
(三).快速入门
    下面这个例子定义了一个 Person 模型，包含 first_name 和 last_name。
    from django.db import models
    class Person(models.Model):
        first_name = models.CharField(max_length=30)
        last_name = models.CharField(max_length=30)
     first_name 和 last_name 是模型的字段。每个字段被指定为一个类属性，每个属性映射到一个数据库列.
    上面的 Person 模型将会像这样创建一个数据库表.
     CREATE TABLE myapp_person (
            "id" serial NOT NULL PRIMARY KEY,
            "first_name" varchar(30) NOT NULL,
            "last_name" varchar(30) NOT NULL
        );
    1.表myapp_person的名称是自动生成的，如果你要自定义表名，需要在model的Meta类中指定 db_table 参数，强烈建议使用小写表名
    特别是使用MySQL作为数据库时。
        class UserInfo(models.Model):
            nid = models.AutoField(primary_key=True)
            username = models.CharField(max_length=32)
            class Meta:
                # 数据库中生成的表名称 默认 app名称 + 下划线 + 类名
                db_table = "table_name"
    2.id字段是自动添加的，如果你想要指定自定义主键，只需在其中一个字段中指定 primary_key=True 即可。如果Django发现你已
    经明确地设置了Field.primary_key，它将不会添加自动ID列。
(四).字段
1.AutoField
    自增的整形字段，必填参数primary_key=True，则成为数据库的主键。无该字段时，django自动创建。
    注意:一个model不能有两个AutoField字段。
2.IntegerField
    一个整数类型,数值的范围是-2147483648 - 2147483647.
3.CharField
    字符类型,必须提供max_length参数.max_length表示字符的长度.
4.DateField
    日期类型，日期格式为YYYY-MM-DD，相当于Python中的datetime.date的实例
    参数:
        auto_now：每次修改时修改为当前日期时间
        auto_now_add：新创建对象时自动添加当前日期时间。
        auto_now和auto_now_add和default参数是互斥的，不能同时设置。
5.DatetimeField
    日期时间字段，格式为YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]，相当于Python中的datetime.datetime的实例。
6.SmallIntegerField(IntegerField):
    小整数 -32768 ～ 32767
7.PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
    - 正小整数 0 ～ 32767
8.PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
        - 正整数 0 ～ 2147483647
9.BigIntegerField(IntegerField):
        - 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807
10.BooleanField(Field)
        - 布尔值类型
11.NullBooleanField(Field):
        - 可以为空的布尔值
12.TextField(Field)
        - 文本类型
13.EmailField(CharField)：
        - 字符串类型，Django Admin以及ModelForm中提供验证机制
14.IPAddressField(Field)
        - 字符串类型，Django Admin以及ModelForm中提供验证 IPV4 机制
15. protocol，用于指定Ipv4或Ipv6， 'both',"ipv4","ipv6"
            unpack_ipv4， 如果指定为True，则输入::ffff:192.0.2.1时候，可解析为192.0.2.1，开启此功能，需要protocol="both"
16.URLField(CharField)
        - 字符串类型，Django Admin以及ModelForm中提供验证 URL
17.SlugField(CharField)
        - 字符串类型，Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符（减号）
18.CommaSeparatedIntegerField(CharField)
        - 字符串类型，格式必须为逗号分割的数字
19.FilePathField(Field)
        - 字符串，Django Admin以及ModelForm中提供读取文件夹下文件的功能
20.FilePathField(Field)
        - 字符串，Django Admin以及ModelForm中提供读取文件夹下文件的功能
        - 参数：
                path,                      文件夹路径
                match=None,                正则匹配
                recursive=False,           递归下面的文件夹
                allow_files=True,          允许文件
                allow_folders=False,       允许文件夹
21.FileField(Field)
        - 字符串，路径保存在数据库，文件上传到指定目录
        - 参数：
            upload_to = ""      上传文件的保存路径
            storage = None      存储组件，默认
22. ImageField(FileField)
     - 字符串，路径保存在数据库，文件上传到指定目录
        - 参数：
            upload_to = ""      上传文件的保存路径
            storage = None      存储组件，默认
            width_field=None,   上传图片的高度保存的数据库字段名（字符串）
            height_field=None   上传图片的宽度保存的数据库字段名（字符串）
23.TimeField(DateTimeCheckMixin, Field)
        - 时间格式      HH:MM[:ss[.uuuuuu]]
24.DurationField(Field)
        - 长整数，时间间隔，数据库中按照bigint存储，ORM中获取的值为datetime.timedelta类型
25. FloatField(Field)
        - 浮点型
26.DecimalField(Field)
        - 10进制小数
        - 参数：
            max_digits，小数总长度
            decimal_places，小数位长度27. BinaryField(Field)
27. BinaryField(Field)
        - 二进制类型
(五).自定义字段
   自定义一个char类型字段：
    class MyCharField(models.Field):
        自定义的char类型的字段类
        def __init__(self, max_length, *args, **kwargs):
            self.max_length = max_length
            super(MyCharField, self).__init__(max_length=max_length, *args, **kwargs)

        def db_type(self, connection):
            限定生成数据库表的字段类型为char，长度为max_length指定的值
            return 'char(%s)' % self.max_length
    使用自定义char类型字段
        class Class(models.Model):
            id = models.AutoField(primary_key=True)
            title = models.CharField(max_length=25)
            # 使用自定义的char类型的字段
            cname = MyCharField(max_length=25)
(六).字段参数
     null                数据库中字段是否可以为空
    db_column           数据库中字段的列名
    default             数据库中字段的默认值
    primary_key         数据库中字段是否为主键
    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      自定义错误信息（字典类型），从而定制想要显示的错误信息；
(七).Model Meta参数
    class UserInfo(models.Model):
        nid = models.AutoField(primary_key=True)
        username = models.CharField(max_length=32)

        class Meta:
            # 数据库中生成的表名称 默认 app名称 + 下划线 + 类名
            db_table = "table_name"

            # admin中显示的表名称
            verbose_name = '个人信息'

            # verbose_name加s
            verbose_name_plural = '所有用户信息'

            # 联合索引
            index_together = [
                ("pub_date", "deadline"),   # 应为两个存在的字段
            ]
     
            # 联合唯一索引
            unique_together = (("driver", "restaurant"),)   # 应为两个存在的字段