[django] shortcut functions

Django shortcut functions

官方文档

HttpResponse

它是作用是内部传入一个字符串参数，然后发给浏览器。
例如：

def index(request):
    return HttpResponse("ok")

render()

render(request, "home.html", {"ret": ret })

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

参数：

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

例子：

from django.shortcuts import render

def my_view(request):
    return render(request, 'myapp/index.html', {'foo': 'bar'})
    
上面的代码等于：

from django.http import HttpResponse
from django.template import loader

def my_view(request):
    t = loader.get_template('myapp/index.html')
    c = {'foo': 'bar'}
    return HttpResponse(t.render(c, request))

redirect()

redirect("/home/")

参数可以是：

• 一个模型：将调用模型的get_absolute_url() 函数
• 一个视图，可以带有参数：将使用urlresolvers.reverse 来反向解析名称
• 一个绝对的或相对的URL，将原封不动的作为重定向的位置。
  默认返回一个临时的重定向；传递permanent=True 可以返回一个永久的重定向。

示例:
你可以用多种方式使用redirect() 函数。
传递一个具体的ORM对象（了解即可）
将调用具体ORM对象的get_absolute_url() 方法来获取重定向的URL：

from django.shortcuts import redirect
 
def my_view(request):
    object = MyModel.objects.get(...)
    return redirect(object)

1. 传递一个视图的名称

   def my_view(request):
       return redirect('some-view-name', foo='bar')
   

2. 传递要重定向到的一个具体的网址

   def my_view(request):
       return redirect('/some/url/')
   

3. 一个完整的网址

   def my_view(request):
       return redirect('http://example.com/')
   

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

def my_view(request):
    object = MyModel.objects.get(...)
    return redirect(object, permanent=True)　　

扩展阅读：

临时重定向（响应状态码：302）和永久重定向（响应状态码：301）对普通用户来说是没什么区别的，它主要面向的是搜索引擎的机器人。

A页面临时重定向到B页面，那搜索引擎收录的就是A页面。
A页面永久重定向到B页面，那搜索引擎收录的就是B页面。

get_objects_or_404()

该函数作用是查找返回某个对象，如果查找不到，自动返回Http404, 如下所示:

from django.shortcuts import get_object_or_404

def my_view(request):
obj = get_object_or_404(Model, pk=1)

该方法还可以接收queryset作为参数。

queryset = Book.objects.filter(title__startswith='M')
book = get_object_or_404(queryset, pk=1)
上述代码等同于:

book = get_object_or_404(Book, title__startswith='M', pk=1)

get_list_or_404()

该函数作用是查找返回某个对象清单，如果查找不到，自动返回Http404, 如下所示:

from django.shortcuts import get_list_or_404

def my_view(request):
    my_objects = get_list_or_404(MyModel, published=True)