バリデータ¶
バリデータを記述する¶
バリデータは、値を取って 特定の条件に合致しない場合に ValidationError
を返すカラブルです。バリデータは、異なるタイプのフィールド間におけるバリデーションロジックを再利用したいときに役立ちます。
例えば、以下は偶数のみを許容するバリデータです:
from django.core.exceptions import ValidationError
from django.utils.translation import gettext_lazy as _
def validate_even(value):
if value % 2 != 0:
raise ValidationError(
_('%(value)s is not an even number'),
params={'value': value},
)
これはフィールドの validators
属性を通じて設定することができます:
from django.db import models
class MyModel(models.Model):
even_field = models.IntegerField(validators=[validate_even])
値はバリデータ実行前に Python に変換されているため、フォームでも同じバリデータを使用することができます:
from django import forms
class MyForm(forms.Form):
even_field = forms.IntegerField(validators=[validate_even])
より複雑なバリデータに対しては、クラスで __call__()
メソッドを利用することもできます。RegexValidator
はその一例で、このテクニックを使っています。クラスベースのバリデータが validators
モデルフィールドのオプション内で使用されるときは、deconstruct() と __eq__()
メソッドを追加して 移行フレームワークによりシリアライズ可能 になるようにしてください。
バリデータはどのように実行されるか¶
バリデータが実行される方法については、フォーム上での実行は フォームのバリデーション、モデル上の実行は オブジェクトを検証する にそれぞれ詳細が記載されています。モデルを save してもバリデータは自動的には呼び出されませんが、ModelForm
を使用している場合にはフォームに含まれるすべてのフィールドでバリデータを実行することに注意してください。モデルのバリデーションがフォーム上でどのように動作するかについては、ModelForm ドキュメント を参照してください。
ビルトインのバリデータ¶
django.core.validators
モジュールは、モデルやフォームで使用する呼び出し可能なバリデータの集まりを有しています。これらは内部で使用されますが、作成したフィールドで使用することもできます。 追加で使うことも、field.clean()
メソッドの代わりに使うことも可能です。
RegexValidator
¶
-
class
RegexValidator
(regex=None, message=None, code=None, inverse_match=None, flags=0)[ソース]¶ パラメータ: -
regex
¶ 提供された
value
を伴う検索用の正規表現パターン、もしくはコンパイル済みの正規表現です。デフォルトでは、match が見つからない場合にmessage
とcode
を伴うValidationError
が発生します。この動作はinverse_match
をTrue
にセットすることで逆にできます。これにより、match が 見つかった 場合にValidationError
が発生するようになります。デフォルトでは、あらゆる文字列 (空白を含みます) と match します。
-
message
¶ バリデーションが失敗した場合に
ValidationError
で使用されるエラーメッセージです。デフォルトは"Enter a valid value"
です。
-
code
¶ バリデーションが失敗した場合に
ValidationError
で使用されるエラーコードです。デフォルトは"invalid"
です。
-
EmailValidator
¶
-
class
EmailValidator
(message=None, code=None, whitelist=None)[ソース]¶ パラメータ: -
message
¶ The error message used by
ValidationError
if validation fails. Defaults to"Enter a valid email address"
.
-
code
¶ バリデーションが失敗した場合に
ValidationError
で使用されるエラーコードです。デフォルトは"invalid"
です。
-
whitelist
¶ Whitelist of email domains to allow. By default, a regular expression (the
domain_regex
attribute) is used to validate whatever appears after the @ sign. However, if that string appears in the whitelist, this validation is bypassed. If not provided, the default whitelist is['localhost']
. Other domains that don't contain a dot won't pass validation, so you'd need to whitelist them as necessary.
-
URLValidator
¶
-
class
URLValidator
(schemes=None, regex=None, message=None, code=None)[ソース]¶ A
RegexValidator
that ensures a value looks like a URL, and raises an error code of'invalid'
if it doesn't.Loopback addresses and reserved IP spaces are considered valid. Literal IPv6 addresses (RFC 2732) and unicode domains are both supported.
In addition to the optional arguments of its parent
RegexValidator
class,URLValidator
accepts an extra optional attribute:-
schemes
¶ URL/URI scheme list to validate against. If not provided, the default list is
['http', 'https', 'ftp', 'ftps']
. As a reference, the IANA website provides a full list of valid URI schemes.
-
validate_email
¶
-
validate_email
¶ An
EmailValidator
instance without any customizations.
validate_slug
¶
-
validate_slug
¶ A
RegexValidator
instance that ensures a value consists of only letters, numbers, underscores or hyphens.
validate_unicode_slug
¶
-
validate_unicode_slug
¶ A
RegexValidator
instance that ensures a value consists of only Unicode letters, numbers, underscores, or hyphens.
validate_ipv4_address
¶
-
validate_ipv4_address
[ソース]¶ A
RegexValidator
instance that ensures a value looks like an IPv4 address.
validate_ipv6_address
¶
validate_ipv46_address
¶
validate_comma_separated_integer_list
¶
-
validate_comma_separated_integer_list
¶ A
RegexValidator
instance that ensures a value is a comma-separated list of integers.
int_list_validator
¶
-
int_list_validator
(sep=', ', message=None, code='invalid', allow_negative=False)[ソース]¶ Returns a
RegexValidator
instance that ensures a string consists of integers separated bysep
. It allows negative integers whenallow_negative
isTrue
.
MaxValueValidator
¶
-
class
MaxValueValidator
(limit_value, message=None)[ソース]¶ Raises a
ValidationError
with a code of'max_value'
ifvalue
is greater thanlimit_value
.
MinValueValidator
¶
-
class
MinValueValidator
(limit_value, message=None)[ソース]¶ Raises a
ValidationError
with a code of'min_value'
ifvalue
is less thanlimit_value
.
MaxLengthValidator
¶
-
class
MaxLengthValidator
(limit_value, message=None)[ソース]¶ Raises a
ValidationError
with a code of'max_length'
if the length ofvalue
is greater thanlimit_value
.
MinLengthValidator
¶
-
class
MinLengthValidator
(limit_value, message=None)[ソース]¶ Raises a
ValidationError
with a code of'min_length'
if the length ofvalue
is less thanlimit_value
.
DecimalValidator
¶
-
class
DecimalValidator
(max_digits, decimal_places)[ソース]¶ Raises
ValidationError
with the following codes:'max_digits'
if the number of digits is larger thanmax_digits
.'max_decimal_places'
if the number of decimals is larger thandecimal_places
.'max_whole_digits'
if the number of whole digits is larger than the difference betweenmax_digits
anddecimal_places
.
FileExtensionValidator
¶
-
class
FileExtensionValidator
(allowed_extensions, message, code)[ソース]¶ Raises a
ValidationError
with a code of'invalid_extension'
if the extension ofvalue.name
(value
is aFile
) isn't found inallowed_extensions
. The extension is compared case-insensitively withallowed_extensions
.警告
Don't rely on validation of the file extension to determine a file's type. Files can be renamed to have any extension no matter what data they contain.
validate_image_file_extension
¶
-
validate_image_file_extension
[ソース]¶ Uses Pillow to ensure that
value.name
(value
is aFile
) has a valid image extension.
ProhibitNullCharactersValidator
¶
-
class
ProhibitNullCharactersValidator
(message=None, code=None)[ソース]¶ - New in Django 2.0:
Raises a
ValidationError
ifstr(value)
contains one or more nulls characters ('\x00'
).パラメータ: -
message
¶ The error message used by
ValidationError
if validation fails. Defaults to"Null characters are not allowed."
.
-
code
¶ The error code used by
ValidationError
if validation fails. Defaults to"null_characters_not_allowed"
.
-