Django 视图与网址进阶

Posted shaobobo

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Django 视图与网址进阶相关的知识，希望对你有一定的参考价值。

一 、在网页上做加减法

1. 采用 /add/?a=4&b=5 这样GET方法进行

1
2
3
django-admin.py startproject zqxt_views
cd zqxt_views
python manage.py startapp calc

 

自动生成目录大致如下（因不同的 Django 版本有一些差异，如果差异与这篇文章相关，我会主动提出来，没有说的，暂时可以忽略他们之间的差异，后面的教程也是这样做）：

 

1
2
3
4
5
6
7
8
9
10
11
12
13
zqxt_views/
├── calc
│   ├── __init__.py
│   ├── admin.py
│   ├── models.py
│   ├── tests.py
│   └── views.py
├── manage.py
└── zqxt_views
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

我们修改一下 calc/views.py文件

1
2
3
4
5
6
7
8
from django.shortcuts import render
from django.http import HttpResponse
 
def add(request):
    a = request.GET[‘a‘]
    b = request.GET[‘b‘]
    c = int(a)+int(b)
    return HttpResponse(str(c))

注：request.GET 类似于一个字典，更好的办法是用 request.GET.get(‘a‘, 0) 当没有传递 a 的时候默认 a 为 0

 

接着修改 zqxt_views/urls.py 文件，添加一个网址来对应我们刚才新建的视图函数。

Django 1.7.x 及以下的同学可能看到的是这样的：

1
2
3
4
5
6
7
8
9
10
11
12
from django.conf.urls import patterns, include, url
 
from django.contrib import admin
admin.autodiscover()
 
urlpatterns = patterns(‘‘,
    # Examples:
    url(r‘^add/$‘, ‘calc.views.add‘, name=‘add‘), # 注意修改了这一行
    # url(r‘^blog/‘, include(‘blog.urls‘)),
 
    url(r‘^admin/‘, include(admin.site.urls)),
)

Django 1.8.x及以上，Django 官方鼓励（或说要求）先引入，再使用。

1
2
3
4
5
6
7
8
9
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‘^admin/‘, admin.site.urls),
]

注意：低版本的 Django 也可以先引入，再使用

 

Django 2.0 版本的同学看下面（上面 Django 1.8 的在 2.0 中也可以用，是兼容的）

1
2
3
4
5
6
7
8
9
from django.contrib import admin
from django.urls import path
from calc import views as calc_views
 
 
urlpatterns = [
    path(‘add/‘, calc_views.add, name=‘add‘),  # new
    path(‘admin/‘, admin.site.urls),
]

我们打开开发服务器并访问

1
2
3
python manage.py runserver 8002
默认端口是 8000，上面使用了自定义端口 8002
如果提示 Error: That port is already in use. 我们可以在后面加上端口号8001，8888等

打开网址：http://127.0.0.1:8002/add/ 就可以看到

MultiValueDictKeyError at /add/

技术分享图片

 

这是因为我们并没有传值进去，我们在后面加上 ?a=4&b=5，即访问 http://127.0.0.1:8002/add/?a=4&b=5

就可以看到网页上显示一个 9，试着改变一下a和b对应的值试试看？

技术分享图片

技术分享图片

2. 采用 /add/3/4/ 这样的网址的方式

前面介绍的时候就说过 Django 支持优雅的网址

我们接着修改 calc/views.py文件，再新定义一个add2 函数，原有部分不再贴出

1
2
3
def add2(request, a, b):
    c = int(a) + int(b)
    return HttpResponse(str(c))

接着修改 zqxt_views/urls.py 文件，再添加一个新的 url

Django 1.7.x 及以下：

1
    url(r‘^add/(d+)/(d+)/$‘, ‘calc.views.add2‘, name=‘add2‘),

Django 1.8.x － Django 1.11.x：

1
    url(r‘^add/(d+)/(d+)/$‘, calc_views.add2, name=‘add2‘),

Django 2.0 及以上：

1
    path(‘add/<int:a>/<int:b>/‘, calc_views.add2, name=‘add2‘),

我们可以看到网址中多了 (d+), 正则表达式中 d 代表一个数字，+ 代表一个或多个前面的字符，写在一起 d+ 就是一个或多个数字，用括号括起来的意思是保存为一个子组（更多知识请参见Python 正则表达式），每一个子组将作为一个参数，被 views.py 中的对应视图函数接收。

我们再访问 http://127.0.0.1:8002/add/4/5/ 就可以看到和刚才同样的效果，但是这回网址更优雅了

技术分享图片

二、URL name详解

教程中所有的文件，没有特别说明的，都是以 utf8 格式编码的，请养成这个习惯。

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‘ 是用来干什么的呢？

简单说，name 可以用于在 templates, models, views ……中得到对应的网址，相当于“给网址取了个名字”，只要这个名字不变，网址变了也能通过名字获取到。

 

为了进一步弄清这个问题，我们先建一个首页的视图和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 中写入以下内容（保存时用 utf8 编码）

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/ 可以看到

 

技术分享图片

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

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

如果这样写“死网址”，会使得在改了网址（正则）后，模板（template)，视图(views.py，比如用于URL跳转)，模型(models.py，获取记录访问地址等）用了此网址的，都必须进行相应的更改，修改的代价很大，一不小心，有的地方没改过来，就不能用了。

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

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

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

1
python manage.py shell

 

1
2
3
4
5
6
7
8
>>> from django.core.urlresolvers import reverse  # django 1.4.x - django 1.10.x
或者
>>> from django.urls import reverse  # Django 1.10.x - Django 2.x 新的，更加规范了
 
>>> 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/

用在 views.py 或 models.py 等地方的 reverse函数，同样会根据 name 对应的url获取到新的网址。

想要改网址的时候，修改 urls.py 中的正则表达式部分（url 参数第一部分），name 不变的前提下，其它地方都不需要修改。

 

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

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

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

1
2
3
4
5
6
7
8
9
from django.http import HttpResponseRedirect
from django.core.urlresolvers import reverse  # Django 1.4.x - Django 1.10.x
#  from django.urls import reverse  # Django 1.10.x - Django 2.x
 
 
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/ 了

以上是关于Django 视图与网址进阶的主要内容，如果未能解决你的问题，请参考以下文章

Django 视图与网址进阶

Django 视图与网址

Django视图与网址

如何从片段内的列表视图打开链接网址？

Django 视图与URL进阶

Django的视图与网址之加法计算