1.3 app的urls与 views

视图：

视图一般都写在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)
]

参数：常用来写路径连接到具体的详情页，也可根据参数在搜索框中查找具体的内容。

注意：参数在网址后+？参数之间&连接  列如：https://www.*****.com/s?ie=utf-8&f=8&rsv_bp=0&rsv_idx=1&tn=baidu&wd=tiantangtupian%20&rsv_pq=9351f22600034896&rsv_t=124aL31x3UpPf3OhdD3KFVF88oGTnjTsYkrjxFXaGdTaJUGo6wSvn5iPNTk&rqlang=cn&rsv_enter=1&rsv_sug3=15&rsv_sug1=3&rsv_sug7=100&rsv_sug2=0&inputT=5350&rsv_sug4=5351

---

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比较多的时候用处很大。

4. 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函数有多种用法，这里讲下两种常用的用法。

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'),
   ]
   

2. include(pattern_list)：可以包含一个列表或者一个元组，这个元组或者列表中又包含的是path或者是re_path函数。

3. 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转换器按照以下五个步骤来走就可以了：

1. 定义一个类。
2. 在类中定义一个属性regex，这个属性是用来保存url转换器规则的正则表达式。
3. 实现to_python(self,value)方法，这个方法是将url中的值转换一下，然后传给视图函数的。
4. 实现to_url(self,value)方法，这个方法是在做url反转的时候，将传进来的参数转换后拼接成一个正确的url。
5. 将定义好的转换器，注册到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),
        ...
    ]