Skip to content

Commit

Permalink
Fixed #14785 - fixes to middleware docs - thanks adamv for the patch.
Browse files Browse the repository at this point in the history
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14731 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information
timgraham committed Nov 27, 2010
1 parent 6051a7d commit 9d3b3d1
Show file tree
Hide file tree
Showing 2 changed files with 22 additions and 22 deletions.
26 changes: 13 additions & 13 deletions docs/ref/middleware.txt
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,9 @@ Cache middleware
.. module:: django.middleware.cache
:synopsis: Middleware for the site-wide cache.

.. class:: django.middleware.cache.UpdateCacheMiddleware
.. class:: UpdateCacheMiddleware

.. class:: django.middleware.cache.FetchFromCacheMiddleware
.. class:: FetchFromCacheMiddleware

Enable the site-wide cache. If these are enabled, each Django-powered page will
be cached for as long as the :setting:`CACHE_MIDDLEWARE_SECONDS` setting
Expand All @@ -32,7 +32,7 @@ defines. See the :doc:`cache documentation </topics/cache>`.
.. module:: django.middleware.common
:synopsis: Middleware adding "common" conveniences for perfectionists.

.. class:: django.middleware.common.CommonMiddleware
.. class:: CommonMiddleware

Adds a few conveniences for perfectionists:

Expand Down Expand Up @@ -80,7 +80,7 @@ View metadata middleware
.. module:: django.middleware.doc
:synopsis: Middleware to help your app self-document.

.. class:: django.middleware.doc.XViewMiddleware
.. class:: XViewMiddleware

Sends custom ``X-View`` HTTP headers to HEAD requests that come from IP
addresses defined in the :setting:`INTERNAL_IPS` setting. This is used by
Expand All @@ -92,7 +92,7 @@ GZIP middleware
.. module:: django.middleware.gzip
:synopsis: Middleware to serve gziped content for performance.

.. class:: django.middleware.gzip.GZipMiddleware
.. class:: GZipMiddleware

Compresses content for browsers that understand gzip compression (all modern
browsers).
Expand All @@ -109,7 +109,7 @@ Conditional GET middleware
.. module:: django.middleware.http
:synopsis: Middleware handling advanced HTTP features.

.. class:: django.middleware.http.ConditionalGetMiddleware
.. class:: ConditionalGetMiddleware

Handles conditional GET operations. If the response has a ``ETag`` or
``Last-Modified`` header, and the request has ``If-None-Match`` or
Expand All @@ -121,7 +121,7 @@ Also sets the ``Date`` and ``Content-Length`` response-headers.
Reverse proxy middleware
------------------------

.. class:: django.middleware.http.SetRemoteAddrFromForwardedFor
.. class:: SetRemoteAddrFromForwardedFor

.. versionchanged:: 1.1

Expand All @@ -134,7 +134,7 @@ Locale middleware
.. module:: django.middleware.locale
:synopsis: Middleware to enable language selection based on the request.

.. class:: django.middleware.locale.LocaleMiddleware
.. class:: LocaleMiddleware

Enables language selection based on data from the request. It customizes
content for each user. See the :doc:`internationalization documentation
Expand All @@ -146,7 +146,7 @@ Message middleware
.. module:: django.contrib.messages.middleware
:synopsis: Message middleware.

.. class:: django.contrib.messages.middleware.MessageMiddleware
.. class:: MessageMiddleware

.. versionadded:: 1.2
``MessageMiddleware`` was added.
Expand All @@ -160,7 +160,7 @@ Session middleware
.. module:: django.contrib.sessions.middleware
:synopsis: Session middleware.

.. class:: django.contrib.sessions.middleware.SessionMiddleware
.. class:: SessionMiddleware

Enables session support. See the :doc:`session documentation
</topics/http/sessions>`.
Expand All @@ -171,7 +171,7 @@ Authentication middleware
.. module:: django.contrib.auth.middleware
:synopsis: Authentication middleware.

.. class:: django.contrib.auth.middleware.AuthenticationMiddleware
.. class:: AuthenticationMiddleware

Adds the ``user`` attribute, representing the currently-logged-in user, to
every incoming ``HttpRequest`` object. See :doc:`Authentication in Web requests
Expand All @@ -184,7 +184,7 @@ CSRF protection middleware
:synopsis: Middleware adding protection against Cross Site Request
Forgeries.

.. class:: django.middleware.csrf.CsrfMiddleware
.. class:: CsrfMiddleware

.. versionadded:: 1.0

Expand All @@ -198,7 +198,7 @@ Transaction middleware
.. module:: django.middleware.transaction
:synopsis: Middleware binding a database transaction to each Web request.

.. class:: django.middleware.transaction.TransactionMiddleware
.. class:: TransactionMiddleware

Binds commit and rollback to the request/response phase. If a view function
runs successfully, a commit is done. If it fails with an exception, a rollback
Expand Down
18 changes: 9 additions & 9 deletions docs/topics/http/middleware.txt
Original file line number Diff line number Diff line change
Expand Up @@ -89,12 +89,12 @@ dictionary of keyword arguments that will be passed to the view. Neither
(``request``).

``process_view()`` is called just before Django calls the view. It should
return either ``None`` or an :class:`~django.http. HttpResponse` object. If it
return either ``None`` or an :class:`~django.http.HttpResponse` object. If it
returns ``None``, Django will continue processing this request, executing any
other ``process_view()`` middleware and, then, the appropriate view. If it
returns an :class:`~django.http. HttpResponse` object, Django won't bother
returns an :class:`~django.http.HttpResponse` object, Django won't bother
calling ANY other request, view or exception middleware, or the appropriate
view; it'll return that :class:`~django.http. HttpResponse`. Response
view; it'll return that :class:`~django.http.HttpResponse`. Response
middleware is always called on every response.

.. _response-middleware:
Expand All @@ -105,16 +105,16 @@ middleware is always called on every response.
.. method:: process_response(self, request, response)

``request`` is an :class:`~django.http.HttpRequest` object. ``response`` is the
:class:`~django.http. HttpResponse` object returned by a Django view.
:class:`~django.http.HttpResponse` object returned by a Django view.

``process_response()`` must return an :class:`~django.http. HttpResponse`
``process_response()`` must return an :class:`~django.http.HttpResponse`
object. It could alter the given ``response``, or it could create and return a
brand-new :class:`~django.http. HttpResponse`.
brand-new :class:`~django.http.HttpResponse`.

Unlike the ``process_request()`` and ``process_view()`` methods, the
``process_response()`` method is always called, even if the ``process_request()``
and ``process_view()`` methods of the same middleware class were skipped because
an earlier middleware method returned an :class:`~django.http. HttpResponse`
an earlier middleware method returned an :class:`~django.http.HttpResponse`
(this means that your ``process_response()`` method cannot rely on setup done in
``process_request()``, for example). In addition, during the response phase the
classes are applied in reverse order, from the bottom up. This means classes
Expand All @@ -132,8 +132,8 @@ defined at the end of :setting:`MIDDLEWARE_CLASSES` will be run first.

Django calls ``process_exception()`` when a view raises an exception.
``process_exception()`` should return either ``None`` or an
:class:`~django.http. HttpResponse` object. If it returns an
:class:`~django.http. HttpResponse` object, the response will be returned to
:class:`~django.http.HttpResponse` object. If it returns an
:class:`~django.http.HttpResponse` object, the response will be returned to
the browser. Otherwise, default exception handling kicks in.

Again, middleware are run in reverse order during the response phase, which
Expand Down

0 comments on commit 9d3b3d1

Please sign in to comment.