2012-06-08 00:08:47 +08:00
|
|
|
from __future__ import unicode_literals
|
|
|
|
|
2012-09-21 03:03:24 +08:00
|
|
|
import logging
|
2007-12-02 10:22:19 +08:00
|
|
|
import sys
|
2012-08-16 04:52:19 +08:00
|
|
|
import types
|
2007-12-02 10:22:19 +08:00
|
|
|
|
|
|
|
from django import http
|
2012-12-17 17:49:26 +08:00
|
|
|
from django.conf import settings
|
|
|
|
from django.core import urlresolvers
|
2006-05-02 09:31:56 +08:00
|
|
|
from django.core import signals
|
2013-05-16 07:14:28 +08:00
|
|
|
from django.core.exceptions import MiddlewareNotUsed, PermissionDenied, SuspiciousOperation
|
2013-03-06 18:12:24 +08:00
|
|
|
from django.db import connections, transaction
|
2014-11-22 04:47:46 +08:00
|
|
|
from django.http.multipartparser import MultiPartParserError
|
2012-07-21 16:00:10 +08:00
|
|
|
from django.utils.encoding import force_text
|
2014-01-21 04:15:14 +08:00
|
|
|
from django.utils.module_loading import import_string
|
2012-07-20 18:18:38 +08:00
|
|
|
from django.utils import six
|
2012-12-17 17:49:26 +08:00
|
|
|
from django.views import debug
|
2005-07-23 02:34:38 +08:00
|
|
|
|
2012-09-21 03:03:24 +08:00
|
|
|
logger = logging.getLogger('django.request')
|
2010-10-04 23:12:39 +08:00
|
|
|
|
|
|
|
|
2006-06-08 13:00:13 +08:00
|
|
|
class BaseHandler(object):
|
2007-11-11 11:55:44 +08:00
|
|
|
# Changes that are always applied to a response (in this order).
|
2008-07-07 09:45:19 +08:00
|
|
|
response_fixes = [
|
|
|
|
http.fix_location_header,
|
|
|
|
http.conditional_content_removal,
|
|
|
|
]
|
2007-11-11 11:55:44 +08:00
|
|
|
|
2005-07-23 02:34:38 +08:00
|
|
|
def __init__(self):
|
2014-09-04 20:15:09 +08:00
|
|
|
self._request_middleware = None
|
|
|
|
self._view_middleware = None
|
|
|
|
self._template_response_middleware = None
|
|
|
|
self._response_middleware = None
|
|
|
|
self._exception_middleware = None
|
2005-07-23 02:34:38 +08:00
|
|
|
|
|
|
|
def load_middleware(self):
|
|
|
|
"""
|
|
|
|
Populate middleware lists from settings.MIDDLEWARE_CLASSES.
|
|
|
|
|
2011-07-05 00:20:16 +08:00
|
|
|
Must be called after the environment is fixed (see __call__ in subclasses).
|
2005-07-23 02:34:38 +08:00
|
|
|
"""
|
|
|
|
self._view_middleware = []
|
2010-12-07 21:57:01 +08:00
|
|
|
self._template_response_middleware = []
|
2005-07-23 02:34:38 +08:00
|
|
|
self._response_middleware = []
|
2005-10-15 10:20:35 +08:00
|
|
|
self._exception_middleware = []
|
2009-03-12 15:27:47 +08:00
|
|
|
|
|
|
|
request_middleware = []
|
2005-07-23 02:34:38 +08:00
|
|
|
for middleware_path in settings.MIDDLEWARE_CLASSES:
|
2014-01-21 04:15:14 +08:00
|
|
|
mw_class = import_string(middleware_path)
|
2005-07-23 02:34:38 +08:00
|
|
|
try:
|
|
|
|
mw_instance = mw_class()
|
2014-11-08 03:57:04 +08:00
|
|
|
except MiddlewareNotUsed as exc:
|
|
|
|
if settings.DEBUG:
|
|
|
|
if six.text_type(exc):
|
|
|
|
logger.debug('MiddlewareNotUsed(%r): %s', middleware_path, exc)
|
|
|
|
else:
|
|
|
|
logger.debug('MiddlewareNotUsed: %r', middleware_path)
|
2005-07-23 02:34:38 +08:00
|
|
|
continue
|
|
|
|
|
|
|
|
if hasattr(mw_instance, 'process_request'):
|
2009-03-12 15:57:35 +08:00
|
|
|
request_middleware.append(mw_instance.process_request)
|
2005-07-23 02:34:38 +08:00
|
|
|
if hasattr(mw_instance, 'process_view'):
|
|
|
|
self._view_middleware.append(mw_instance.process_view)
|
2010-12-07 21:57:01 +08:00
|
|
|
if hasattr(mw_instance, 'process_template_response'):
|
|
|
|
self._template_response_middleware.insert(0, mw_instance.process_template_response)
|
2005-07-23 02:34:38 +08:00
|
|
|
if hasattr(mw_instance, 'process_response'):
|
|
|
|
self._response_middleware.insert(0, mw_instance.process_response)
|
2005-10-15 10:20:35 +08:00
|
|
|
if hasattr(mw_instance, 'process_exception'):
|
|
|
|
self._exception_middleware.insert(0, mw_instance.process_exception)
|
2005-07-23 02:34:38 +08:00
|
|
|
|
2009-03-12 15:27:47 +08:00
|
|
|
# We only assign to this when initialization is complete as it is used
|
|
|
|
# as a flag for initialization being complete.
|
|
|
|
self._request_middleware = request_middleware
|
|
|
|
|
2013-03-06 18:12:24 +08:00
|
|
|
def make_view_atomic(self, view):
|
2013-05-19 23:55:12 +08:00
|
|
|
non_atomic_requests = getattr(view, '_non_atomic_requests', set())
|
|
|
|
for db in connections.all():
|
|
|
|
if (db.settings_dict['ATOMIC_REQUESTS']
|
|
|
|
and db.alias not in non_atomic_requests):
|
|
|
|
view = transaction.atomic(using=db.alias)(view)
|
2013-03-06 18:12:24 +08:00
|
|
|
return view
|
|
|
|
|
2014-06-22 11:32:14 +08:00
|
|
|
def get_exception_response(self, request, resolver, status_code):
|
|
|
|
try:
|
|
|
|
callback, param_dict = resolver.resolve_error_handler(status_code)
|
|
|
|
response = callback(request, **param_dict)
|
|
|
|
except:
|
|
|
|
signals.got_request_exception.send(sender=self.__class__, request=request)
|
|
|
|
response = self.handle_uncaught_exception(request, resolver, sys.exc_info())
|
|
|
|
|
|
|
|
return response
|
|
|
|
|
2006-09-28 09:56:02 +08:00
|
|
|
def get_response(self, request):
|
2005-07-23 02:34:38 +08:00
|
|
|
"Returns an HttpResponse object for the given HttpRequest"
|
2013-03-07 07:33:51 +08:00
|
|
|
|
|
|
|
# Setup default url resolver for this thread, this code is outside
|
|
|
|
# the try/except so we don't get a spurious "unbound local
|
|
|
|
# variable" exception in the event an exception is raised before
|
|
|
|
# resolver is set
|
|
|
|
urlconf = settings.ROOT_URLCONF
|
|
|
|
urlresolvers.set_urlconf(urlconf)
|
|
|
|
resolver = urlresolvers.RegexURLResolver(r'^/', urlconf)
|
2010-01-11 01:35:01 +08:00
|
|
|
try:
|
2013-03-07 07:33:51 +08:00
|
|
|
response = None
|
|
|
|
# Apply request middleware
|
|
|
|
for middleware_method in self._request_middleware:
|
|
|
|
response = middleware_method(request)
|
|
|
|
if response:
|
|
|
|
break
|
|
|
|
|
|
|
|
if response is None:
|
|
|
|
if hasattr(request, 'urlconf'):
|
|
|
|
# Reset url resolver with a custom urlconf.
|
|
|
|
urlconf = request.urlconf
|
|
|
|
urlresolvers.set_urlconf(urlconf)
|
|
|
|
resolver = urlresolvers.RegexURLResolver(r'^/', urlconf)
|
|
|
|
|
|
|
|
resolver_match = resolver.resolve(request.path_info)
|
|
|
|
callback, callback_args, callback_kwargs = resolver_match
|
|
|
|
request.resolver_match = resolver_match
|
|
|
|
|
|
|
|
# Apply view middleware
|
|
|
|
for middleware_method in self._view_middleware:
|
|
|
|
response = middleware_method(request, callback, callback_args, callback_kwargs)
|
2010-01-11 01:35:01 +08:00
|
|
|
if response:
|
2010-10-30 15:19:04 +08:00
|
|
|
break
|
2009-11-16 09:58:00 +08:00
|
|
|
|
2013-03-07 07:33:51 +08:00
|
|
|
if response is None:
|
|
|
|
wrapped_callback = self.make_view_atomic(callback)
|
|
|
|
try:
|
|
|
|
response = wrapped_callback(request, *callback_args, **callback_kwargs)
|
|
|
|
except Exception as e:
|
|
|
|
# If the view raised an exception, run it through exception
|
|
|
|
# middleware, and if the exception middleware returns a
|
|
|
|
# response, use that. Otherwise, reraise the exception.
|
|
|
|
for middleware_method in self._exception_middleware:
|
|
|
|
response = middleware_method(request, e)
|
2009-11-16 09:58:00 +08:00
|
|
|
if response:
|
2010-10-30 15:19:04 +08:00
|
|
|
break
|
2013-03-07 07:33:51 +08:00
|
|
|
if response is None:
|
|
|
|
raise
|
|
|
|
|
|
|
|
# Complain if the view returned None (a common error).
|
|
|
|
if response is None:
|
|
|
|
if isinstance(callback, types.FunctionType): # FBV
|
|
|
|
view_name = callback.__name__
|
|
|
|
else: # CBV
|
|
|
|
view_name = callback.__class__.__name__ + '.__call__'
|
2014-02-15 22:55:50 +08:00
|
|
|
raise ValueError("The view %s.%s didn't return an HttpResponse object. It returned None instead."
|
|
|
|
% (callback.__module__, view_name))
|
2013-03-07 07:33:51 +08:00
|
|
|
|
|
|
|
# If the response supports deferred rendering, apply template
|
|
|
|
# response middleware and then render the response
|
|
|
|
if hasattr(response, 'render') and callable(response.render):
|
|
|
|
for middleware_method in self._template_response_middleware:
|
|
|
|
response = middleware_method(request, response)
|
2014-06-08 01:48:45 +08:00
|
|
|
# Complain if the template response middleware returned None (a common error).
|
|
|
|
if response is None:
|
|
|
|
raise ValueError(
|
|
|
|
"%s.process_template_response didn't return an "
|
|
|
|
"HttpResponse object. It returned None instead."
|
|
|
|
% (middleware_method.__self__.__class__.__name__))
|
2013-03-07 07:33:51 +08:00
|
|
|
response = response.render()
|
|
|
|
|
|
|
|
except http.Http404 as e:
|
|
|
|
logger.warning('Not Found: %s', request.path,
|
|
|
|
extra={
|
|
|
|
'status_code': 404,
|
|
|
|
'request': request
|
|
|
|
})
|
|
|
|
if settings.DEBUG:
|
|
|
|
response = debug.technical_404_response(request, e)
|
|
|
|
else:
|
2014-06-22 11:32:14 +08:00
|
|
|
response = self.get_exception_response(request, resolver, 404)
|
2013-03-07 07:33:51 +08:00
|
|
|
|
|
|
|
except PermissionDenied:
|
|
|
|
logger.warning(
|
|
|
|
'Forbidden (Permission denied): %s', request.path,
|
|
|
|
extra={
|
|
|
|
'status_code': 403,
|
|
|
|
'request': request
|
|
|
|
})
|
2014-06-22 11:32:14 +08:00
|
|
|
response = self.get_exception_response(request, resolver, 403)
|
2013-03-07 07:33:51 +08:00
|
|
|
|
2014-11-22 04:47:46 +08:00
|
|
|
except MultiPartParserError:
|
|
|
|
logger.warning(
|
|
|
|
'Bad request (Unable to parse request body): %s', request.path,
|
|
|
|
extra={
|
|
|
|
'status_code': 400,
|
|
|
|
'request': request
|
|
|
|
})
|
|
|
|
response = self.get_exception_response(request, resolver, 400)
|
|
|
|
|
2013-05-16 07:14:28 +08:00
|
|
|
except SuspiciousOperation as e:
|
|
|
|
# The request logger receives events for any problematic request
|
|
|
|
# The security logger receives events for all SuspiciousOperations
|
|
|
|
security_logger = logging.getLogger('django.security.%s' %
|
|
|
|
e.__class__.__name__)
|
2013-11-09 19:11:58 +08:00
|
|
|
security_logger.error(
|
|
|
|
force_text(e),
|
|
|
|
extra={
|
|
|
|
'status_code': 400,
|
|
|
|
'request': request
|
|
|
|
})
|
2014-06-24 12:13:34 +08:00
|
|
|
if settings.DEBUG:
|
|
|
|
return debug.technical_500_response(request, *sys.exc_info(), status_code=400)
|
2013-05-16 07:14:28 +08:00
|
|
|
|
2014-06-22 11:32:14 +08:00
|
|
|
response = self.get_exception_response(request, resolver, 400)
|
2013-05-16 07:14:28 +08:00
|
|
|
|
2013-03-07 07:33:51 +08:00
|
|
|
except SystemExit:
|
|
|
|
# Allow sys.exit() to actually exit. See tickets #1023 and #4701
|
|
|
|
raise
|
|
|
|
|
2013-11-03 05:02:56 +08:00
|
|
|
except: # Handle everything else.
|
2013-03-07 07:33:51 +08:00
|
|
|
# Get the exception info now, in case another exception is thrown later.
|
|
|
|
signals.got_request_exception.send(sender=self.__class__, request=request)
|
|
|
|
response = self.handle_uncaught_exception(request, resolver, sys.exc_info())
|
2008-07-16 03:17:49 +08:00
|
|
|
|
2010-10-30 15:19:04 +08:00
|
|
|
try:
|
|
|
|
# Apply response middleware, regardless of the response
|
|
|
|
for middleware_method in self._response_middleware:
|
|
|
|
response = middleware_method(request, response)
|
2014-06-08 01:48:45 +08:00
|
|
|
# Complain if the response middleware returned None (a common error).
|
|
|
|
if response is None:
|
|
|
|
raise ValueError(
|
|
|
|
"%s.process_response didn't return an "
|
|
|
|
"HttpResponse object. It returned None instead."
|
|
|
|
% (middleware_method.__self__.__class__.__name__))
|
2010-10-30 15:19:04 +08:00
|
|
|
response = self.apply_response_fixes(request, response)
|
2013-11-03 05:02:56 +08:00
|
|
|
except: # Any exception should be gathered and handled
|
2011-09-11 06:46:44 +08:00
|
|
|
signals.got_request_exception.send(sender=self.__class__, request=request)
|
2010-10-30 15:19:04 +08:00
|
|
|
response = self.handle_uncaught_exception(request, resolver, sys.exc_info())
|
|
|
|
|
2014-05-26 04:52:47 +08:00
|
|
|
response._closable_objects.append(request)
|
|
|
|
|
2010-10-30 15:19:04 +08:00
|
|
|
return response
|
|
|
|
|
2008-07-16 03:17:49 +08:00
|
|
|
def handle_uncaught_exception(self, request, resolver, exc_info):
|
|
|
|
"""
|
|
|
|
Processing for any otherwise uncaught exceptions (those that will
|
|
|
|
generate HTTP 500 responses). Can be overridden by subclasses who want
|
|
|
|
customised 500 handling.
|
|
|
|
|
|
|
|
Be *very* careful when overriding this because the error could be
|
|
|
|
caused by anything, so assuming something like the database is always
|
|
|
|
available would be an error.
|
|
|
|
"""
|
2008-07-20 02:49:49 +08:00
|
|
|
if settings.DEBUG_PROPAGATE_EXCEPTIONS:
|
|
|
|
raise
|
|
|
|
|
2012-02-10 02:58:36 +08:00
|
|
|
logger.error('Internal Server Error: %s', request.path,
|
2010-10-04 23:12:39 +08:00
|
|
|
exc_info=exc_info,
|
|
|
|
extra={
|
|
|
|
'status_code': 500,
|
2011-06-09 06:18:46 +08:00
|
|
|
'request': request
|
2010-10-04 23:12:39 +08:00
|
|
|
}
|
|
|
|
)
|
|
|
|
|
2011-06-22 14:01:44 +08:00
|
|
|
if settings.DEBUG:
|
|
|
|
return debug.technical_500_response(request, *exc_info)
|
|
|
|
|
2010-03-26 23:08:24 +08:00
|
|
|
# If Http500 handler is not installed, re-raise last exception
|
|
|
|
if resolver.urlconf_module is None:
|
2012-08-12 05:43:45 +08:00
|
|
|
six.reraise(*exc_info)
|
2008-07-16 03:17:49 +08:00
|
|
|
# Return an HttpResponse that displays a friendly error message.
|
2014-06-22 11:32:14 +08:00
|
|
|
callback, param_dict = resolver.resolve_error_handler(500)
|
2008-07-16 03:17:49 +08:00
|
|
|
return callback(request, **param_dict)
|
2005-07-23 02:34:38 +08:00
|
|
|
|
2007-11-11 11:55:44 +08:00
|
|
|
def apply_response_fixes(self, request, response):
|
|
|
|
"""
|
|
|
|
Applies each of the functions in self.response_fixes to the request and
|
|
|
|
response, modifying the response in the process. Returns the new
|
|
|
|
response.
|
|
|
|
"""
|
|
|
|
for func in self.response_fixes:
|
|
|
|
response = func(request, response)
|
|
|
|
return response
|