mirror of
https://github.com/django/django.git
synced 2024-12-23 09:36:06 +00:00
Added stub of docs/shortcuts.txt
git-svn-id: http://code.djangoproject.com/svn/django/trunk@6215 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
parent
66e4541101
commit
e259b8712a
41
docs/shortcuts.txt
Normal file
41
docs/shortcuts.txt
Normal file
@ -0,0 +1,41 @@
|
||||
=========================
|
||||
Django shortcut functions
|
||||
=========================
|
||||
|
||||
The package ``django.shortcuts`` collects helper functions and classes that
|
||||
"span" multiple levels of MVC. In other words, these functions/classes
|
||||
introduce controlled coupling for convenience's sake.
|
||||
|
||||
``render_to_response``
|
||||
======================
|
||||
|
||||
``django.shortcuts.render_to_response`` renders a given template with a given
|
||||
context dictionary and returns an ``HttpResponse`` object with that rendered
|
||||
text.
|
||||
|
||||
Example::
|
||||
|
||||
from django.shortcuts import render_to_response
|
||||
r = render_to_response('myapp/template.html', {'foo': 'bar'})
|
||||
|
||||
This example is equivalent to::
|
||||
|
||||
from django.http import HttpResponse
|
||||
from django.template import Context, loader
|
||||
t = loader.get_template('myapp/template.html')
|
||||
c = Context({'foo': 'bar'})
|
||||
r = HttpResponse(t.render(c))
|
||||
|
||||
``get_object_or_404``
|
||||
=====================
|
||||
|
||||
``django.shortcuts.get_object_or_404`` calls ``get()`` on a given model
|
||||
manager, but it raises ``django.http.Http404`` instead of the model's
|
||||
``DoesNotExist`` exception.
|
||||
|
||||
``get_list_or_404``
|
||||
===================
|
||||
|
||||
``django.shortcuts.get_list_or_404`` returns the result of ``filter()`` on a
|
||||
given model manager, raising ``django.http.Http404`` if the resulting list is
|
||||
empty.
|
Loading…
Reference in New Issue
Block a user