Django 的快捷函数

django.shortcuts 收集了“跨越” 多层MVC 的辅助函数和类。 换句话讲,这些函数/类为了方便,引入了可控的耦合。

render()

render(request, template_name, context=None, content_type=None, status=None, using=None)结合一个给定的模板和一个给定的上下文字典,并返回一个渲染后的HttpResponse对象。render() 与以一个强制使用RequestContext的context_instance参数调render_to_response()相同。Django 不提供返回TemplateResponse的快捷函数,因为TemplateResponse 的构造与render() 提供的便利是一个层次的。

必选的参数

request该request用于生成response
template_name要使用的模板的完整名称或者模板名称的一个序列。

可选参数

context添加到模板上下文的一个字典。默认是一个空字典。如果字典中的某个值是可调用的,视图将在渲染模板之前调用它。
content_type生成的文档要使用的MIME 类型。默认DEFAULT_CONTENT_TYPE设置的值。
status响应的状态码。默认为200。
using用于加载模板使用的模板引擎

from django.shortcuts import render
def my_view(request):
    # View code here...
    return render(request, 'myapp/index.html', {
        'foo': 'bar',
    }, content_type='application/xhtml+xml')
from django.http import HttpResponse
from django.template import loader
def my_view(request):
    # View code here...
    t = loader.get_template('myapp/index.html')
    c = {'foo': 'bar'}
    return HttpResponse(t.render(c, request), content_type='application/xhtml+xml')

render_to_response()

render_to_response(template_name, context=None, content_type=None, status=None, using=None)
根据一个给定的上下文字典渲染一个给定的目标,并返回渲染后的HttpResponse

from django.shortcuts import render_to_response
def my_view(request):
    # View code here...
    return render_to_response('myapp/index.html', {"foo": "bar"},
        content_type="application/xhtml+xml")

redirect()

redirect(to, permanent=False, *args, **kwargs)
为传递进来的参数返回HttpResponseRedirect给正确的URL 。

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

  • 通过传递一个对象;将调用get_absolute_url() 方法来获取重定向的URL:

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

  • 通过传递一个视图的名称,可以带有位置参数和关键字参数;
    将使用reverse()方法反向解析URL:

     url(r'^video/(\d{1})/$',video,name='some-view-name')
    def my_view(request):
        ...
        return redirect('some-view-name', foo='bar')
    

  • 传递要重定向的一个硬编码的URL:

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

    get_object_or_404()

    get_object_or_404(klass, *args, **kwargs)
    在一个给定的模型管理器上调用get()但是引发Http404 而不是模型的DoesNotExist异常。

    必选的参数
    klass获取该对象的一个Model类,或QuerySet实例。
    **kwargs查询的参数,格式应该可以被get() 和filter()接受。

    from django.shortcuts import get_object_or_404
    def my_view(request):
        my_object = get_object_or_404(MyModel, pk=1)
    
    from django.http import Http404
    def my_view(request):
        try:
            my_object = MyModel.objects.get(pk=1)
        except MyModel.DoesNotExist:
            raise Http404("No MyModel matches the given query.")
    

    然而,你还可以传递一个QuerySet 实例:

    queryset = Book.objects.filter(title__startswith='M')
    get_object_or_404(queryset, pk=1)
    相似于
    get_object_or_404(Book, title__startswith='M', pk=1)
    

    get_list_or_404()

    get_list_or_404(klass, *args, **kwargs)
    返回一个给定模型管理器上filter()的结果,并将结果映射为一个列表,如果结果为空则返回Http404。

    from django.shortcuts import get_list_or_404
    def my_view(request):
        my_objects = get_list_or_404(MyModel, published=True)
    
    ---相同功能
    
    from django.http import Http404
    def my_view(request):
        my_objects = list(MyModel.objects.filter(published=True))
        if not my_objects:
            raise Http404("No MyModel matches the given query.")
    
  • 你可能感兴趣的:(Django 的快捷函数)