Django框架详细介绍---视图系统

Django视图系统

1.什么是视图

　　在Django中，一个视图函数/类，称为视图。实质就是一个用户自定义的简单函数，用来接收WEB请求并xing响应请求，响应的内容可以是一个HTML文件、重定向、一个文件、照片等。无论视图本身包含什么逻辑，都要返回响应。

　　一般的，视图函数一般存放于用户创建的APP目录下的views.py中。

2.视图种类

　　1）FBV

　　FBV（function base views），全称基于函数的视图，也就是在视图中使用函数处理请求，

函数内部再定义如何处理GET、POST等请求

urlpatterns = [# 班级列表
    path('class_list/', views.class_list),
    # 创建班级
    path('create_class/', views.create_class),
 ]

def class_list(request):
    cla_list = models.Class.objects.all()
    return render(request, 'class_list.html', {'class_list': cla_list})

def create_class(request):
    if request.method == 'POST':
        # 获取班级名称
        class_name = request.POST.get('class_name', None)
        # 获取班级所在校区
        campus_name = request.POST.get('campus_name', None)
        # 将数据写入数据库
        models.Class.objects.create(class_name=class_name, campus_name=campus_name)
        # 返回主界面
        return redirect('/class_list/')
    return render(request, 'create_class.html')

　　2）CBV

　　CBV（class base views），全称基于类的视图，也就是在视图中使用类处理请求，函数内部再定义如何处理GET、POST等请求的方法

urlpatterns = [
    # 修改班级信息
    # path('change_class/', views.change_class),
    path('change_class/', views.ChangeClass.as_view()),
]

from django.views import View

class ChangeClass(View):
    def get(self,request):
        change_id = request.GET.get("id")
        change_obj = models.Class.objects.get(id=change_id)
        return render(request, 'change_class.html', {'class': change_obj})

    def post(self,request):
        # 获取更改班级的ID
        change_id = request.POST.get('change_id', None)
        # 获取更改班级的对象
        change_obj = models.Class.objects.get(id=change_id)
        # 获取班级名称
        class_name = request.POST.get('class_name', None)
        # 获取班级所在校区
        campus_name = request.POST.get('campus_name', None)
        # 更数据
        change_obj.class_name = class_name
        change_obj.campus_name = campus_name
        # 将数据写入数据库
        change_obj.save()
        # 返回主界面
        return redirect('/class_list/')

注意：

　　项目中根据需求选择视图方法

3.给视图添加装饰器

　　1）使用装饰器装饰FBV

　　FBV自身就是函数，所以和给普通函数加装饰器无区别

def wrapper(func):
    def inner(*args, **kwargs):
        start_time = time.time()
        ret = func(*args, **kwargs)
        end_time = time.time()
        print("used:", end_time-start_time)
        return ret
    return inner

@wrapper
def change_class(request):
    pass

　　2）使用装饰器装饰CBV

　　类中的方法与独立函数不完全相同，因此不能直接将函数装饰器应用于类中的方法，需要将其装换成方法装饰器

　　Django中提供了method_decorator装饰器用于将函数装饰器转换成方法装饰器

# 修改班级信息
from django.views import View
from django.utils.decorators import method_decorator

class ChangeClass(View):
    @method_decorator(wrapper)
    def get(self, request):
        passdef post(self, request):pass

4.Request对象和Response对象

　　官方文档：

https://docs.djangoproject.com/en/2.0/ref/request-response/

　　1）request对象

 　　当请求一个页面时，Django会创建一个含有本次请求信息的HttpRequest对象，并自动将其传递给响应的视图函数，一般视图函数默认承接这个对象

　　请求相关的常用值：

path_info     返回用户访问url，不包括域名
method        请求中使用的HTTP方法的字符串表示，全大写表示。
GET           包含所有HTTP  GET参数的类字典对象
POST          包含所有HTTP POST参数的类字典对象
body          请求体，byte类型 request.POST的数据就是从body里面提取到的

　　相关属性：

属性：
　　django将请求报文中的请求行、头部信息、内容主体封装成 HttpRequest 类中的属性
   除了特殊说明的之外，其他均为只读的

0.HttpRequest.scheme
   表示请求方案的字符串（通常为http或https）

1.HttpRequest.body
　　一个字符串，代表请求报文的主体。在处理非 HTTP 形式的报文时非常有用，例如：二进制图片、XML,Json等
　　但是，如果要处理表单数据的时候，推荐还是使用 HttpRequest.POST 
　　另外，我们还可以用 python 的类文件方法去操作它，详情参考 HttpRequest.read() 

2.HttpRequest.path
　　一个字符串，表示请求的路径组件（不含域名）
　　例如："/music/bands/the_beatles/"

3.HttpRequest.method
　　一个字符串，表示请求使用的HTTP 方法。必须使用大写
　　例如："GET"、"POST"

4.HttpRequest.encoding
　　一个字符串，表示提交的数据的编码方式（如果为 None 则表示使用 DEFAULT_CHARSET 的设置，默认为 'utf-8'）
   这个属性是可写的，你可以修改它来修改访问表单数据使用的编码
   接下来对属性的任何访问（例如从 GET 或 POST 中读取数据）将使用新的 encoding 值
   如果你知道表单数据的编码不是 DEFAULT_CHARSET ，则使用它
 
5.HttpRequest.GET 
　　一个类似于字典的对象，包含 HTTP GET 的所有参数。详情请参考 QueryDict 对象

6.HttpRequest.POST
　　一个类似于字典的对象，如果请求中包含表单数据，则将这些数据封装成 QueryDict 对象
　　POST 请求可以带有空的 POST 字典 —— 如果通过 HTTP POST 方法发送一个表单，但是表单中没有任何的数据，QueryDict 对象依然会被创建。
   因此，不应该使用 if request.POST  来检查使用的是否是POST 方法；应该使用 if request.method == "POST" 
　　另外：如果使用 POST 上传文件的话，文件信息将包含在 FILES 属性中。

 7.HttpRequest.COOKIES
　　一个标准的Python 字典，包含所有的cookie。键和值都为字符串。

8.HttpRequest.FILES
　　一个类似于字典的对象，包含所有的上传文件信息。
   FILES 中的每个键为<input type="file" name="" /> 中的name，值则为对应的数据
　　注意，FILES 只有在请求的方法为POST 且提交的<form> 带有enctype="multipart/form-data" 的情况下才会
   包含数据。否则，FILES 将为一个空的类似于字典的对象

9.HttpRequest.META
 　　一个标准的Python 字典，包含所有的HTTP 首部。具体的头部信息取决于客户端和服务器，下面是一些示例：
    CONTENT_LENGTH —— 请求的正文的长度（是一个字符串）
    CONTENT_TYPE —— 请求的正文的MIME 类型
    HTTP_ACCEPT —— 响应可接收的Content-Type
    HTTP_ACCEPT_ENCODING —— 响应可接收的编码
    HTTP_ACCEPT_LANGUAGE —— 响应可接收的语言
    HTTP_HOST —— 客服端发送的HTTP Host 头部
    HTTP_REFERER —— Referring 页面
    HTTP_USER_AGENT —— 客户端的user-agent 字符串。
    QUERY_STRING —— 单个字符串形式的查询字符串（未解析过的形式）
    REMOTE_ADDR —— 客户端的IP 地址
    REMOTE_HOST —— 客户端的主机名
    REMOTE_USER —— 服务器认证后的用户
    REQUEST_METHOD —— 一个字符串，例如"GET" 或"POST"
    SERVER_NAME —— 服务器的主机名
    SERVER_PORT —— 服务器的端口（是一个字符串）
 　　从上面可以看到，除 CONTENT_LENGTH 和 CONTENT_TYPE 之外，请求中的任何 HTTP 首部转换为 META 的键时，
    都会将所有字母大写并将连接符替换为下划线最后加上 HTTP_  前缀
    所以，一个叫做 X-Bender 的头部将转换成 META 中的 HTTP_X_BENDER 键
 
10.HttpRequest.user
　　一个 AUTH_USER_MODEL 类型的对象，表示当前登录的用户。
　　如果用户当前没有登录，user 将设置为 django.contrib.auth.models.AnonymousUser 的一个实例。你可以通过 is_authenticated() 区分它们
    例如：
    if request.user.is_authenticated():
        # Do something for logged-in users.
    else:
        # Do something for anonymous users.
     　　user 只有当Django 启用 AuthenticationMiddleware 中间件时才可用。

-------------------------------------------------------------------------------------
    匿名用户
    class models.AnonymousUser

    django.contrib.auth.models.AnonymousUser 类实现了django.contrib.auth.models.User 接口，但具有下面几个不同点：

    id 永远为None。
    username 永远为空字符串。
    get_username() 永远返回空字符串。
    is_staff 和 is_superuser 永远为False。
    is_active 永远为 False。
    groups 和 user_permissions 永远为空。
    is_anonymous() 返回True 而不是False。
    is_authenticated() 返回False 而不是True。
    set_password()、check_password()、save() 和delete() 引发 NotImplementedError。
    New in Django 1.8:
    新增 AnonymousUser.get_username() 以更好地模拟 django.contrib.auth.models.User。

11.HttpRequest.session
 　　一个既可读又可写的类似于字典的对象，表示当前的会话。只有当Django 启用会话的支持时才可用
    完整的细节参见会话的文档

示例：用户注册+头像上传

from django.shortcuts import render


# Create your views here.
def upload_file(request):
    if request.method == 'POST':
        file_obj = request.FILES.get("file")
        # 获取文件名
        file_name = file_obj.name
        # 在本地新建一个同名文件
        with open(r'file/%s' % file_name,'wb') as f:
            # 从上传的文件对象一点点的读取数据
            for line in file_obj.chunks():
                # 将数据写到文件中
                f.write(line)
    return render(request,"upload.html")

<form action="/upload/" method="post" enctype="multipart/form-data">
    <div class="form-group">
        <label for="InputName">用户名</label>
        <input type="text" class="form-control" id="InputName" placeholder="输入用户名"
               name="username">
    </div>
    <div class="form-group">
        <label for="InputPassword">密码</label>
        <input type="password" class="form-control" id="InputPassword" placeholder="输入密码"
               name="password">
    </div>
    <div class="form-group">
        <label for="InputFile">上传头像</label>
        <input type="file" id="InputFile" name="file">
        <p class="help-block">只支持jpg/png等格式</p>
    </div>
    <div class="checkbox">
        <label>
            <input type="checkbox">点击选择文件
        </label>
    </div>
    <button type="submit" class="btn btn-default col-sm-3">提交</button>
</form>

　　相关方法：

1.HttpRequest.get_host()
　　根据从HTTP_X_FORWARDED_HOST（如果打开 USE_X_FORWARDED_HOST，默认为False）和 HTTP_HOST 头部信息返回请求的原始主机
   如果这两个头部没有提供相应的值，则使用SERVER_NAME 和SERVER_PORT，在PEP 3333 中有详细描述。
　　USE_X_FORWARDED_HOST：一个布尔值，用于指定是否优先使用 X-Forwarded-Host 首部，仅在代理设置了该首部的情况下，才可以被使用
　　例如："127.0.0.1:8000"
　　注意：当主机位于多个代理后面时，get_host() 方法将会失败。除非使用中间件重写代理的首部

2.HttpRequest.get_full_path()
　　返回 path，如果可以将加上查询字符串。
　　例如："/music/bands/the_beatles/?print=true"

3.HttpRequest.get_signed_cookie(key, default=RAISE_ERROR, salt='', max_age=None)
　　返回签名过的Cookie 对应的值，如果签名不再合法则返回django.core.signing.BadSignature
　　如果提供 default 参数，将不会引发异常并返回 default 的值
　　可选参数salt 可以用来对安全密钥强力攻击提供额外的保护。max_age 参数用于检查Cookie 对应的时间戳以确保Cookie 的时间不会超过max_age 秒
        复制代码
        >>> request.get_signed_cookie('name')
        'Tony'
        >>> request.get_signed_cookie('name', salt='name-salt')
        'Tony' # 假设在设置cookie的时候使用的是相同的salt
        >>> request.get_signed_cookie('non-existing-cookie')
        ...
        KeyError: 'non-existing-cookie'    # 没有相应的键时触发异常
        >>> request.get_signed_cookie('non-existing-cookie', False)
        False
        >>> request.get_signed_cookie('cookie-that-was-tampered-with')
        ...
        BadSignature: ...    
        >>> request.get_signed_cookie('name', max_age=60)
        ...
        SignatureExpired: Signature age 1677.3839159 > 60 seconds
        >>> request.get_signed_cookie('name', False, max_age=60)
        False
        复制代码
         
4.HttpRequest.is_secure()
　　如果请求时是安全的，则返回True；即请求通是过 HTTPS 发起的
 
5.HttpRequest.is_ajax()
　　如果请求是通过XMLHttpRequest 发起的，则返回True，方法是检查 HTTP_X_REQUESTED_WITH 相应的首部是否是字符串'XMLHttpRequest'
　　大部分现代的 JavaScript 库都会发送这个头部。如果你编写自己的 XMLHttpRequest 调用（在浏览器端），你必须手工设置这个值来让 is_ajax() 可以工作
　　如果一个响应需要根据请求是否是通过AJAX 发起的，并且你正在使用某种形式的缓存例如Django 的 cache middleware， 
   你应该使用 vary_on_headers('HTTP_X_REQUESTED_WITH') 装饰你的视图以让响应能够正确地缓存

注意：

　　当键值对的值是多个的时候，比如checkbox类型的input标签，select标签，需要使用getlist()方法

request.POST.getlist("hobby")

　　2）response对象

　　在Django建立的每个视图都要实例化，填充和返回一个HttpResponse

示例：用于传递字符串

from django.http import HttpResponse
response = HttpResponse("Here's the text of the Web page.")
response = HttpResponse("Text only, please.", content_type="text/plain")

　　设置和删除报头信息

response = HttpResponse()
response['Content-Type'] = 'text/html; charset=UTF-8'
del response['Content-Type']

　　相关属性

HttpResponse.content            响应内容
HttpResponse.charset            响应内容的编码
HttpResponse.status_code        响应的状态码             

4.JsonResponse对象

　　JsonResponse是HttpResponse的子类，专门用来生成Json编码的相应

def test(request):
    info = {
        'name': 'zhang',
        'password': '123',
    }
    response = JsonResponse(info)
    print(response)
    print(response.content)
    # return response

    # 默认只能传递字典类型，如果要传递非字典类型需要设置一下safe关键字参数
    list_r = ['zh', '331']
    response_list = JsonResponse(list_r,safe=False)
    return response_list

5.Django shortcut functions

　　参考：

https://docs.djangoproject.com/en/2.0/topics/http/shortcuts/

　　1）render()

　　结合一个给定的模板和一个给定的上下文字典，并返回一个渲染后的HttpResponse对象

　　参数：

request　　　　　　　　用于生成响应的请求对象
template_name　　　　 要使用的模板的完整名称，可选的参数
context　　　　　　　　添加到模板上下文的一个字典。默认是一个空字典。如果字典中的某个值是可调用的，视图将在渲染
　　　　　　　　　　　　 模板之前调用它
content_type　　　　　生成的文档要使用的MIME类型。默认为 DEFAULT_CONTENT_TYPE 设置的值
　　　　　　　　　　　　 默认为'text/html'
status　　　　　　　　 响应的状态码。默认为200
useing　　　　　　　　 用于加载模板的模板引擎的名称

示例：

def student_list(request):
    stu_list = models.Student.objects.all()return render(request, 'student_list.html', {'student_list': stu_list})

　　2）redirect()

　　参数：

一个模型                    将调用模型的get_absolute_url() 函数
一个视图                    可带参数，将使用urlresolvers.reverse 来反向解析名称
一个绝对的或相对的URL         将原封不动的作为重定向的位置

默认返回一个临时的重定向，传递permanent=True可以返回一个永久的重定向

　　传递一个具体的ORM对象，将调用的ORM对象的get_absolute_url()方法来获取重定向的URL

def test(request):
    // 代码块
    obj = MyModel.objects.get("...")
    return redirect(obj)

　　传递一个视图名称

def test(request):
    // 代码块
    return redirect('/test/')

　　传递一个具体的网址

def test(request):
    // 代码块
    return redirect('https://i.cnblogs.com/EditPosts.aspx?postid=9189003&update=1')

注意：

　　默认情况下，redirect() 返回一个临时重定向；以上所有的形式都接收一个permanent 参数，如果设置为True，将返回一个永久的重定向