萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Django URL 路由簡化神器:url_helper 實現預設路由與參數綁定

痛點:原生 URLconf 繁瑣


# 傳統寫法:每個 view 手寫正則
urlpatterns = [
    url(r'^articles/(?P\d{4})/(?P\d{2})/$', views.archive),
    url(r'^users/(?P\w+)/$', views.profile),
    # 數十行重複模式...
]

url_helper 設計理念

  • 單檔案 url_helper.py,零依賴
  • 實現 預設路由:/action/param1/param2/ 自動對應 views.action(param1, param2)
  • 提供 url_() 簡化參數捕獲:/user/:id/ → (?P[^/]+)

完整原始碼 (url_helper.py)


#!/usr/bin/env python
# -*- coding: UTF-8 -*-
from django import http
from django.conf.urls import url
import re

def execute(request, urls, views):
    """
    預設路由分發器
    URL 格式: /method/param1/param2/...
    無 method 時預設為 index
    """
    def get_method(views, method_name):
        try:
            return getattr(views, method_name)
        except AttributeError:
            return None
    
    # 解析路徑段
    parts = [p for p in urls.split('/') if p]
    parts.reverse()  # 便於 pop
    
    method_name = parts.pop() if parts else 'index'
    method = get_method(views, method_name)
    
    if not method:
        raise http.Http404(f'View "{method_name}" not found')
    
    # 剩餘部分作為位置參數傳遞
    return method(request, *parts)

def url_(*args, **kwargs):
    """
    簡化 URL 模式:參數用 :name 表示
    url_(r'/user/:id/', views.profile) 
    → url(r'^user/(?P[^/]+)/$', views.profile)
    """
    pattern = args[0]
    if pattern.startswith('/'):
        pattern = pattern[1:]
    pattern = '^' + pattern + '$'
    
    # 將 :param 轉為 (?P[^/]+)
    pattern = re.sub(r':([^/]+)', r'(?P<\1>[^/]+)', pattern)
    
    return url(pattern, *args[1:], **kwargs)

使用範例

1. 預設路由模式


# urls.py
from django.conf.urls import patterns, include
from url_helper import execute, url_
import views

urlpatterns = patterns('',
    # 捕獲所有未匹配路徑,交給 execute 分發
    url(r'^(?P.*)$', execute, {'views': views}),
)

# views.py
def index(request):
    return HttpResponse("首頁")

def show(request, id):
    return HttpResponse(f"顯示文章 {id}")

def edit(request, id):
    return HttpResponse(f"編輯文章 {id}")

def create(request):
    return HttpResponse("新增表單")

# URL 對應:
# /                    → index()
# /show/123/           → show('123')
# /edit/123/           → edit('123')
# /create/             → create()

2. url_ 簡化參數捕獲


# urls.py
from url_helper import url_
import views

urlpatterns = patterns('',
    url_(r'/user/:username/', views.profile),
    url_(r'/article/:id/edit/', views.edit_article),
    url_(r'/api/:version/users/:id/', views.api_user),
)

# views.py
def profile(request, username):
    return HttpResponse(f"用戶: {username}")

def edit_article(request, id):
    return HttpResponse(f"編輯文章 {id}")

def api_user(request, version, id):
    return HttpResponse(f"API v{version} 用戶 {id}")

3. 混合使用


urlpatterns = patterns('',
    # 明確路由優先
    url(r'^admin/', include(admin.site.urls)),
    url(r'^api/', include('api.urls')),
    
    # 靜態頁面
    url_(r'/about/', views.about),
    url_(r'/contact/', views.contact),
    
    # 其餘交給預設路由
    url(r'^(?P.*)$', execute, {'views': views}),
)

進階擴展建議

  1. HTTP 方法分發:在 execute 中根據 request.method 呼叫 method_GET/method_POST
  2. 型別轉換::int:id → (?P\d+) 並自動 int(id)
  3. 正則自定義::re<[a-z]+>:slug
  4. 命名空間支援:整合 include() 機制
  5. 類別視圖 (CBV) 適配:execute 回傳 View.as_view() 結果

現代替代方案

Django 2.0+ 內建 path() 提供類似簡化語法:


from django.urls import path

urlpatterns = [
    path('user//', views.profile),
    path('article//edit/', views.edit_article),
    path('api//users//', views.api_user),
]

path() 使用路徑轉換器 (str, int, slug, uuid, path),更標準、效能更好、支援反向解析。新專案請直接使用 path()/re_path()。

適用場景

  • 維護 Django 1.x 老專案
  • 快速原型開發、腳本化管理介面
  • 理解路由分發原理教學用途
copyright © 萬盛學電腦網 all rights reserved