# Django 5.2.9 - dokumentacja

# Pisanie pierwszej aplikacji Django, część 4.

Ten tutorial zaczyna się, gdzie skończył się Tutorial 3 </intro/tutorial03>. Kontynuujemy prace nad aplikacją web-ankiet i skupimy się na przetwarzaniu formularza i przycinaniu naszego kodu.

Gdzie szukać pomocy:

Jeśli masz trudności w przejściu tego tutorialu, przejdź do sekcji Uzyskiwanie pomocy często zadawanych pytań.

## Napisz mały formularz

Zaktualizujmy nasz szablon szczegółów ankiety („polls/detail.html”) z ostatniego tutoriala, aby zawierał element HTML `<form>`:

`polls/templates/polls/detail.html`

    <form action="{% url 'polls:vote' question.id %}" method="post">
    {% csrf_token %}
    <fieldset>
        <legend><h1>{{ question.question_text }}</h1></legend>
        {% if error_message %}<p><strong>{{ error_message }}</strong></p>{% endif %}
        {% for choice in question.choice_set.all %}
            <input type="radio" name="choice" id="choice{{ forloop.counter }}" value="{{ choice.id }}">
            <label for="choice{{ forloop.counter }}">{{ choice.choice_text }}</label><br>
        {% endfor %}
    </fieldset>
    <input type="submit" value="Vote">
    </form>

Krótkie sprawozdanie:

- Powyższy szablon wyświetla przycisk opcji dla każdej z odpowiedzi. Atrybut `value` każdego przycisku opcji to ID związanej z pytaniem odpowiedzi. Atrybut `name` każdego przycisku opcji to `"choice"`. To znaczy, że kiedy ktoś wybierze jeden z przycisków opcji i wyśle formularz, formularz wyśle dane POST `choice=#`, gdzie # jest ID wybranej odpowiedzi. To jest podstawowa idea formularzy HTML.

- Ustawiamy atrybut `action` formularza na `{% url 'polls:vote' question.id %}` i ustawiamy `method="post"`. Użycie `method="post"` (w opozycji do `method="get"`) jest bardzo ważne, ponieważ akt wysłania formularza zmieni dane po stronie serwera. Kiedykolwiek tworzysz formularz, który zmienia dane po stronie serwera, używaj `method="post"`. Ta wskazówka nie dotyczy tylko Django; jest dobrą praktyką w web-dewelopmencie.`

- `forloop.counter` mówi ile razy tag `for` przeszedł przez swoją pętlę

- Jako że stworzymy formularz POST (który może mieć efekt modyfikacji danych), musimy martwić się o cross-site request forgeries. Na szczęście, nie musisz przejmować się za bardzo, bo Django oferuje pomocny system przed nimi chroniący. W skrócie: wszystkie formularze POST, które są skierowane na wewnętrzne URL-e powinny używać szablonowego taga `{% csrf_token %}`.

Teraz stwórzmy widok Django, który obsługuje wysłane dane i coś z nimi robi. Pamiętaj, w Tutorialu 3, stworzyliśmy URLconfa dla aplikacji ankietowej, który zawiera tę linię:

`polls/urls.py`

    path("<int:question_id>/vote/", views.vote, name="vote"),

Stworzyliśmy także zaślepkową implementację funkcji `vote()`. Stwórzmy prawdziwą wersję. Dodaj następujący kod do `polls/views.py`:

`polls/views.py`

    from django.db.models import F
    from django.http import HttpResponse, HttpResponseRedirect
    from django.shortcuts import get_object_or_404, render
    from django.urls import reverse

    from .models import Choice, Question

    # ...
    def vote(request, question_id):
        question = get_object_or_404(Question, pk=question_id)
        try:
            selected_choice = question.choice_set.get(pk=request.POST["choice"])
        except (KeyError, Choice.DoesNotExist):
            # Redisplay the question voting form.
            return render(
                request,
                "polls/detail.html",
                {
                    "question": question,
                    "error_message": "You didn't select a choice.",
                },
            )
        else:
            selected_choice.votes = F("votes") + 1
            selected_choice.save()
            # Always return an HttpResponseRedirect after successfully dealing
            # with POST data. This prevents data from being posted twice if a
            # user hits the Back button.
            return HttpResponseRedirect(reverse("polls:results", args=(question.id,)))

Ten kod zawiera kilka rzeczy, których jeszcze nie omówiliśmy w tym tutorialu:

- `request.POST` to słownikowy obiekt, który daje dostęp do wysłanych danych według nazwy klucza. W tym przypadku `request.POST['choice']` zwraca ID wybranej odpowiedzi jako stringa. Wartości `request.POST` są zawsze stringami.

  Zwróć uwagę, że Django ma także `request.GET` dające dostęp do danych GET w ten sam sposób – ale my specjalnie używamy `request.POST` w naszym kodzie, aby upewnić się, że dane są zmieniane tylko przez wywołanie POST.

- `request.POST['choice']` zgłosi `KeyError` jeśli atrybutu `choice` nie było wśród danych POST. Powyższy kod sprawdza `KeyError` i ponownie wyświetla formularz pytania z komunikatem błędu, jeśli `choice` nie został wskazany.

- `F("votes") + 1` instructs the database to increase the vote count by 1.

- Po zwiększeniu licznika odpowiedzi, kod zwraca `HttpResponseRedirect` zamiast normalnej `HttpResponse`. `HttpResponseRedirect` bierze jeden argument: URL, do którego użytkownik będzie przekierowany (zobacz następny punkt, aby dowiedzieć się, jak w tym przypadku kontruujemy URL-e).

  Tak jak wskazuje komentarz powyżej w Pythonie, powinieneś zawsze zwracać `HttpResponseRedirect` po poradzeniu sobie z danymi POST. Ta wskazówka nie jest szczególna dla Django; to ogólnie dobra praktyka w web-dewelopmencie.

- Używamy funkcji `reverse()` w konstruktorze `HttpResponseRedirect` w tym przykładzie. Ta funkcja pomaga uniknąć konieczności hardkodowania URL-i w funkcji widoku. Daje jej się nazwę widoku, któremu chcemy przekazać kontrolę i zestaw zmiennych z wzorca URL-a, który prowadzi do tego widoku. W tym przypadku, używając URLconfa, którego napisaliśmy w Tutorialu 3, to wywołanie `reverse()` zwróci taki ciąg znaków:

      "/polls/3/results/"

  gdzie `3` jest wartością `question.id`. Ten przekierowany URL później wywoła widok `'results'`, aby wyświetlić ostateczną stronę.

Jak wspomniano w Tutorialu 3, `request` jest obiektem `HttpRequest`. Po więcej informacji na temat obiektów `HttpRequest`, zobacz dokumentację żądań i odpowiedzi.

Po tym, jak ktoś zagłosuje w danym pytaniu, widok `vote()` przekieruje go na stronę wyników dla pytania. Napiszmy ten widok:

`polls/views.py`

    from django.shortcuts import get_object_or_404, render

    def results(request, question_id):
        question = get_object_or_404(Question, pk=question_id)
        return render(request, "polls/results.html", {"question": question})

Jest prawie identyczny z widokiem `detail()` z Tutoriala 3. Jedyna różnica to nazwa szablonu. Naprawimy tę redundancję później.

Teraz stwórzmy szablon `polls/results.html`:

`polls/templates/polls/results.html`

    <h1>{{ question.question_text }}</h1>

    <ul>
    {% for choice in question.choice_set.all %}
        <li>{{ choice.choice_text }} -- {{ choice.votes }} vote{{ choice.votes|pluralize }}</li>
    {% endfor %}
    </ul>

    <a href="{% url 'polls:detail' question.id %}">Vote again?</a>

Teraz wejdź na `/polls/1/` w swojej przeglądarce i zagłosuj w ankiecie. Powinieneś zobaczyć stronę wyników, która aktualizuje się za każdym razem, kiedy oddasz głosz. Jeśli wyślesz formularz bez wybranej odpowiedzi, powinieneś zobaczyć komunikat błędu.

## Użycie widoków generycznych: Im mniej kodu tym lepiej

Widoki `detail()` (z Tutoriala 3) i `results()` są bardzo krótkie – i, jak wspomnieliśmy wcześniej, redundantne. Widok `index()`, który wyświetal listę ankiet, jest podobny.

Te widoki reprezentują częsty przypadek w podstawowym web dewelopmencie: pobieranie danych z bazy danych na podstawie parametru podanego w URL, ładownie szablonu i zwracanie wyrenderowanego szablonu. Z powodu, że jest to tak powszechne, Django dostarcza skrót, nazwany systemem „generycznych widoków”.

Generic views abstract common patterns to the point where you don’t even need to write Python code to write an app. For example, the `ListView` and `DetailView` generic views abstract the concepts of „display a list of objects” and „display a detail page for a particular type of object” respectively.

Przekonwertujmy naszą aplikację ankietową, aby używała systemu widoków generycznych, abyśmy mogli usunąć sporo naszego własnego kodu. Musimy podjąć kilka kroków, aby dokonać konwersji. Będziemy:

1. Konwertować URLconf.

2. Usuwać stare, niepotrzebne widoki.

3. Wprowadzać nowe widoki oparte na generycznych widokach Django.

Kontynuuj czytanie, aby dowiedzieć się szczegółów.

Dlaczego podmiana kodu?

W ogólności, pisząc aplikację Django, ocenisz, czy widoki generyczne są dobre do twojego problemu i będziesz używał ich od początku zamiast robić refactoring kodu w połowie pracy. Ten tutorial specjalnie był skupiony na pisaniu widoków „w trudny sposób” aż do teraz, aby skupić się podstawowych konceptach.

Powinieneś znać podstawową matematykę zanim zaczniesz używać kalkulatora.

### Modyfikacja URLconf

Najpierw otwórz URLconfa w `polls/urls.py` i zmień go tak:

`polls/urls.py`

    from django.urls import path

    from . import views

    app_name = "polls"
    urlpatterns = [
        path("", views.IndexView.as_view(), name="index"),
        path("<int:pk>/", views.DetailView.as_view(), name="detail"),
        path("<int:pk>/results/", views.ResultsView.as_view(), name="results"),
        path("<int:question_id>/vote/", views.vote, name="vote"),
    ]

Note that the name of the matched pattern in the path strings of the second and third patterns has changed from `<question_id>` to `<pk>`. This is necessary because we’ll use the `DetailView` generic view to replace our `detail()` and `results()` views, and it expects the primary key value captured from the URL to be called `"pk"`.

### Modyfikacja widoków

Następnie usuniemy nasze stare widoki `index`, `detail` i `results` i użyjemy zamiast nich generycznych widoków Django. Aby to zrobić, otwórz plik `polls/views.py` i zmień go w ten sposób:

`polls/views.py`

    from django.db.models import F
    from django.http import HttpResponseRedirect
    from django.shortcuts import get_object_or_404, render
    from django.urls import reverse
    from django.views import generic

    from .models import Choice, Question

    class IndexView(generic.ListView):
        template_name = "polls/index.html"
        context_object_name = "latest_question_list"

        def get_queryset(self):
            """Return the last five published questions."""
            return Question.objects.order_by("-pub_date")[:5]

    class DetailView(generic.DetailView):
        model = Question
        template_name = "polls/detail.html"

    class ResultsView(generic.DetailView):
        model = Question
        template_name = "polls/results.html"

    def vote(request, question_id):
        # same as above, no changes needed.
        ...

Each generic view needs to know what model it will be acting upon. This is provided using either the `model` attribute (in this example, `model = Question` for `DetailView` and `ResultsView`) or by defining the `get_queryset()` method (as shown in `IndexView`).

Domyślnie widok generyczny `DetailView` używa szablonu o nazwie `<app name>/<model name>_detail.html`. W naszym przypadku użyłby szablonu `"polls/question_detail.html"`. Atrybut `template_name` jest używany, by kazać Django użyć wskazanego szablonu zamiast samo-wygenerowanej domyślnej nazwy szablonu. Wskazujemy również `template_name` dla widoku listy `results` – to powoduje, że widok wyników i widok szczegółów mają inny wygląd po wyrenderowaniu, mimo że oba są `DetailView` pod maską.

Podobnie widok generyczny `ListView` używa domyślnego szablonu o nazwie `<app name>/<model name>_list.html`; używamy `template_name`, aby powiedzieć `ListView`, by używała naszego istniejącego szablonu `"polls/index.html"`.

W poprzednich częściach tutoriala szablonom dawaliśmy kontekst, który zawierał zmienne kontekstu `question` i `latest_question_list`. Dla `DetailView` zmienna `question` jest dostarczona automatycznie – ponieważ używamy modelu Django (`Question`), Django może wyznaczyć odpowiednią nazwę dla zmiennej kontekstowej. Jednak dla ListView automatycznie generowaną zmienną kontekstową jest `question_list`. Aby to nadpisać nadajemy wartość atrybutowi `context_object_name`, wskazując, że chcemy użyć zamiast niej `latest_question_list`. Alternatywnym podejściem byłoby zmienienie szablonów, aby zgadzały się z nowymi domyślnymi zmiennymi kontekstowymi – ale dużo prościej jest powiedzieć Django, aby używało zmiennej, jakiej chcesz.

Uruchom serwer i użyj nowej aplikacji ankietowej opartej na widokach generycznych.

Po wszystkie szczegóły widoków generycznych, sprawdź dokumentację widoków generycznych.

Kiedy już czujesz się dobrze z formularzami i widokami generycznymi, przeczytaj część 5 tego tutoriala, aby nauczyć się testowania naszej ankietowej aplikacji.