Este tutorial comienza donde quedó el :doc:‘Tutorial 3 </intro/tutorial03>`. Vamos a continuar la aplicación Web encuestas y nos enfocaremos en el procesamiento simple de formularios y en la reducción de nuestro código.
\nVamos a actualizar nuestra plantilla de detalles de encuestas («polls/detail.html») a partir del último tutorial, de modo que la plantilla contenga un elemento <form> HTML.
polls/templates/polls/detail.html<h1>{{ question.question_text }}</h1>\n\n{% if error_message %}<p><strong>{{ error_message }}</strong></p>{% endif %}\n\n<form action="{% url 'polls:vote' question.id %}" method="post">\n{% csrf_token %}\n{% for choice in question.choice_set.all %}\n <input type="radio" name="choice" id="choice{{ forloop.counter }}" value="{{ choice.id }}" />\n <label for="choice{{ forloop.counter }}">{{ choice.choice_text }}</label><br />\n{% endfor %}\n<input type="submit" value="Vote" />\n</form>\nUn resumen rápido:
\nLa plantilla anterior muestra un botón de opción para cada pregunta de selección. El “valor” de cada botón de opción es la ID de la pregunta de selección asociada. El “nombre” de cada botón de opción es “choice”. Esto significa que cuando alguien selecciona uno de los botones de opción y envía el formulario, enviará los datos POST choice=# donde # es la ID de la opción seleccionada. Este es el concepto básico de los formularios HTML.
Ajustamos la “action” del formulario a {% url 'polls:vote' question.id %}, y configuramos method="post". Utilizar method="post" (en lugar de method="get") es muy importante porque enviar este formulario modificará los datos del lado del servidor. Cuando cree un formulario que altere los datos del lado del servidor, utilice method="post". Esta sugerencia no es solo para Django, es solo una buena práctica de desarrollo Web.
`` forloop.counter`` indica cuántas veces la etiqueta :ttag:` for` ha pasado por el bucle
Ya que estamos creando un formulario POST (que puede tener el efecto de modificar los datos) tenemos que preocuparnos de las falsificaciones de peticiones entre sitios. Afortunadamente, no tiene que preocuparse demasiado porque Django cuenta con un sistema muy fácil de usar para protegerse contra ello. En pocas palabras, todos los formularios POST que están dirigidos a las URLs internas deben utilizar la etiqueta de plantilla {% csrf_token %}.
A continuación, vamos a crear una vista Django que maneje los datos enviados y haga algo con ello. Recuerde que en el Tutorial 3, creamos un URLconf para la aplicación encuestas que incluye esta línea:
\npolls/urls.pyurl(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'),\nTambién creamos una implementación simulada de la función vote(). Vamos a crear una versión real. Agregue lo siguiente a polls/views.py:
polls/views.pyfrom django.shortcuts import get_object_or_404, render\nfrom django.http import HttpResponseRedirect, HttpResponse\nfrom django.urls import reverse\n\nfrom .models import Choice, Question\n# ...\ndef vote(request, question_id):\n question = get_object_or_404(Question, pk=question_id)\n try:\n selected_choice = question.choice_set.get(pk=request.POST['choice'])\n except (KeyError, Choice.DoesNotExist):\n # Redisplay the question voting form.\n return render(request, 'polls/detail.html', {\n 'question': question,\n 'error_message': "You didn't select a choice.",\n })\n else:\n selected_choice.votes += 1\n selected_choice.save()\n # Always return an HttpResponseRedirect after successfully dealing\n # with POST data. This prevents data from being posted twice if a\n # user hits the Back button.\n return HttpResponseRedirect(reverse('polls:results', args=(question.id,)))\nEste código incluye algunas cosas que no hemos cubierto todavía en este tutorial:
\n: attr: request.POST <django.http.HttpRequest.POST> ` es un objeto tipo diccionario que le permite acceder a los datos presentados mediante el nombre clave. En este caso, ` request.POST['choice'] retorna la ID de la opción seleccionada como una cadena. :attr: Los valores `request.POST <django.http.HttpRequest.POST> ` son siempre cadenas.
Tenga en cuenta que Django también proporciona :attr: `request.GET <django.http.HttpRequest.GET> ` para acceder a datos GET de la misma manera, pero estamos usando de manera explícita :attr:`request.POST <django.http.HttpRequest.POST> ` en nuestro código, para garantizar que los datos sólo se modifiquen a través de una llamada POST.
\nrequest.POST['choice'] levantará un excepción :exc: KeyError si «choice” no fue proporcionado en los datos POST. El código anterior busca la excepción KeyError y muestra de nuevo el formulario de pregunta con un mensaje de error si no se ha proporcionado «choice».
Después de incrementar el conteo de la elección, el código retorna una :class: ~django.http.HttpResponseRedirect en lugar de una :class: ~django.http.HttpResponse normal HttpResponseRedirect toma un único argumento: La URL a la que el usuario será redirigido (vea el siguiente aspecto de cómo construimos la URL en este caso).
Como señala el comentario Python anterior, usted siempre debe retornar una :class: ~django.http.HttpResponseRedirect después de gestionar exitosamente los datos POST. Esta sugerencia no es solo para Django, es solo una buena práctica de desarrollo Web.
\nWe are using the reverse() function in the\nHttpResponseRedirect constructor in this example.\nThis function helps avoid having to hardcode a URL in the view function.\nIt is given the name of the view that we want to pass control to and the\nvariable portion of the URL pattern that points to that view. In this\ncase, using the URLconf we set up in Tutorial 3,\nthis reverse() call will return a string like
'/polls/3/results/'\ndonde el `` 3`` es el valor de question.id. Esta URL redirigida entonces llamará a la vista « “ results”» para mostrar la página final.
Como se mencionó en el Tutorial 3 </intro/tutorial03> ``request` es un objeto: class:~django.http.HttpRequest . Para más información sobre los objetos :class: ~django.http.HttpRequest, consulte la :doc:` documentación de petición y respuesta </ref/request-response> `.
\nDespués de que alguien vota en una pregunta, la vista vote() remite a la página de resultados de la pregunta. Vamos a escribir dicha vista:
polls/views.pyfrom django.shortcuts import get_object_or_404, render\n\n\ndef results(request, question_id):\n question = get_object_or_404(Question, pk=question_id)\n return render(request, 'polls/results.html', {'question': question})\nEsto es casi exactamente lo mismo que la vista detail() del Tutorial 3. La única diferencia es el nombre de la plantilla. Solucionaremos esta redundancia más tarde.
Ahora, cree una plantilla polls/results.html:
polls/templates/polls/results.html<h1>{{ question.question_text }}</h1>\n\n<ul>\n{% for choice in question.choice_set.all %}\n <li>{{ choice.choice_text }} -- {{ choice.votes }} vote{{ choice.votes|pluralize }}</li>\n{% endfor %}\n</ul>\n\n<a href="{% url 'polls:detail' question.id %}">Vote again?</a>\nA continuación, vaya a /polls/1/ en su navegador y vote en la pregunta. Debería ver una página de resultados que se actualiza cada vez que usted vota. Si usted envía el formulario sin haber seleccionado una opción, usted debería ver el mensaje de error.
Las vistas “detail()” y “results()” (del Tutorial 3) son muy sencillas y, como se mencionó anteriormente, redundantes. La vista “índex()” que muestra una lista de encuestas es similar.
\nEstas vistas representan un caso común de desarrollo Web básico: obtener datos de la base de datos según un parámetro pasado en la URL, cargar una plantilla y retornar la plantilla creada. Debido a que esto es tan común, Django proporciona un atajo denominado sistema de “vistas genéricas”.
\nLas vistas genéricas abstraen los patrones comunes hasta el punto en que ni siquiera es necesario escribir código Python para escribir una aplicación.
\nVamos a convertir nuestra aplicación encuesta para utilizar el sistema de vistas genéricas, por lo que podemos eliminar mucho de nuestro propio código. Solo tendremos que seguir algunos pasos para hacer la conversión. Vamos a:
\nConvertir el URLconf.
Eliminar algunas de las vistas viejas e innecesarias.
Introducir nuevas vistas basadas en las vistas genéricas de Django.
Siga leyendo para conocer más detalles.
\n\nPrimero, abra el URLconf polls/urls.py y modifíquelo de la siguiente manera:
polls/urls.pyfrom django.conf.urls import url\n\nfrom . import views\n\napp_name = 'polls'\nurlpatterns = [\n url(r'^$', views.IndexView.as_view(), name='index'),\n url(r'^(?P<pk>[0-9]+)/$', views.DetailView.as_view(), name='detail'),\n url(r'^(?P<pk>[0-9]+)/results/$', views.ResultsView.as_view(), name='results'),\n url(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'),\n]\nTenga en cuenta que el nombre del patrón coincidente en las expresiones regulares de los patrones segundo y tercero ha cambiado de `` <question_id> `` a `` <pk> ``.
\nA continuación, vamos a eliminar nuestras viejas vistas index, detail y `` results`` y en su lugar vamos a usar las vistas genéricas de Django. Para ello, abra el archivo polls/views.py y modifíquelo de la siguiente manera:
polls/views.pyfrom django.shortcuts import get_object_or_404, render\nfrom django.http import HttpResponseRedirect\nfrom django.urls import reverse\nfrom django.views import generic\n\nfrom .models import Choice, Question\n\n\nclass IndexView(generic.ListView):\n template_name = 'polls/index.html'\n context_object_name = 'latest_question_list'\n\n def get_queryset(self):\n """Return the last five published questions."""\n return Question.objects.order_by('-pub_date')[:5]\n\n\nclass DetailView(generic.DetailView):\n model = Question\n template_name = 'polls/detail.html'\n\n\nclass ResultsView(generic.DetailView):\n model = Question\n template_name = 'polls/results.html'\n\n\ndef vote(request, question_id):\n ... # same as above, no changes needed.\nEstamos utilizando dos vistas genéricas aquí: ListView y DetailView. Respectivamente, esas dos vistas abstraen los conceptos de «mostrar una lista de objetos» y «mostrar una página de detalles para un tipo específico de objeto».
Cada vista genérica tiene que saber cuál es el modelo sobre el que estará actuando. Esto se proporciona utilizando el atributo `` model``.
La vista genérica DetailView espera que el valor de la clave primaria capturado desde la URL sea denominado "pk", por lo que hemos cambiado``question_id`` a pk para las vistas genéricas.
Por defecto, la vista genérica DetailView utiliza una plantilla llamada “<app name>/<model name>_detail.html. En nuestro caso, utilizaría la plantilla "polls/question_detail.html". El atributo template_name se utiliza para indicarle a Django que utilice un nombre de plantilla específico en vez del nombre de plantilla generado de forma automática. También especificamos el atributo template_name para la vista de lista “results”, esto garantiza que la vista de resultados y la vista detalle tengan un aspecto diferente cuando sean creadas, a pesar de que las dos son una vista genérica DetailView en segundo plano.
Del mismo modo, la vista genérica ListView utiliza una plantilla predeterminada llamada <app name>/<model name>_list.html; utilizamos el atributo template_name para indicarle a ListView que utilice nuestra plantilla "polls/index.html" existente.
En partes anteriores del tutorial, las plantillas se han dotado de un contexto que contiene las variables contextuales question y latest_question_list. Para DetailView se suministra la variable question de forma automática, ya que estamos utilizando un modelo (Question) de Django, Django puede determinar un nombre adecuado para la variable contextual. Sin embargo, para ListView, la variable contextual generada de forma automática es question_list. Para anular esto, proporcionamos el atributo``context_object_name`` especificando que queremos utilizar en cambio latest_question_list. Como un método alternativo, usted puede modificar sus plantillas para que coincidan con las nuevas variables contextuales predeterminadas, pero es mucho más sencillo solo indicarle a Django que utilice la variable que usted quiere.
Ejecute el servidor y utilice su nueva aplicación encuesta basada en las vistas genéricas.
\nPara más detalles sobre las vistas genéricas, consulte la documentación de las vistas genéricas.
\nCuando esté familiarizado con los formularios y las vistas genéricas, lea la :doc: parte 5 de este tutorial </intro/tutorial05> para aprender sobre cómo probar nuestra aplicación encuestas.
\n