mirror of
https://github.com/django/django.git
synced 2024-12-24 18:16:19 +00:00
Fixed #14746 - Add links to docs/ref/request-response.txt. Thanks adamv.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14840 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
parent
06850baefa
commit
0f5a7e0775
@ -62,24 +62,22 @@ All attributes except ``session`` should be considered read-only.
|
|||||||
|
|
||||||
.. attribute:: HttpRequest.encoding
|
.. attribute:: HttpRequest.encoding
|
||||||
|
|
||||||
.. versionadded:: 1.0
|
|
||||||
|
|
||||||
A string representing the current encoding used to decode form submission
|
A string representing the current encoding used to decode form submission
|
||||||
data (or ``None``, which means the ``DEFAULT_CHARSET`` setting is used).
|
data (or ``None``, which means the :setting:`DEFAULT_CHARSET` setting is
|
||||||
You can write to this attribute to change the encoding used when accessing
|
used). You can write to this attribute to change the encoding used when
|
||||||
the form data. Any subsequent attribute accesses (such as reading from
|
accessing the form data. Any subsequent attribute accesses (such as reading
|
||||||
``GET`` or ``POST``) will use the new ``encoding`` value. Useful if you
|
from ``GET`` or ``POST``) will use the new ``encoding`` value. Useful if
|
||||||
know the form data is not in the ``DEFAULT_CHARSET`` encoding.
|
you know the form data is not in the :setting:`DEFAULT_CHARSET` encoding.
|
||||||
|
|
||||||
.. attribute:: HttpRequest.GET
|
.. attribute:: HttpRequest.GET
|
||||||
|
|
||||||
A dictionary-like object containing all given HTTP GET parameters. See the
|
A dictionary-like object containing all given HTTP GET parameters. See the
|
||||||
``QueryDict`` documentation below.
|
:class:`QueryDict` documentation below.
|
||||||
|
|
||||||
.. attribute:: HttpRequest.POST
|
.. attribute:: HttpRequest.POST
|
||||||
|
|
||||||
A dictionary-like object containing all given HTTP POST parameters. See the
|
A dictionary-like object containing all given HTTP POST parameters. See the
|
||||||
``QueryDict`` documentation below.
|
:class:`QueryDict` documentation below.
|
||||||
|
|
||||||
It's possible that a request can come in via POST with an empty ``POST``
|
It's possible that a request can come in via POST with an empty ``POST``
|
||||||
dictionary -- if, say, a form is requested via the POST HTTP method but
|
dictionary -- if, say, a form is requested via the POST HTTP method but
|
||||||
@ -110,14 +108,7 @@ All attributes except ``session`` should be considered read-only.
|
|||||||
|
|
||||||
A dictionary-like object containing all uploaded files. Each key in
|
A dictionary-like object containing all uploaded files. Each key in
|
||||||
``FILES`` is the ``name`` from the ``<input type="file" name="" />``. Each
|
``FILES`` is the ``name`` from the ``<input type="file" name="" />``. Each
|
||||||
value in ``FILES`` is an ``UploadedFile`` object containing the following
|
value in ``FILES`` is an :class:`UploadedFile` as described below.
|
||||||
attributes:
|
|
||||||
|
|
||||||
* ``read(num_bytes=None)`` -- Read a number of bytes from the file.
|
|
||||||
* ``name`` -- The name of the uploaded file.
|
|
||||||
* ``size`` -- The size, in bytes, of the uploaded file.
|
|
||||||
* ``chunks(chunk_size=None)`` -- A generator that yields sequential
|
|
||||||
chunks of data.
|
|
||||||
|
|
||||||
See :doc:`/topics/files` for more information.
|
See :doc:`/topics/files` for more information.
|
||||||
|
|
||||||
@ -130,11 +121,11 @@ All attributes except ``session`` should be considered read-only.
|
|||||||
|
|
||||||
In previous versions of Django, ``request.FILES`` contained simple ``dict``
|
In previous versions of Django, ``request.FILES`` contained simple ``dict``
|
||||||
objects representing uploaded files. This is no longer true -- files are
|
objects representing uploaded files. This is no longer true -- files are
|
||||||
represented by ``UploadedFile`` objects as described below.
|
represented by :class:`UploadedFile` objects.
|
||||||
|
|
||||||
These ``UploadedFile`` objects will emulate the old-style ``dict``
|
These :class:`UploadedFile` objects will emulate the old-style ``dict``
|
||||||
interface, but this is deprecated and will be removed in the next release of
|
interface, but this is deprecated and will be removed in the next release
|
||||||
Django.
|
of Django.
|
||||||
|
|
||||||
.. attribute:: HttpRequest.META
|
.. attribute:: HttpRequest.META
|
||||||
|
|
||||||
@ -202,16 +193,14 @@ All attributes except ``session`` should be considered read-only.
|
|||||||
|
|
||||||
Not defined by Django itself, but will be read if other code (e.g., a custom
|
Not defined by Django itself, but will be read if other code (e.g., a custom
|
||||||
middleware class) sets it. When present, this will be used as the root
|
middleware class) sets it. When present, this will be used as the root
|
||||||
URLconf for the current request, overriding the ``ROOT_URLCONF`` setting.
|
URLconf for the current request, overriding the :setting:`ROOT_URLCONF`
|
||||||
See :ref:`how-django-processes-a-request` for details.
|
setting. See :ref:`how-django-processes-a-request` for details.
|
||||||
|
|
||||||
Methods
|
Methods
|
||||||
-------
|
-------
|
||||||
|
|
||||||
.. method:: HttpRequest.get_host()
|
.. method:: HttpRequest.get_host()
|
||||||
|
|
||||||
.. versionadded:: 1.0
|
|
||||||
|
|
||||||
Returns the originating host of the request using information from the
|
Returns the originating host of the request using information from the
|
||||||
``HTTP_X_FORWARDED_HOST`` and ``HTTP_HOST`` headers (in that order). If
|
``HTTP_X_FORWARDED_HOST`` and ``HTTP_HOST`` headers (in that order). If
|
||||||
they don't provide a value, the method uses a combination of
|
they don't provide a value, the method uses a combination of
|
||||||
@ -252,8 +241,6 @@ Methods
|
|||||||
|
|
||||||
.. method:: HttpRequest.build_absolute_uri(location)
|
.. method:: HttpRequest.build_absolute_uri(location)
|
||||||
|
|
||||||
.. versionadded:: 1.0
|
|
||||||
|
|
||||||
Returns the absolute URI form of ``location``. If no location is provided,
|
Returns the absolute URI form of ``location``. If no location is provided,
|
||||||
the location will be set to ``request.get_full_path()``.
|
the location will be set to ``request.get_full_path()``.
|
||||||
|
|
||||||
@ -270,8 +257,6 @@ Methods
|
|||||||
|
|
||||||
.. method:: HttpRequest.is_ajax()
|
.. method:: HttpRequest.is_ajax()
|
||||||
|
|
||||||
.. versionadded:: 1.0
|
|
||||||
|
|
||||||
Returns ``True`` if the request was made via an ``XMLHttpRequest``, by
|
Returns ``True`` if the request was made via an ``XMLHttpRequest``, by
|
||||||
checking the ``HTTP_X_REQUESTED_WITH`` header for the string
|
checking the ``HTTP_X_REQUESTED_WITH`` header for the string
|
||||||
``'XMLHttpRequest'``. Most modern JavaScript libraries send this header.
|
``'XMLHttpRequest'``. Most modern JavaScript libraries send this header.
|
||||||
@ -300,8 +285,38 @@ Methods
|
|||||||
process(element)
|
process(element)
|
||||||
|
|
||||||
|
|
||||||
|
UploadedFile objects
|
||||||
|
====================
|
||||||
|
|
||||||
|
.. class:: UploadedFile
|
||||||
|
|
||||||
|
|
||||||
|
Attributes
|
||||||
|
----------
|
||||||
|
|
||||||
|
.. attribute:: UploadedFile.name
|
||||||
|
|
||||||
|
The name of the uploaded file.
|
||||||
|
|
||||||
|
.. attribute:: UploadedFile.size
|
||||||
|
|
||||||
|
The size, in bytes, of the uploaded file.
|
||||||
|
|
||||||
|
Methods
|
||||||
|
----------
|
||||||
|
|
||||||
|
.. method:: UploadedFile.chunks(chunk_size=None)
|
||||||
|
|
||||||
|
Returns a generator that yields sequential chunks of data.
|
||||||
|
|
||||||
|
.. method:: UploadedFile.read(num_bytes=None)
|
||||||
|
|
||||||
|
Read a number of bytes from the file.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
QueryDict objects
|
QueryDict objects
|
||||||
-----------------
|
=================
|
||||||
|
|
||||||
.. class:: QueryDict
|
.. class:: QueryDict
|
||||||
|
|
||||||
@ -463,7 +478,7 @@ Django, :class:`HttpResponse` objects are your responsibility. Each view you
|
|||||||
write is responsible for instantiating, populating and returning an
|
write is responsible for instantiating, populating and returning an
|
||||||
:class:`HttpResponse`.
|
:class:`HttpResponse`.
|
||||||
|
|
||||||
The :class:`HttpResponse` class lives in the ``django.http`` module.
|
The :class:`HttpResponse` class lives in the :mod:`django.http` module.
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
-----
|
-----
|
||||||
@ -543,7 +558,8 @@ Methods
|
|||||||
.. method:: HttpResponse.__init__(content='', mimetype=None, status=200, content_type=DEFAULT_CONTENT_TYPE)
|
.. method:: HttpResponse.__init__(content='', mimetype=None, status=200, content_type=DEFAULT_CONTENT_TYPE)
|
||||||
|
|
||||||
Instantiates an ``HttpResponse`` object with the given page content (a
|
Instantiates an ``HttpResponse`` object with the given page content (a
|
||||||
string) and MIME type. The ``DEFAULT_CONTENT_TYPE`` is ``'text/html'``.
|
string) and MIME type. The :setting:`DEFAULT_CONTENT_TYPE` is
|
||||||
|
``'text/html'``.
|
||||||
|
|
||||||
``content`` can be an iterator or a string. If it's an iterator, it should
|
``content`` can be an iterator or a string. If it's an iterator, it should
|
||||||
return strings, and those strings will be joined together to form the
|
return strings, and those strings will be joined together to form the
|
||||||
@ -551,15 +567,13 @@ Methods
|
|||||||
|
|
||||||
``status`` is the `HTTP Status code`_ for the response.
|
``status`` is the `HTTP Status code`_ for the response.
|
||||||
|
|
||||||
.. versionadded:: 1.0
|
|
||||||
|
|
||||||
``content_type`` is an alias for ``mimetype``. Historically, this parameter
|
``content_type`` is an alias for ``mimetype``. Historically, this parameter
|
||||||
was only called ``mimetype``, but since this is actually the value included
|
was only called ``mimetype``, but since this is actually the value included
|
||||||
in the HTTP ``Content-Type`` header, it can also include the character set
|
in the HTTP ``Content-Type`` header, it can also include the character set
|
||||||
encoding, which makes it more than just a MIME type specification.
|
encoding, which makes it more than just a MIME type specification.
|
||||||
If ``mimetype`` is specified (not ``None``), that value is used.
|
If ``mimetype`` is specified (not ``None``), that value is used.
|
||||||
Otherwise, ``content_type`` is used. If neither is given, the
|
Otherwise, ``content_type`` is used. If neither is given, the
|
||||||
``DEFAULT_CONTENT_TYPE`` setting is used.
|
:setting:`DEFAULT_CONTENT_TYPE` setting is used.
|
||||||
|
|
||||||
.. method:: HttpResponse.__setitem__(header, value)
|
.. method:: HttpResponse.__setitem__(header, value)
|
||||||
|
|
||||||
@ -668,8 +682,6 @@ types of HTTP responses. Like ``HttpResponse``, these subclasses live in
|
|||||||
|
|
||||||
.. class:: HttpResponseBadRequest
|
.. class:: HttpResponseBadRequest
|
||||||
|
|
||||||
.. versionadded:: 1.0
|
|
||||||
|
|
||||||
Acts just like :class:`HttpResponse` but uses a 400 status code.
|
Acts just like :class:`HttpResponse` but uses a 400 status code.
|
||||||
|
|
||||||
.. class:: HttpResponseNotFound
|
.. class:: HttpResponseNotFound
|
||||||
|
Loading…
Reference in New Issue
Block a user