Web アプリケーションでは非常に一般的に、フォームやその他のユーザーインプットのプロセスの後、ユーザーに向けて一過性の通知メッセージ ("フラッシュメッセージ" とも言われます) を表示する必要があります。
\nDjango は、anonymous および認証済みユーザーの両方に対して、Cookie とセッションをベースにしたメッセージングを完全にサポートしています。このメッセージフレームワークは、一時的に一つのリクエスト内にメッセージを保管し、その後のリクエスト (通常、直後のリクエスト) 内で表示するために、これらを検索することを可能にします。全てのメッセージは、優先順位 (例えば info、 warning、ないし error) を決定づける特定の level でタグづけされます。
メッセージは、 ミドルウェア クラスと、それに対応する コンテクストプロセッサー を通して実行されます。
\ndjango-admin startproject によって生成されたデフォルトの settings.py は、メッセージ機能を有効にするために必要な設定を全て含んでいます:
'django.contrib.messages' は、INSTALLED_APPS の中にあります。
MIDDLEWARE は 'django.contrib.sessions.middleware.SessionMiddleware' と 'django.contrib.messages.middleware.MessageMiddleware' を含みます。
デフォルトの storage backend は sessions に依存します。そのため SessionMiddleware を有効にして、 MIDDLEWARE 内で MessageMiddleware より前に記述する必要があります。
TEMPLATES 設定で定義した DjangoTemplates バックエンドの 'context_processors' オプションは、'django.contrib.messages.context_processors.messages' を含みます。
メッセージを使いたくない場合は、INSTALLED_APPS から 'django.contrib.messages' を、MIDDLEWARE から MessageMiddleware 行を、そして TEMPLATES から messages コンテクストプロセッサーを削除できます。
メッセージフレームワークは、一時的なメッセージを保管するために、異なるバックエンドを使うことができます。
\nDjango は、django.contrib.messages の中で、以下の3つのビルトインのストレージクラスを提供しています:
このクラスは、すべてのメッセージをリクエストのセッション内部に保管します。ゆえに、Django の contrib.sessions アプリケーションが必要となります。
このクラスは、複数のリクエストにわたって通知を保持するために、Cookie (改ざんを防ぐため秘密のハッシュで署名されます) にメッセージデータを保管します。古いメッセージは Cookie データのサイズが 2048 バイトを超えると破棄されます。
\n\nこのクラスは、まず CookieStorage を使い、単一の Cookie に合わないメッセージに対して SessionStorage を使います。Django の contrib.sessions アプリケーションも必要となります。
この動作は、可能な限りセッションへの書き込みを避けます。一般的なケースでは最高のパフォーマンスを提供するはずです。
\nFallbackStorage はデフォルトのストレージクラスです。もしあなたのニーズに合わないときは、 MESSAGE_STORAGE を完全な import パスに設定することで他のストレージクラスを選べます。例えば:
MESSAGE_STORAGE = 'django.contrib.messages.storage.cookie.CookieStorage'\n独自のストレージクラスに書き込むためには、 django.contrib.messages.storage.base 内の BaseStorage クラスをサブクラス化して、 _get と _store メソッドを実装してください。
メッセージフレームワークは、Python ロギングモジュールに似た、設定可能なレベルアーキテクチャに基づきます。メッセージレベルは、タイプによるグループメッセージを可能にします。これにより、ビューやテンプレートの中で異なるフィルターおよび表示ができるようになります。
\ndjango.contrib.messages から直接インポートできるビルトインのレベルは以下の通りです:
定数 | \n目的 | \n
|---|---|
| \nプロダクション環境では無視 (ないし削除) される、開発に関連したメッセージ | \n
| \nユーザーに何か情報を伝えるメッセージ | \n
| \nあるアクションが成功した、例えば "あなたのプロフィールは無事に更新されました" | \n
| \n問題は起きなかったが、問題になり得る | \n
| \nあるアクションが成功 しなかった か、他の問題が発生した | \n
MESSAGE_LEVEL 設定は、最小限の記録されたレベルを変更するため (もしくは リクエストごとに変更 するため)に使うことができます。これ以下のレベルのメッセージを追加しようとしても無視されます。
メッセージを付与するには、以下を呼び出してください:
\nfrom django.contrib import messages\nmessages.add_message(request, messages.INFO, 'Hello world.')\nいくつかのショートカットメソッドは、一般的に使われるタグ (通常、メッセージのHTMLクラスとして表されます) とともにメッセージを付与する標準的な方法を提供します:
\nmessages.debug(request, '%s SQL statements were executed.' % count)\nmessages.info(request, 'Three credits remain in your account.')\nmessages.success(request, 'Profile details updated.')\nmessages.warning(request, 'Your account expires in three days.')\nmessages.error(request, 'Document deleted.')\nあなたのテンプレート内で、以下のようなものを使ってください:
\n{% if messages %}\n<ul class="messages">\n {% for message in messages %}\n <li{% if message.tags %} class="{{ message.tags }}"{% endif %}>{{ message }}</li>\n {% endfor %}\n</ul>\n{% endif %}\nコンテクストプロセッサーを使っている場合、テンプレートは RequestContext でレンダリングされる必要があります。もしくは、 messages をテンプレートコンテクストに対して有効にしてください。
Even if you know there is only one message, you should still iterate over the\nmessages sequence, because otherwise the message storage will not be\ncleared for the next request.
コンテクストプロセッサーは、メッセージレベルの名前と数値を対応させた DEFAULT_MESSAGE_LEVELS 変数も提供します。
{% if messages %}\n<ul class="messages">\n {% for message in messages %}\n <li{% if message.tags %} class="{{ message.tags }}"{% endif %}>\n {% if message.level == DEFAULT_MESSAGE_LEVELS.ERROR %}Important: {% endif %}\n {{ message }}\n </li>\n {% endfor %}\n</ul>\n{% endif %}\nテンプレート以外では、 get_messages() を使うことができます:
from django.contrib.messages import get_messages\n\nstorage = get_messages(request)\nfor message in storage:\n do_something_with_the_message(message)\n例えば、 すべてのメッセージを取得して、TemplateResponseMixin の代わりに JSONResponseMixin の中にreturnすることができます。
get_messages() は設定されたストレージバックエンドのインスタンスを返します。
Message クラスLink to this heading#When you loop over the list of messages in a template, what you get are\ninstances of the Message class. They have only a few attributes:
message: メッセージの実際のテキストです。
level: メッセージのタイプを説明する数値です (詳細は上述の message levels セクション)。
tags: スペースによって区切られた、全てのメッセージのタグを結合する文字列 (extra_tags と level_tag) です。
extra_tags: スペースによって区切られた、メッセージのカスタムタグを含む文字列です。空がデフォルトです。
level_tag: レベルを表す文字列です。デフォルトでは定数名の小文字バージョンですが、MESSAGE_TAGS 設定によって変更することができます。
メッセージレベルは実際には単なる整数なので、独自のレベル定数を定義して、よりカスタマイズされたユーザーフィードバックを作成することができます。例えば:
\nCRITICAL = 50\n\ndef my_view(request):\n messages.add_message(request, CRITICAL, 'A serious error occurred.')\n独自のメッセージレベルを作成するときには、既存のレベルを上書きしないように気をつけてください。ビルトインのレベルで使われている値は以下の通りです:
\nレベル定数 | \n値 | \n
|---|---|
| \n10 | \n
| \n20 | \n
| \n25 | \n
| \n30 | \n
| \n40 | \n
HTML や CSS の中で独自のレベルを指定する必要がある場合は、MESSAGE_TAGS 設定を通してマップを提供する必要があります。
The minimum recorded level can be set per request via the set_level\nmethod:
from django.contrib import messages\n\n# Change the messages level to ensure the debug message is added.\nmessages.set_level(request, messages.DEBUG)\nmessages.debug(request, 'Test message...')\n\n# In another request, record only messages with a level of WARNING and higher\nmessages.set_level(request, messages.WARNING)\nmessages.success(request, 'Your profile was updated.') # ignored\nmessages.warning(request, 'Your account is about to expire.') # recorded\n\n# Set the messages level back to default.\nmessages.set_level(request, None)\nSimilarly, the current effective level can be retrieved with get_level:
from django.contrib import messages\ncurrent_level = messages.get_level(request)\nFor more information on how the minimum recorded level functions, see\nMessage levels above.
\nIf you're writing a reusable app (or other piece of code) and want to include\nmessaging functionality, but don't want to require your users to enable it\nif they don't want to, you may pass an additional keyword argument\nfail_silently=True to any of the add_message family of methods. For\nexample:
messages.add_message(\n request, messages.SUCCESS, 'Profile details updated.',\n fail_silently=True,\n)\nmessages.info(request, 'Hello world.', fail_silently=True)\nAdds a success message attribute to\nFormView based classes
cleaned_data is the cleaned data from the form which is used for\nstring formatting
Example views.py:
\nfrom django.contrib.messages.views import SuccessMessageMixin\nfrom django.views.generic.edit import CreateView\nfrom myapp.models import Author\n\nclass AuthorCreateView(SuccessMessageMixin, CreateView):\n model = Author\n success_url = '/success/'\n success_message = "%(name)s was created successfully"\nThe cleaned data from the form is available for string interpolation using\nthe %(field_name)s syntax. For ModelForms, if you need access to fields\nfrom the saved object override the\nget_success_message()\nmethod.
Example views.py for ModelForms:
\nfrom django.contrib.messages.views import SuccessMessageMixin\nfrom django.views.generic.edit import CreateView\nfrom myapp.models import ComplicatedModel\n\nclass ComplicatedCreateView(SuccessMessageMixin, CreateView):\n model = ComplicatedModel\n success_url = '/success/'\n success_message = "%(calculated_field)s was created successfully"\n\n def get_success_message(self, cleaned_data):\n return self.success_message % dict(\n cleaned_data,\n calculated_field=self.object.calculated_field,\n )\nThe messages are marked to be cleared when the storage instance is iterated\n(and cleared when the response is processed).
\nTo avoid the messages being cleared, you can set the messages storage to\nFalse after iterating:
storage = messages.get_messages(request)\nfor message in storage:\n do_something_with(message)\nstorage.used = False\nDue to the way cookies (and hence sessions) work, the behavior of any\nbackends that make use of cookies or sessions is undefined when the same\nclient makes multiple requests that set or get messages in parallel. For\nexample, if a client initiates a request that creates a message in one window\n(or tab) and then another that fetches any uniterated messages in another\nwindow, before the first window redirects, the message may appear in the\nsecond window instead of the first window where it may be expected.
\nIn short, when multiple simultaneous requests from the same client are\ninvolved, messages are not guaranteed to be delivered to the same window that\ncreated them nor, in some cases, at all. Note that this is typically not a\nproblem in most applications and will become a non-issue in HTML5, where each\nwindow/tab will have its own browsing context.
\nA few settings give you control over message\nbehavior:
\n\nFor backends that use cookies, the settings for the cookie are taken from\nthe session cookie settings:
\n\n