Django для веб-разработки: практическое введение с примерами кода

Расширенные примеры работы с Django

Работа с формами и валидация

Создадим форму обратной связи с использованием ModelForm и обработаем её в представлении.

Файл forms.py приложения blog:

from django import forms
from .models import Post

class PostForm(forms.ModelForm):
    class Meta:
        model = Post
        fields = ['title', 'content']
        widgets = {
            'content': forms.Textarea(attrs={'rows': 5}),
        }

Представление views.py:

from django.shortcuts import render, redirect
from .forms import PostForm

def create_post(request):
    if request.method == 'POST':
        form = PostForm(request.POST)
        if form.is_valid():
            form.save()
            return redirect('post_list')
    else:
        form = PostForm()
    return render(request, 'blog/post_form.html', {'form': form})

Шаблон templates/blog/post_form.html:

<form method="post">
  {% csrf_token %}
  {{ form.as_p }}
  <button type="submit">Сохранить</button>
</form>

Результат: при отправке формы данные проходят валидацию, сохраняются в базу, и происходит перенаправление.

Использование generic-представлений ListView и DetailView

Заменим ручное представление на обобщённое:

from django.views.generic import ListView, DetailView
from .models import Post

class PostListView(ListView):
    model = Post
    template_name = 'blog/post_list.html'
    context_object_name = 'posts'

class PostDetailView(DetailView):
    model = Post
    template_name = 'blog/post_detail.html'

URL-паттерны (urls.py):

from django.urls import path
from .views import PostListView, PostDetailView

urlpatterns = [
    path('', PostListView.as_view(), name='post_list'),
    path('<int:pk>/', PostDetailView.as_view(), name='post_detail'),
]

Шаблон списка:

{% for post in posts %}
  <h2><a href="{% url 'post_detail' post.pk %}">{{ post.title }}</a></h2>
  <p>{{ post.content|truncatewords:20 }}</p>
{% endfor %}

Результат: список постов с ссылками, страница детального просмотра.

Добавление пагинации

В ListView пагинация настраивается очень просто:

class PostListView(ListView):
    model = Post
    paginate_by = 5
    # остальные атрибуты

В шаблоне:

<div class="pagination">
  <span class="step-links">
    {% if page_obj.has_previous %}
      <a href="?page=1">&laquo; первая</a>
      <a href="?page={{ page_obj.previous_page_number }}">предыдущая</a>
    {% endif %}
    <span class="current">Страница {{ page_obj.number }} из {{ page_obj.paginator.num_pages }}.</span>
    {% if page_obj.has_next %}
      <a href="?page={{ page_obj.next_page_number }}">следующая</a>
      <a href="?page={{ page_obj.paginator.num_pages }}">последняя &raquo;</a>
    {% endif %}
  </span>
</div>

Результат: на странице отображается не более 5 записей, внизу появляются ссылки для навигации.

REST API с Django REST Framework

Установка: pip install djangorestframework. Добавляем 'rest_framework' в INSTALLED_APPS. Создаём сериализатор:

from rest_framework import serializers
from .models import Post

class PostSerializer(serializers.ModelSerializer):
    class Meta:
        model = Post
        fields = '__all__'

Представление (views.py):

from rest_framework import generics
from .models import Post
from .serializers import PostSerializer

class PostListAPI(generics.ListCreateAPIView):
    queryset = Post.objects.all()
    serializer_class = PostSerializer

class PostDetailAPI(generics.RetrieveUpdateDestroyAPIView):
    queryset = Post.objects.all()
    serializer_class = PostSerializer

URL-паттерны:

from django.urls import path
from .views import PostListAPI, PostDetailAPI

urlpatterns = [
    path('api/posts/', PostListAPI.as_view(), name='post-list'),
    path('api/posts/<int:pk>/', PostDetailAPI.as_view(), name='post-detail'),
]

Результат: полноценный REST API для модели Post с поддержкой GET, POST, PUT, PATCH, DELETE.

Использование сигналов для автоматических действий

Например, при создании поста автоматически генерировать slug. В signals.py:

from django.db.models.signals import pre_save
from django.dispatch import receiver
from django.utils.text import slugify
from .models import Post

@receiver(pre_save, sender=Post)
def create_slug(sender, instance, **kwargs):
    if not instance.slug:
        instance.slug = slugify(instance.title)

В apps.py приложения нужно импортировать сигналы:

from django.apps import AppConfig

class BlogConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'blog'

    def ready(self):
        import blog.signals

Результат: при сохранении поста slug заполняется автоматически из заголовка.