jQuery-File-Upload 项目技术文档

1. 安装指南

环境要求

• Django
• Python Imaging Library (PIL) 或其替代包 Pillow

安装步骤

1. 创建虚拟环境：

   virtualenv -p python3 venv
   

2. 激活虚拟环境：

   source venv/bin/activate
   

3. 安装依赖：

   pip install -r requirements.txt
   

4. 运行数据库迁移：

   ./manage.py migrate
   

5. 启动服务器：

   ./manage.py runserver
   

6. 访问项目： 打开浏览器，访问 localhost:8000，即可开始使用文件上传功能。

2. 项目使用说明

功能概述

• 拖放文件：支持通过拖放方式上传文件。
• 多文件选择：允许一次选择多个文件进行上传。
• 取消上传：在上传过程中可以取消文件上传。
• 删除上传文件：可以从数据库中删除已上传的文件。
• 无需插件：不依赖Flash或其他浏览器插件。

使用步骤

1. 打开项目页面后，点击“选择文件”按钮或直接拖放文件到指定区域。
2. 选择文件后，点击“上传”按钮开始上传。
3. 在上传过程中，可以点击“取消”按钮取消上传。
4. 上传完成后，可以在页面上查看已上传的文件，并选择删除。

3. 项目API使用文档

API 接口

• 上传文件：

  • URL: /upload/
  • 方法: POST
  • 参数: file (文件对象)
  • 返回值: 上传成功后返回文件的URL或相关信息。

• 删除文件：

  • URL: /delete/<file_id>/
  • 方法: DELETE
  • 参数: file_id (文件ID)
  • 返回值: 删除成功后返回状态码 204 No Content。

示例代码

# 上传文件
import requests

url = 'http://localhost:8000/upload/'
files = {'file': open('example.jpg', 'rb')}
response = requests.post(url, files=files)
print(response.json())

# 删除文件
delete_url = 'http://localhost:8000/delete/1/'
response = requests.delete(delete_url)
print(response.status_code)

4. 项目安装方式

通过GitHub克隆项目

1. 打开终端，执行以下命令克隆项目：

   git clone https://github.com/sigurdga/django-jquery-file-upload.git
   

2. 进入项目目录：

   cd django-jquery-file-upload
   

3. 按照安装指南中的步骤进行安装和配置。

通过pip安装

1. 打开终端，执行以下命令安装项目：

   pip install django-jquery-file-upload
   

2. 在Django项目中配置应用，添加 'fileupload' 到 INSTALLED_APPS 中。

3. 运行数据库迁移并启动服务器。

通过以上步骤，您可以成功安装并使用 jQuery-File-Upload 项目。