神出鬼没的Enderman

静态文件

什么是静态文件

• 不能与服务器端做动态交互的文件都是静态文件
• 如:图片,css,js,音频,视频,html文件(部分)

静态文件配置

1. 配置静态文件的访问路径

• 通过哪个url地址找静态文件
• STATIC_URL = '/static/'
• 说明:
• 指定访问静态文件时是需要通过 /static/xxx或 127.0.0.1:8000/static/xxx
• xxx 表示具体的静态资源位置

2. 配置静态文件的存储路径 STATICFILES_DIRS

• STATICFILES_DIRS保存的是静态文件在服务器端的存储位置

3. 示例

# file: setting.py
STATICFILES_DIRS = (
    os.path.join(BASE_DIR, "static"),
)

访问静态文件

1. 使用静态文件的访问路径进行访问

• 访问路径: STATIC_URL = '/static/'

<img src="/static/images/lena.jpg">
<img src="http://127.0.0.1:8000/static/images/lena.jpg">

2. 通过{% static %}标签访问静态文件

• {% static %} 表示的就是静态文件访问路径

3. 加载 static

• {% load static %}

4. 使用静态资源时

• {% static '静态资源路径' %}
• <img src="{% static 'images/lena.jpg' %}">

Django中的应用 - app

• 应用在Django项目中是一个独立的业务模块,可以包含自己的路由,视图,模板,模型

创建应用app

1. 用manage.py中的子命令startapp创建应用文件夹

python3 manage.py startapp 应用名称
python3 manage.py startapp music

2. 在settings.py里注册应用

INSTALLED_APPS = [
    # ....
    'user',  #用户信息模块
    'music',  #音乐模块
]

应用的结构

1. migrations 文件夹

• 保存数据迁移的中间文件

2. __init__.py

• 应用子包的初始化文件

3. admin.py

• 应用的后台管理配置文件

4. apps.py

• 应用的属性配置文件

5. models.py

• 与数据库相关的模型映射类文件

6. tests.py

• 应用的单元测试文件

7. views.py

• 定义视图处理函数的文件

应用的分布式路由

• Django中，主路由配置文件urls.py可以不处理用户具体路由，主路由配置文件的可以做请求的分发(分布式请求处理)。具体的请求可以由各自的应用来进行处理

include 函数

作用

• 用于分发将当前路由转到各个应用的路由配置文件的urlpatterns进行分布式处理

函数格式

• include('app命字.url模块名')
• 模块app命字/url模块名.py文件件里必须有urlpatterns列表
• 使用前需要使用from django.conf.urls import include导入此函数

应用的模板

应用内部可以配置模板目录
1，应用下手动创建 templates 文件夹
2，settings.py中确认 TEMPLATE 配置项中 的 'APP_DIRS' 值
   例如 ： 'APP_DIRS': True

#应用下templates 和 外层templates 都存在时，django得查找模板规则
1，优先查找外层templates目录下的模板
2，按INSTALLED_APPS配置下的 应用顺序 逐层查找

模型层

Django下配置使用 mysql 数据库

安装 mysqlclient [版本 mysqlclient 1.3.13以上 ，官网目前为1.4.x]

• 安装前确认ubuntu是否已安装 python3-dev 和 default-libmysqlclient-dev
• sudo apt list --installed|grep -E 'libmysqlclient-dev|python3-dev'
• 若命令无输出则需要安装 - sudo apt-get install python3-dev default-libmysqlclient-dev
• 确保上述两个库已经安装，执行 sudo pip3 install mysqlclient即可

创建和配置数据库

创建数据库

• 创建 create database 数据库名 default charset utf8;

create database mywebdb default charset utf8 collate utf8_general_ci;

数据库的配置

• sqlite 数据库配置

# file: settings.py
DATABASES = {
    'default': {
            'ENGINE': 'django.db.backends.sqlite3',
            'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

• mysql 数据库配置

DATABASES = {
    'default' : {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'mywebdb',  # 数据库名称,需要自己定义
        'USER': 'root',
        'PASSWORD': '123456',  # 管理员密码
        'HOST': '127.0.0.1',
        'PORT': 3306,
    }
}

关于数据为的SETTING设置

1. ENGINE

• 指定数据库的后端引擎

'django.db.backends.mysql'
'django.db.backends.sqlite3'
'django.db.backends.oracle'
'django.db.backends.postgresql'

2. NAME

• 指定要连接的数据库的名称
• 'NAME': 'mywebdb'

3. USER

• 指定登录到数据库的用户名
• 'USER':'root'

4. PASSWORD

• 接数据库的密码。
• 'PASSWORD':'123456'

5. HOST

• 连接数据库时使用哪个主机。
• 'HOST':'127.0.0.1'

6. PORT

• 连接数据库时使用的端口。
• 'PORT':'3306'

模型（Models）

• 模型是一个Python类，它是由django.db.models.Model派生出的子类。
• 一个模型类代表数据库中的一张数据表
• 模型类中每一个类属性都代表数据库中的一个字段。
• 模型是数据交互的接口，是表示和操作数据库的方法和方式

Django的ORM框架

• ORM（Object Relational Mapping）即对象关系映射，它是一种程序技术，它允许你使用类和对象对数据库进行操作,从而避免通过SQL语句操作数据库
• ORM框架的作用

1. 建立模型类和表之间的对应关系，允许我们通过面向对象的方式来操作数据库。
2. 根据设计的模型类生成数据库中的表格。
3. 通过简单的配置就可以进行数据库的切换。

• ORM 好处:

1. 只需要面向对象编程, 不需要面向数据库编写代码.

• 对数据库的操作都转化成对类属性和方法的操作.
• 不用编写各种数据库的sql语句.

2. 实现了数据模型与数据库的解耦, 屏蔽了不同数据库操作上的差异.

• 不在关注用的是mysql、oracle...等数据库的内部细节.

• 通过简单的配置就可以轻松更换数据库, 而不需要修改代码.

• ORM 缺点

1. 对于复杂业务，使用成本较高
2. 根据对象的操作转换成SQL语句,根据查询的结果转化成对象, 在映射过程中有性能损失.

模型示例

• 此示例为添加一个 bookstore_book 数据表来存放图书馆中书目信息
• 添加一个 bookstore 的 app

python3 manage.py startapp bookstore

• 注册app

# file : setting.py
INSTALLED_APPS = [
    ...
    'bookstore',
]

• 添加模型类

# file : bookstore/models.py
from django.db import models

class Book(models.Model): 
    title = models.CharField("书名", max_length=50, default='')
    price = models.DecimalField('定价', max_digits=7, decimal_places=2, default=0.0)

数据库的迁移

• 迁移是Django同步您对模型所做更改（添加字段，删除模型等）到您的数据库模式的方式

1. 生成或更新迁移文件

​- 将每个应用下的models.py文件生成一个中间文件,并保存在migrations文件夹中 ​- python3 manage.py makemigrations

2. 执行迁移脚本程序

• 执行迁移程序实现迁移。将每个应用下的migrations目录中的中间文件同步回数据库
• python3 manage.py migrate

模型类Models创建

• 模型类需继承自django.db.models.Model

Models的语法规范

from django.db import models
class 模型类名(models.Model):
    字段名 = models.字段类型(字段选项)

• 模型类名是数据表名的一部分，建议类名首字母大写
• 字段名又是当前类的类属性名，此名称将作为数据表的字段名
• 字段类型用来映射到数据表中的字段的类型
• 字段选项为这些字段提供附加的参数信息

字段类型

• 参考文档 https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-types

1. BooleanField()

• 数据库类型:tinyint(1)
• 编程语言中:使用True或False来表示值
• 在数据库中:使用1或0来表示具体的值

2. CharField()

• 数据库类型:varchar
• 必须要指定max_length参数值

3. DateField()

• 数据库类型:date
• 作用:表示日期
• auto_now: 每次保存对象时，自动设置该字段为当前时间(取值:True/False)。
• auto_now_add: 当对象第一次被创建时自动设置当前时间(取值:True/False)。
• default: 设置当前时间(取值:字符串格式时间如: '2019-6-1')。
• 以上三个参数只能多选一

4. DateTimeField()

• 数据库类型:datetime(6)
• 作用:表示日期和时间
• 参数同DateField

5. DecimalField()

• 数据库类型:decimal(x,y)
• 编程语言中:使用小数表示该列的值
• 在数据库中:使用小数
• max_digits: 位数总数，包括小数点后的位数。 该值必须大于等于decimal_places.
• decimal_places: 小数点后的数字数量

money=models.DecimalField(
    max_digits=7,
    decimal_places=2,
    default=0.0
)

6. FloatField()

• 数据库类型:double
• 编程语言中和数据库中都使用小数表示值

7. EmailField()

• 数据库类型:varchar
• 编程语言和数据库中使用字符串

8. IntegerField()

• 数据库类型:int
• 编程语言和数据库中使用整数

9. URLField()

• 数据库类型:varchar(200)
• 编程语言和数据库中使用字符串

10. ImageField()

• 数据库类型:varchar(100)
• 作用:在数据库中为了保存图片的路径
• 编程语言和数据库中使用字符串

11. TextField()

• 数据库类型:longtext
• 作用:表示不定长的字符数据

字段选项

• https://docs.djangoproject.com/en/2.2/ref/models/fields/#field-options
• 字段选项, 指定创建的列的额外的信息
• 允许出现多个字段选项,多个选项之间使用,隔开

1. primary_key

• 如果设置为True,表示该列为主键,如果指定一个字段为主键，则此数库表不会创建id字段

2. blank

• 设置为True时，字段可以为空。设置为False时，字段是必须填写的。

3. null

• 如果设置为True,表示该列值允许为空。
• 默认为False,如果此选项为False建议加入default选项来设置默认值

4. default

• 设置所在列的默认值,如果字段选项null=False建议添加此项

5. db_index

• 如果设置为True,表示为该列增加索引

6. unique

• 如果设置为True,表示该字段在数据库中的值必须是唯一(不能重复出现的)

7. db_column

• 指定列的名称,如果不指定的话则采用属性名作为列名

8. verbose_name

• 设置此字段在admin界面上的显示名称

# 创建一个属性,表示用户名称,长度30个字符,必须是唯一的,不能为空,添加索引
name = models.CharField(max_length=30, unique=True, null=False, db_index=True)

Meta内部类

• 使用内部 Meta类 来给模型赋予属性，Meta类下有很多内建的类属性，可对模型类做一些控制

# file : bookstore/models.py
from django.db import models

class Book(models.Model): 
    title = models.CharField("书名", max_length=50, default='')
    price = models.DecimalField('定价', max_digits=7, decimal_places=2, default=0.0)
    class Meta:
        db_table = 'book'  #可改变当前模型类对应的表名

数据库迁移的错误处理方法

当执行python3 manage.py makemigrations出现如下迁移错误时的处理方法

You are trying to add a non-nullable field 'des' to book without a default; we can't do that (the database needs something to populate existing rows).
Please select a fix:
 1) Provide a one-off default now (will be set on all existing rows with a null value for this column)
 2) Quit, and let me add a default in models.py
Select an option:  

• 翻译为中文

您试图添加一个非空字段'des'来预订没有默认;我们不能这样做(数据库需要填充现有行)
请选择修复:
1)现在提供一次性默认值(将对所有现有行设置此列的空值)
2)退出，让我在models.py中添加一个默认值
选择一个选项:

错误原因

• 当对模型类新添加一个字段时可出现该错误
• 原理是 添加新字段后，数据库不知道原来已有数据对于新建字段该如何赋值，所以新增字段时，务必要添加default默认值。

处理方法

1. 选择1 则会进入到shell中，手动输入一个默认值
2. 退出当前生成迁移文件的过程，自己去修改models.py, 新增加一个default=XXX 的缺省值(推荐使用)

• 数据库的迁移文件混乱的解决办法

1. 删除 所有 migrations 里所有的 000?_XXXX.py (__init__.py除外)
2. 删除 数据库

drop database mywebdb;

3. 重新创建 数据库

create datebase mywebdb default charset...;

4. 重新生成migrations里所有的000?_XXXX.py

python3 manage.py makemigrations

5. 重新更新数据库

python3 manage.py migrate

模型层的基本操作

• 基本操作包括增删改查操作，即(CRUD操作)
• CRUD是指在做计算处理时的增加(Create)、读取查询(Read)、更新(Update)和删除(Delete)

管理器对象

• 每个继承自 models.Model 的模型类，都会有一个 objects 对象被同样继承下来。这个对象叫管理器对象
• 数据库的增删改查可以通过模型的管理器实现

class MyModel(models.Model):
    ...
MyModel.objects.create(...) # objects 是管理器对象

创建数据对象

• Django 使用一种直观的方式把数据库表中的数据表示成Python 对象
• 创建数据中每一条记录就是创建一个数据对象

1. MyModel.objects.create(属性1=值1, 属性2=值1,...)

• 成功: 返回创建好的实体对象
• 失败: 抛出异常

2. 创建 MyModel 实例对象,并调用save()进行保存

obj = MyModel(属性=值,属性=值)
obj.属性=值
obj.save()

Django shell 的使用

• 在Django提供了一个交互式的操作项目叫Django Shell它能够在交互模式用项目工程的代码执行相应的操作
• 利用 Django Shell 可以代替编写View的代码来进行直接操作
• 在Django Shell 下只能进行简单的操作，不能运行远程调式

python3 manage.py shell