Django框架的HTTP请求之WSGIRequest
WSGIRequest对象
Django在接收到http请求之后,会根据http请求携带的参数以及报文信息创建一个WSGIRequest对象,并且作为视图函数第一个参数传给视图函数。
这个参数就是django视图函数的第一个参数,通常写成request。
在这个对象上我们可以找到客户端上传上来的所有信息。这个对象的完整路径是django.core.handlers.wsgi.WSGIRequest。
http请求的url详解:
在了解WSGIRequest对象的属性和方法之前,我们先了解一下url的组成,通常来说url的完整组成如下,[]为可选:
protocol 😕/hostname[:port]/path/[;parameters][?query]#fragment
protocol
: 网络协议,常用的协议有http/https/ftp等hostname
: 主机地址,可以是域名,也可以是IP地址port
: 端口 http协议默认端口是:80端口,在浏览器中默认会隐藏不显示path
:路径 网络资源在服务器中的指定路径parameter
: 参数 如果要向服务器传入参数,在这部分输入query
: 查询字符串 如果需要从服务器那里查询内容,在这里编辑fragment
:片段 网页中可能会分为不同的片段,如果想访问网页后直接到达指定位置,可以在这部分设置
WSGIRequest对象常用属性
WSGIRequest对象上大部分的属性都是只读的。
因为这些属性是从客户端上传上来的,没必要做任何的修改,在django视图中使用时,视图函数的第一个参数参数request就是WSGIRequest对象。
以下将对一些常用的属性进行讲解:
path
:资源在服务器的完整“路径”,但不包含域名和参数,在url中也是path的内容。比如http://www.baidu.com/xxx/yyy/,那么path就是/xxx/yyy/。method
:代表当前请求的http方法。比如是GET、POST、delete或者是put等方GET
:一个django.http.request.QueryDict对象。操作起来类似于字典。这个属性中包含了所有以?xxx=xxx的方式上传上来的参数。POST
:也是一个django.http.request.QueryDict对象。这个属性中包含了所有以POST方式上传上来的参数。FILES
:也是一个django.http.request.QueryDict对象。这个属性中包含了所有上传的文件。COOKIES
:一个标准的Python字典,包含所有的cookie,键值对都是字符串session
:一个类似于字典的对象。用来操作服务器的session。user
:user 只有当Django 启用AuthenticationMiddleware 中间件时才可用。它的值是一个 setting.py 里面AUTH_USER_MODEL字段所定义的类的对象,表示当前登录的用户。如果用户当前没有登录,user 将设为django.contrib.auth.models.AnonymousUser 的一个实例。你可以通过is_authenticated() 区分它们。
META:存储的客户端发送上来的所有header信息
下面是这些常用的header信息:
CONTENT_LENGTH
:请求的正文的长度(是一个字符串)。 CONTENT_TYPE:请求的正文的MIME类型。HTTP_ACCEPT
:响应可接收的Content-Type。HTTP_ACCEPT_ENCODING
:响应可接收的编码,用于告知服务器客户端所能够处理的编码方式和相对优先级。HTTP_ACCEPT_LANGUAGE
: 响应可接收的语言。 HTTP_HOST:客户端发送的HOST值。HTTP_REFERER
:在访问这个页面上一个页面的url。 QUERY_STRING:单个字符串形式的查询字符串(未解析过的形式)。TE
:设置传输实体的编码格式,表示请求发起者愿意接收的Transfer-Encoding类型(传输过程中的编码格式,代理服务器之间)REMOTE_ADDR
:客户端的IP地址。如果服务器使用了nginx做反向代理或者负载均衡,那么这个值返回的是127.0.0.1,这时候可以使用HTTP_X_FORWARDED_FOR来获取,所以获取ip地址的代码片段如下:
if request.META.has_key('HTTP_X_FORWARDED_FOR'):
ip = request.META['HTTP_X_FORWARDED_FOR']
else:
ip = request.META['REMOTE_ADDR']
REMOTE_HOST:客户端的主机名。
REQUEST_METHOD:请求方法。一个字符串类似于GET或者POST。
SERVER_NAME:服务器域名。
SERVER_PORT:服务器端口号,是一个字符串类型。
WSGIRequest对象常用方法
is_secure()
:是否是采用https协议。is_ajax()
:是否采用ajax发送的请求。原理就是判断请求头中是否存在X-Requested-With:XMLHttpRequest。get_host()
:服务器的域名。如果在访问的时候还有端口号,那么会加上端口号,在url中就是hostname+port。比如www.baidu.com:9000。get_full_path()
:返回完整的path。如果有查询字符串,还会加上查询字符串,在url中就是path以及其后面的所有。比如/music/bands/?print=True。get_raw_uri()
:获取请求的完整url。
QueryDict对象
我们平时用的request.GET、request.POST和request.FILES都是QueryDict对象,这个对象继承自dict,因此用法跟dict相差无几。其中用得比较多的是get方法和getlist方法。
get方法
:用来获取指定key的值,如果没有这个key,那么会返回None。getlist方法
:如果浏览器上传上来的key对应的值有多个,如果使用get取值,那么你只能取出最后面一个值,如果你想取到所有的值,那么就需要通过getlist这个方法获取。
import logging
from django.utils.deprecation import MiddlewareMixin
logger = logging.getLogger('solomon_info')
class TestMiddleware(MiddlewareMixin):
def process_request(self, request: object) -> object:
logger.info({
'path': request.path,
'method': request.method,
# 包含了所有以?xxx=xxx的方式上传上来的参数
'get_data': request.GET,
# 包含了所有以POST方式上传上来的参数
'post_data': request.POST,
# 包含了所有上传的文件
'file': request.FILES,
# 请求携带的cookie值
'cookie': request.COOKIES,
# 请求携带的session值
'session': request.session,
# 当前系统用户
'user': request.user.username,
# WSGIRequest对象常用方法
# 是否是采用https协议
'is_secure': request.is_secure(),
'is_ajax': request.is_ajax(),
'host': request.get_host(),
'full_path': request.get_full_path(),
# 获取请求的完整url
'raw_uri': request.get_raw_uri()
})