Валидатор — это вызываемый объект (callable), который принимает значение и вызывает исключение ValidationError, если значение не соответствует неким критериям. Валидаторы могут быть полезны когда надо использовать одинаковую логику проверки для разных типов полей.
Например, здесь показан валидатор, который принимает только чётные числа:
from django.core.exceptions import ValidationError
def validate_even(value):
if value % 2 != 0:
raise ValidationError(u'%s is not an even number' % 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])
Обратитесь к документации по проверке форм для получения подробностей о работе валидаторов в формах и к документации по проверке объектов, чтобы узнать как валидаторы запускаются для моделей. Следует отметить, что валидаторы не запускаются автоматически в случае когда вы сохраняете модель. Но если вы используете класс ModelForm, то он запустит ваши валидаторы для всех полей формы. Обратитесь к документации на модельные формы для получения информации о том, как валидаторы модели взаимодействуют с формами.
Модуль django.core.validators содержит коллекцию валидаторов, которые можно использовать как с моделями, так и с полями формы. Они используются Django, но также доступны для применения в ваших полях. Их можно использовать в дополнение к или вместо метода field.clean().
| Параметры: |
|---|
Шаблон регулярного выражения для поиска в предоставленном value или заранее скомпилированное регулярное выражение. Вызывает исключение ValidationError с атрибутами message и code, если ничего не совпало. По умолчанию совпадает с любыми строками, включая пустые строки.
Сообщение об ошибке, используемое исключением ValidationError, если проверка не прошла. По умолчанию, "Enter a valid value".
Код ошибки, используемый исключением ValidationError, если проверка не прошла. По умолчанию "invalid".
Класс RegexValidator, который проверяет, что значение выглядит как URL, и обеспечивает необязательную проверку существования этого URL (т.е., в ответ не приходит отклик со статусом 404). Вызывает исключение с кодом 'invalid', если значение не похоже на URL, или с кодом 'invalid_link', если запрос получил статус 404.
| Параметры: |
|
|---|
Если значение равно True, то валидатор проверяет существование URL.
Если атрибут verify_exists имеет значение True, то Django использует это значение в качестве значения поля “User-agent” при выполнении запроса.
Экземпляр класса RegexValidator, который проверяет, что значение выглядит как адрес электронной почты.
Экземпляр класса RegexValidator, который проверяет, что значение содержит только буквы, числа, символы подчёркивания или тире.
Экземпляр класса RegexValidator, который проверяет, что значение выглядит как IPv4 адрес.
Использует django.utils.ipv6 для проверки соответствия значения IPv6 адресу.
Использует оба валидатора (validate_ipv4_address и validate_ipv6_address) для проверки, что значение соответствует IPv4 или IPv6 адресу.
Экземпляр класса RegexValidator, который проверяет, что значение является списком целых чисел, разделённых запятыми.
Вызывает исключение ValidationError с кодом 'max_value', если value больше, чем max_value.
Вызывает исключение ValidationError с кодом 'min_value', если value меньше, чем min_value.
Вызывает исключение ValidationError с кодом 'max_length', если длина value больше, чем max_length.
Вызывает исключение ValidationError с кодом 'min_length', если длина value меньше, чем min_length.
Aug 21, 2013