用于 URLconfs 的 django.urls 函数 — Django 文档
django.urls 用于 URLconfs 的函数
path()
- path(route, view, kwargs=None, name=None)
返回包含在 urlpatterns
中的元素。 例如:
from django.urls import include, path
urlpatterns = [
path('index/', views.index, name='main-view'),
path('bio/<username>/', views.bio, name='bio'),
path('articles/<slug:title>/', views.article, name='article-detail'),
path('articles/<slug:title>/<int:section>/', views.section, name='article-section'),
path('weblog/', include('blog.urls')),
...
]
route
参数应该是包含 URL 模式的字符串或 gettext_lazy()(请参阅 翻译 URL 模式)。 该字符串可能包含尖括号(如上面的 <username>
)以捕获 URL 的一部分并将其作为关键字参数发送到视图。 尖括号可能包含一个转换器规范(如 <int:section>
的 int
部分),它限制了匹配的字符,也可能改变传递给视图的变量的类型。 例如,<int:section>
匹配一串十进制数字并将值转换为 int
。 有关更多详细信息,请参阅 Django 如何处理请求 。
view
参数是一个视图函数或 as_view() 的结果,用于基于类的视图。 它也可以是 django.urls.include()。
kwargs
参数允许您将附加参数传递给视图函数或方法。 有关示例,请参阅 传递额外选项以查看函数 。
请参阅 Naming URL patterns 了解为什么 name
参数有用。
re_path()
- re_path(route, view, kwargs=None, name=None)
返回包含在 urlpatterns
中的元素。 例如:
from django.urls import include, re_path
urlpatterns = [
re_path(r'^index/$', views.index, name='index'),
re_path(r'^bio/(?P<username>\w+)/$', views.bio, name='bio'),
re_path(r'^weblog/', include('blog.urls')),
...
]
route
参数应该是包含与 Python 的 re
模块兼容的正则表达式的字符串或 gettext_lazy()(参见 翻译 URL 模式)。 字符串通常使用原始字符串语法 (r
),这样它们就可以包含像 \d
这样的序列,而无需用另一个反斜杠转义反斜杠。 当匹配时,正则表达式中捕获的组被传递到视图——如果组被命名,则作为命名参数,否则作为位置参数。 值作为字符串传递,没有任何类型转换。
view
、kwargs
和 name
参数与 path() 相同。
include()
- include(module, namespace=None)
include(pattern_list)
include((pattern_list, app_namespace), namespace=None) 一个函数,它将完整的 Python 导入路径带到另一个应该“包含”在这个地方的 URLconf 模块。 或者,也可以指定 应用程序命名空间 和 实例命名空间 ,其中条目将被包含在其中。
通常,应用程序命名空间应由包含的模块指定。 如果设置了应用程序命名空间,则
namespace
参数可用于设置不同的实例命名空间。include()
还接受返回 URL 模式的可迭代对象或包含此类可迭代对象和应用程序命名空间名称的 2 元组作为参数。
请参阅 包含其他 URLconfs 和 URL 命名空间以及包含的 URLconfs。
register_converter()
- register_converter(converter, type_name)
用于注册转换器以用于 path() route
s 的函数。
converter
参数是一个转换器类,type_name
是在路径模式中使用的转换器名称。 有关示例,请参阅 注册自定义路径转换器 。
django.conf.urls 用于 URLconfs 的函数
static()
- static.static(prefix, view=django.views.static.serve, **kwargs)
在调试模式下返回用于提供文件的 URL 模式的帮助函数:
from django.conf import settings
from django.conf.urls.static import static
urlpatterns = [
# ... the rest of your URLconf goes here ...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
handler400
- handler400
一个可调用对象,或者一个代表视图的完整 Python 导入路径的字符串,如果 HTTP 客户端发送了一个引起错误条件的请求,并且响应的状态码为 400,那么就会调用该视图。
默认情况下,这是 django.views.defaults.bad_request()。 如果您实现自定义视图,请确保它接受 request
和 exception
参数并返回 HttpResponseBadRequest。
handler403
- handler403
如果用户没有访问资源所需的权限,则可调用或表示视图的完整 Python 导入路径的字符串。
默认情况下,这是 django.views.defaults.permission_denied()。 如果您实现自定义视图,请确保它接受 request
和 exception
参数并返回 HttpResponseForbidden。
handler404
- handler404
一个可调用对象,或者一个代表视图的完整 Python 导入路径的字符串,如果没有任何 URL 模式匹配,那么就会调用该视图。
默认情况下,这是 django.views.defaults.page_not_found()。 如果您实现自定义视图,请确保它接受 request
和 exception
参数并返回 HttpResponseNotFound。
handler500
- handler500
一个可调用的,或者一个字符串,表示在服务器错误的情况下应该调用的视图的完整 Python 导入路径。 当您在视图代码中出现运行时错误时,就会发生服务器错误。
默认情况下,这是 django.views.defaults.server_error()。 如果您实现自定义视图,请确保它接受 request
参数并返回 HttpResponseServerError。