视图:
视图一般都写在app
的views.py
中。并且视图的第一个参数永远都是request
(一个HttpRequest)对象。这个对象存储了请求过来的所有信息,包括携带的参数以及一些头部信息等。在视图中,一般是完成逻辑相关的操作。比如这个请求是添加一篇博客,那么可以通过request来接收到这些数据,然后存储到数据库中,最后再把执行的结果返回给浏览器。视图函数的返回结果必须是HttpResponseBase
对象或者子类的对象。示例代码如下:
from django.http import HttpResponse
def book_list(request):
return HttpResponse("书籍列表!")
这里的 HttpResponse 能起到一个html文本的效果 ,参数是html标签在浏览器中能被渲染
URL映射:
视图写完后,要与URL进行映射,也即用户在浏览器中输入什么url
的时候可以请求到这个视图函数。在用户输入了某个url
,请求到我们的网站的时候,django
会从项目的urls.py
文件中寻找对应的视图。在urls.py
文件中有一个urlpatterns
变量,以后django
就会从这个变量中读取所有的匹配规则。匹配规则需要使用django.urls.path
函数进行包裹,这个函数会根据传入的参数返回URLPattern
或者是URLResolver
的对象。示例代码如下:
1-path('admin/',admin.site.urls) 此路由是Django自带的后台管理界面,创建项目便生成
2-用path写路由与使用url写路由不同处在于 第一个参数url中用正则re写成 所以正则表达式要写的清楚,不能让式子匹配多个路径,写的不清楚会报错的。
注意:路由在app中创建urls.py文件写入视图函数与前端关联的路由,而app与项目交互的路由写法如下>>项目中的urls
为什么使用namespace:
由于name没有作用域,Django在反解URL时,会在项目全局顺序搜索,当查找到第一个name指定URL时,立即返回
我们在开发项目时,会经常使用name属性反解出URL,当不小心定义相同的name时,可能会导致URL反解错误,为了避免这种事情发生,引入了命名空间,此时使用namespace解决。
URL中添加参数:
有时候,url
中包含了一些参数需要动态调整。比如简书某篇文章的详情页的url,是https://www.jianshu.com/p/a5aab9c4978e
后面的a5aab9c4978e
就是这篇文章的id
,那么简书的文章详情页面的url就可以写成https://www.jianshu.com/p/<id>
,其中id就是文章的id。那么如何在django
中实现这种需求呢。这时候我们可以在path
函数中,使用尖括号的形式来定义一个参数。比如我现在想要获取一本书籍的详细信息,那么应该在url
中指定这个参数。
from django.contrib import admin
from django.urls import path
from book import views
urlpatterns = [
path('admin/', admin.site.urls),
path('book/',views.book_list),
path('book/<book_id>/',views.book_detail)
]
参数:常用来写路径连接到具体的详情页,也可根据参数在搜索框中查找具体的内容。
path函数:
path
函数的定义为:path(route,view,name=None,kwargs=None)
。以下对这几个参数进行讲解。
-
route
参数:url
的匹配规则。这个参数中可以指定url
中需要传递的参数,比如在访问文章详情页的时候,可以传递一个id
。传递参数是通过<>
尖括号来进行指定的。并且在传递参数的时候,可以指定这个参数的数据类型,比如文章的id
都是int
类型,那么可以这样写<int:id>
,以后匹配的时候,就只会匹配到id
为int
类型的url
,而不会匹配其他的url
,并且在视图函数中获取这个参数的时候,就已经被转换成一个int
类型了。其中还有几种常用的类型:- str:非空的字符串类型。默认的转换器。但是不能包含斜杠。
- int:匹配任意的零或者正数的整形。到视图函数中就是一个int类型。
- slug:由英文中的横杠
-
,或者下划线_
连接英文字符或者数字而成的字符串。 - uuid:匹配
uuid
字符串。 - path:匹配非空的英文字符串,可以包含斜杠。
-
view
参数:可以为一个视图函数或者是类视图.as_view()
或者是django.urls.include()
函数的返回值。 -
name
参数:这个参数是给这个url
取个名字的,这在项目比较大,url
比较多的时候用处很大。 -
kwargs
参数:有时候想给视图函数传递一些额外的参数,就可以通过kwargs
参数进行传递。这个参数接收一个字典。传到视图函数中的时候,会作为一个关键字参数传过去。比如以下的url
规则:from django.urls import path from . import views urlpatterns = [ path('blog/<int:year>/', views.year_archive, {'foo': 'bar'}), ]
那么以后在访问
blog/1991/
这个url的时候,会将foo=bar
作为关键字参数传给year_archive
函数。
re_path函数:
有时候我们在写url匹配的时候,想要写使用正则表达式来实现一些复杂的需求,那么这时候我们可以使用re_path
来实现。re_path
的参数和path
参数一模一样,只不过第一个参数也就是route
参数可以为一个正则表达式。
一些使用re_path
的示例代码如下:
from django.urls import path, re_path
from . import views
urlpatterns = [
path('articles/2003/', views.special_case_2003),
re_path(r'articles/(?P<year>[0-9]{4})/', views.year_archive),
re_path(r'articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/', views.month_archive),
re_path(r'articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<slug>[\w-_]+)/', views.article_detail),
]
以上例子中我们可以看到,所有的route
字符串前面都加了一个r
,表示这个字符串是一个原生字符串。在写正则表达式中是推荐使用原生字符串的,这样可以避免在python
这一层面进行转义。而且,使用正则表达式捕获参数的时候,是用一个圆括号进行包裹,然后这个参数的名字是通过尖括号<year>
进行包裹,之后才是写正则表达式的语法。
include函数:
在项目变大以后,经常不会把所有的url
匹配规则都放在项目的urls.py
文件中,而是每个app
都有自己的urls.py
文件,在这个文件中存储的都是当前这个app
的所有url
匹配规则。然后再统一注册到项目的urls.py
文件中。include
函数有多种用法,这里讲下两种常用的用法。
-
include(pattern,namespace=None)
:直接把其他app
的urls
包含进来。示例代码如下:from django.contrib import admin from django.urls import path,include urlpatterns = [ path('admin/', admin.site.urls), path('book/',include("book.urls")) ]
当然也可以传递
namespace
参数来指定一个实例命名空间,但是在使用实例命名空间之前,必须先指定一个应用命名空间。示例代码如下:# 主urls.py文件: from django.urls import path,include urlpatterns = [ path('movie/',include('movie.urls',namespace='movie')) ]
然后在
movie/urls.py
中指定应用命名空间。实例代码如下:from django.urls import path from . import views # 应用命名空间 app_name = 'movie' urlpatterns = [ path('',views.movie,name='index'), path('list/',views.movie_list,name='list'), ]
-
include(pattern_list)
:可以包含一个列表或者一个元组,这个元组或者列表中又包含的是path
或者是re_path
函数。 -
include((pattern,app_namespace),namespace=None)
:在包含某个app
的urls
的时候,可以指定命名空间,这样做的目的是为了防止不同的app
下出现相同的url
,这时候就可以通过命名空间进行区分。示例代码如下:from django.contrib import admin from django.urls import path,include urlpatterns = [ path('admin/', admin.site.urls), path('book/',include(("book.urls",'book')),namespace='book') ]
但是这样做的前提是已经包含了应用命名空间。即在
myapp.urls.py
中添加一个和urlpatterns
同级别的变量app_name
。
自定义URL转换器:
之前已经学到过一些django内置的url
转换器,包括有int
、uuid
等。有时候这些内置的url转换器
并不能满足我们的需求,因此django给我们提供了一个接口可以让我们自己定义自己的url转换器。
自定义url
转换器按照以下五个步骤来走就可以了:
- 定义一个类。
- 在类中定义一个属性
regex
,这个属性是用来保存url
转换器规则的正则表达式。 - 实现
to_python(self,value)
方法,这个方法是将url
中的值转换一下,然后传给视图函数的。 - 实现
to_url(self,value)
方法,这个方法是在做url
反转的时候,将传进来的参数转换后拼接成一个正确的url。 - 将定义好的转换器,注册到django中。
# 1. 定义一个类
class FourDigitYearConverter:
# 2. 定义一个正则表达式
regex = '[0-9]{4}'
# 3. 定义to_python方法
def to_python(self, value):
return int(value)
# 4. 定义to_url方法
def to_url(self, value):
return '%04d' % value
# 5. 注册到django中
from django.urls import register_converter
register_converter(converters.FourDigitYearConverter, 'yyyy')
urlpatterns = [
path('articles/2003/', views.special_case_2003),
# 使用注册的转换器
path('articles/<yyyy:year>/', views.year_archive),
...
]