Django URL

url–>视图函数–>视图

path(‘book/’,views.book_list) :左侧为url , 右侧为视图函数

Django URL

第一个Django项目剖析(1)

创建 Django 项目: 用命令行的方式:

  1. 创建项目:打开终端,使用命令: django-admin startproject
    [项目名称] 即可创建。比 如: django-admin startproject first_project 。
  2. 创建应用(app):一个项目类似于是一个架子,但是真正起作用的还是 app 。在终端进入到 项目所在的路径,然后执行 python manage.py startapp [app名称] 创建一个app

用 pycharm 新建一个 Django 项目,新建项目的截图如下:
在这里插入图片描述

第一个Django项目剖析(2)

运行Django项目:

  1. 通过命令行的方式: python manage.py runserver 。这样可以在本地访问你的网站,默认端 口号是 8000 ,这样就可以在浏览器中通过 http://127.0.0.1:8000/ 来访问你的网站啦。如 果想要修改端口号,那么在运行的时候可以指定端口号, python manage.py runserver 9000 这样就可以通过 9000 端口来访问啦。另外,这样运行的项目只能在本机上能访问,如 果想要在其他电脑上也能访问本网站,那么需要指定 ip 地址为 0.0.0.0 。示例为: python manage.py runserver 0.0.0.0:8000
  2. 通过 pycharm 运行。直接点击右上角的绿色箭头按钮即可运行。

项目结构介绍:

  1. manage.py :以后和项目交互基本上都是基于这个文件。一般都是在终端输入 python manage.py [子命令] 。可以输入 python manage.py help 看下能做什么事情。除非你知道你自 己在做什么,一般情况下不应该编辑这个文件。
  2. settings.py :本项目的设置项,以后所有和项目相关的配置都是放在这个里面。
  3. urls.py :这个文件是用来配置URL路由的。比如访问 http://127.0.0.1/news/ 是访问新闻 列表页,这些东西就需要在这个文件中完成。
  4. wsgi.py :项目与 WSGI 协议兼容的 web 服务器入口,部署的时候需要用到的,一般情况下 也是不需要修改的

Django的项目规范

project和app的关系:
app 是 django 项目的组成部分。一个 app 代表项目中的一个模块,所有 URL 请求的响应都是由 app 来处理。比如豆瓣,里面有图书,电影,音乐,同城等许许多多的模块,如果站 在 django 的角度来看,图书,电影这些模块就是
app ,图书,电影这些 app 共同组成豆瓣这个 项目。因此这里要有一个概念, django 项目由许多 app 组成,一个 app
可以被用到其他项 目, django 也能拥有不同的 app 。

python manage.py startapp [app名称] 创建一个app
实例:  python manage.py startapp cv

创建app之后要进行注册,在settings中

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

DEBUG模式详解

在settings中有DEBUG=TRUE和FALSE的选择
在开发的时候设置为ture 部署的时候设置false

视图函数介绍

视图:
视图一般都写在 app 的 views.py 中。并且视图的第一个参数永远都是 request (一个 HttpRequest)对象。
这个对象存储了请求过来的所有信息,包括携带的参数以及一些头部信息 等。

在视图中,一般是完成逻辑相关的操作。

比如这个请求是添加一篇博客,那么可以通过 request来接收到这些数据,然后存储到数据库中,最后再把执行的结果返回给浏览器。

视图函数的返回结果必须是 HttpResponseBase 对象或者子类的对象。

示例代码如下:

from django.http import HttpResponse 
def book_list(request): 
    return HttpResponse("书籍列表!")

URL映射补充

从ROOT_URLCONF中去寻找url
在这里插入图片描述

视图写完后,要与URL进行映射,也即用户在浏览器中输入什么 url 的时候可以请求到这个视图 函数。在用户输入了某个 url ,请求到我们的网站的时候, django 会从项目的 urls.py 文件中 寻找对应的视图。
在 urls.py 文件中有一个 urlpatterns 变量,以后 django 就会从这个变量中 读取所有的匹配规则。
匹配规则需要使用 django.urls.path 函数进行包裹,这个函数会根据传入 的参数返回 URLPattern 或者是 URLResolver 的对象。示例代码如下:

urlpatterns = [
    path('admin/', admin.site.urls),
    path('',index)

url中传递参数给视图函数

URL中添加参数: 有时候, url 中包含了一些参数需要动态调整。比如简书某篇文章的详情页的url, 是 https://www.jianshu.com/p/a5aab9c4978e 后面的 a5aab9c4978e 就是这篇文章的 id ,那么简 书的文章详情页面的url就可以写成 https://www.jianshu.com/p/ ,其中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) ]

而 views.py 中的代码如下:

def book_detail(request,book_id): 
    text = "您输入的书籍的id是:%s" % book_id 
    return HttpResponse(text)

当然,也可以通过查询字符串的方式传递一个参数过去。示例代码如下:

urlpatterns = [ 
path('admin/', admin.site.urls), 
path('book/',views.book_list), 
path('book/detail/',views.book_detail) ]

在 views.py 中的代码如下:

def book_detail(request): 
    book_id = request.GET.get("id") 
    text = "您输入的书籍id是:%s" % book_id 
    return HttpResponse(text)

以后在访问的时候就是通过 /book/detail/?id=1 即可将参数传递过去。

Django内置的URL转换器

path函数:

path 函数的定义为: path(route,view,name=None,kwargs=None) 。以下对这几个参数进行讲解。

  1. route 参数: url 的匹配规则。这个参数中可以指定 url 中需要传递的参数,比如在访问文 章详情页的时候,可以传递一个 id 。传递参数是通过 <> 尖括号来进行指定的。并且在传递 参数的时候,可以指定这个参数的数据类型,比如文章的 id 都是 int 类型,那么可以这样 写 int:id ,以后匹配的时候,就只会匹配到 id 为 int 类型的 url ,而不会匹配其他 的 url
    ,并且在视图函数中获取这个参数的时候,就已经被转换成一个 int 类型了。
    其中还 有几种常用的类型:
    str:非空的字符串类型。默认的转换器。但是不能包含斜杠。
    int:匹配任意的零或者正数的整形。到视图函数中就是一个int类型。
    slug:由英文中的横杠 - ,或者下划线 _ 连接英文字符或者数字而成的字符串。 uuid:匹配 uuid 字符串。
    path:匹配非空的英文字符串,可以包含斜杠。

  2. view 参数:可以为一个视图函数或者是 类视图.as_view() 或者是 django.urls.include() 函 数的返回值。

  3. name 参数:这个参数是给这个 url 取个名字的,这在项目比较大, url 比较多的时候用处很大。

url传递参数:

一 url映射:

  1. 为什么会去urls.py文件中寻找映射呢?
    是因为在settings.py文件中配置了ROOT_URLCONFurls.py。所有django会去urls.py中寻找。
  2. urls.py中我们所有的映射,都应该放在urlpatterns这个变量中。
  3. 所有的映射不是随便写的,而是使用path函数或者是re_path函数进行包装的。

二 url传参数:

  1. 采用在url中使用变量的方式:在path的第一个参数中,使用<参数名>的方式可以传递参数。然后在视图函数中也要写一个参数,视图函数中的参数必须和url中的参数名称保持一致,不然就找不到这个参数。另外,url中可以传递多个参数。
  2. 采用查询字符串的方式:在url中,不需要单独的匹配查询字符串的部分。只需要在视图函数中使用request.GET.get('参数名称')的方式来获取。示例代码如下:
    def author_detail(request):
        author_id = request.GET['id']
        text = '作者的id是:%s' % author_id
        return HttpResponse(text)
    
    因为查询字符串使用的是GET请求,所以我们通过request.GET来获取参数。并且因为GET是一个类似于字典的数据类型,所有获取值跟字典的方式都是一样的。
urlpatterns = [
    path('admin/', admin.site.urls),
    path('',index),
    path('book/',views.book),
    # /book/detail/1/
    path("book/detail/<book_id>/<category_id>/",views.book_detail),
    path('book/author/',views.author_detail),
    path("book/publisher/<path:publisher_id>/",views.publisher_detail)
]

book.views

from django.http import HttpResponse


def book(request):
    return HttpResponse("图书首页")

def book_detail(request,book_id,category_id):
    # 可以从数据库中根据book_id提取这个图书的信息
    text = "您获取的图书id是:%s,图书分类是%s" % (book_id,category_id)
    return HttpResponse(text)

def author_detail(request):
    author_id = request.GET['id']
    text = '作者的id是:%s' % author_id
    return HttpResponse(text)

def publisher_detail(request,publisher_id):
    text = '出版社的id是:%s' % publisher_id
    return HttpResponse(text)

三 url参数的转换器:

  1. str:除了斜杠/以外所有的字符都是可以的。
  2. int:只有是一个或者多个的阿拉伯数字。
  3. path:所有的字符都是满足的。
  4. uuid:只有满足uuid.uuid4()这个函数返回的字符串的格式。
  5. slug:英文中的横杆或者英文字符或者阿拉伯数字或者下划线才满足。

转换器格式 :<str:> <int:> <slug:> <path>

urls分层模块化

urls模块化:

如果项目变得越来越大。那么url会变得越来越多。如果都放在主urls.py文件中,那么将不太好管理。因此我们可以将每个app自己的urls放到自己的app中进行管理。一般我们会在app中新建一个urls.py文件用来存储所有和这个app相关的子url。
需要注意的地方:

  1. 应该使用include函数包含子urls.py,并且这个urls.py的路径是相对于项目的路径。示例代码如下:
    urlpatterns = [
        path('admin/', admin.site.urls),
        path('book',include('book.urls'))
    ]
    
  2. appurls.py中,所有的url匹配也要放在一个叫做urlpatterns的变量中,否则找不到。
  3. url是会根据主urls.py和app中的urls.py进行拼接的,因此注意不要多加斜杠。

include函数的用法:

  1. include(module,namespace=None):
    • module:子url的模块字符串。
    • namespace:实例命名空间。这个地方需要注意一点。如果指定实例命名空间,那么前提必须要先指定应用命名空间。也就是在子urls.py中添加app_name变量。
  2. include((pattern_list, app_namespace), namespace=None):include函数的第一个参数既可以为一个字符串,也可以为一个元组,如果是元组,那么元组的第一个参数是子urls.py模块的字符串,元组的第二个参数是应用命名空间。也就是说,应用命名空间既可以在子urls.py中通过app_name指定,也可以在include函数中指定。
  3. include(pattern_list):pattern_list是一个列表。这个列表中装的是path或者re_path函数。实例代码如下:
    path('movie/',include([
        path('',views.movie),
        path('list/',views.movie_list),
    ]))
    

url命名与反转url

url命名:

为什么需要url命名?

因为url是经常变化的。如果在代码中写死可能会经常改代码。给url取个名字,以后使用url的时候就使用他的名字进行反转就可以了,就不需要写死url了。

如何给一个url指定名称?

path函数中,传递一个name参数就可以指定。示例代码如下:

urlpatterns = [
    path('',views.index,name='index'),
    path('login/',views.login,name='login')
]

应用命名空间:

在多个app之间,有可能产生同名的url。这时候为了避免反转url的时候产生混淆,可以使用应用命名空间,来做区分。定义应用命名空间非常简单,只要在appurls.py中定义一个叫做app_name的变量,来指定这个应用的命名空间即可。示例代码如下:

# 应用命名空间
app_name = 'front'

urlpatterns = [
    path('',views.index,name='index'),
    path('login/',views.login,name='login')
]

以后在做反转的时候就可以使用应用命名空间:url名称的方式进行反转。示例代码如下:

login_url = reverse('front:login')

应用(app)命名空间和实例命名空间:

一个app,可以创建多个实例。可以使用多个url映射同一个app。所以这就会产生一个问题。以后在做反转的时候,如果使用应用命名空间,那么就会发生混淆。为了避免这个问题。我们可以使用实例命名空间。实例命名空间也是非常简单,只要在include函数中传递一个namespace变量即可。示例代码如下:

urlpatterns = [
    path('',include('front.urls')),
    # 同一个app下有两个实例
    path('cms1/',include('cms.urls',namespace='cms1')),
    path('cms2/',include('cms.urls',namespace='cms2')),
]

以后在做反转的时候,就可以根据实例命名空间来指定具体的url。示例代码如下:

def index(request):
    username = request.GET.get("username")
    if username:
        return HttpResponse('CMS首页')
    else:
        # 获取当前的命名空间
        current_namespace = request.resolver_match.namespace
        return redirect(reverse("%s:login"%current_namespace))

前后台都有index\login等
url命名与反转url

from django.urls import path
from . import views

# 应用命名空间
# 应用命名空间的变量叫做app_name
app_name = 'front'

urlpatterns = [
    path('',views.index,name='index'),   # name url命名
    path('signin/',views.login,name='login')  # 如果要修改url 只需要修改signin部分
]
from django.http import HttpResponse
from django.shortcuts import redirect,reverse

def index(request):
    # ?username=xxx
    username = request.GET.get('username')
    if username:
        return HttpResponse('前台首页')
    else:
        # signin
        # signup
        login_url = reverse('front:login') # 反转 == signin(指定了命名空间)
        print('='*30)
        print(login_url)
        print('='*30)
        return redirect(login_url)

def login(request):
    return HttpResponse("前台登录页面")

为什么用到命名空间

path('',views.index,name='index'),   # name url命名

因为前后端都有可能用到login和index等命名(name),反转时可能遇到问题

url反转: 之前我们都是通过url来访问视图函数。有时候我们知道这个视图函数,但是想反转回他的url。这 时候就可以通过 reverse 来实现。示例代码如下:

 reverse("list") 
 > /book/list/ 

如果有应用命名空间或者有实例命名空间,那么应该在反转的时候加上命名空间。
示例代码如下:

 reverse('book:list') 
 > /book/list/ 

如果这个url中需要传递参数,那么可以通过 kwargs 来传递参数。示例代码如下:

 reverse("book:detail",kwargs={"book_id":1}) 
 > /book/detail/1 

因为 django 中的 reverse 反转 url 的时候不区分 GET 请求和 POST 请求,因此不能在反转的时 候添加查询字符串的参数。如果想要添加查询字符串的参数,只能手动的添加。示例代码如下:

  login_url = reverse('login') + "?next=/"

应用命名空间和实例命名空间

include函数详解

在项目变大以后,经常不会把所有的 url 匹配规则都放在项目的 urls.py 文件中,而是每 个 app 都有自己的 urls.py 文件,在这个文件中存储的都是当前这个 app 的所有 url 匹配规 则。然后再统一注册到项目的 urls.py 文件中。 include 函数有多种用法,这里讲下两种常用的 用法。

  1. 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'), 
 ]
  1. include(pattern_list) :可以包含一个列表或者一个元组,这个元组或者列表中又包含的 是 path 或者是 re_path 函数。

  2. 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') 
]

re_path函数详解

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_archiv e), re_path(r'articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<slug>[\w-_]+)/', views.article_detail),
 ]

以上例子中我们可以看到,所有的 route 字符串前面都加了一个 r ,表示这个字符串是一个原生 字符串。在写正则表达式中是推荐使用原生字符串的,这样可以避免在 python 这一层面进行转 义。而且,使用正则表达式捕获参数的时候,是用一个圆括号进行包裹,然后这个参数的名字是通 过尖括号 进行包裹,之后才是写正则表达式的语法。

reverse函数补充

reverse笔记:

  1. 如果在反转url的时候,需要添加参数,那么可以传递kwargs参数到revers函数中。示例代码如下:
    detail_url = reverse('detail',kwargs={"article_id":1,'page':2})
    
  2. 如果想要添加查询字符串的参数,则必须手动的进行拼接。示例代码如下:
    login_url = reverse('login') + "?next=/"
    
    
    

自定义path转换器

自定义URL(PATH)转换器笔记:

需求:

实现一个获取文章列表的demo,用户可以根据/articles/文章分类/的方式来获取文章。其中文章分类采用的是分类1+分类2+分类3...的方式拼接的,并且如果只有一个分类,那就不需要加号。示例如下:

# 1. 第一种:获取python分类下的文章
/articles/python/
# 2. 第二种:获取python和django分类下的文章
/articles/python+django/
# 3. 第三种:获取python和django和flask分类下的文章
/articles/python+django+flask/
以此类推...

在“文章分类”参数传到视图函数之前要把这些分类分开来存储到列表中。
比如参数是python+django,那么传到视图函数的时候就要变成['python','django']

以后在使用reverse反转的时候,限制传递“文章分类”的参数应该是一个列表,并且要将这个列表变成python+django的形式。

自定义URL转换器:

之前已经学到过一些django内置的url转换器,包括有int、uuid等。有时候这些内置的url转换器并不能满足我们的需求,因此django给我们提供了一个接口可以让我们自己定义自己的url转换器。

自定义url转换器按照以下五个步骤来走就可以了:

  1. 定义一个类,直接继承自object就可以了。
  2. 在类中定义一个属性regex,这个属性是用来限制url转换器规则的正则表达式。
  3. 实现to_python(self,value)方法,这个方法是将url中的值转换一下,然后传给视图函数的。
  4. 实现to_url(self,value)方法,这个方法是在做url反转的时候,将传进来的参数转换后拼接成一个正确的url。 5. 将定义好的转换器,使用django.urls.converters.register_converter方法注册到django中。

示例代码如下:

from django.urls import register_converter

class CategoryConverter(object):
    regex = r'\w+|(\w+\+\w+)+'

    def to_python(self,value):
        # python+django+flask
        # ['python','django','flask']
        result = value.split("+")
        return result

    def to_url(self,value):
        # value:['python','django','flask']
        # python+django+flask
        if isinstance(value,list):
            result = "+".join(value)
            return result
        else:
            raise RuntimeError("转换url的时候,分类参数必须为列表!")

register_converter(CategoryConverter,'cate')

URL映射时指定默认参数

URL映射的时候指定默认参数:

使用path或者是re_path的后,在route中都可以包含参数,而有时候想指定默认的参数,这时候可以通过以下方式来完成。示例代码如下:

from django.urls import path

from . import views

urlpatterns = [
    path('blog/', views.page),
    path('blog/page<int:num>/', views.page),
]

# View (in blog/views.py)
def page(request, num=1):
    # Output the appropriate page of blog entries, according to num.
    ...

当在访问blog/的时候,因为没有传递num参数,所以会匹配到第一个url,这时候就执行view.page这个视图函数,而在page函数中,又有num=1这个默认参数。因此这时候就可以不用传递参数。而如果访问blog/1的时候,因为在传递参数的时候传递了num,因此会匹配到第二个url,这时候也会执行views.page,然后把传递进来的参数传给page函数中的num。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值