django.middleware.gzip.GZipMiddleware

このミドルウェアは、ミドルウェアリストの先頭に置くよう勧めます。なぜなら、 コンテンツの圧縮は最後に行うべきものだからです。このミドルウェアは、 200 バ イト未満のコンテンツを圧縮しません。また、状態コード 200 以外のレスポンス内 のコンテンツ、Javascript ファイル (IE との互換性のため)、 Content-Encoding が指定されているレスポンスも圧縮しません。

SlugField

DateTimeField, ForeignKey, ManyToManyField は prepopulate_from に入れら れません。

DecimalField

開発版の Django で新たに追加された機能です

• デフォルトのウィジェット: TextInput
• 空のフォームデータに対する値: None
• Python データへの正規化: Python の decimal オブジェクト
• 値が 10 進小数に変換可能か検証します。文字列の先頭および末尾の空白文 字は除去されます。

max_value, min_value, max_digits, および decimal_places の 4 つのオプション引数を取ります。 max_digits は最大の桁数 (先頭のゼロ詰 め桁を除いた上での小数点前後の桁数の合計) です。 decimal_places は小数 部の最大桁数です。

IntegerField

オプションの引数として、指定可能な数値の範囲を表す max_value および min_value をとります。

ウィジェットの指定

フォームに何らかのフィールドを作成する場合、 Django は表示するデータの型に 応じて、適切なデフォルトのウィジェットを使います。どのフィールドがどのウィ ジェットを使っているかは、組み込みフィールドクラスのドキュメントを参照して ください。

とはいえ、デフォルトとは違うウィジェットを使いたい場合もあるでしょう。その 場合には、以下の例のように、フィールドを定義する際に widget 引数を指定 します:

class CommentForm(forms.Form):
    name = forms.CharField()
    url = forms.URLField()
    comment = forms.CharField(widget=forms.TextArea)

上のコードでは、 comment フィールドにデフォルトの TextInput ウィジェットで はなく、より大きな TextArea ウィジェットを使うように指定しています。

ウィジェットインスタンスのカスタマイズ

ウィジェットを HTML としてレンダリングする際、 Django は最小限の HTML しか 出力しません。すなわち、クラス定義やウィジェット固有の属性は一切付加しない のです。従って、例えばページ上にまったく同じ見栄えの 'TextInput' ウィジェッ トが並ぶわけです。

ウィジェットごとに見栄えを変えたいのなら、各々のウィジェットを指定するとき に、HTML レンダリング時に追加したい属性のリストを指定してやる必要があります。

例えば、以下のような簡単なフォームを考えましょう

class CommentForm(forms.Form):
    name = forms.CharField()
    url = forms.URLField()
    comment = forms.CharField()

このフォームは 3 つの TextInput ウィジェットからなり、デフォルトのレンダリ ングでは CSS クラスや属性は指定されていません。従って、各ウィジェットは全く 同じ入力ボックスとしてレンダリングされます

>>> f = CommentForm(auto_id=False)
>>> f.as_table()
<tr><th>Name:</th><td><input type="text" name="name" /></td></tr>
<tr><th>Url:</th><td><input type="text" name="url"/></td></tr>
<tr><th>Comment:</th><td><input type="text" name="comment" /></td></tr>

現実の Web ページでは、全ウィジェットが同じに見えるような見栄えを期待しない でしょう。コメント欄をもうちょっと大きな入力ボックスにしたかったり、 'name' ウィジェットに特別な CSS クラスを指定したかったりするかもしれま せん。個々のウィジェットの属性こ細かく指定するには、フィールドにカスタムの ウィジェットを指定して、ウィジェットのレンダリング時に使われる属性を指定し ます

class CommentForm(forms.Form):
    name = forms.CharField(
                widget=forms.TextInput(attrs={'class':'special'}))
    url = forms.URLField()
    comment = forms.CharField(
               widget=forms.TextInput(attrs={'size':'40'}))

これで、 Django はレンダリング結果に追加の属性を組み込むようになります

>>> f = CommentForm(auto_id=False)
>>> f.as_table()
<tr><th>Name:</th><td><input type="text" name="name" class="special"/></td></tr>
<tr><th>Url:</th><td><input type="text" name="url"/></td></tr>
<tr><th>Comment:</th><td><input type="text" name="comment" size="40"/></td></tr>

カスタムウィジェット

フォームをたくさん書くようになれば、特定の属性が指定されたウィジェットを再 利用したくなることでしょう。カスタムウィジェットを使えば、属性定義をキャプ チャできるので、毎回必要に応じて同じ属性定義を繰り返さなくてすみます。

例えば、自分のコードでフォームにコメントフィールドをたくさん使っていること に気付いたとしましょう。固定の size 属性を持った TextInput は、 TextInput ウィジェットを拡張したカスタムウィジェットとしてキャプチャで きます

class CommentWidget(forms.TextInput):
    def __init__(self, *args, **kwargs):
        kwargs.setdefault('attrs',{}).update({'size': '40'})
        super(forms.TextInput, self).__init__(*args, **kwargs)

そして、このウィジェットをフォームで使います

class CommentForm(forms.Form):
    name = forms.CharField()
    url = forms.URLField()
    comment = forms.CharField(widget=CommentWidget)

カスタムウィジェットは、他のウィジェットと同様に更にカスタマイズできます。 一回限りしか使わないような CSS クラス属性を CommentWidget に追加したけ れば、属性定義にパラメタを追加するだけです

class CommentForm(forms.Form):
    name = forms.CharField(max_length=20)
    url = forms.URLField()
    comment = forms.CharField(
                widget=CommentWidget(attrs={'class': 'special'}))

また、カスタムウィジェットを使うカスタムのフィールド型を簡単に定義できます。 例えば、コメント入力用のカスタムフィールドは以下のように定義できます

class CommentInput(forms.CharField):
    widget = CommentWidget

こうしておけば、コメント入力が必要なフォーム全般に CommentInput を利用でき ます

class CommentForm(forms.Form):
    name = forms.CharField()
    url = forms.URLField()
    comment = CommentInput()

HttpRequest オブジェクト

encoding

開発版の Django で新たに登場した機能です。

提出されたフォームデータのデコードに使われる、現在のエンコーディングを 表す文字列です (None の場合もありますが、この場合は DEFAULT_CHARSET を使います)。この属性を変更すれば、フォームデータに アクセスする際に使われるエンコーディングを指定できます。一度エンコーディ ングを変更すると、変更後に (GET や POST の) 属性へのアクセスは すべて新しい encoding の値に従って行われます。フォームデータが DEFAULT_CHARSET 以外の特定のエンコーディングと分かっている場合に便 利です。

HttpResponse オブジェクト

セッションはいつ保存されるのか

# 落とし穴: request.session ではなく request.session['foo'] の変更なの
# で、セッションデータは変更されたものとみなされません。
request.session['foo']['bar'] = 'baz'

上の例の最後のケースでは、セッションオブジェクトに内容が変更されたことを明 示的に教えねばなりません。変更の通知は modified 属性で行います

request.session.modified = True

この振舞いを変更したければ、 SESSION_SAVE_EVERY_REQUEST 設定を True に設定してください。 SESSION_SAVE_EVERY_REQUEST を True にすると、 Django はリクエスト一つ一つに対してセッションを保存します。