Django messages框架

一.简介

　　在网页应用中，你常常须要在处理完表单或其它类型的用户输入后，显示一个通知消息（也叫作“flash message”）给用户

对于这个功能，Django 提供基于Cookie 和会话的消息，不管是匿名用户仍是认证的用户。

其消息框架容许你临时将消息存储在请求中，并在接下来的请求（一般就是下一个请求）中提取它们并显示。每一个消息都带有一个特定level 标签，表示其优先级（例如info、warning 或error）

二.启用消息框架　

消息框架的实现经过一个中间件 类和对应的context processor。

django-admin startproject 建立的默认settings.py  已经包含启用消息框架功能须要的全部的设置：

• INSTALLED_APPS 中的'django.contrib.messages'。

• MIDDLEWARE_CLASSES 中的'django.contrib.sessions.middleware.SessionMiddleware' 和'django.contrib.messages.middleware.MessageMiddleware'。

  默认的后端存储 依赖sessions。因此MIDDLEWARE_CLASSES 中必须启用SessionMiddleware 并出如今MessageMiddleware 以前。

• TEMPLATES 设置中定义的DjangoTemplates 的'context_processors' 选项包含'django.contrib.messages.context_processors.messages'。

若是你不想使用消息框架，你能够删除INSTALLED_APPS 中的 'django.contrib.messages'、MIDDLEWARE_CLASSES 中的MessageMiddleware 和TEMPLATES 中的messages context processo

2.1 配置消息框架引擎

　　

消息框架可使用不一样的后台存储临时消息。

Django 在django.contrib.messages 中提供三个内建的存储类：

class storage.session.SessionStorage

这个类存储全部的消息于请求的会话中。所以，它要求启用Django 的contrib.sessions 应用。

class storage.cookie.CookieStorage

这个类存储消息数据于与Cookie 中（已经用一个安全的哈希进行签名以防止篡改）以在请求之间传递消息。若是Cookie 数据的大小将超过2048 字节，将丢弃旧的消息。

class storage.fallback.FallbackStorage

这个类首先使用CookieStorage，若是消息塞不进一个Cookie 中则使用SessionStorage。 它一样要求启用Django 的contrib.sessions 应用。

这个行为避免每次都写会话。在一般状况下，它提供的性能应该是最好的。

FallbackStorage 是默认的存储类。若是它不适合你的须要，你能够经过设置 MESSAGE_STORAGE 为它的完整导入路径选择另一个存储类，例如：

MESSAGE_STORAGE = 'django.contrib.messages.storage.cookie.CookieStorage'

3.3 消息级别

　　消息框架的级别是可配置的，与Python logging 模块相似。消息的级别可让你根据类型进行分组，这样它们可以在不一样的视图和模板中过滤或显示出来

django.contrib.messages 导入的内建级别有：

Constant	Purpose
DEBUG	Development-related messages that will be ignored (or removed) in a production deployment
INFO	Informational messages for the user
SUCCESS	An action was successful, e.g. “Your profile was updated successfully”
WARNING	A failure did not occur but may be imminent
ERROR	An action was not successful or some other failure occurred

MESSAGE_LEVEL 设置能够用来改变记录的最小级别（它还能够在每一个请求中修改）。小于这个级别的消息将被忽略。

若要修改消息级别的默认标签，设置MESSAGE_TAGS为包含你想要修改的级别的字典

from django.contrib.messages import constants as messages
MESSAGE_TAGS = {
    messages.INFO: '',
    50: 'critical',
}

3.3 在视图及模板中使用

add_message(request, level, message, extra_tags='', fail_silently=False)

例 

新增消息

from django.contrib import messages
messages.add_message(request, messages.INFO, 'Hello world.')

有几个快捷方法提供标准的方式来新增消息并带有常见的标签（这些标签一般表示消息的HTML 类型）

messages.debug(request, '%s SQL statements were executed.' % count)
messages.info(request, 'Three credits remain in your account.')
messages.success(request, 'Profile details updated.')
messages.warning(request, 'Your account expires in three days.')
messages.error(request, 'Document deleted.')

3.4 显示消息

get_messages(request)

在你的模板中，像下面这样使用：

{% if messages %}
<ul class="messages">
    {% for message in messages %}
    <li{% if message.tags %} class="{{ message.tags }}"{% endif %}>{{ message }}</li>
    {% endfor %}
</ul>
{% endif %}

三.配置使用

　　以上只是简单举例使用，看更详细文档请参考 https://docs.djangoproject.com/en/1.10/ref/contrib/messages/

　　在生产使用中咱们能够把它整合成一个模块便于调用，结合前端显示当有错误或者其它信息时浏览器能够alert消息

例

from django.contrib.messages import constants as message_constants

MESSAGE_LEVEL = message_constants.INFO



TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, "templates")],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

settings

#!/usr/bin/env python
# -*- coding: utf-8 -*-
from django.contrib import messages
def flash(request, title, text, level='info'):
    """
    利用django的message系统发送一个信息。
    """
    level_map = {
        'info': messages.INFO,
        'debug': messages.DEBUG,
        'success': messages.SUCCESS,
        'warning': messages.WARNING,
        'error': messages.ERROR
    }

    level = level_map[level]

    messages.add_message(request, level, text, extra_tags=title)
    return 'ok'

message method

{% if messages %}
<script>
    {% for msg in messages %}
        alert('{{ msg.message }}');
    {% endfor %}
</script>
{% endif %}

前端显示

VIEWS调用

 result = XXXXX
      if result:
         flash(request,"success", "成功！")
      else:
         flash(request,"error",  "。。。。")