.. _ref-middleware-index:
=============
Middlewares
=============
==========
Middleware
==========
.. module:: kiowa.core.middleware
Per atttivare uno specifico middleware è necessario
aggiungere la relativa classe al parametro setting.MIDDLEWARE_CLASSES del file settings di Django::
MIDDLEWARE_CLASSES = (
'django.middleware.common.CommonMiddleware',
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.csrf.CsrfViewMiddleware',
'django.contrib.auth.middleware.AuthenticationMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
)
Maggiori informazioni possono essere trovate nella `guida ufficiale `_
.. _ref-middleware-kiauth:
KiAuthMiddleware
----------------
.. class:: kiowa.core.middleware.KiAuthMiddleware
Permette un gestione centralizzata del sistema di autorizzazione.
Tramite il parametro :setting:`URLS_ACCESS_RULES` è possibile definire una serie di regole per l'accesso alle view,
deve essere impostato come una lista di elementi ognuno dei quali è composto da una lista di tre elementi,
- regular expression compatibile con la dfinizione di `urls di Diango `_
- callable da richiamare per effettuare il controllo. Questa funzione verra invocata dal middleware passandogli l'istanza User o KiUser presente nella request.
- url sulla quale fare il redirect se non viene superato il controllo
Esempio::
URLS_ACCESS_RULES = (
(r'^/.+', lambda u: u.is_admin(), '/'), # chi non è admin può accedere solo alla home
)
ThreadLocals
----------------
.. class:: kiowa.core.middleware.ThreadLocals
.. warning::
Ci sono delle limitazioni nell'uso di questo middleaware. Per ulteriori informazioni:
* http://code.djangoproject.com/wiki/CookBookThreadlocalsAndUser
* http://lucumr.pocoo.org/2006/7/10/why-i-cant-stand-threadlocal-and-others>
KiDebugMiddleware
-----------------
.. class:: kiowa.core.middleware.KiDebugMiddleware
KiUserMiddleware
----------------
.. class:: kiowa.core.middleware.KiUserMiddleware
Questo middleware si preoccupa di sostituire l'istanza della classe `User`
l'utente autenticato presente nella `request` con una di tipo :ref:`ref-models-kiuser`.
.. request: http://docs.djangoproject.com/en/dev/ref/request-response/#httprequest-objects
.. User: http://docs.djangoproject.com/en/dev/topics/auth/#django.contrib.auth.models.User
KiMiddleware
----------------
.. class:: kiowa.core.middleware.KiMiddleware