用python编写restful…
- User
用python编写restful api接口,提供文件的上传、通过文件名下载,文件支持修改和删除,记录文件的上传和下载时间,以及是谁上传和下载的,且需要token鉴权,restful api接口基于fastapi框架,文件存储在mongodb数据库
- Assistant
下方是一个基本的示例代码,仅供参考。
from datetime import datetime from typing import List, Optional from fastapi import FastAPI, HTTPException, Depends from fastapi.security import OAuth2PasswordBearer, OAuth2PasswordRequestForm from pymongo import MongoClient app = FastAPI() # 连接mongodb数据库 client = MongoClient('mongodb://localhost:27017/') db = client['file_db'] # 定义文件信息结构 class FileInDB: def __init__(self, id, name, content, upload_time, download_time, uploader, downloader): self.id = id self.name = name self.content = content self.upload_time = upload_time self.download_time = download_time self.uploader = uploader self.downloader = downloader def __repr__(self): return f'id={self.id},name={self.name},content={self.content},upload_time={self.upload_time},' \ f'download_time={self.download_time},uploader={self.uploader},downloader={self.downloader}' # 创建文件上传接口,接收上传文件的二进制数据,并保存到mongodb @app.post("/file/upload") async def upload_file(name: str, content: bytes, token: str = Depends(OAuth2PasswordBearer(tokenUrl="/token"))): # 获取上传者的用户名 uploader = get_user(token) # 构建文件信息对象 file = FileInDB(None, name, content, datetime.utcnow(), None, uploader, None) # 保存文件信息到mongodb file_id = db.files.insert_one(file.__dict__).inserted_id # 返回文件的id return {"file_id": str(file_id)} # 创建文件下载接口,通过文件名查找文件并返回内容 @app.get("/file/download/{name}") async def download_file(name: str, token: str = Depends(OAuth2PasswordBearer(tokenUrl="/token"))): # 获取下载者的用户名 downloader = get_user(token) # 通过文件名查找文件信息 file_info = db.files.find_one({"name": name}) if file_info is None: raise HTTPException(status_code=404, detail="File not found") # 构建文件信息对象,并更新下载信息 file = FileInDB(**file_info) file.download_time = datetime.utcnow() file.downloader = downloader # 保存更新后的文件信息 db.files.update_one({"_id": file.id}, {"$set": file.__dict__}) # 返回文件内容 return file.content # 创建文件删除接口,通过文件名查找文件并删除记录 @app.delete("/file/delete/{name}") async def delete_file(name: str, token: str = Depends(OAuth2PasswordBearer(tokenUrl="/token"))): # 获取删除者的用户名 user = get_user(token) # 删除文件信息 count = db.files.delete_one({"name": name, "uploader": user}).deleted_count if count == 0: raise HTTPException(status_code=404, detail="File not found") return {"message": f"Deleted {count} file(s)"} # 创建文件修改接口,通过文件名查找文件并更新内容 @app.put("/file/update/{name}") async def update_file(name: str, new_content: bytes, token: str = Depends(OAuth2PasswordBearer(tokenUrl="/token"))): # 获取修改者的用户名 user = get_user(token) # 查找文件信息,更新内容并保存 count = db.files.update_one({"name": name, "uploader": user}, {"$set": {"content": new_content}}).modified_count if count == 0: raise HTTPException(status_code=404, detail="File not found") return {"message": f"Updated {count} file(s)"} # 模拟一个用户鉴权的过程 async def get_user(token: str): # 在真实场景中,这里需要查询数据库或其他鉴权提供者来验证token if token != "example_token": raise HTTPException(status_code=401, detail="Invalid token") return "example_user" # 定义鉴权模型 oauth2_scheme = OAuth2PasswordBearer(tokenUrl="/token") # 创建token获取接口 @app.post("/token") async def login(form_data: OAuth2PasswordRequestForm = Depends()): # 在真实场景中,这里需要查询数据库或其他鉴权提供者来验证用户名和密码 if form_data.username != "example_user" or form_data.password != "example_password": raise HTTPException(status_code=401, detail="Incorrect username or password") return {"access_token": "example_token", "token_type": "bearer"} # 获取当前所有文件的信息 @app.get("/file") async def get_all_files(token: str = Depends(oauth2_scheme)): user = get_user(token) # 在真实场景中,这里可以根据需要添加过滤条件 files = db.files.find() return [FileInDB(**file_info).__dict__ for file_info in files]使用示例:
我们首先启动FastAPI服务器:
uvicorn main:app --reload然后通过curl等工具调用接口。
上传文件:
curl -H "Authorization: Bearer example_token" -X POST -F "name=example.txt" -F "content=@example.txt" http://localhost:8000/file/upload下载文件:
curl -H "Authorization: Bearer example_token" http://localhost:8000/file/download/example.txt > example_downloaded.txt删除文件:
curl -H "Authorization: Bearer example_token" -X DELETE http://localhost:8000/file/delete/example.txt修改文件:
curl -H "Authorization: Bearer example_token" -X PUT -F "new_content=@example_new.txt" http://localhost:8000/file/update/example.txt获取所有文件信息:
curl -H "Authorization: Bearer example_token" http://localhost:8000/file - User
用python编写restful api接口,提供文件的上传、通过文件名下载,且提交的文件支持修改和删除,记录文件的上传和下载时间,以及是谁上传和下载的,且需要token鉴权,restful api接口基于fastapi框架,文件存储在mongodb数据库
- Assistant
以下是示例代码:
from fastapi import FastAPI, Depends, HTTPException, UploadFile, File from datetime import datetime from pymongo import MongoClient from typing import List app = FastAPI() client = MongoClient('mongodb://localhost:27017/') db = client['file_db'] class FileInDB: def __init__(self, id, name, content, upload_time, download_time, uploader, downloader): self.id = id self.name = name self.content = content self.upload_time = upload_time self.download_time = download_time self.uploader = uploader self.downloader = downloader def __repr__(self): return f'id={self.id},name={self.name},content={self.content},upload_time={self.upload_time},' \ f'download_time={self.download_time},uploader={self.uploader},downloader={self.downloader}' """ 文件上传接口 POST /file/upload 请求参数: - name: 文件名 - file: 上传的文件 - token: 用户token 响应: - file_id: 文件在数据库中的ID - message: 上传成功 """ @app.post("/file/upload") async def upload_file(name: str, file: UploadFile = File(...), token: str = Depends(get_token)): uploader = get_user(token) content = await file.read() file_in_db = FileInDB(None, name, content, datetime.utcnow(), None, uploader, None) file_id = db.files.insert_one(file_in_db.__dict__).inserted_id return {"file_id": str(file_id), "message": "上传成功"} """ 文件下载接口 GET /file/download/{name} 请求参数: - name: 文件名 - token: 用户token 响应: - 文件内容 """ @app.get("/file/download/{name}") async def download_file(name: str, token: str = Depends(get_token)): downloader = get_user(token) file_in_db = db.files.find_one({"name": name}) if not file_in_db: raise HTTPException(status_code=404, detail="File not found") file_in_db = FileInDB(**file_in_db) file_in_db.download_time = datetime.utcnow() file_in_db.downloader = downloader db.files.replace_one({"_id": file_in_db.id}, file_in_db.__dict__) return file_in_db.content """ 文件删除接口 DELETE /file/delete/{name} 请求参数: - name 文件名 - token 用户token 响应: - message: 删除成功信息 """ @app.delete("/file/delete/{name}") async def delete_file(name: str, token: str = Depends(get_token)): user = get_user(token) count = db.files.delete_one({"name": name, "uploader": user}).deleted_count if count == 0: raise HTTPException(status_code=404, detail="File not found") return {"message": f"成功删除 {count} 个文件"} """ 修改文件接口 PUT /file/update/{name} 请求参数: - name: 文件名 - new_content: 新的文件内容 - token: 用户token 响应: - message: 修改文件信息 """ @app.put("/file/update/{name}") async def update_file(name: str, new_content: bytes, token: str = Depends(get_token)): user = get_user(token) count = db.files.update_one({"name": name, "uploader": user}, {"$set": {"content": new_content}}).modified_count if count == 0: raise HTTPException(status_code=404, detail="File not found") return {"message": f"成功修改 {count} 个文件"} # 鉴权 async def get_token(token: str = Depends()): if not token: raise HTTPException(status_code=401, detail="Token缺失") return token async def get_user(token: str = Depends(get_token)): user = db.users.find_one({"token": token}) if not user: raise HTTPException(status_code=401, detail="用户不存在") return user['username'] """ 用户鉴权接口 POST /token 请求参数: - username: 用户名 - password: 密码 响应: - access_token: 用户Token """ @app.post("/token") async def login(username: str, password: str): user = db.users.find_one({"username": username, "password": password}) if not user: raise HTTPException(status_code=401, detail="用户名或密码错误") token = db.tokens.insert_one({"token": user['token'], "username": user['username']}).inserted_id return {"access_token": str(token)} """ 获取上传下载信息接口 GET /file_info/{name} 请求参数: - name: 文件名 - token: 用户token 响应: - 文件上传下载信息 """ @app.get("/file_info/{name}") async def get_file_info(name: str, token: str = Depends(get_token)): file_in_db = db.files.find_one({"name": name}) if not file_in_db: raise HTTPException(status_code=404, detail="File not found") file_in_db = FileInDB(**file_in_db) return { "name": file_in_db.name, "upload_time": file_in_db.upload_time, "download_time": file_in_db.download_time, "uploader": file_in_db.uploader, "downloader": file_in_db.downloader } """ 获取所有文件信息 GET /file 请求参数: - token: 用户token 响应: - 所有文件信息 """ @app.get("/file") async def get_all_files(token: str = Depends(get_token)): files = db.files.find() return [FileInDB(**file_info).__dict__ for file_info in files]本示例代码中,我们为文件信息和用户信息分别定义了
FileInDB和UserInDB类。每个FileInDB实例代表一个文件在数据库中的信息,包括文件名、文件内容、上传时间、上传者、下载时间和下载者等。当需要查询文件信息时,将查询结果转换成一个字典返回。为了使文件的上传和下载过程中能够将相关信息存储在数据库中,我们在文件上传和下载时,会将上传和下载者以及时间等信息更新到数据库中。由于涉及到鉴权,我们在部分接口上添加了依赖注入,通过
get_token函数验证用户的token,确认用户身份,并通过get_user函数获取当前用户的用户名。同时,我们实现了一个/token接口用于用户的登录鉴权。用户在登录鉴权后可以获取到一个access_token,在后续请求中需要携带该Token才能访问相关资源。最后,我们在附加了上传信息和下载信息并拥有所有增删改查操作的方法基础上添加了获取所有文件信息和某一文件的上传下载信息的方法。