From a667f550b1fe4cbed4697a7160fac24ef661e156 Mon Sep 17 00:00:00 2001 From: pfy5v82cw <1667039373@qq.com> Date: Sun, 9 Nov 2025 21:09:13 +0800 Subject: [PATCH] Update urls.py --- src/DjangoBlog-master/owntracks/urls.py | 38 +++++++++++++++++++++---- 1 file changed, 33 insertions(+), 5 deletions(-) diff --git a/src/DjangoBlog-master/owntracks/urls.py b/src/DjangoBlog-master/owntracks/urls.py index c19ada8..60221ef 100644 --- a/src/DjangoBlog-master/owntracks/urls.py +++ b/src/DjangoBlog-master/owntracks/urls.py @@ -1,12 +1,40 @@ +# 导入 Django 路由核心函数：path 用于定义 URL 路径与视图函数的映射关系 from django.urls import path +# 导入当前应用的视图模块：views 中包含所有路由对应的业务处理函数 from . import views +# 应用路由命名空间：用于区分不同应用的同名路由（避免反向解析时冲突） +# 作用：在模板或视图中通过「app_name:route_name」反向生成 URL（如 reverse('owntracks:logtracks')） app_name = "owntracks" +# 路由配置列表：每个 path 对应一条 URL 规则，按定义顺序匹配（优先匹配靠前的规则） urlpatterns = [ - path('owntracks/logtracks', views.manage_owntrack_log, name='logtracks'), - path('owntracks/show_maps', views.show_maps, name='show_maps'), - path('owntracks/get_datas', views.get_datas, name='get_datas'), - path('owntracks/show_dates', views.show_log_dates, name='show_dates') -] + # 1. 轨迹数据提交接口：接收客户端发送的轨迹数据（经纬度、用户标识）并存储 + path( + 'owntracks/logtracks', # URL 路径：客户端访问的接口地址（需完整匹配） + views.manage_owntrack_log, # 对应的视图函数：处理该 URL 的业务逻辑（如数据验证、写入数据库） + name='logtracks' # 路由别名：用于反向解析 URL（替代硬编码路径，便于维护） + ), + + # 2. 地图展示接口：渲染包含用户轨迹的地图页面（需登录权限） + path( + 'owntracks/show_maps', # URL 路径：地图展示页面地址 + views.show_maps, # 视图函数：查询轨迹数据并传递给模板渲染地图 + name='show_maps' # 路由别名：如模板中使用 {% url 'owntracks:show_maps' %} 生成 URL + ), + + # 3. 轨迹数据查询接口：返回指定条件的轨迹数据（如按日期筛选），通常用于前端异步请求 + path( + 'owntracks/get_datas', # URL 路径：数据查询接口地址（支持带查询参数，如 ?date=2023-09-06） + views.get_datas, # 视图函数：处理查询条件，从数据库筛选数据并返回（如 JSON 格式） + name='get_datas' # 路由别名：前端 AJAX 请求时可通过反向解析获取接口地址 + ), + + # 4. 轨迹日期列表接口：返回所有轨迹数据的日期列表（用于前端筛选日期选择） + path( + 'owntracks/show_dates', # URL 路径：日期列表展示/查询地址 + views.show_log_dates, # 视图函数：查询数据库中轨迹数据的所有日期并返回（去重处理） + name='show_dates' # 路由别名：用于反向生成日期筛选接口的 URL + ) +] \ No newline at end of file