davidbgk
/
larlet-fr-david
Watch 1
Star 0
Fork 0
Code Releases 0 Activity
Repository with sources and generator of https://larlet.fr/david/ https://larlet.fr/david/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
244 Commits
1 Branch
Tree: f16aada5e3
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'f16aada5e3'
${ noResults }
larlet-fr-david/david/biologeek/archives/20060617-redaction-de-votre.../index.html

index.html 37KB
Raw Blame History

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649 
  1. <!doctype html>

  2. <html lang=fr>

  3. <head>

  4.   <!-- Always define the charset before the title -->

  5.   <meta charset=utf-8>

  6.   <title>Rédaction de votre première appli Django, partie 3 : Création des vues de l&#39;interface publique — Biologeek — David Larlet</title>

  7.   <!-- Define a viewport to mobile devices to use - telling the browser to assume that the page is as wide as the device (width=device-width) and setting the initial page zoom level to be 1 (initial-scale=1.0) -->

  8.   <meta name="viewport" content="width=device-width, initial-scale=1"/>

  9.   <!-- Fake favicon, to avoid extra request to the server -->

  10.   <link rel="icon" href="data:;base64,iVBORw0KGgo=">

  11.   <link type="application/atom+xml" rel="alternate" title="Feed" href="/david/log/" />

  12.   <link rel="manifest" href="/manifest.json">

  13.   

  14.   <link rel="stylesheet" href="/static/david/css/larlet-david-_J6Rv.css" data-instant-track />

  15.   

  16.   <noscript>

  17.     <style type="text/css">

  18.       /* Otherwise fonts are loaded by JS for faster initial rendering. See scripts at the bottom. */

  19.       body {

  20.         font-family: 'EquityTextB', serif;

  21.       }

  22.       h1, h2, h3, h4, h5, h6, time, nav a, nav a:link, nav a:visited {

  23.         font-family: 'EquityCapsB', sans-serif;

  24.         font-variant: normal;

  25.       }

  26.     </style>

  27.   </noscript>

  28.   

  29.   <!-- Canonical URL for SEO purposes -->

  30.   <link rel="canonical" href="https://larlet.fr/david/biologeek/archives/20060617-redaction-de-votre-premiere-appli-django-partie-3-creation-des-vues-de-l-interface-publique">

  31. 

  32. </head>

  33. <body>

  34.   <div>

  35.     

  36.     <header>

  37.       <nav>

  38.         <p>

  39.           <small>

  40.             Je suis <a href="/david/" title="Profil public">David Larlet</a>, <a href="/david/pro/" title="Activité professionnelle">artisan</a> du web qui vous <a href="/david/pro/accompagnement/" title="Activité d’accompagnement">accompagne</a><span class="more-infos"> dans l’acquisition de savoirs pour concevoir des <a href="/david/pro/produits-essentiels/" title="Qu’est-ce qu’un produit essentiel ?">produits essentiels</a></span>. <span class="more-more-infos">Discutons ensemble d’une <a href="/david/pro/devis/" title="En savoir plus">non-demande de devis</a>.</span> Je partage ici mes <a href="/david/blog/" title="Expériences bienveillantes">réflexions</a> et <a href="/david/correspondances/2017/" title="Lettres hebdomadaires">correspondances</a>.

  41.           </small>

  42.         </p>

  43.       </nav>

  44.     </header>

  45.     

  46.     

  47.   <section>

  48.     <h1 property="schema:name">Rédaction de votre première appli Django, partie 3 : Création des vues de l&#39;interface publique</h1>

  49.     <article typeof="schema:BlogPosting">

  50.       <div property="schema:articleBody">

  51.         <img src="/static/david/biologeek/images/logos/django.png" alt="vignette" style="float:left; margin: 0.5em 1em;" property="schema:thumbnailUrl" />

  52.         <p>Ce tutoriel commence là où s'est achevé le <a class="reference" href="https://larlet.fr/david/biologeek/archives/20060617-redaction-de-votre-premiere-appli-django-partie-2-exploration-de-l-interface-d-admin-auto-generee/">Tutoriel 2</a>. Nous continuons

  53. l'application Web de sondage et allons nous focaliser sur la création

  54. d'interfaces publiques -- les « vues ».</p>

  55. 

  56. <div class="section">

  57. <h1><a id="philosophie" name="philosophie">Philosophie</a></h1>

  58. <p>Une vue est un « type » de page Web dans votre application Django qui en général

  59. sert une fonctionnalité spécifique et possède un template spécifique. Par

  60. exemple, dans une application de weblog, vous pourriez avoir les vues suivantes:</p>

  61. <blockquote>

  62. <ul class="simple">

  63. <li>Page d'accueil du blog -- afficher quelques unes des dernières entrées.</li>

  64. <li>Page de « détail » d'un billet -- page au lien permanent pour un certain

  65. billet.</li>

  66. <li>Page d'archivage par années -- affiche tous les mois ayant des entrées

  67. dans une année donnée.</li>

  68. <li>Page d'archivage par mois -- affiche tous les jours ayant des entrées dans

  69. un mois donné.</li>

  70. <li>Page d'archivage par jour -- affiche toutes les entrées pour un jour

  71. donné.</li>

  72. 

  73. <li>Action de commentaire -- gère l'envoi de commentaires pour un billet

  74. donné.</li>

  75. </ul>

  76. </blockquote>

  77. <p>Dans notre application de sondage, nous aurons les quatre vues suivantes:</p>

  78. <blockquote>

  79. <ul class="simple">

  80. <li>Page « d'archive » des sondages -- affiche quelques uns des derniers

  81. sondages.</li>

  82. <li>Page « de détail » de sondage -- affiche la question d'un sondage, sans

  83. les résultats mais avec un formulaire pour voter.</li>

  84. <li>Page « de résultat » de sondage -- affiche les résultats pour un sondage

  85. particulier.</li>

  86. <li>Action de vote -- gère le vote d'un choix particulier pour un sondage

  87. particulier.</li>

  88. </ul>

  89. 

  90. </blockquote>

  91. <p>Dans Django, chaque vue est représentée par une simple fonction Python.</p>

  92. </div>

  93. 

  94. <div class="section">

  95. <h1><a id="conception-de-vos-urls" name="conception-de-vos-urls">Conception de vos URLs</a></h1>

  96. <p>La première étape dans la rédaction de vues est de concevoir la structure de vos

  97. URLs. Vous faites cela en créant un module Python, appelé URLconf. Les URLconfs

  98. décrivent comment Django associe une URL donnée avec un code Python donné.</p>

  99. <p>Lorsqu'un utilisateur effectue une requête pour une page gérée par Django, le

  100. système examine l'option <tt class="docutils literal"><span class="pre">ROOT_URLCONF</span></tt>, qui contient une chaîne dans la

  101. syntaxe à points de Python. Django charge ce module et recherche une variable de

  102. module appelé <tt class="docutils literal"><span class="pre">urlpatterns</span></tt>, que est une séquence de tuples dans le format

  103. suivant:</p>

  104. <pre class="literal-block">

  105. (expression rationnelle, fonction Python de rappel [, dictionnaire facultatif])

  106. 

  107. </pre>

  108. <p>Django démarre la première expression rationnelle et parcourt la liste, en

  109. comparant l'URL de la requête avec chaque expression rationnelle jusqu'à ce

  110. qu'il en trouve une qui corresponde.</p>

  111. <p>Quand il trouve une correspondance, Django appelle la fonction Python de rappel,

  112. avec un objet <tt class="docutils literal"><span class="pre">HTTPRequest</span></tt> en premier argument, toutes les valeurs

  113. « capturées » dans l'expression rationnelle sous forme d'arguments mot-clés, et,

  114. facultativement, un argument mot-clé arbitraire contenant un dictionnaire (le

  115. troisième élément facultatif du tuple).</p>

  116. <p>Pour plus d'infos sur les objets <tt class="docutils literal"><span class="pre">HTTPRequest</span></tt>, lisez la <a class="reference" href="http://www.djangoproject.com/documentation/request_response/">documentation sur

  117. les requêtes et réponses</a>.

  118. Pour plus de détails sur les URLconfs, lisez la <a class="reference" href="http://www.djangoproject.com/documentation/url_dispatch/">documentation URLconf</a>.</p>

  119. <p>Quand vous avez lancé <tt class="docutils literal"><span class="pre">python</span> <span class="pre">manage.py</span> <span class="pre">startproject</span> <span class="pre">monsite</span></tt> au début du

  120. Tutoriel 1, ça a créé un URLconf par défaut dans <tt class="docutils literal"><span class="pre">monsite/urls.py</span></tt>. Ça a aussi

  121. défini automatiquement votre option <tt class="docutils literal"><span class="pre">ROOT_URLCONF</span></tt> pour pointer vers ce

  122. fichier:</p>

  123. 

  124. <pre class="literal-block">

  125. ROOT_URLCONF = 'monsite.urls'

  126. </pre>

  127. <p>Passons à un exemple. Éditez <tt class="docutils literal"><span class="pre">monsite/urls.py</span></tt> pour qu'il ressemble à ceci:</p>

  128. <pre class="literal-block">

  129. from django.conf.urls.defaults import *

  130. 

  131. urlpatterns = patterns('',

  132.     (r'^polls/$', 'monsite.polls.views.index'),

  133.     (r'^polls/(?P&lt;poll_id&gt;\d+)/$', 'monsite.polls.views.detail'),

  134.     (r'^polls/(?P&lt;poll_id&gt;\d+)/results/$', 'monsite.polls.views.results'),

  135.     (r'^polls/(?P&lt;poll_id&gt;\d+)/vote/$', 'monsite.polls.views.vote'),

  136. )

  137. </pre>

  138. 

  139. <p>Cela mérite quelques explications. Lorsque quelqu'un effectue une requête sur

  140. une page de votre site Web -- disons, « /polls/23/ », Django va charger ce

  141. module Python, parce qu'il est pointé par l'option <tt class="docutils literal"><span class="pre">ROOT_URLCONF</span></tt>. Ça trouve

  142. la variable nommée <tt class="docutils literal"><span class="pre">urlpatterns</span></tt> et parcourt les expressions rationnelles dans

  143. l'ordre. Quand il trouve une expression rationnelle qui correspond --

  144. <tt class="docutils literal"><span class="pre">r'^polls/(?P&lt;poll_id&gt;\d+)/$'</span></tt> -- il charge le module ou paquetage Python

  145. associé : <tt class="docutils literal"><span class="pre">monsite.polls.views.detail</span></tt>. Ce qui correspond à la fonction

  146. <tt class="docutils literal"><span class="pre">detail()</span></tt> dans <tt class="docutils literal"><span class="pre">mysite/polls/views.py</span></tt>.</p>

  147. 

  148. <p>Enfin, il appelle cette fonction <tt class="docutils literal"><span class="pre">detail()</span></tt> comme ceci:</p>

  149. <blockquote>

  150. detail(request=&lt;HttpRequest object&gt;, poll_id='23')</blockquote>

  151. <p>La partie <tt class="docutils literal"><span class="pre">poll_id='23'</span></tt> vient de <tt class="docutils literal"><span class="pre">(?P&lt;poll_id&gt;\d+)</span></tt>. Mettre les parenthèses

  152. autour d'un masque (pattern) « capture » le texte correspondant à ce masque et

  153. l'envoie en argument à la fonction de vue. Le <tt class="docutils literal"><span class="pre">?P&lt;poll_id&gt;</span></tt> définit le nom qui

  154. sera utilisé pour identifier le masque correspondant et <tt class="docutils literal"><span class="pre">\d+</span></tt> est une

  155. expression rationnelle pour trouver une séquence de chiffres (c'est-à-dire, un

  156. nombre).</p>

  157. 

  158. <p>Parce que les masques d'URL sont des expressions rationnelles, il n'y a vraiment

  159. aucune limite sur ce que vous pouvez faire avec eux. Et il n'est pas nécessaire

  160. d'ajouter de fioritures à l'URL tel que <tt class="docutils literal"><span class="pre">.php</span></tt> -- sauf si vous avez un sens de

  161. l'humour tordu, dans lequel cas vous pouvez faire quelque chose comme ça:</p>

  162. <pre class="literal-block">

  163. (r'^polls/latest\.php$', 'monsite.polls.views.index'),

  164. </pre>

  165. <p>Mais, ne faites pas ça. C'est stupide.</p>

  166. <p>Notez que ces expressions rationnelles ne recherchent pas dans les paramètres

  167. GET et POST, ni dans le nom de domaine. Par exemple, dans une requête vers

  168. <tt class="docutils literal"><span class="pre">http://www.exemple.com/monappli/</span></tt>, l'URLconf va rechercher dans

  169. <tt class="docutils literal"><span class="pre">/monappli/</span></tt>. Dans une requête vers

  170. <tt class="docutils literal"><span class="pre">http://www.exemple.com/monappli/?page=3</span></tt>, l'URLconf va rechercher dans

  171. 

  172. <tt class="docutils literal"><span class="pre">/myapp/</span></tt>.</p>

  173. <p>Si vous avez besoin d'aide sur les expressions rationnelles, lisez <a class="reference" href="http://en.wikipedia.org/wiki/Regular_expression">l'article de

  174. Wikipedia</a> et la <a class="reference" href="http://www.python.org/doc/current/lib/module-re.html">documentation Python</a>. De plus, le livre O'Reilly

  175. « Mastering Regular Expressions » de Jeffrey Friedl est fantastique.</p>

  176. <p>Pour finir, une note sur la performance: ces expressions rationnelles sont

  177. compilées la première fois que le modul URLconf est chargé. Ça les rend très

  178. rapides.</p>

  179. </div>

  180. 

  181. <div class="section">

  182. <h1><a id="crire-votre-premi-re-vue" name="crire-votre-premi-re-vue">Écrire votre première vue</a></h1>

  183. <p>Bien, nous n'avons toujours pas créé de vue -- nous avons juste touché à

  184. URLconf. Mais assurons-nous que Django suit l'URLconf comme il faut.</p>

  185. 

  186. <p>Lancez le serveur Web de développement de Django:</p>

  187. <pre class="literal-block">

  188. python manage.py runserver

  189. </pre>

  190. <p>Maintenant, allez sur « <a class="reference" href="http://localhost:8000/polls/">http://localhost:8000/polls/</a> » avec votre navigateur

  191. Web. Vous devriez obtenir une page d'erreur agréablement colorée avec

  192. le message suivant:</p>

  193. <pre class="literal-block">

  194. ViewDoesNotExist at /polls/

  195. 

  196. Tried index in module mysite.polls.views. Error was: 'module'

  197. object has no attribute 'index'

  198. </pre>

  199. <p>Cette erreur survient parce que vous n'avez pas écrit la fonction <tt class="docutils literal"><span class="pre">index()</span></tt>

  200. dans le module <tt class="docutils literal"><span class="pre">monsite/polls/views.py</span></tt>.</p>

  201. 

  202. <p>Essayez « /polls/23/ », « /polls/23/results/ » et « /polls/23/vote/ ». Les

  203. messages d'erreur vous disent quelle vue Django essaie de charger (et n'arrive

  204. pas à trouver, parce que vous n'avez pas encore écrit les vues).</p>

  205. <p>Il est temps d'écrire la première vue. Ouvrez le fichier

  206. <tt class="docutils literal"><span class="pre">monsite/polls/views.py</span></tt> et mettez-y le code Python suivant:</p>

  207. <pre class="literal-block">

  208. from django.http import HttpResponse

  209. 

  210. def index(request):

  211.     return HttpResponse(&quot;Bonjour tout le monde. Vous est dans l'index des sondages.&quot;)

  212. </pre>

  213. <p>Voilà la vue la plus simple possible. Allez dans « /polls/ » avec votre

  214. navigateur, et vous devriez voir votre texte.</p>

  215. <p>À présent, ajoutez la vue suivante. C'est un petit peu différent, parce qu'il

  216. prend un argument (qui, rappelez-vous, est passé depuis ce qui a été capturé par

  217. l'expression rationnelle dans l'URLconf):</p>

  218. <pre class="literal-block">

  219. 

  220. def detail(request, poll_id):

  221.     return HttpResponse(&quot;Vous consultez le sondage %s.&quot; % poll_id)

  222. </pre>

  223. <p>Jetez à oeil à votre navigateur, à « /polls/34/ ». Ça affichera l'ID que vous

  224. avez fournie dans l'URL.</p>

  225. </div>

  226. 

  227. <div class="section">

  228. <h1><a id="crire-des-vues-qui-font-quelque-chose" name="crire-des-vues-qui-font-quelque-chose">Écrire des vues qui font quelque chose</a></h1>

  229. <p>Chaque vue a la responsabilité de faire l'une des deux choses suivantes :

  230. Retourner un objet <tt class="docutils literal"><span class="pre">HttpResponse</span></tt> renfermant le contenu de la page demandée,

  231. ou lever une exception telle que <tt class="docutils literal"><span class="pre">Http404</span></tt>. Le reste est pour vous.</p>

  232. 

  233. <p>Votre vue peut lire ou non les enregistrements d'une base de données. Il peut

  234. utiliser ou non un système de template tel que celui de Django -- ou un système

  235. tiers de template Python. Il peut générer un fichier PDF, une sortie XML, créer

  236. un fichier ZIP à la volée, tout ce que vous voulez, en utilisant toutes les

  237. bibliothèques Python que vous désirez.</p>

  238. <p>Tout ce que Django veut, c'est <tt class="docutils literal"><span class="pre">HttpResponse</span></tt>. Ou une exception.</p>

  239. <p>Parce que c'est plus pratique, utilisons l'API de base de données propre à

  240. Django, que nous avons abordée dans le Tutoriel 1.  Voici un premier jet de la

  241. vue <tt class="docutils literal"><span class="pre">index()</span></tt>, qui affiche les 5 dernières questions de sondage du système,

  242. séparées par des virgules, triées par date de publication:</p>

  243. <pre class="literal-block">

  244. from monsite.polls.models import Poll

  245. from django.http import HttpResponse

  246. 

  247. def index(request):

  248.     latest_poll_list = Poll.objects.all().order_by('-pub_date')[:5]

  249.     output = ', '.join([p.question for p in latest_poll_list])

  250.     return HttpResponse(output)

  251. </pre>

  252. <p>Nous avons ici un problème, à savoir : Le design de la page est codée en dure

  253. dans la vue. Si vous voulez changer l'apparence de la page, vous devrez éditer

  254. ce code Python. Donc utilisons plutôt le système de template de Django pour

  255. la présentation des données:</p>

  256. <pre class="literal-block">

  257. from django.template import Context, loader

  258. from monsite.polls.models import Poll

  259. from django.http import HttpResponse

  260. 

  261. def index(request):

  262.     latest_poll_list = Poll.objects.all().order_by('-pub_date')[:5]

  263.     t = loader.get_template('polls/index.html')

  264.     c = Context({

  265.         'latest_poll_list': latest_poll_list,

  266.     })

  267.     return HttpResponse(t.render(c))

  268. 

  269. </pre>

  270. <p>Ce code charge la template appelé « polls/index.html » et lui passe un contexte.

  271. Le contexte est un dictionnaire indexant les objets Python selon des noms de

  272. variable de template.</p>

  273. <p>Rechargez la page. Maintenant, vous verrez une erreur:</p>

  274. <pre class="literal-block">

  275. TemplateDoesNotExist at /polls/

  276. polls/index.html

  277. </pre>

  278. <p>Ah. Il n'y a pas encore de template. En premier lieu, créez un répertoire,

  279. quelque part dans votre système de fichers, auquel Django a accès (Django

  280. s'exécute avec les droits de l'utilisateur qui a lancé le serveur). Cependant,

  281. ne les mettez pas à la racine de vos documents. Vous ne devriez probablement pas

  282. les rendre publics, juste par mesure de sécurité.</p>

  283. <p>Puis éditez <tt class="docutils literal"><span class="pre">TEMPLATE_DIRS</span></tt> dans votre <tt class="docutils literal"><span class="pre">settings.py</span></tt> pour dire à Django où

  284. il peut trouver les templates -- tout comme vous l'avez fait dans la section

  285. « Personnaliser l'apparence de l'interface d'admin » du Tutoriel 2.</p>

  286. 

  287. <p>Une fois fait, créez un répertoire <tt class="docutils literal"><span class="pre">polls</span></tt> dans votre répertoire de templates.

  288. Dedans, créez un fichier appelé <tt class="docutils literal"><span class="pre">index.html</span></tt>. Notez que notre code

  289. <tt class="docutils literal"><span class="pre">loader.get_template('polls/index.html')</span></tt> ci-dessus se réfère à

  290. &quot;[répertoire_de_templates]/polls/index.html&quot; dans le système de fichiers.</p>

  291. <p>Placez le code suivant dans ce template:</p>

  292. <pre class="literal-block">

  293. {% if latest_poll_list %}

  294.     &lt;ul&gt;

  295. 

  296.     {% for poll in latest_poll_list %}

  297.         &lt;li&gt;{{ poll.question }}&lt;/li&gt;

  298.     {% endfor %}

  299.     &lt;/ul&gt;

  300. {% else %}

  301.     &lt;p&gt;Aucun sondage disponnible.&lt;/p&gt;

  302. {% endif %}

  303. </pre>

  304. 

  305. <p>Chargez la page dans votre navigateur Web, et vous devriez voir une liste à puce

  306. contenant le sondage &quot;Quoi de neuf&quot; du Tutoriel 1.</p>

  307. <div class="section">

  308. <h2><a id="un-raccourci-render-to-response" name="un-raccourci-render-to-response">Un raccourci: render_to_response()</a></h2>

  309. <p>Il est vraiment très courant de charger un template, remplir un contexte et

  310. retourner un objet <tt class="docutils literal"><span class="pre">HttpResponse</span></tt> avec le résultat du rendu de la template.

  311. Django fournit un raccourci. Voici le vue complète de <tt class="docutils literal"><span class="pre">index()</span></tt>, réécrite:</p>

  312. <pre class="literal-block">

  313. from django.shortcuts import render_to_response

  314. from monsite.polls.models import Poll

  315. 

  316. def index(request):

  317.     latest_poll_list = Poll.objects.all().order_by('-pub_date')

  318.     return render_to_response('polls/index.html', {'latest_poll_list': latest_poll_list})

  319. 

  320. </pre>

  321. <p>Notez que nous n'avons plus besoin d'importer <tt class="docutils literal"><span class="pre">loader</span></tt>, <tt class="docutils literal"><span class="pre">Context</span></tt> ni

  322. <tt class="docutils literal"><span class="pre">HttpResponse</span></tt>.</p>

  323. <p>La fonction <tt class="docutils literal"><span class="pre">render_to_response()</span></tt> prend un nom de template en premier

  324. argument et un dictionnaire comme second argument facultatif. Il retourne un

  325. objet <tt class="docutils literal"><span class="pre">HttpResponse</span></tt> du template donné rendu avec le contexte donné.</p>

  326. 

  327. </div>

  328. 

  329. <p></div>

  330. <div class="section">

  331. <h1><a id="lever-l-erreur-404" name="lever-l-erreur-404">Lever l'erreur 404</a></h1>

  332. <p>À présent, abordons la vue de sondage détaillé -- la page qui affiche la

  333. question d'un sondage donné. Voici la vue:</p>

  334. <pre class="literal-block">

  335. from django.http import Http404</p>

  336. <h1>...</h1>

  337. <p>def detail(request, poll_id):

  338.     try:

  339.         p = Poll.objects.get(pk=poll_id)

  340.     except Poll.DoesNotExist:

  341.         raise Http404

  342.     return render_to_response('polls/detail.html', {'poll': p})

  343. </pre>

  344. <p>Le nouveau concept ici : La vue lève l'exception <tt class="docutils literal"><span class="pre">django.http.Http404</span></tt> si un

  345. sondage avec l'ID demandé n'existe pas.</p>

  346. <div class="section">

  347. <h2><a id="un-raccourci-get-object-or-404" name="un-raccourci-get-object-or-404">Un raccourci : get_object_or_404()</a></h2></p>

  348. <p>Il est vraiment très courant d'utiliser <tt class="docutils literal"><span class="pre">get_object()</span></tt> et de déclencher

  349. <tt class="docutils literal"><span class="pre">Http404</span></tt> si l'objet n'existe pas. Django fournit un raccourci. Voici la vue

  350. <tt class="docutils literal"><span class="pre">detail()</span></tt>, réécrite:</p>

  351. 

  352. <pre class="literal-block">

  353. from django.shortcuts import render_to_response, get_object_or_404

  354. # ...

  355. def detail(request, poll_id):

  356.     p = get_object_or_404(Poll, pk=poll_id)

  357.     return render_to_response('polls/detail.html', {'poll': p})

  358. </pre>

  359. 

  360. <p>La fonction <tt class="docutils literal"><span class="pre">get_object_or_404()</span></tt> prend un modèle Django en premier argument

  361. et un nombre arbitaire d'arguments mot-clés, qu'elle passe à la fonction

  362. 

  363. <tt class="docutils literal"><span class="pre">get_object()</span></tt> du module. Elle déclenche <tt class="docutils literal"><span class="pre">Http404</span></tt> si l'object n'existe pas.</p>

  364. 

  365. <div class="admonition-philosophie admonition">

  366. <p class="first admonition-title">Philosophie</p>

  367. <p>Pourquoi utilisons-nous une fonction utilitaire <tt class="docutils literal"><span class="pre">get_object_or_404()</span></tt> au

  368. lieu de récupérer automatiquement les exceptions <tt class="docutils literal"><span class="pre">DoesNotExist</span></tt> de haut

  369. niveau, ou avoir l'API du modèle qui déclenche <tt class="docutils literal"><span class="pre">Http404</span></tt> au lieu de

  370. 

  371. <tt class="docutils literal"><span class="pre">DoesNotExist</span></tt> ?</p>

  372. <p class="last">Parce que ça serait coupler la couche du modèle avec la couche de la vue.

  373. Une des règles d'or de la conception de Django est de maintenir ce

  374. découplage entre les différentes couches.</p>

  375. </div>

  376. 

  377. <p>Il y a également une fonction <tt class="docutils literal"><span class="pre">get_list_or_404()</span></tt>, qui fonctionne

  378. similairement à <tt class="docutils literal"><span class="pre">get_object_or_404()</span></tt> -- sauf qu'elle utilise <tt class="docutils literal"><span class="pre">filter()</span></tt>

  379. au lieu de <tt class="docutils literal"><span class="pre">get()</span></tt>. Elle lève <tt class="docutils literal"><span class="pre">Http404</span></tt> si la liste est vide.</p>

  380. 

  381. <p></div>

  382. </div>

  383. <div class="section">

  384. <h1><a id="crire-une-vue-404-page-non-trouv-e" name="crire-une-vue-404-page-non-trouv-e">Écrire une vue 404 (page non trouvée)</a></h1>

  385. <p>Lorsque vous levez une <tt class="docutils literal"><span class="pre">Http404</span></tt> à partir d'une vue, Django va charger une vue

  386. spéciale qui s'occupe des erreurs 404. Il la trouve en cherchant la variable

  387. <tt class="docutils literal"><span class="pre">handler404</span></tt>, qui est une chaîne de caractères utilisant la syntaxe Python à

  388. points -- le même format qui est utilisé par l'URLconf. Une vue 404 en elle-même

  389. n'a rien de particulier : c'est juste une vue classique.</p>

  390. <p>Vous n'avez normalement pas à vous soucier de l'écriture des vues 404.

  391. Par défaut les URLconfs ont la ligne suivante en en-tête :</p>

  392. <blockquote>

  393. from django.conf.urls.defaults import *</blockquote></p>

  394. <p>Cela permet de prendre en compte le paramètre <tt class="docutils literal"><span class="pre">handler404</span></tt> pour le module

  395. courrant. Comme vous pouvez le constater dans <tt class="docutils literal"><span class="pre">django/conf/urls/defaults.py</span></tt>,

  396. <tt class="docutils literal"><span class="pre">handler404</span></tt> correspond par défaut à

  397. <tt class="docutils literal"><span class="pre">'django.views.defaults.page_not_found'</span></tt>.</p>

  398. 

  399. <p>Encore trois remarques au sujet des vues 404 :</p>

  400. 

  401. <blockquote>

  402. <ul class="simple">

  403. <li>La vue 404 est aussi appelée si aucune des expressions rationnelle de

  404. l'URLconf ne correspond à l'adresse demandée.</li>

  405. 

  406. <li>Si vous ne définissez pas votre propre vue 404 -- et utilisez celle par

  407. défaut, ce qui est recommandé -- vous devez quand même créer un template

  408. <tt class="docutils literal"><span class="pre">404.html</span></tt> à la racide de votre dossier de templates.</li>

  409. <li>Si <tt class="docutils literal"><span class="pre">DEBUG</span></tt> est à <tt class="docutils literal"><span class="pre">True</span></tt> (dans votre module de paramètres), votre vue

  410. 404 utilisera ce template pour toutes les erreurs 404.</li>

  411. </ul>

  412. </blockquote>

  413. 

  414. <p></div>

  415. <div class="section"></p>

  416. <h1><a id="crire-une-vue-500-erreur-serveur" name="crire-une-vue-500-erreur-serveur">Écrire une vue 500 (erreur serveur)</a></h1>

  417. 

  418. <p>De la même manière, URLconfs peut définir une <tt class="docutils literal"><span class="pre">handler500</span></tt>, qui pointe sur une

  419. vue appelée en cas d'erreur du serveur. Les erreurs du serveur lorsque vous avez

  420. des erreurs d'exécution dans le code de vos vues.</p>

  421. 

  422. <p></div>

  423. <div class="section">

  424. <h1><a id="utiliser-le-syst-me-de-template" name="utiliser-le-syst-me-de-template">Utiliser le système de template</a></h1>

  425. <p>Revenons à notre vue <tt class="docutils literal"><span class="pre">polls.detail</span></tt>. Considérant la variable de contexte

  426. <tt class="docutils literal"><span class="pre">poll</span></tt>, voici le template tel qu'il pourrait être:</p>

  427. <pre class="literal-block"></p>

  428. <p>&lt;h1&gt;{{ poll.question }}&lt;/h1&gt;

  429. &lt;ul&gt;

  430. {% for choice in poll.choice_set.all %}

  431.     &lt;li&gt;{{ choice.choice }}&lt;/li&gt;

  432. {% endfor %}

  433. &lt;/ul&gt;

  434. </pre>

  435. <p>Le système de template utilise une syntaxe par points pour accéder aux attributs

  436. des variables. Dans l'exemple <tt class="docutils literal"><span class="pre">{{</span> <span class="pre">poll.question</span> <span class="pre">}}</span></tt>, Django commence par

  437. chercher la clé <tt class="docutils literal"><span class="pre">question</span></tt> du dictionnaire <tt class="docutils literal"><span class="pre">poll</span></tt>. N'y parvenant pas, il

  438. essaye avec les attributs de classe -- ce qui marche dans ce cas. Si ça n'avait

  439. pas été le cas, il aurait essayé d'appeler la méthode <tt class="docutils literal"><span class="pre">question()</span></tt> de l'objet

  440. poll.</p></p>

  441. <p>L'appel d'une méthode se produit dans la boucle <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">for</span> <span class="pre">%}</span></tt> :

  442. <tt class="docutils literal"><span class="pre">poll.choice_set.all</span></tt> est interprété comme le code <tt class="docutils literal"><span class="pre">poll.choice_set.all()</span></tt>,

  443. ce qui renvoie un iterable d'objets « Choice » ce qui est parfait pour une

  444. utilisation dans un tag <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">for</span> <span class="pre">%}</span></tt>.</p>

  445. 

  446. <p>Lisez le <a class="reference" href="http://www.djangoproject.com/documentation/templates/">guide des templates</a> pour davantage de détails sur le fonctionnement

  447. des templates.</p>

  448. 

  449. <p></div>

  450. <div class="section">

  451. <h1><a id="simplifier-urlconfs" name="simplifier-urlconfs">Simplifier URLconfs</a></h1>

  452. <p>Prennons le temps de jouer un peu avec les vues et le système de templates. Lors

  453. de l'édition d'URLconf, vous avez dû vous rendre compte de la redondance

  454. présente dans le fichier:</p>

  455. <pre class="literal-block">

  456. urlpatterns = patterns('',

  457.     (r'^polls/$', 'mysite.polls.views.index'),

  458.     (r'^polls/(?P&lt;poll_id&gt;\d+)/$', 'mysite.polls.views.detail'),

  459.     (r'^polls/(?P&lt;poll_id&gt;\d+)/results/$', 'mysite.polls.views.results'),

  460.     (r'^polls/(?P&lt;poll_id&gt;\d+)/vote/$', 'mysite.polls.views.vote'),

  461. )</p>

  462. <p></pre>

  463. <p>Le répertoire d'accès <tt class="docutils literal"><span class="pre">mysite.polls.views</span></tt> est dans chaque URL.</p>

  464. <p>Étant un cas courrant, le framework URLconf possède un raccourci pour les

  465. préfixes communs. Vous pouvez les factoriser et les placer en premier argument

  466. de <tt class="docutils literal"><span class="pre">patterns()</span></tt> de la façon suivante:</p>

  467. <pre class="literal-block">

  468. urlpatterns = patterns('mysite.polls.views',

  469.     (r'^polls/$', 'index'),

  470.     (r'^polls/(?P&lt;poll_id&gt;\d+)/$', 'detail'),

  471.     (r'^polls/(?P&lt;poll_id&gt;\d+)/results/$', 'results'),

  472.     (r'^polls/(?P&lt;poll_id&gt;\d+)/vote/$', 'vote'),

  473. )</p>

  474. <p></pre>

  475. <p>C'est identique au précédent formatage. C'est juste un peu plus propre.</p>

  476. </div>

  477. <div class="section">

  478. <h1><a id="d-coupler-urlconfs" name="d-coupler-urlconfs">Découpler URLconfs</a></h1>

  479. <p>En parlant de ça, prennons le temps de découpler les URLs de notre appli de

  480. sondage à partir de la configuration de notre projet Django. Les applis Django

  481. sont censées être « pluggables » -- ce qui signifie que chaque application peut

  482. être transférée sur une autre installation de Django avec le minimum de

  483. désagréments.</p>

  484. <p>Notre appli de sondage est pas mal découplée pour le moment grâce à la structure

  485. générée par <tt class="docutils literal"><span class="pre">python</span> <span class="pre">manage.py</span> <span class="pre">startapp</span></tt>. Une partie est néanmois liée aux

  486. paramètres de Django : l'URLconf.</p></p>

  487. <p>Nous avons édité les URLs dans <tt class="docutils literal"><span class="pre">mysite/urls.py</span></tt>, mais la conception des URLs

  488. d'une appli est spécifique à l'application, pas à l'installation de Django --

  489. déplaçons donc les URLs dans le dossier de notre appli.</p>

  490. 

  491. <p>Copiez le fichier <tt class="docutils literal"><span class="pre">mysite/urls.py</span></tt> vers <tt class="docutils literal"><span class="pre">mysite/polls/urls.py</span></tt>. Puis,

  492. modifiez <tt class="docutils literal"><span class="pre">mysite/urls.py</span></tt> pour retirer les URLs spécifiques au sondage et

  493. insérez un <tt class="docutils literal"><span class="pre">include()</span></tt>:</p>

  494. 

  495. <pre class="literal-block">

  496. 

  497. (r'^polls/', include('mysite.polls.urls')),

  498. </pre>

  499. 

  500. <p><tt class="docutils literal"><span class="pre">include()</span></tt>, permet simplement d'établir une référence à une autre URLconf.

  501. Notez l'absence de <tt class="docutils literal"><span class="pre">$</span></tt> (détection de fin de chaîne de caractère) dans

  502. l'expression rationnelle mais la présence d'un slash final. Lorsque Django

  503. rencontre un <tt class="docutils literal"><span class="pre">include()</span></tt>, il extrait tout ce qui suit l'URL détectée et

  504. l'envoie à l'URLconf inclus pour un traitement ultérieur.</p>

  505. 

  506. <p>Voici ce qu'il se passe si un utilisateur se rend sur « /polls/34/ » avec ce

  507. système :</p>

  508. 

  509. <ul class="simple">

  510. <li>Django va rencontrer <tt class="docutils literal"><span class="pre">'^polls/'</span></tt></li>

  511. <li>Il va enlever la partie reconnue (<tt class="docutils literal"><span class="pre">&quot;polls/&quot;</span></tt>) et envoyer le texte restant --

  512. 

  513. <tt class="docutils literal"><span class="pre">&quot;34/&quot;</span></tt> -- à l'URLconf monsite.polls.urls' pour un traitement ultérieur.</li>

  514. </ul>

  515. 

  516. <p>Maitenant que le découplage est effectué, il est nécessaire de découpler

  517. l'URLconf de 'monsite.polls.urls' en enlevant les préfixes « polls/ » à chaque

  518. ligne:</p>

  519. 

  520. <pre class="literal-block">

  521. urlpatterns = patterns('monsite.polls.views',

  522.     (r'^$', 'index'),

  523.     (r'^(?P&lt;poll_id&gt;\d+)/$', 'detail'),

  524.     (r'^(?P&lt;poll_id&gt;\d+)/results/$', 'results'),

  525.     (r'^(?P&lt;poll_id&gt;\d+)/vote/$', 'vote'),

  526. )

  527. </pre>

  528. 

  529. <p>L'idée derrière <tt class="docutils literal"><span class="pre">include()</span></tt> et le découplage d'URLconf est de faciliter

  530. l'aspect plug-and-play des URLs. Maintenant que les sondages ont leur propre

  531. URLconf, ils peuvent être placés à la suite de « /polls », ou de « /fun_polls »,

  532. ou de « /content/polls », ou de n'importe quelle URL, et l'appli sera toujours

  533. fonctionnelle.</p>

  534. 

  535. <p>Toute l'appli de sondage se base sur des URL relatives, non sur des URLs

  536. absolues.</p>

  537. 

  538. <p>Lorsque vous avez assimilé l'écriture des vues, lisez la

  539. <a class="reference" href="https://larlet.fr/david/biologeek/archives/20060617-redaction-de-votre-premiere-appli-django-partie-4-conception-d-un-formulaire-et-vues-generiques/">partie 4 de ce tutoriel</a> de façon à en apprendre plus sur la génération de

  540. formulaires et les vues génériques.</p>

  541. 

  542. <p>Vous pouvez maintenant retourner à la <a class="reference" href="https://larlet.fr/david/biologeek/archives/20060617-traduction-francaise-de-la-documentation-de-django-le-framework-web-python/">page d'accueil des traductions de la

  543. documentation de Django</a>.</p>

  544. 

  545. <p>Cette traduction correspond à la révision 3589 (post 0.95).</p>

  546. 

  547. </div>

  548.       </div>

  549.     </article>

  550.     <footer>

  551.       <h6 property="schema:datePublished">— 17/06/2006</h6>

  552.     </footer>

  553.   </section>

  554.   <section>

  555.     <div>

  556.       <h3>Articles peut-être en rapport</h3>

  557.       <ul>

  558.         <li><a href="/david/biologeek/archives/20060815-le-langage-de-template-django-pour-les-auteurs-de-templates/" title="Accès à Le langage de template Django : Pour les auteurs de templates">Le langage de template Django : Pour les auteurs de templates</a></li>

  559.         <li><a href="/david/biologeek/archives/20060715-comparaison-de-turbogears-et-django-deux-frameworks-web-python/" title="Accès à Comparaison de TurboGears et Django, deux frameworks web Python">Comparaison de TurboGears et Django, deux frameworks web Python</a></li>

  560.         <li><a href="/david/biologeek/archives/20060617-redaction-de-votre-premiere-appli-django-partie-4-conception-d-un-formulaire-et-vues-generiques/" title="Accès à Rédaction de votre première appli Django, partie 4 : Conception d&#39;un formulaire et vues génériques">Rédaction de votre première appli Django, partie 4 : Conception d&#39;un formulaire et vues génériques</a></li>

  561.       </ul>

  562.     </div>

  563.   </section>

  564.   <section>

  565.     <div id="comments">

  566.       <h3>Commentaires</h3>

  567.       

  568. <div class="comment" typeof="schema:UserComments">

  569.     <p class="comment-meta">

  570.         <span class="comment-author" property="schema:creator">David</span> le <span class="comment-date" property="schema:commentTime">19/07/2006</span> :

  571.     </p>

  572.     <div class="comment-content" property="schema:commentText">

  573.         <p>Tu as laissé un morceau d'anglais dans la partie erreur 500 :-)</p>

  574.     </div>

  575. </div>

  576. <div class="comment" typeof="schema:UserComments">

  577.     <p class="comment-meta">

  578.         <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">19/07/2006</span> :

  579.     </p>

  580.     <div class="comment-content" property="schema:commentText">

  581.         <p>En effet, merci c'est corrigé :)</p>

  582.     </div>

  583. </div>

  584. <div class="comment" typeof="schema:UserComments">

  585.     <p class="comment-meta">

  586.         <span class="comment-author" property="schema:creator">gigi</span> le <span class="comment-date" property="schema:commentTime">04/01/2007</span> :

  587.     </p>

  588.     <div class="comment-content" property="schema:commentText">

  589.         <p>Copiez le fichier mysite/urls.py vers mysite/polls/urls.py. Puis, modifiez mysite/urls.py pour retirer les URLs spécifiques au sondage et insérez un include():<br />

  590. <br />

  591. (r'^polls/', include('mysite.polls.urls')),<br />

  592. <br />

  593. à remplacer par : <br />

  594. <br />

  595. Copiez le fichier mysite/urls.py vers mysite/polls/urls.py. Puis, modifiez mysite/urls.py comme indiquer ci-dessous<br />

  596. <br />

  597. from django.conf.urls.defaults import *<br />

  598. <br />

  599. urlpatterns = patterns('',<br />

  600.      (r'', include('mysite.polls.urls')),<br />

  601. )</p>

  602.     </div>

  603. </div>

  604. <div class="comment" typeof="schema:UserComments">

  605.     <p class="comment-meta">

  606.         <span class="comment-author" property="schema:creator">cgasmi</span> le <span class="comment-date" property="schema:commentTime">24/05/2007</span> :

  607.     </p>

  608.     <div class="comment-content" property="schema:commentText">

  609.         <p>il y a une petite erreur de traduction:<br />

  610. une requête vers <a href="http://www.exemple.com/monappli/?page=3," title="http://www.exemple.com/monappli/?page=3," rel="nofollow">www.exemple.com/monappli/...</a> l'URLconf va rechercher dans /myapp/.<br />

  611. <br />

  612. /myapp/ a la place de /monappli/<br />

  613. <br />

  614. Sinon merci pour cette doc, elle m'a beaucoup aider dans mon debut avec django.</p>

  615.     </div>

  616. </div>

  617. <div class="comment" typeof="schema:UserComments">

  618.     <p class="comment-meta">

  619.         <span class="comment-author" property="schema:creator">Raysuken</span> le <span class="comment-date" property="schema:commentTime">26/06/2007</span> :

  620.     </p>

  621.     <div class="comment-content" property="schema:commentText">

  622.         <p>Tres bon tuto pour commercer a utiliser le framework django !!<br />

  623. <br />

  624. Merci</p>

  625.     </div>

  626. </div>

  627. 

  628.     </div>

  629.   </section>

  630. 

  631.     

  632.     <footer>

  633.       <nav>

  634.         <p>

  635.           <small>

  636.             Je réponds quasiment toujours aux <a href="m&#x61;ilto:d&#x61;vid%40l&#x61;rlet&#46;fr" title="Envoyer un email">emails</a> (<a href="/david/signature/" title="Ma signature actuelle avec possibilité de chiffrement">signés</a>) et vous pouvez me rencontrer à Montréal. <span class="more-infos">N’hésitez pas à <a href="/david/log/" title="Être tenu informé des mises à jour">vous abonner</a> pour être tenu informé des publications récentes.</span>

  637.           </small>

  638.         </p>

  639.       </nav>

  640.     </footer>

  641.     

  642.   </div>

  643.   

  644.   <script src="/static/david/js/larlet-david-3ee43f.js" data-no-instant></script>

  645.   

  646.   <script data-no-instant>InstantClick.init()</script>

  647.   

  648. </body>

  649. </html>