Django URL name详解

我们基于上一节的代码来开始这一节的内容。

上节源代码：zqxt_views(django 1.4 - django 1.10).zip [更新于 2016-09-06 00:13:23]

1. 打开 zqxt_views/urls.py

1
2
3
4
5
6
7
8
9
10
from django.conf.urls import url
from django.contrib import admin
from calc import views as calc_views
 
 
urlpatterns = [
    url(r'^add/$', calc_views.add, name='add'),
    url(r'^add/(\d+)/(\d+)/$', calc_views.add2, name='add2'),
    url(r'^admin/', admin.site.urls),
]


url(r'^add/$', calc_views.add, name='add'), 这里的 name='add' 是用来干什么的呢？

为了弄清这个问题，我们先建一个首页的视图和url


2. 修改 calc/views.py

1
2
3
4
5
6
7
8
9
from django.http import HttpResponse
from django.shortcuts import render
 
 
def index(request):
    return render(request, 'home.html')
 
 
...此处省去一些代码

render 是渲染模板，不懂先照着打就好。


3. 将 'calc' 这个 app 加入到 zqxt_views/settings.py 中

1
2
3
4
5
6
7
8
9
10
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
 
    'calc',
]

这样，使用render的时候，Django 会自动找到 INSTALLED_APPS 中列出的各个 app 下的 templates 中的文件。

小提示，DEBUG=True 的时候，Django 还可以自动找到 各 app 下 static 文件夹中的静态文件（js，css，图片等资源），方便开发哦，后面有专门的章节会讲这些。


4. 我们在 calc 这个 app 中新建一个 templates 文件夹，在templates中新建一个 home.html （关于模板更详细的可以稍后看下一节）

文件 calc/templates/home.html 中写入以下内容

1
2
3
4
5
6
7
8
9
10
11
<!DOCTYPE html>
<html>
<head>
    <title>自强学堂</title>
</head>
<body>
 
<a href="/add/4/5/">计算 4+5</a>
 
</body>
</html>


修改 zqxt_views/urls.py

1
2
3
4
5
6
7
8
...此处省去一些代码
 
urlpatterns = [
    url(r'^$', calc_views.index, name='home'),
    url(r'^add/$', calc_views.add, name='add'),
    url(r'^add/(\d+)/(\d+)/$', calc_views.add2, name='add2'),
    url(r'^admin/', admin.site.urls),
]

运行开发服务器，我们访问 http://127.0.0.1:8000/ 可以看到


django-url-name-1.png

我们计算加法的时候用的是 /add/4/5/ ，后来需求发生变化，比如我们又想改成 /4_add_5/这样的格式，但是我们在网页中，代码中很多地方都写死的是 

1
<a href="/add/4/5/">计算 4+5</a>

这样就导致当我们改了 urls.py 后，对应的模板，甚至还视图中的跳转，以及 models.py 中也可能有获取网址的地方。

每个地方都要改，修改的代价很大，一不小心，有的地方没改过来，那个就不能用了。


那么有没有更优雅的方式来解决这个问题呢？当然答案是肯定的。

我们先说一下如何用 Python 代码获取对应的网址（可以用在 views.py，models.py等各种需要转换得到网址的地方）：

我们在终端上输入(推荐安装 bpython, 这样Django会用 bpython的 shell)

1
python manage.py shell

1
2
3
4
5
>>> from django.core.urlresolvers import reverse
>>> reverse('add2', args=(4,5))
u'/add/4/5/'
>>> reverse('add2', args=(444,555))
u'/add/444/555/'

reverse 接收 url 中的 name 作为第一个参数，我们在代码中就可以通过 reverse() 来获取对应的网址（这个网址可以用来跳转，也可以用来计算相关页面的地址），只要对应的 url 的name不改，就不用改代码中的网址。

在网页模板中也是一样，可以很方便的使用。

1
2
3
4
5
6
7
不带参数的：
{% url 'name' %}
带参数的：参数可以是变量名
{% url 'name' 参数 %}
 
例如：
<a href="{% url 'add2' 4 5 %}">link</a>

上面的代码渲染成最终的页面是

1
<a href="/add/4/5/">link</a>

这样就可以通过 {% url 'add2' 4 5 %} 获取到对应的网址 /add/4/5/


当 urls.py 进行更改，前提是不改 name（这个参数设定好后不要轻易改），获取的网址也会动态地跟着变，比如改成：

1
url(r'^new_add/(\d+)/(\d+)/$', calc_views.add2, name='add2'),


注意看重点 add 变成了 new_add，但是后面的 name='add2' 没改，这时 {% url 'add2' 4 5 %} 就会渲染对应的网址成 /new_add/4/5/

reverse 函数也是一样，获取的时候会跟着变成新的网址，这样，在想改网址时只需要改 urls.py 中的正则表达式（url 参数第一部分），其它地方都“自动”跟着变了，是不是这样更好呢？


另外，比如用户收藏夹中收藏的URL是旧的，如何让以前的 /add/3/4/自动跳转到现在新的网址呢？

要知道Django不会帮你做这个，这个需要自己来写一个跳转方法：

具体思路是，在 views.py 写一个跳转的函数：

1
2
3
4
5
6
7
8
from django.http import HttpResponseRedirect
from django.core.urlresolvers import reverse
 
 
def old_add2_redirect(request, a, b):
    return HttpResponseRedirect(
        reverse('add2', args=(a, b))
    )

urls.py中：

1
2
    url(r'^add/(\d+)/(\d+)/$', calc_views.old_add2_redirect),
    url(r'^new_add/(\d+)/(\d+)/$', calc_views.add2, name='add2'),

这样，假如用户收藏夹中有 /add/4/5/ ，访问时就会自动跳转到新的 /new_add/4/5/ 了


开始可能觉得直接写网址简单，但是用多了你一定会发现，用“死网址”的方法很糟糕。

posted @ 2016-11-20 12:20  老茶客96  阅读(494)  评论(0)  编辑  收藏  举报