我们在第三章讲述 View 的函数时已经介绍过 HttpRequest 对象了,但当时并没有讲太多。让我们回忆下:每个 view 函数的第一个参数是一个 HttpRequest 对象,就像下面这个 hello() 函数:
from django.http import HttpResponse def hello(request): return HttpResponse("Hello world")
HttpRequest 对象,比如上面代码里的 request 变量,会有一些有趣的、你必须让自己熟悉的属性和方法,以便知道能拿它们来做些什么。 在 view 函数的执行过程中,你可以用这些属性来获取当前 request 的一些信息(比如,你正在加载这个页面的用户是谁,或者用的是什么浏览器)。
HttpRequest对象包含当前请求URL的一些信息:
属性/方法 | 说明 | 举例 |
---|---|---|
request.path |
除域名以外的请求路径,以正斜杠开头 | "/hello/" |
request.get_host() |
主机名(比如,通常所说的域名) | "127.0.0.1:8000" or "www.example.com" |
request.get_full_path() |
请求路径,可能包含查询字符串 | "/hello/?print=true" |
request.is_secure() |
如果通过HTTPS访问,则此方法返回True, 否则返回False | True 或者 False |
在view函数里,要始终用这个属性或方法来得到URL,而不要手动输入。 这会使得代码更加灵活,以便在其它地方重用。 下面是一个简单的例子:
# BAD! def current_url_view_bad(request): return HttpResponse("Welcome to the page at /current/") # GOOD def current_url_view_good(request): return HttpResponse("Welcome to the page at %s" % request.path)
request.META 是一个 Python 字典,包含了所有本次 HTTP 请求的 Header 信息,比如用户 IP 地址和用户 Agent(通常是浏览器的名称和版本号)。 注意,Header 信息的完整列表取决于用户所发送的 Header 信息和服务器端设置的 Header 信息。这个字典中几个常见的键值有:
HTTP_REFERER
,进站前链接网页,如果有的话。(请注意,它是
REFERRER
的笔误。)
HTTP_USER_AGENT
,用户浏览器的 user-agent 字符串,如果有的话。例如:"Mozilla/5.0 (X11; U; Linux i686;
fr-FR; rv:1.8.1.17) Gecko/20080829 Firefox/2.0.0.17"
。
REMOTE_ADDR
客户端IP,如:"12.345.67.89"
。(如果申请是经过代理服务器的话,那么它可能是以逗号分割的多个IP地址,如:"12.345.67.89,23.456.78.90"
。)
注意,因为 request.META 是一个普通的 Python 字典,因此当你试图访问一个不存在的键时,会触发一个 KeyError 异常。(HTTP header 信息是由用户的浏览器所提交的、不应该给予信任的“额外”数据,因此你总是应该好好设计你的应用以便当一个特定的 Header 数据不存在时,给出一个优雅的回应。)你应该用 try/except 语句,或者用 Python 字典的 get() 方法来处理这些“可能不存在的键”:
# BAD! def ua_display_bad(request): ua = request.META['HTTP_USER_AGENT'] # Might raise KeyError! return HttpResponse("Your browser is %s" % ua) # GOOD (VERSION 1) def ua_display_good1(request): try: ua = request.META['HTTP_USER_AGENT'] except KeyError: ua = 'unknown' return HttpResponse("Your browser is %s" % ua) # GOOD (VERSION 2) def ua_display_good2(request): ua = request.META.get('HTTP_USER_AGENT', 'unknown') return HttpResponse("Your browser is %s" % ua)
我们鼓励你动手写一个简单的 view 函数来显示 request.META 的所有数据,这样你就知道里面有什么了。 这个view函数可能是这样的:
def display_meta(request): values = request.META.items() values.sort() html = [] for k, v in values: html.append(' <tr> <td>%s</td> <td>%s</td> </tr>' % (k, v)) return HttpResponse('<table>%s</table>' % '\n'.join(html))
做为一个练习,看你自己能不能把上面这个 view 函数改用 Django 模板系统来实现,而不是上面这样来手动输入 HTML 代码。也可以试着把前面提到的 request.path 方法或 HttpRequest 对象的其它方法加进去。
除了基本的元数据,HttpRequest 对象还有两个属性包含了用户所提交的信息: request.GET 和 request.POST。二者都是类字典对象,你可以通过它们来访问GET和POST数据。
类字典对象
我们说“request.GET 和 request.POST 是类字典对象”,意思是他们的行为像 Python 里标准的字典对象,但在技术底层上他们不是标准字典对象。比如说,request.GET 和 request.POST 都有 get()、keys()和values() 方法,你可以用用 for key in request.GET 获取所有的键。
那到底有什么区别呢?因为 request.GET 和 request.POST 拥有一些普通的字典对象所没有的方法。 我们会稍后讲到。
你可能以前遇到过相似的名字:类文件对象,这些 Python 对象有一些基本的方法,如 read(),用来做真正的Python文件对象的代用品。
POST数据是来自HTML中的〈form〉标签提交的,而 GET 数据可能来自〈form〉提交也可能是 URL 中的查询字符串(the query string)。