104 lines
5.3 KiB
Python
104 lines
5.3 KiB
Python
# +======================================================================
|
||
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者，助力企业发展 ]
|
||
# +----------------------------------------------------------------------
|
||
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
|
||
# +----------------------------------------------------------------------
|
||
# | 开源协议: Apache-2.0
|
||
# | 重要声明: 未经书面许可，不得移除或修改本框架相关版权标识。
|
||
# +----------------------------------------------------------------------
|
||
# | 官方网站: https://www.djangoadmin.cn
|
||
# +----------------------------------------------------------------------
|
||
# | 研发团队: 小蚂蚁云团队 荣誉出品
|
||
# +======================================================================
|
||
# | 版权和免责声明:
|
||
# | 一、知识产权声明
|
||
# | 本团队对该软件框架产品（以下简称“本产品”）拥有完整知识产权，包括但不限于商标权、专利权、
|
||
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权，
|
||
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
|
||
# | 二、使用限制与禁止条款
|
||
# | 您理解并同意，禁止将本产品用于以下任何行为：
|
||
# | 1. 任何违反中华人民共和国法律法规的用途；
|
||
# | 2. 任何侵害他人合法权益（包括但不限于人身权、财产权、知识产权等）的行为；
|
||
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
|
||
# | 三、责任豁免
|
||
# | 因使用本产品而产生的任何损失或法律纠纷（包括但不限于直接损失、间接损失、附带损失、衍生损失
|
||
# | 以及因违约、侵权等引发的责任），本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
|
||
# | 方提起索赔或行政机关进行调查，您应独立承担全部责任。
|
||
# | 四、违约与法律责任
|
||
# | 如发现任何违反本声明的行为，本团队有权：
|
||
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作；
|
||
# | 2. 依法追究相关方的民事责任，并要求赔偿全部损失；
|
||
# | 3. 保留进一步采取刑事控告等法律措施的权利。
|
||
# | 五、许可范围说明
|
||
# | 1、被授权方应视本产品源代码为核心机密信息，负有最高标准的保密与保管义务。禁止以任何形式（包
|
||
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
|
||
# | 过网络服务提供给任何第三方）泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
|
||
# | 传播行为均构成对本团队知识产权的严重侵权，本团队有权依法追究其全部法律责任，并要求赔偿因此造
|
||
# | 成的一切经济损失及商誉损害。
|
||
# | 2、本产品仅限于公司或个人在法律允许范围内，用于内部且合规的软件产品研发。具体权利义务以《软件
|
||
# | 许可协议》附件为准。
|
||
# +======================================================================
|
||
|
||
from django.urls import path # 导入路径相关配置
|
||
|
||
from application.upload import views
|
||
|
||
"""
|
||
文件上传模块路由配置
|
||
=============================================================
|
||
|
||
URL端点概览：
|
||
------------------------------------------------------------------------
|
||
| 功能说明 | 请求方法 | URL路径 | 视图类 |
|
||
|-----------------|----------|-----------------------------|---------------------|
|
||
| 上传文件 | POST | /upload/uploadFile | uploadFile |
|
||
------------------------------------------------------------------------
|
||
|
||
使用示例：
|
||
1. 上传文件：POST /api/upload/uploadFile
|
||
Content-Type: multipart/form-data
|
||
Form Data:
|
||
- file: (二进制文件，支持文档、压缩包等)
|
||
|
||
返回数据格式：
|
||
{
|
||
"code": 200,
|
||
"msg": "上传成功",
|
||
"data": {
|
||
"filePath": "/uploads/images/2023/01/abc123.jpg", # 文件存储路径
|
||
"fileUrl": "https://example.com/uploads/images/2023/01/abc123.jpg", # 文件访问URL
|
||
"fileName": "abc123.jpg", # 文件名
|
||
"fileSize": 1024, # 文件大小（字节）
|
||
"fileType": "image/jpeg" # 文件类型
|
||
}
|
||
}
|
||
|
||
功能说明：
|
||
- 提供统一的文件上传接口
|
||
- 支持图片、文档、压缩包等多种文件类型
|
||
- 自动按日期目录存储文件
|
||
- 返回文件的访问URL供前端使用
|
||
|
||
文件类型限制：
|
||
- 图片：jpg、jpeg、png、gif、bmp、webp等
|
||
- 文档：doc、docx、xls、xlsx、ppt、pptx、pdf、txt等
|
||
- 压缩包：zip、rar、7z、tar、gz等
|
||
|
||
注意事项：
|
||
- 单个文件大小受系统配置限制（默认10MB）
|
||
- 上传文件会自动重命名，避免文件名冲突
|
||
- 图片上传可能生成缩略图（根据配置）
|
||
- 建议在前端做文件类型和大小的预检查
|
||
- 文件存储路径在配置文件中定义（DJANGO_UPLOAD_DIR）
|
||
"""
|
||
|
||
# 文件上传模块路由配置
|
||
urlpatterns = [
|
||
# 上传文件接口
|
||
# URL: /upload/uploadFile
|
||
# 请求方法: POST
|
||
# 功能: 上传普通文件，支持文档、压缩包等各种格式
|
||
# 文件限制: 根据系统配置限制文件类型和大小
|
||
path('uploadFile', views.uploadFile.as_view()),
|
||
]
|