Обработка форм осуществляется обычно в три этапа:
Инициализирующий GET запрос(пустая или частично проинициализированная форма)
Запрос POST с неверными данными(обычно отображается форма с указанием ошибок)
Запрос POST с корректными данными(обработка данных и , как правило, перенаправление)
При самостоятельной реализации подобной обработки форм, вы сталкиваетесь с большим количеством повторяющегося “шаблонного” кода. (См. использование форм в представлениях). Чтобы избавиться от этого, Django предоставляет нам коллекцию общих CBV для работы с формами.
Рассмотрим простую контактную форму:
from django import forms
class ContactForm(forms.Form):
name = forms.CharField()
message = forms.CharField(widget=forms.Textarea)
def send_email(self):
# send email using the self.cleaned_data dictionary
pass
Представление можно создать используя класс FormView
:
from myapp.forms import ContactForm
from django.views.generic.edit import FormView
class ContactView(FormView):
template_name = 'contact.html'
form_class = ContactForm
success_url = '/thanks/'
def form_valid(self, form):
# This method is called when valid form data has been POSTed.
# It should return an HttpResponse.
form.send_email()
return super(ContactView, self).form_valid(form)
Примечания:
FormView наследует TemplateResponseMixin
, таким образом вы можете использовать атрибут template_name
.
Реализация по умолчанию для метода form_valid()
просто осуществляет редирект на URL, хранящийся в атрибуте success_url
.
Общие CBV раскрываются во всей красе при работе с моделями. Они автоматически создают класс ModelForm
при работе с моделями:
Если указано значение атрибута model
, то будет использоваться этот класс модели.
Если метод get_object()
возвращает объект, то будет использоваться класс этого объекта.
Если указан атрибут queryset
, то будет использована модель этого запроса(queryset).
Представления форм, связанные с моделями, предоставляют реализацию метода form_valid()
, которая автоматически сохраняет модель. Вы можете переопределить этот метод согласно вашим требованиям; смотрите примеры ниже.
Вы можете не устанавливать значение success_url
для классов CreateView
или UpdateView
- они воспользуются методом get_absolute_url()
объекта модели (если такой объект доступен).
Если вам необходимо специальное поведение для ModelForm
(например для дополнительной валидации данных) просто установите form_class
в нужное значение.
Примечание
При создании пользовательского класса формы, вы по прежнему должны указать модель. Даже в том случае если в form_class
используется ModelForm
.
Во-первых, мы должны добавить метод get_absolute_url()
в наш класс Author
:
from django.core.urlresolvers import reverse
from django.db import models
class Author(models.Model):
name = models.CharField(max_length=200)
def get_absolute_url(self):
return reverse('author-detail', kwargs={'pk': self.pk})
Затем мы можем использовать класс CreateView
и “сотоварищей” чтобы выполнить необходимую работу. Обратите внимание, что мы лишь создаем конфигурацию для CBV; нам не нужно писать никакого кода, реализующего логику:
from django.views.generic.edit import CreateView, UpdateView, DeleteView
from django.core.urlresolvers import reverse_lazy
from myapp.models import Author
class AuthorCreate(CreateView):
model = Author
fields = ['name']
class AuthorUpdate(UpdateView):
model = Author
fields = ['name']
class AuthorDelete(DeleteView):
model = Author
success_url = reverse_lazy('author-list')
Примечание
Мы должны использовать здесь функцию reverse_lazy()
, а не просто reverse
, поскольку urls не “загружаются” при импорте файла.
Атрибут fields
работает аналогично атрибуту fields
внутреннего класса Meta
ModelForm
. Если вы не указали класс формы другим способом, этот атрибут обязателен и вы получите исключение ImproperlyConfigured
, если он не указан.
Если вы указали и fields
и form_class
, будет вызвано исключение ImproperlyConfigured
.
Ранее атрибут fields
был не обязательным. При его отсутствии форма содержала все поля модели.
Ранее, если указаны fields
и form_class
, fields
просто игнорировался.
И наконец, мы подключаем новые представления в URLconf:
from django.conf.urls import url
from myapp.views import AuthorCreate, AuthorUpdate, AuthorDelete
urlpatterns = [
# ...
url(r'author/add/$', AuthorCreate.as_view(), name='author-add'),
url(r'author/(?P<pk>[0-9]+)/$', AuthorUpdate.as_view(), name='author-update'),
url(r'author/(?P<pk>[0-9]+)/delete/$', AuthorDelete.as_view(), name='author-delete'),
]
Примечание
Эти представления наследуют SingleObjectTemplateResponseMixin
,который использует атрибут template_name_suffix
для создания template_name
с помощью имени модели.
В этом примере:
Классы CreateView
и UpdateView
используют myapp/author_form.html
Классы DeleteView
используют myapp/author_confirm_delete.html
Если вам нужно разделить шаблоны для классов CreateView
и UpdateView
, вы можете либо назначить атрибут template_name
, либо использовать template_name_suffix
в ваших классах представлений.
Чтобы отслеживать пользователя, создавшего некий объект с помощью CreateView
, вы можете использовать пользовательский класс ModelForm
. Первое, добавьте внешний ключ (foreign key) к модели:
from django.contrib.auth.models import User
from django.db import models
class Author(models.Model):
name = models.CharField(max_length=200)
created_by = models.ForeignKey(User, on_delete=models.CASCADE)
# ...
В представлении удостоверьтесь, что вы не включаете created_by
в список редактируемых полей и переопределите метод form_valid()
для добавления пользователя:
from django.views.generic.edit import CreateView
from myapp.models import Author
class AuthorCreate(CreateView):
model = Author
fields = ['name']
def form_valid(self, form):
form.instance.created_by = self.request.user
return super(AuthorCreate, self).form_valid(form)
Обратите внимание, что вам необходимо задекорировать представление используя login_required()
, или в качестве альтернативы, обрабатывать неавторизированных пользователей в методе form_valid()
.
Вот простой пример, показывающий, как вы могли бы реализовать форму, которая работает и с запросами AJAX, и с “обычными” POST запросами формы:
from django.http import JsonResponse
from django.views.generic.edit import CreateView
from myapp.models import Author
class AjaxableResponseMixin(object):
"""
Mixin to add AJAX support to a form.
Must be used with an object-based FormView (e.g. CreateView)
"""
def form_invalid(self, form):
response = super(AjaxableResponseMixin, self).form_invalid(form)
if self.request.is_ajax():
return JsonResponse(form.errors, status=400)
else:
return response
def form_valid(self, form):
# We make sure to call the parent's form_valid() method because
# it might do some processing (in the case of CreateView, it will
# call form.save() for example).
response = super(AjaxableResponseMixin, self).form_valid(form)
if self.request.is_ajax():
data = {
'pk': self.object.pk,
}
return JsonResponse(data)
else:
return response
class AuthorCreate(AjaxableResponseMixin, CreateView):
model = Author
fields = ['name']
Jun 05, 2017