Lmorillas: Página creada con '== Creación de la interfaz pública == En la filosofía de Django una vista es un tipo de página web que sirve para una función específica y tiene una plantilla específica.…'

2011-08-24T06:25:44Z

Página creada con '== Creación de la interfaz pública == En la filosofía de Django una vista es un tipo de página web que sirve para una función específica y tiene una plantilla específica.…'

Página nueva

== Creación de la interfaz pública ==
En la filosofía de Django una vista es un tipo de página web que sirve para una función específica y tiene una plantilla específica. Por ejemplo en un blog podemos tener:
* La página inicial del Blog (muestra las últimas entradas)
* El detalle de una entada
* Página de las entradas por ffechas (día, mes, año)
* Comentarios

En la aplicación de las encuestas:
* Página índice de Encuestas, que muestre las últimas encuestas
* Página de detalle de encuestas: Muestra una pregunta con el formulario para votar
* Página de resultados de una encuesta.

Philosophy
A view is a “type” of Web page in your Django application that generally serves a specific function and has a specific template. For example, in a Weblog application, you might have the following views:

Blog homepage – displays the latest few entries.
Entry “detail” page – permalink page for a single entry.
Year-based archive page – displays all months with entries in the given year.
Month-based archive page – displays all days with entries in the given month.
Day-based archive page – displays all entries in the given day.
Comment action – handles posting comments to a given entry.
In our poll application, we’ll have the following four views:

En Django cada vista la gestiona una fución.

=== Diseño de URLs===
El primer paso para escribir una vista es diseñar la estructura de la URL. Django asocia una URL con código Python mediante el módulo URLconf.

Las urls se controlan con la variable urlpatterns, que es una secuencia de tuplas con el siguiente formato:
(expresión regular, function python [, diccionario opcional])
Django busca por orden y lanza la primera función que cumple el patrón. Cuando Django la encuentra, llama a la función Python con un objeto '''HttpRequest''' como primer argumento, valores capturados de la url como argumentos por clave y otros argumentos opcionales (tercer elemento de la tupla)

Al crear el proyecto se crea un URLconf por defecto en '''urls.py''' Esto se configura en settings.py (ver variable ROOT_URLCONF)

ROOT_URLCONF = 'mysite.urls'

Ejemplo. Edita urls.py como el siguiente ejemplo:

<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.conf.urls.defaults import patterns, include, url

from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
(r'^encuestas/$', 'encuestas.views.index'),
(r'^encuestas/(?P<encuesta_id>\d+)/$', 'encuestas.views.detalle'),
(r'^encuestas/(?P<encuesta_id>\d+)/resultado/$', 'encuestas.views.resultado'),
(r'^encuestas/(?P<encuesta_id>\d+)/votar/$', 'encuestas.views.votar'),
url(r'^admin/', include(admin.site.urls)),
)
</source>

Según nuestro ejemplo si el usuario pide
/encuestas/23

Django ejecutará
detalle((request=<HttpRequest object>, encuesta_id='23')

Los paréntesis de la expresión regular capturan el texto que coincide con el patrón.

El módulo URLconf compila las expresiones regulares para que se ejecuten más rápidas.

=== Primera vista===
Todavía no hemos creado ninguna vista. Vamos a comprobar que el URLconf funciona bien.
python manage.py runserver
Ve a "http://localhost:8000/encuestas/" con el navegador. Tenemos que ver el error de que la vista no existe.

Exception Type: ViewDoesNotExist

Escribimos las vistas en '''encuestas/views.py'''

<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.http import HttpResponse

def index(request):
return HttpResponse(u"Hola, este es el índice de las encuestas.")

def detalle(request, encuesta_id):
return HttpResponse(u"Estás viendo la encuesta %s." % encuesta_id)

def resultado(request, encuesta_id):
return HttpResponse(u"Estás viendo el resultado de la encuesta %s." % encuesta_id)

def votar(request, encuesta_id):
return HttpResponse(u"Estás votando la encuesta %s." % encuesta_id)
</source>
=== Vistas que hacen algo ===
Ahora vamos a escribir vistas que hagan algo realmente
Las vistas tienen que devolver:
* El objeto HttpResponse con el contenido de la página solicitada o
* Una excepción (por ej. Http404)

'''index'''
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
def index(request):
# Extrae 5 últimas encuestas de la bbdd. Orden: la última primero.
listado_ultimas = Encuesta.objects.all().order_by('-fecha_pub')[:5]
# prepara el resultado para mostrarlo
output = ', '.join([p.pregunta for p in listado_ultimas])
return HttpResponse(output)
</source>

Problema: el diseño de la página está integrado en la vista. Si queremos cambiar el aspecto de la página, hay que editar código python. Idea: separar código y presentación usando el sistema de plantillas de Django:

<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.http import HttpResponse
from django.template import Context, loader
from encuestas.models import Encuesta

def index(request):
# Extrae 5 últimas encuestas de la bbdd. Orden: la última primero.
listado_ultimas = Encuesta.objects.all().order_by('-fecha_pub')[:5]
t = loader.get_template('encuestas/index.html')
c = Context({
'listado_ultimas': listado_ultimas,
})
return HttpResponse(t.render(c))
</source>

====Primera plantilla ====
Es necesario crear la plantilla en una ruta incluida en TEMPLATE_DIRS. Editamos '''[directorio_plantillas]/encuestas/index.html" Por> seguridad no se extraen las plantillas de la raíz del proyecto.

<source lang="html4strict">
{% if listado_ultimas %}
<ul>
{% for encuesta in listado_ultimas %}
<li><a href="/encuestas/{{ encuesta.id}}/">{{ encuesta.pregunta }}</a></li>
{% endfor %}
</ul>
{% else %}
<p>No hay encuestas disponibles.</p>
{% endif %}
</source>

====Atajo: render_to_response()====
¿Para qué repetir tanto? Ya no es necesario importar loader, Context y HttpResponse.
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.shortcuts import render_to_response
from encuestas.models import Encuesta

def index(request):
listado_ultimas = Encuesta.objects.all().order_by('-fecha_pub')[:5]
return render_to_response('encuestas/index.html',
{'listado_ultimas': listado_ultimas,})
</source>

==== Lanzando una respuesta 404 (no encontrado) ====

<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.shortcuts import render_to_response
from django.http import Http404
from encuestas.models import Encuesta
# ...
def detalle(request, encuesta_id):
try:
enc = Encuesta.objects.get(pk=encuesta_id)
except Encuesta.DoesNotExist:
raise Http404 # Si la encuesta no existe, lanza un httpresponse: 404
return render_to_response('encuestas/detalle.html', {'encuesta': enc})
</source>
Creamos una plantilla para encuestas/detalle.html:
<source lang="html4strict">
{{encuesta}}
</source>
Resultado:

<source lang="bash">
$ curl -I http://127.0.0.1:8000/encuestas/12/
HTTP/1.0 404 NOT FOUND
Date: Wed, 24 Aug 2011 05:27:20 GMT
Server: WSGIServer/0.1 Python/2.7.1+
Content-Type: text/html
</source>

====Otro atajo: get_object_or_404()====
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.shortcuts import render_to_response, get_object_or_404
# ...
def detalle(request, encuesta_id):
enc = get_object_or_404(Encuesta, pk=encuesta_id)
return render_to_response('encuestas/detalle.html', {'encuesta': enc})
</source>
La función '''get_object_or_404()''' toma como primer argumento un modelo de Django y un número no determinado de argumentos por clave. Si el objeto no existe, lanza un Http404.

Si buscamos una secuencia de objetos, podemos usar '''get_list_or_404()''', que usa filter() en lugar de get(). Lanza Http404 si la lista está vacía.
==== Escribir una vista 404 (página no encontrada) ====
Cuando DEBUG está activado, la vista 404 no se usa y Django muestra el error.
Cuando DEBUG está a False, va a buscar un template 404.html en la raíz del directorio de templates. Si no lo encuentra, lanza un Http500. También hay que escribir una plantilla para 500.html.

Plantilla de detalle.html
<source lang="html4strict">
<h1>{{ encuesta.pregunta }}</h1>
<ul>
{% for opcion in encuesta.opcion_set.all %}
<li>{{ opcion.opcion }}</li>
{% endfor %}
</ul>
</source>
El sistema de plantillas usa la sintaxis del punto para accceder a los atributos. Fíjate en como usa el {% for %} y como accede a las opciones desde el objeto encuestas
encuesta.opcion_set.all
equivale a
encuesta.opcion_set.all()
Que devuelve el iterable que recorre el for.

Más información en la [https://docs.djangoproject.com/en/1.3/topics/templates/ guía de plantillas]

====Simplificando URLconfs ====
Podemos usar patrones para evitar repeticiones:
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
urlpatterns = patterns('encuestas.views',
(r'^encuestas/$', 'index'),
(r'^encuestas/(?P<encuesta_id>\d+)/$', 'detalle'),
(r'^encuestas/(?P<encuesta_id>\d+)/resultado/$', 'resultado'),
(r'^encuestas/(?P<encuesta_id>\d+)/votar/$', 'votar'),
)

urlpatterns += patterns('',
(r'^admin/', include(admin.site.urls)),)
</source>

También se pueden desacoplar, para hacer más reutilizables las aplicaciones (aplicaciones pluggables)
Pasos:
* Movemos sitio_encuestas/urls.py a encuestas/urls.py
* Cambiamos sitio_encuestas/urls.py para eliminar las urls de encuestas e insertamos un include():
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.conf.urls.defaults import *

from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
(r'^encuestas/', include('encuestas.urls')),
(r'^admin/', include(admin.site.urls)),
)
</source>

Así quedará encuestas/urls.py
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.conf.urls.defaults import *

urlpatterns = patterns('encuestas.views',
(r'^$', 'index'),
(r'^(?P<encuesta_id>\d+)/$', 'detalle'),
(r'^(?P<encuesta_id>\d+)/resultado/$', 'resultado'),
(r'^(?P<encuesta_id>\d+)/votar/$', 'votar'),
)
</source>
Como ahora tienen una ruta relativa, podemos instalar la aplicación en distintas URLs: /encuestas, /encuestas_alumnos, /encuestas_corporativas y la aplicación seguirá funcionando.

Curso Python DGA 2011/django/contenidos/vistas - Historial de revisiones

Lmorillas: Página creada con '== Creación de la interfaz pública == En la filosofía de Django una vista es un tipo de página web que sirve para una función específica y tiene una plantilla específica.…'