Changeset 7510 for django/trunk/docs

Timestamp:

04/29/08 19:03:45 (3 months ago)

Author:

adrian

Message:

Added 'Setting headers' and 'Telling the browser to treat the response as a file attachment' sections to docs/request_response.txt

Files:

• django/trunk/docs/request_response.txt (modified) (2 diffs)

django/trunk/docs/request_response.txt

@@ -403 +403 @@
-      object. Doing so will raise ``Exception``.
-
+Setting headers
+~~~~~~~~~~~~~~~
+
+To set a header in your response, just treat it like a dictionary::
+
+    >>> response = HttpResponse()
+    >>> response['Pragma'] = 'no-cache'
+
+Telling the browser to treat the response as a file attachment
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To tell the browser to treat the response as a file attachment, use the
+``mimetype`` argument and set the ``Content-Disposition`` header. For example,
+this is how you might return a Microsoft Excel spreadsheet::
+
+    >>> response = HttpResponse(my_data, mimetype='application/vnd.ms-excel')
+    >>> response['Content-Disposition'] = 'attachment; filename=foo.xls'
+
+There's nothing Django-specific about the ``Content-Disposition`` header, but
+it's easy to forget the syntax, so we've included it here.
+
-Methods
--------
@@ -421 +442 @@
-    header, it can also include the character set encoding, which makes it
-    more than just a MIME type specification. If ``mimetype`` is specified
-None
+``None``
-    neither is given, the ``DEFAULT_CONTENT_TYPE`` setting is used.
-