== 內建的基於類的通用編輯檢視 (Forms)

表單(處理)通常包含3條路徑：
* 初始的GET (空或預填充的表單)
* 非法資料的POST (通常重新顯示錶單並提示錯誤)
* 合法資料的POST (處理資料並通常重定向)

你自己實現這些常常需要重複很多模式化的程式碼。幫助避免這些，Django提供了一系列通用的基於類的檢視用於表單處理。

- 基本表單

# forms.py
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

# views.py
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):
        # 當合法form資料被POST時，此方法被呼叫。
        # 它應當返回一個HttpResponse.
        form.send_email()
        return super(ContactView, self).form_valid(form)

- Model表單

通用檢視將自動建立ModelForm, 依據下列規則：
* 如果給出model屬性，其model類將被使用
* 如果get_object()返回一個物件，此物件的類被使用
* 如果給出queryset，則queryset的model被使用

Model form檢視提供了一個form_valid()實現，自動儲存model物件。你可以根據自己的需要重寫它。

對於CreateView或UpdateView,你甚至不需要提供一個success_url, 它們將使用model物件的get_absolute_url()，如果可用。

如果你需要自定義ModelForm(例如，增加校驗)，只需要在你的檢視(view)中設定form_class, *還必須設定model.

# models.py
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})

# views.py
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')

# urls.py
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'),
]

- Models 和 request.user

為跟蹤使用CreateView建立某物件的使用者，你可以自定義一個ModelForm.

# models.py
class Author(models.Model):
    name = models.CharField(max_length=200)
    created_by = models.ForeignKey(User)

# views.py
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)

- AJAX 用例

from django.http import JsonResponse
from django.views.generic.edit import CreateView
from myapp.models import Author

class AjaxableResponseMixin(object):
    """
Mixin用於為form增加AJAX支援。
必須用於基於類的FormView(如，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):
# 我們需要確保呼叫父類的form_valid()方法，因為它可能會做一些處理
# (在CreateView的例子中，它將呼叫form.save())
        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']


== 在基於類的檢視中使用Mixins
https://docs.djangoproject.com/en/1.8/ref/class-based-views/mixins/

- 內容及模板響應
TemplateResponseMixin
ContextMixin

- 構建Django的通用基於類的檢視
DetailView: working with a single Django object
#To get the object, DetailView relies on SingleObjectMixin
#To then make a TemplateResponse, DetailView uses SingleObjectTemplateResponseMixin

ListView: working with many Django objects
#To get the objects, ListView uses MultipleObjectMixin
#To make a TemplateResponse, ListView then uses MultipleObjectTemplateResponseMixin

- 使用Django的基於類檢視的Mixins
Using SingleObjectMixin with View
Using SingleObjectMixin with ListView

- 避免更復雜
Using FormMixin with DetailView
A better solution
An alternative better solution

- 不限於HTML

from django.http import JsonResponse

class JSONResponseMixin(object):
    """
    A mixin that can be used to render a JSON response.
    """
    def render_to_json_response(self, context, **response_kwargs):
        """
        Returns a JSON response, transforming 'context' to make the payload.
        """
        return JsonResponse(
            self.get_data(context),
            **response_kwargs
        )

    def get_data(self, context):
        """
        Returns an object that will be serialized as JSON by json.dumps().
        """
        # Note: This is *EXTREMELY* naive; in reality, you'll need
        # to do much more complex handling to ensure that arbitrary
        # objects -- such as Django model instances or querysets
        # -- can be serialized as JSON.
        return context

from django.views.generic import TemplateView

class JSONView(JSONResponseMixin, TemplateView):
    def render_to_response(self, context, **response_kwargs):

        return self.render_to_json_response(context, **response_kwargs)