Django(1) - 初识Django框架

1.前言

该专栏学习笔记环境参数如下：

Windows 10
Xampp/Navicat for MySQL
Python 3.8+
Django 3.0.*
Vue 2.6+

开发工具：

PyCharm 专业版
VS Code

补充说明：

本人电脑存在多个版本的python，那么当你电脑存在多个版本python，如何使用？如何指定pip安装到指定版本？通过py 选择版本，然后进行相关命令操作。详见：https://blog.csdn.net/stone_tigerLI/article/details/121496828，自行百度不赘诉

2.初识Django框架

2.1.Django介绍

Django分层设计也是通过MTV，区别于Flask，这些相关内容Django都有，不需要依赖扩展。安装Django时，自己要在网上查找一下你安装的Django版本和你的Python版本兼容不兼容！

2.2.开发基础知识

2.2.1.Django的安装

方式一：pip安装【推荐】 pip install django

方式二：前往官网pypi.org下载源码安装，cd到setup.py目录下，执行 python setup.py install

检测是否安装成功
```
import django
django.__version__
```
View Code

2.2.2.Django项目的创建

方式一：使用命令行生成模板 django-admin[.py] startproject my_project ,这个命令的django-admin是什么？在我们pip安装好django后，在图示目录生成exe。命令参数含义：【.py】是可选的；startproject创建；my_project创建的项目名称。

方式二：使用PyCharm创建项目，pycharm的一些配置，比如修改镜像源啥的，参照之前Flask笔记：https://www.cnblogs.com/gltou/p/16985624.html

2.2.3.Django项目的文件目录结构

templates：模板目录

test_django：项目目录

__init__.py：包的入口文件
asgi.py：部署配置
settings.py：项目配置文件
urls.py：url访问地址配置文件
wsgi.py：部署配置

manage.py：命令行管理工具

2.2.4.Django项目开发服务器的启动

启动服务器方式一： python manage.py runserver

启动服务器方式二：

思考：我想指定启动的端口怎么办？

2.3.开发流程讲解

2.3.1.开发服务器的启动配置

知识点1：选择项目解释器，通过cmd执行django-admin创建的项目需要进行选择。pycharm方式创建的项目不需要选择，因为在创建项目的时候已经选择过了解释器

知识点2：启动开发服务器 python manage.py runserver ，runserver常用参数

指定端口：
- 命令行启动 python manage.py runserver 9527
- pycharm启动

指定IP及端口：
- 命令行启动python manage.py runserver 0.0.0.0:9527
- pycharm启动

指定IP启动后，根据页面提示信息，我们需要在setting.py配置ALLOWED_HOSTS，由于安全的需要，需要指定哪些主机是可以访问的；添加好之后，再次访问就OK了

2.3.2.项目模块的创建

创建示例hello模块： python manage.py startapp hello ，模块的含义以及生成的内容会在后面笔记中写，该篇随笔只是认识Django框架

2.3.3.完成第一个页面

第一步：在views.py文件中写个函数

第二步：在urls.py配置规则

3.从请求到响应

3.1.从请求到响应

知识点：

了解URL的设计及配置
掌握视图的定义及作用
掌握URL和视图的关系
了解视图响应的内容

什么是视图？

一个视图函数，简称为视图，是一个简单的Python函数。函数定义的位置是在模块的views.py文件中，传入request参数，request这个参数是固定的必须得有，当然你也可以叫其他名字。

视图函数的作用：就是接受一个请求，返回一个响应；

URL的设计：设计简单优雅的URL：使用正则表达式、指定参数类型

URL的常用配置：函数 path(route,view,name,**kwargs) \函数 include(urls,namespace) ;path函数就是之前上述例子urls.py文件中使用的，include函数就是我们在使用模块化开发的时候进行使用，希望把某一个模块下的url单独进行管理，然后再把所有模块的url整合到一起，这个时候就需要用到include函数。

通过django项目的配置文件settings.py我们看到，根url是图示的urls文件

include示例：按模块管理url，首先在hello模块下新建一个urls文件

URL与视图的关系：

URL的正向解析
URL的逆向解析，防止我们硬编吗，类似flask中的url_for。使用reverse()方法

视图响应的内容：

可以是文本
HTML内容
图像
甚至是404、重定向等

小结：视图是一个Python函数，用来处理http请求。通过path和include函数配置url，将url和视图函数关系建立起来。

3.2.在视图中处理业务逻辑

3.2.1.响应HTML内容

3.2.2.获取URL参数

获取URL中指定类型的参数
获取URL中正则匹配的参数

3.2.3.获取GET参数

3.3.从文件响应HTML内容

知识点：

回顾响应HTML内容的原理
了解 render_to_string()函数
掌握 render()函数

3.3.1.响应HTML内容的原理

其实和FLASK差不多

第一步，从磁盘读取HTML文件
第二步，替换HTML中的特殊字符
第三步，发送给浏览器

3.3.2.render_to_string()函数

render_to_string(template_name,context=None,request=None,using=None)

template_name：模板名称，必传
request：请求对象
context：模板上下文对象（dict）
using：模板引擎名称（如：Jinja2）

补充说明：配置文件settings.py文件的TEMPLATES属性说明

BACKEND：模板引擎，现在默认是使用django自带的模板引擎
DIRS：模板目录，去哪里找html文件
APP_DIRS：为True时，代表可以在模块下面去找html文件
OPTIONS：配置选项

补充说明：Django框架寻找模板的顺序，程序会先去根目录的templates下寻找对应的html文件，若根目录下的templates下没有对应的html文件，程序会去模块下的templates寻找对应的html。若根目录和模块目录的templates都有这个html文件，会执行根目录下的html文件。这个执行顺序是无法修改的！

想让程序去模块目录里面找html文件怎么配置呢？

3.3.3.render()函数

render(request,template_name,context=None,content_type=None,status=None,using=None) ,实际工作当中render()的使用频率要高于render_to_string()，因为它使用起来更简单。

request：请求对象，必传
template_name：模板名称，必传
context：模板上下文对象（dict）
context_type：MIME类型，默认为text/html
status：HTTP状态码
using：模板引擎名称（如：Jinja2）

3.4.请求响应对象

知识点：

掌握请求到响应的流程
理解请求对象
理解响应对象

3.4.1.请求与响应

3.4.2.请求对象HttpRequest

请求对象HttpRequest其实是Django框架中写好的一个类，它把我们每一次发过来的请求封装成一个对象。视图中使用的使用，方法传递进去的request，就是HttpRequest的实例。它里面有一些常用的属性和方法可以提供给我们使用：

请求方式method（POST/GET/.....）
请求头信息META/headers，META返回的更详细，header返回的请求头信息常用的基本都在。反回的请求头信息都是JSON格式，常用的key信息👇
- REMOTE_ADDR：获取请求的IP地址
- HTTP_USER_AGENT：用户请求终端的信息
获取请求传递参数
- GET：GET请求参数
- POST：POST请求参数
- COOKIES：cookie信息
- FILES：文件信息

示例代码：

 1 # urls.py文件照着图片敲，后面就只粘贴知识点代码
 2 
 3 def http_request(request):
 4     """请求练习"""
 5     # 1. 请求方式
 6     print(request.method)
 7 
 8     # 2. 请求头信息
 9     # 2.1 获取请求头信息META和headers
10     # META
11     headers = request.META  #详细
12     print(headers)
13     # headers
14     print(request.headers)  #简略
15 
16     # 2.2 根据key获取具体属性信息
17     # 方式一：META.get(key)
18     ua = request.META.get('HTTP_USER_AGENT',None)
19     print(ua)
20     # 方式二：headers['key'],key的大小写都支持
21     print(request.headers['User-Agent'])
22     print(request.headers.get('user-agent'))
23 
24     # 3. 获取请求参数request.Get.get()
25     name = request.GET.get('name','')
26     print(name)
27     print(request.GET.get('cookies'))
28 
29     return HttpResponse('响应')

3.4.3.响应对象

常用响应对象

HttpResponse
HttpResponseRedirect：重定向
JsonResponse：响应json
FileResponse：响应文件

响应对象之间的关系

下面将针对常用的响应对象的属性和方法进行详细阐述

HttpResponse

status：设置HTTP响应状态码
status_code查看HTTP响应状态码
content_type：设置响应的类型
write()：写入响应内容

1 def http_response(request):
2     """响应练习"""
3     resp = HttpResponse('响应内容',status=201,content_type='text/html; charset=utf-8')
4     resp.status_code = 200
5     resp.write('lalallalalal')
6     print(resp.status_code)
7     return resp

JsonResponse

1 def http_response(request):
2     """响应练习"""
3     user_info = {
4         'name':'张三',
5         'age':34
6     }
7     return JsonResponse(user_info)

FileResponse

常见的Content-Type

text/html：超文本标记语言文本（HTML）
text/plain：普通文本
text/xml：xml文档
image/png、image/jpeg、image/git：图片或图形
application/json：json数据类型

小结：请求对象就一个，响应对象可以有多种类型

3.5.视图快捷方法

知识点：

了解什么是重定向：这个自行百度
掌握如何实现重定向

实现URL访问的重定向

方式一：使用HttpResponseRedirect重定向
方式二：使用redirect()快捷方式

思考：程序异常怎么办？磁盘满了？数据库崩了？

3.6.内置的视图及重写

知识点：

了解常见的错误
掌握重写内置视图
了解处理静态文件

内置的错误处理视图

400 Bad Request
403 Forbidden
404 Not Found
500 Internal Server Error

重写内置的错误处理视图

第一步：在项目urls.py中添加配置
- handler500 = “my_project.views.page_500”，给handler500报错赋予处理错误视图函数，为空时，使用框架自带默认的
- handler400，handler403，handler404同上配置
第二步：切换到生产模式，将settings.py中的DEBUG改为False

示例

编写错误处理视图函数，实际项目中，位置一般不放在模块里面，因为这是所有模块可以公用的。

由于公用，因此添加到根目录的urls.py文件中。指定处理500报错的视图

模块业务逻辑视图中，raise抛出错误

配置文件中将环境改为生产环境，注意改为False时，ALLOWED_HOSTS属性不能为空值，否则报错。

访问raise抛出错误的模块url。

注意：400几个的handler，如果编写其对应的视图处理函数时，需要传递其他的参数👇。后面的笔记中用到400几个handler的时候，会进行详述。

static.serve处理静态文件

实际项目中会有许多静态文件，有用户上传的图片，有项目自带的js、css、图片等等。通过django如何展示呢，上面有提到可以通过fileresponse对象展示，还有没有其他办法？通过static.server进行处理

第一步：在项目settings.py中添加配置
- MEDIA_URL='/media/' ：表示媒体media的URL。下面的示例没有添加该配置项，后面项目实战笔记会阐述该配置的作用。
- MEDIA_ROOT=os.path.join(BASE_DIR,'medias') ：我们静态文件存放的位置
第二步：在urls.py中添加配置，将我们进行开发的时候，把项目当中的静态文件，放到django内置服务器当中，是我们可以直接进行访问。

👆图，官方说在开发模式下进行使用，为什么呢？因为django内置的服务器就是开发服务器，肯定不能满足生产环境的需要。在实际生产环境中呢，我们会使用其他的方式进行处理，后面会讲。此处重要内容是处理静态文件，知道通过django自带的服务器，可以访问静态文件。衍生跟项目相关的，后面笔记有。

处理静态文件示例：

在settings.py中添加MEDIA_ROOT，指明静态文件存放的位置。

如何指明静态文件存放的位置，使用绝对路径还是相对路径？在配置文件一开始，我们看到django自带的变量BASE_DIR代表的就是当前项目目录

在urls.py文件中添加图示配置，那这段代码是什么意思？如果我们开启了调试模式即开发模式。在urlpatterns中追加一个路由寻址，通过正则匹配，media开头任意结尾。调用的视图是django.views.static自带的serve。document_root指向我们刚刚在settings.py文件中新增的变量MEDIA_ROOT,即静态文件目录。

settings.py开启开发模式，访问地址(按照我们添加的规则，路由即media/开头)，发现成功访问静态文件

思考：我们在settings.py文件添加静态文件目录MEDIA_ROOT时，发现有一个STATIC_URL变量，这个是干什么用的？

Django有两种静态文件：

medias 称为媒体文件夹，主要用来保存用户上传的文件，例如图片等，是变动的，由用户定义的文件，如用户头像，用户上传的图片或视频等；
static 称为静态文件夹，主要存的是CSS, JavaScript, 网站logo等不变的文件，是不变的，形成网站的核心部件，如 CSS文件，JS文件，背景图片等；

settings中的STATIC_URL = 'static/'配置是静态路由映射，就是可以让django利用STATIC_URL来让浏览器可以直接访问static下的静态文件。在urls.py对static文件路径进行配置