url

一. Django路由:
URL配置(URLconf) 就像是django所支撐的網站的目錄, 本質是URL與要爲該URL調用的視圖函數之間的映射表,  以這種方式告訴Django遇到哪一個url的時候, 要執行哪一個函數
    1. 基本格式:
        from django.conf.urls import url
        urlpatterns = [
            url('正則表達式', views視圖, 參數, 別名 )
        ]
    forE:from django.conf.urls import url
         from . import views
         urlpatterns = [
            url(r'^articles/2002/$', views.special_case_2003),
            url(r'^articles/(\d{4})/$', views.year_archive),
            url(r'^articles/(\d{4})/(\d{2})/$', views.month_archive),
            url(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)', views.article_detail)
         ]
    說明: 正則表達式: 一個正則表達式字符串
          views視圖: 一個可調用對象,一般爲一個視圖函數
          參數:  可選的要傳遞給視圖函數的默認參數(字典形式)
          別名: 一個可選的name參數
          Django2.0的寫法 , 名字有點區別,用法一致
          from django.urls import path，re_path
          urlpatterns = [
                path('articles/2003/', views.special_case_2003),
                path('articles/<int:year>/', views.year_archive),
                path('articles/<int:year>/<int:month>/', views.month_archive),
                path('articles/<int:year>/<int:month>/<slug:slug>/', views.article_detail),
            ]
    2.正則表達式
        注意事項: 1. urlpatterns中的元素按照書寫順序從上往下逐一匹配正則表達式, 一旦匹配成功則再也不繼續
                  2. 若要從URL中捕獲一個值,只須要 在它周圍放置一對圓括號(分組匹配).
                  3. 不須要添加一個前導的反斜槓, 由於每一個url都有. 例如應該是^articles而不是^/articles.
                  4. 每一個正則表達式前面的 r 是可選的, 建議加上.
                  tip: APPEND_SLASH = True  :  配置這個開始url訪問地址後面不帶 / 的跳轉帶 /的路徑
                        django默認沒有配置, 可是默認這個屬性是True
    3. 分組命名匹配:
        使用簡單的正則表達式分組匹配(經過圓括號)來捕獲url中的值並以位置參數形式傳遞給視圖.
        更高級的用法中,能夠用分組命名匹配的正則表達式組來捕獲url中的值並以關鍵字參數形式傳遞給視圖.
        在python正則表達式中,分組命名語法是: (?<name>pattern), 其中name是組的名稱, pattern是要匹配的模式

        url(r'articles/(?P<yuar>[0-9]{4})/(?P<month>[0-9]{2})$'), views.year_archive),
        針對URL : /articles/2017/12/   >>>函數調用: views.month_archive(request, year='2017',month='12')
    4. URLconf匹配的位置
        URLconf在請求的URL上查找, 將它看成一個普通的python字符串.不包括GET和POST參數以域名.
        例如http://www.example.con/myapp/請求中, URLconf將查找/myapp/.
            在http://www.example.com/myapp/?page=3 請求中,URLconf仍將查找/myapp/.
        URLconf不檢查請求的方法.換句話講, 全部的請求方法---同一個url的POST，　GET．　HEAD等等都將路由到相同的函數
    5. 捕獲的參數永遠都是字符串
        每一個URLconf中捕獲的參數都做爲一個普通的python字符串傳遞給視圖, 不管正則表達式使用的是什麼匹配方式,例如
            url(r'^articles/(?P<year>[0-9]{4})/', views.year_archive)  -->>傳遞給函數views.year_archive()中的year參數永遠              是一個字符串類型
    6. 視圖函數中指定默認值:
        urls:  url(r'^blog/page(?P<num>[0-9]+)/$', views.page)

        views:  def page(request, num='1'):  #  num匹配的值會傳給函數, 因此要預留位置, 若是沒有匹配也不會報錯
                     pass

    7. include其餘的URLconfs
        #At any point, your urlpatterns can 「include」 other URLconf modules. This
        #essentially 「roots」 a set of URLs below other ones.

        #For example, here’s an excerpt of the URLconf for the Django website itself.
        #It includes a number of other URLconfs:


        from django.conf.urls import include, url

        urlpatterns = [
           url(r'^admin/', admin.site.urls),
           url(r'^blog/', include('blog.urls')),  # 能夠包含其餘的URLconfs文件
        ]

    8.  傳遞額外的參數給視圖
            URLconfs 具備一個鉤子，讓你傳遞一個Python 字典做爲額外的參數傳遞給視圖函數。

            django.conf.urls.url() 能夠接收一個可選的第三個參數，它是一個字典，表示想要傳遞給視圖函數的額外關鍵字參數。

            例如：

            from django.conf.urls import url
            from . import views

            urlpatterns = [
                url(r'^blog/(?P<year>[0-9]{4})/$', views.year_archive, {'foo': 'bar'}),
            ]
            在這個例子中，對於/blog/2005/請求，Django 將調用views.year_archive(request, year='2005', foo='bar')。
            當傳遞額外參數的字典中的參數和URL中捕獲值的命名關鍵字參數同名時，函數調用時將使用的是字典中的參數，而不是URL中              捕獲的參數。

                            9. 命名URL和URL反向解析：在使用Django 項目時，一個常見的需求是得到URL的最終形式，以用於嵌入到生成的內容中
                            （視圖中和顯示給用戶的URL等）或者用於處理服務器端的導航（重定向等）。
                        人們強烈但願不要硬編碼這些URL（費力、不可擴展且容易產生錯誤）或者設計一種與URLconf 絕不相關的專門的URL 生成機制，
                        由於這樣容易致使必定程度上產生過時的URL。 換句話講，須要的是一個DRY 機制。除了其它有點，它還容許設計的URL
                         能夠自動更新而不用遍歷項目的源代碼來搜索並替換過時的URL。
                        獲取一個URL 最開始想到的信息是處理它視圖的標識（例如名字），查找正確的URL 的其它必要的信息有視圖參數的類型（位置參數、關鍵字參數）和值。
                        Django 提供一個辦法是讓URL 映射是URL 設計惟一的地方。你填充你的URLconf，而後能夠雙向使用它：

                        根據用戶/瀏覽器發起的URL 請求，它調用正確的Django 視圖，並從URL 中提取它的參數須要的值。
                        根據Django 視圖的標識和將要傳遞給它的參數的值，獲取與之關聯的URL。
                        第一種方式是咱們在前面的章節中一直討論的用法。第二種方式叫作反向解析URL、反向URL 匹配、反向URL 查詢或者簡單的URL 反查。
                        在須要URL 的地方，對於不一樣層級，Django 提供不一樣的工具用於URL 反查：

                        在模板中：使用url模板標籤。
                        在Python 代碼中：使用django.core.urlresolvers.reverse() 函數。
                        在更高層的與處理Django 模型實例相關的代碼中：使用get_absolute_url() 方法。
                        上面說了一大堆，你可能並無看懂。（那是官方文檔的生硬翻譯）。

                        我們簡單來講就是能夠給咱們的URL匹配規則起個名字，一個URL匹配模式起一個名字。

                        這樣咱們之後就不須要寫死URL代碼了，只須要經過名字來調用當前的URL。
             例如：url(r'^home', views.home, name='home')  # 給個人url匹配模式起名爲home
                   url(r'^index/(\d+)', views.index, name='index') # 給個人url匹配模式起名爲index
                   在模板中引用:  {% url 'home' %}
                   在視圖中能夠這樣用:  from django.urls import reverse
                                        reverse('inedx', args=('2018', ))

                    from django.conf.urls import url
                    from . import views
                    urlpatterns = [
                        # ...
                        url(r'^articles/([0-9]{4})/$', views.year_archive, name='news-year-archive'),
                        # ...
                    ]
                    根據這裏的設計，某一年nnnn (對應的)  歸檔的URL是/articles/nnnn/。

                    模板中:
                   <a href="{% url 'news-year-archive' 2012 %}">2012 Archive</a>
                    <ul>
                    {% for yearvar in year_list %}
                    <li><a href="{% url 'news-year-archive' yearvar %}">{{ yearvar }} Archive</a></li>
                    {% endfor %}
                    </ul>
                    視圖中:
                    from django.urls import reverse
                    from django.shortcuts import redirect

                    def redirect_to_year(request):
                        # ...
                        year = 2006
                        # ...
                        return redirect(reverse('news-year-archive', args=(year,)))
                     tip:  在某些場景中，一個視圖是通用的，因此在URL 和視圖之間存在多對一的關係。對於這些狀況，當反查URL 時，只有視圖的名字還不夠。
                            注意：
                            爲了完成上面例子中的URL 反查，你將須要使用命名的URL 模式。URL 的名稱使用的字符串能夠包含任何你喜歡的字符。不僅限制在合法的Python 名稱。
                            當命名你的URL 模式時，請確保使用的名稱不會與其它應用中名稱衝突。若是你的URL 模式叫作comment，而另一個應用中也有一個一樣的名稱，當你
                            在模板中使用這個名稱的時候不能保證將插入哪一個URL。在URL 名稱中加上一個前綴，好比應用的名稱，將減小衝突的可能。咱們建議使用myapp-comment                                           而不是comment。

    9.命名空間:不一樣的APP使用相同的URL名稱，URL的命名空間模式可讓你惟一反轉命名的URL
        from django.conf.urls import url, include
            urlpatterns = [
                url(r'^app01/', include('app01.urls', namespace='app01')),
                url(r'^app02/', include('app02.urls', namespace='app02')),
            ]


            app01:
            from django.conf.urls import url
            from app01 import views
            app_name = 'app01'
            urlpatterns = [
                url(r'^(?P<pk>\d+)/$', views.detail, name='detail')
            ]


            app02:
            from django.conf.urls import url
            from app02 import views
            app_name = 'app02'
            urlpatterns = [
                url(r'^(?P<pk>\d+)/$', views.detail, name='detail')
            ]
        使用語法: '命名空間名稱: URL名稱'
            模板中的使用: {% url 'app01:detail'pk=12 pp=99 %}
            views中的函數使用: v = reverse('app01:detail', kwargs={'pk': 11})