.. _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