Changes between Version 1 and Version 2 of DocPtTutorial3

Timestamp:

Nov 7, 2006, 7:13:21 PM (18 years ago)

Author:

marvinware2005@…

Comment:

--

DocPtTutorial3

@@ -64 +64 @@
     (regular expression, Python callback function [, optional dictionary])
 
+Django começa a procura na primeira expressão e continua pela lista, comarpando a URL requisitada com cada expressão até que encontre uma coincida.
 
+Quando é encontrada tal expressão, Django executa a função de callback com um objeto ``HTTPRequest`` como primeiro argumento, e qualquer valor “capturado” da expressão regular como argumentos chave, e opcionalmente, qualquer argumento do dicionário opcional (o terceiro item da tupla).
+
+Para mais detalhe sobre objetos ``HTTPRequest``, veja `request and response documentation`_.
+Para mais detalhes sobre URLconfs, veja `URLconf documentation`_.
+
+Quando você executou ``python manage.py startproject mysite`` no começo do Tutorial 1, foi criado um URLconf padrão, em ``mysite/urls.py``. Além disso, foi automaticamente setado sua configuração ``ROOT_URLCONF`` para apontar para esse arquivo::
+
+    ROOT_URLCONF = 'mysite.urls'
+
+É hora de um exemplo. Edite ``mysite/urls.py`` para que fique da seguinte forma::
+
+    from django.conf.urls.defaults import *
+
+    urlpatterns = patterns('',
+        (r'^polls/$', 'mysite.polls.views.index'),
+        (r'^polls/(?P<poll_id>\d+)/$', 'mysite.polls.views.detail'),
+        (r'^polls/(?P<poll_id>\d+)/results/$', 'mysite.polls.views.results'),
+        (r'^polls/(?P<poll_id>\d+)/vote/$', 'mysite.polls.views.vote'),
+    )
+
+Uma pequena revisão. Quando alguém requisita uma página do se site – diga-se “/polls/23/”, Django vai carregar esse módulo Python, porque ele está apontado pela configuração ``ROOT_URLCONF``. Então, é encontrado uma variável chamada ``urlpatterns`` e realiza uma busca pela expressão regular. Quando é encontrada tal expressão regular - ``r'^polls/(?P<poll_id>\d+)/$'`` - é então carregado o pacote/modulo Python associado: ``mysite.polls.views.detail``. Isso corresponde à função ``detail()`` em ``mysite/polls/views.py``. Finalmente, é chamda a função ``detail()`` da seguinte forma::
+
+    detail(request=<HttpRequest object>, poll_id='23')
+
+A parte ``poll_id='23'`` vem de ``(?P<poll_id>\d+)``. Usando parentes em volta de um padrão “captura” o texto correspondente por aquele padrao e envia esse texto como argumento para a função da view; o ``?P<poll_id>`` define o nome que será usado para identificar o padrão; e ``\d+`` é uma expressão regular que indica uma seqüência de dígitos (ou seja, um número).
+
+Como os padrões de URL são expressões regulares, não há um limite no que você pode fazer com eles. E não há a necessidade de adicionar “URL cruft” como `.php`` - ao menos que você tenha um “belo” senso de humor, e queira fazer algo como::
+
+    (r'^polls/latest\.php$', 'mysite.polls.views.index'),
+
+Mas não o faça. É horrível.
+
+Note que essas expressões regulares não procuram por parâmetros GET e POST, ou pelo domínio do site. Por exemplo, em uma requisição para ``http://www.example.com/myapp/``, o URLconf irá, procurar por ``/myapp/``. Em uma requisição para ``http://www.example.com/myapp/?page=3``, o URLconf irá procurar por ``/myapp/``.
+
+.. _request and response documentation: http://www.djangoproject.com/documentation/request_response/
+.. _URLconf documentation: http://www.djangoproject.com/documentation/url_dispatch/
 
 }}}