HttpRequest对象的属性 |
|
属性 |
描述 |
path |
表示提交请求页面完整地址的字符串,不包括域名,如 "/music/bands/the_beatles/"。 |
method |
表示提交请求使用的HTTP方法。它总是大写的。例如: if request.method == ‘GET‘: do_something() elif request.method == ‘POST‘: do_something_else() |
GET |
一个类字典对象,包含所有的HTTP的GET参数的信息。见 QueryDict 文档。 |
POST |
一个类字典对象,包含所有的HTTP的POST参数的信息。见 QueryDict 文档。 通过POST提交的请求有可能包含一个空的 POST 字典,也就是说, 一个通过POST方法提交的表单可能不包含数据。因此,不应该使用 if request.POST 来判断POST方法的使用,而是使用 if request.method == "POST" (见表中的 method 条目)。 注意: POST 并 不 包含文件上传信息。见 FILES 。 |
REQUEST |
为了方便而创建,这是一个类字典对象,先搜索 POST ,再搜索 GET 。 灵感来自于PHP的 $_REQEUST 。 例如, 若 GET = {"name": "john"} , POST = {"age": ‘34‘} ,REQUEST["name"] 会是 "john" , REQUEST["age"] 会是 "34" 。 强烈建议使用 GET 和 POST ,而不是 REQUEST 。这是为了向前兼容和更清楚的表示。 |
COOKIES |
一个标准的Python字典,包含所有cookie。键和值都是字符串。cookie使用的更多信息见第12章。 |
FILES |
一个类字典对象,包含所有上传的文件。 FILES 的键来自 <input type="file" name="" /> 中的 name 。 FILES 的值是一个标准的Python字典,包含以下三个键: filename :字符串,表示上传文件的文件名。 content-type :上传文件的内容类型。 content :上传文件的原始内容。 注意 FILES 只在请求的方法是 POST ,并且提交的 <form> 包含enctype="multipart/form-data" 时才包含数据。否则, FILES 只是一个空的类字典对象。 |
META |
一个标准的Python字典,包含所有有效的HTTP头信息。有效的头信息与客户端和服务器有关。这里有几个例子: CONTENT_LENGTH CONTENT_TYPE QUERY_STRING :未解析的原始请求字符串。 REMOTE_ADDR :客户端IP地址。 REMOTE_HOST :客户端主机名。 SERVER_NAME :服务器主机名。 SERVER_PORT :服务器端口号。 在 META 中有效的任一HTTP头信息都是带有 HTTP_ 前缀的键,例如: HTTP_ACCEPT_ENCODING HTTP_ACCEPT_LANGUAGE HTTP_HOST :客户端发送的 Host 头信息。 HTTP_REFERER :被指向的页面,如果存在的。 HTTP_USER_AGENT :客户端的user-agent字符串。 HTTP_X_BENDER : X-Bender 头信息的值,如果已设的话。 |
user |
一个 django.contrib.auth.models.User 对象表示当前登录用户。 若当前用户尚未登录, 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 时有效。 关于认证和用户的完整细节,见第12章。 |
session |
一个可读写的类字典对象,表示当前session。仅当Django已激活session支持时有效。见第12章。 |
raw_post_data |
POST的原始数据。 用于对数据的复杂处理。 |
HttpRequest 的方法 |
|
方法 |
描述 |
__getitem__(key) |
请求所给键的GET/POST值,先查找POST,然后是GET。若键不存在,则引发异常KeyError 。 该方法使用户可以以访问字典的方式来访问一个 HttpRequest 实例。 例如, request["foo"] 和先检查 request.POST["foo"] 再检查request.GET["foo"] 一样。 |
has_key() |
返回 True 或 False ,标识 request.GET 或 request.POST 是否包含所给的键。 |
get_full_path() |
返回 path ,若请求字符串有效,则附加于其后。例如,"/music/bands/the_beatles/?print=true" 。 |
is_secure() |
如果请求是安全的,则返回 True 。也就是说,请求是以HTTPS的形式提交的。 |