Refactor import statements for ResponseBase in API routers
- Updated import statements in the following files to import ResponseBase directly from models instead of models.response: - routers/api/v1/share/__init__.py - routers/api/v1/site/__init__.py - routers/api/v1/slave/__init__.py - routers/api/v1/tag/__init__.py - routers/api/v1/user/__init__.py - routers/api/v1/vas/__init__.py - routers/api/v1/webdav/__init__.py Enhance user registration and related endpoints in user router - Changed return type annotations from models.response.ResponseBase to models.ResponseBase in multiple functions. - Updated return statements to reflect the new import structure. - Improved documentation for clarity. Add PhysicalFile model and storage service implementation - Introduced PhysicalFile model to represent actual files on disk with reference counting logic. - Created storage service module with local storage implementation, including file operations and error handling. - Defined exceptions for storage operations to improve error handling. - Implemented naming rule parser for generating file and directory names based on templates. Update dependency management in uv.lock - Added aiofiles version 25.1.0 to the project dependencies.
This commit is contained in:
@@ -1,7 +1,37 @@
|
||||
from fastapi import APIRouter, Depends, UploadFile
|
||||
"""
|
||||
文件操作路由
|
||||
|
||||
提供文件上传、下载、创建等核心功能。
|
||||
|
||||
路由前缀：
|
||||
- /file - 文件操作
|
||||
- /file/upload - 上传相关操作
|
||||
"""
|
||||
from datetime import datetime, timedelta
|
||||
from typing import Annotated
|
||||
from uuid import UUID
|
||||
|
||||
from fastapi import APIRouter, Depends, File, HTTPException, UploadFile
|
||||
from fastapi.responses import FileResponse
|
||||
from middleware.auth import SignRequired
|
||||
from models.response import ResponseBase
|
||||
from loguru import logger as l
|
||||
|
||||
from middleware.auth import AuthRequired, SignRequired
|
||||
from middleware.dependencies import SessionDep
|
||||
from models import (
|
||||
CreateFileRequest,
|
||||
CreateUploadSessionRequest,
|
||||
Object,
|
||||
ObjectType,
|
||||
PhysicalFile,
|
||||
Policy,
|
||||
PolicyType,
|
||||
UploadChunkResponse,
|
||||
UploadSession,
|
||||
UploadSessionResponse,
|
||||
User,
|
||||
)
|
||||
from models import ResponseBase
|
||||
from service.storage import LocalStorageService, StorageFileNotFoundError
|
||||
|
||||
file_router = APIRouter(
|
||||
prefix="/file",
|
||||
@@ -13,370 +43,614 @@ file_upload_router = APIRouter(
|
||||
tags=["file"]
|
||||
)
|
||||
|
||||
@file_router.get(
|
||||
path='/get/{id}/{name}',
|
||||
summary='文件外链（直接输出文件数据）',
|
||||
description='Get file external link endpoint.',
|
||||
)
|
||||
def router_file_get(id: str, name: str) -> FileResponse:
|
||||
"""
|
||||
Get file external link endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file.
|
||||
name (str): The name of the file.
|
||||
|
||||
Returns:
|
||||
FileResponse: A response containing the file data.
|
||||
"""
|
||||
pass
|
||||
|
||||
@file_router.get(
|
||||
path='/source/{id}/{name}',
|
||||
summary='文件外链(301跳转)',
|
||||
description='Get file external link with 301 redirect endpoint.',
|
||||
)
|
||||
def router_file_source(id: str, name: str) -> ResponseBase:
|
||||
"""
|
||||
Get file external link with 301 redirect endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file.
|
||||
name (str): The name of the file.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file with a redirect.
|
||||
"""
|
||||
pass
|
||||
|
||||
@file_upload_router.get(
|
||||
path='/download/{id}',
|
||||
summary='下载文件',
|
||||
description='Download file endpoint.',
|
||||
)
|
||||
def router_file_download(id: str) -> ResponseBase:
|
||||
"""
|
||||
Download file endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file to download.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file download.
|
||||
"""
|
||||
pass
|
||||
|
||||
@file_upload_router.get(
|
||||
path='/archive/{sessionID}/archive.zip',
|
||||
summary='打包并下载文件',
|
||||
description='Archive and download files endpoint.',
|
||||
)
|
||||
def router_file_archive_download(sessionID: str) -> ResponseBase:
|
||||
"""
|
||||
Archive and download files endpoint.
|
||||
|
||||
Args:
|
||||
sessionID (str): The session ID for the archive.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the archived files download.
|
||||
"""
|
||||
pass
|
||||
|
||||
@file_upload_router.post(
|
||||
path='/{sessionID}/{index}',
|
||||
summary='文件上传',
|
||||
description='File upload endpoint.',
|
||||
)
|
||||
def router_file_upload(sessionID: str, index: int, file: UploadFile) -> ResponseBase:
|
||||
"""
|
||||
File upload endpoint.
|
||||
|
||||
Args:
|
||||
sessionID (str): The session ID for the upload.
|
||||
index (int): The index of the file being uploaded.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data.
|
||||
"""
|
||||
pass
|
||||
# ==================== 上传会话管理 ====================
|
||||
|
||||
@file_upload_router.put(
|
||||
path='/',
|
||||
summary='创建上传会话',
|
||||
description='Create an upload session endpoint.',
|
||||
dependencies=[Depends(SignRequired)],
|
||||
description='创建文件上传会话，返回会话ID用于后续分片上传。',
|
||||
)
|
||||
def router_file_upload_session() -> ResponseBase:
|
||||
async def create_upload_session(
|
||||
session: SessionDep,
|
||||
user: Annotated[User, Depends(AuthRequired)],
|
||||
request: CreateUploadSessionRequest,
|
||||
) -> UploadSessionResponse:
|
||||
"""
|
||||
Create an upload session endpoint.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the upload session.
|
||||
创建上传会话端点
|
||||
|
||||
流程：
|
||||
1. 验证父目录存在且属于当前用户
|
||||
2. 确定存储策略（使用指定的或继承父目录的）
|
||||
3. 验证文件大小限制
|
||||
4. 创建上传会话并生成存储路径
|
||||
5. 返回会话信息
|
||||
|
||||
:param session: 数据库会话
|
||||
:param user: 当前登录用户
|
||||
:param request: 创建请求
|
||||
:return: 上传会话信息
|
||||
"""
|
||||
pass
|
||||
# 验证文件名
|
||||
if not request.file_name or '/' in request.file_name or '\\' in request.file_name:
|
||||
raise HTTPException(status_code=400, detail="无效的文件名")
|
||||
|
||||
# 验证父目录
|
||||
parent = await Object.get(session, Object.id == request.parent_id)
|
||||
if not parent or parent.owner_id != user.id:
|
||||
raise HTTPException(status_code=404, detail="父目录不存在")
|
||||
|
||||
if not parent.is_folder:
|
||||
raise HTTPException(status_code=400, detail="父对象不是目录")
|
||||
|
||||
# 确定存储策略
|
||||
policy_id = request.policy_id or parent.policy_id
|
||||
policy = await Policy.get(session, Policy.id == policy_id)
|
||||
if not policy:
|
||||
raise HTTPException(status_code=404, detail="存储策略不存在")
|
||||
|
||||
# 验证文件大小限制
|
||||
if policy.max_size > 0 and request.file_size > policy.max_size:
|
||||
raise HTTPException(
|
||||
status_code=400,
|
||||
detail=f"文件大小超过限制 ({policy.max_size} bytes)"
|
||||
)
|
||||
|
||||
# 检查是否已存在同名文件
|
||||
existing = await Object.get(
|
||||
session,
|
||||
(Object.owner_id == user.id) &
|
||||
(Object.parent_id == parent.id) &
|
||||
(Object.name == request.file_name)
|
||||
)
|
||||
if existing:
|
||||
raise HTTPException(status_code=409, detail="同名文件已存在")
|
||||
|
||||
# 计算分片信息
|
||||
options = await policy.awaitable_attrs.options
|
||||
chunk_size = options.chunk_size if options else 52428800 # 默认 50MB
|
||||
total_chunks = max(1, (request.file_size + chunk_size - 1) // chunk_size) if request.file_size > 0 else 1
|
||||
|
||||
# 生成存储路径
|
||||
storage_path: str | None = None
|
||||
if policy.type == PolicyType.LOCAL:
|
||||
storage_service = LocalStorageService(policy)
|
||||
dir_path, storage_name, full_path = await storage_service.generate_file_path(
|
||||
user_id=user.id,
|
||||
original_filename=request.file_name,
|
||||
)
|
||||
storage_path = full_path
|
||||
else:
|
||||
# S3 后续实现
|
||||
raise HTTPException(status_code=501, detail="S3 存储暂未实现")
|
||||
|
||||
# 创建上传会话
|
||||
upload_session = UploadSession(
|
||||
file_name=request.file_name,
|
||||
file_size=request.file_size,
|
||||
chunk_size=chunk_size,
|
||||
total_chunks=total_chunks,
|
||||
storage_path=storage_path,
|
||||
expires_at=datetime.now() + timedelta(hours=24), # 24小时过期
|
||||
owner_id=user.id,
|
||||
parent_id=request.parent_id,
|
||||
policy_id=policy_id,
|
||||
)
|
||||
upload_session = await upload_session.save(session)
|
||||
|
||||
l.info(f"创建上传会话: {upload_session.id}, 文件: {request.file_name}, 大小: {request.file_size}")
|
||||
|
||||
return UploadSessionResponse(
|
||||
id=upload_session.id,
|
||||
file_name=upload_session.file_name,
|
||||
file_size=upload_session.file_size,
|
||||
chunk_size=upload_session.chunk_size,
|
||||
total_chunks=upload_session.total_chunks,
|
||||
uploaded_chunks=0,
|
||||
expires_at=upload_session.expires_at,
|
||||
)
|
||||
|
||||
|
||||
@file_upload_router.post(
|
||||
path='/{session_id}/{chunk_index}',
|
||||
summary='上传文件分片',
|
||||
description='上传指定分片，分片索引从0开始。',
|
||||
)
|
||||
async def upload_chunk(
|
||||
session: SessionDep,
|
||||
user: Annotated[User, Depends(AuthRequired)],
|
||||
session_id: UUID,
|
||||
chunk_index: int,
|
||||
file: UploadFile = File(...),
|
||||
) -> UploadChunkResponse:
|
||||
"""
|
||||
上传文件分片端点
|
||||
|
||||
流程：
|
||||
1. 验证上传会话
|
||||
2. 写入分片数据
|
||||
3. 更新会话进度
|
||||
4. 如果所有分片上传完成，创建 Object 记录
|
||||
|
||||
:param session: 数据库会话
|
||||
:param user: 当前登录用户
|
||||
:param session_id: 上传会话UUID
|
||||
:param chunk_index: 分片索引（从0开始）
|
||||
:param file: 上传的文件分片
|
||||
:return: 上传进度信息
|
||||
"""
|
||||
# 获取上传会话
|
||||
upload_session = await UploadSession.get(session, UploadSession.id == session_id)
|
||||
if not upload_session or upload_session.owner_id != user.id:
|
||||
raise HTTPException(status_code=404, detail="上传会话不存在")
|
||||
|
||||
if upload_session.is_expired:
|
||||
raise HTTPException(status_code=400, detail="上传会话已过期")
|
||||
|
||||
# 存储 user.id，避免后续 save() 导致 user 过期后无法访问
|
||||
user_id = user.id
|
||||
|
||||
if chunk_index < 0 or chunk_index >= upload_session.total_chunks:
|
||||
raise HTTPException(status_code=400, detail="无效的分片索引")
|
||||
|
||||
# 获取策略
|
||||
policy = await Policy.get(session, Policy.id == upload_session.policy_id)
|
||||
if not policy:
|
||||
raise HTTPException(status_code=500, detail="存储策略不存在")
|
||||
|
||||
# 读取分片内容
|
||||
content = await file.read()
|
||||
|
||||
# 写入分片
|
||||
if policy.type == PolicyType.LOCAL:
|
||||
if not upload_session.storage_path:
|
||||
raise HTTPException(status_code=500, detail="存储路径丢失")
|
||||
|
||||
storage_service = LocalStorageService(policy)
|
||||
offset = chunk_index * upload_session.chunk_size
|
||||
await storage_service.write_file_chunk(
|
||||
upload_session.storage_path,
|
||||
content,
|
||||
offset,
|
||||
)
|
||||
else:
|
||||
raise HTTPException(status_code=501, detail="S3 存储暂未实现")
|
||||
|
||||
# 更新会话进度
|
||||
upload_session.uploaded_chunks += 1
|
||||
upload_session.uploaded_size += len(content)
|
||||
upload_session = await upload_session.save(session)
|
||||
|
||||
# 检查是否完成
|
||||
is_complete = upload_session.is_complete
|
||||
file_object_id: UUID | None = None
|
||||
|
||||
if is_complete:
|
||||
# 创建 PhysicalFile 记录
|
||||
physical_file = PhysicalFile(
|
||||
storage_path=upload_session.storage_path,
|
||||
size=upload_session.uploaded_size,
|
||||
policy_id=upload_session.policy_id,
|
||||
reference_count=1,
|
||||
)
|
||||
physical_file = await physical_file.save(session)
|
||||
|
||||
# 创建 Object 记录
|
||||
file_object = Object(
|
||||
name=upload_session.file_name,
|
||||
type=ObjectType.FILE,
|
||||
size=upload_session.uploaded_size,
|
||||
physical_file_id=physical_file.id,
|
||||
upload_session_id=str(upload_session.id),
|
||||
parent_id=upload_session.parent_id,
|
||||
owner_id=user_id,
|
||||
policy_id=upload_session.policy_id,
|
||||
)
|
||||
file_object = await file_object.save(session)
|
||||
file_object_id = file_object.id
|
||||
|
||||
# 删除上传会话
|
||||
await UploadSession.delete(session, upload_session)
|
||||
|
||||
l.info(f"文件上传完成: {file_object.name}, size={file_object.size}, id={file_object.id}")
|
||||
|
||||
return UploadChunkResponse(
|
||||
uploaded_chunks=upload_session.uploaded_chunks if not is_complete else upload_session.total_chunks,
|
||||
total_chunks=upload_session.total_chunks,
|
||||
is_complete=is_complete,
|
||||
object_id=file_object_id,
|
||||
)
|
||||
|
||||
|
||||
@file_upload_router.delete(
|
||||
path='/{sessionID}',
|
||||
path='/{session_id}',
|
||||
summary='删除上传会话',
|
||||
description='Delete an upload session endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='取消上传并删除会话及已上传的临时文件。',
|
||||
)
|
||||
def router_file_upload_session_delete(sessionID: str) -> ResponseBase:
|
||||
async def delete_upload_session(
|
||||
session: SessionDep,
|
||||
user: Annotated[User, Depends(AuthRequired)],
|
||||
session_id: UUID,
|
||||
) -> ResponseBase:
|
||||
"""
|
||||
Delete an upload session endpoint.
|
||||
|
||||
Args:
|
||||
sessionID (str): The session ID to delete.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the deletion.
|
||||
删除上传会话端点
|
||||
|
||||
:param session: 数据库会话
|
||||
:param user: 当前登录用户
|
||||
:param session_id: 上传会话UUID
|
||||
:return: 删除结果
|
||||
"""
|
||||
pass
|
||||
upload_session = await UploadSession.get(session, UploadSession.id == session_id)
|
||||
if not upload_session or upload_session.owner_id != user.id:
|
||||
raise HTTPException(status_code=404, detail="上传会话不存在")
|
||||
|
||||
# 删除临时文件
|
||||
policy = await Policy.get(session, Policy.id == upload_session.policy_id)
|
||||
if policy and policy.type == PolicyType.LOCAL and upload_session.storage_path:
|
||||
storage_service = LocalStorageService(policy)
|
||||
await storage_service.delete_file(upload_session.storage_path)
|
||||
|
||||
# 删除会话记录
|
||||
await UploadSession.delete(session, upload_session)
|
||||
|
||||
l.info(f"删除上传会话: {session_id}")
|
||||
|
||||
return ResponseBase(data={"deleted": True})
|
||||
|
||||
|
||||
@file_upload_router.delete(
|
||||
path='/',
|
||||
summary='清除所有上传会话',
|
||||
description='Clear all upload sessions endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='清除当前用户的所有上传会话。',
|
||||
)
|
||||
def router_file_upload_session_clear() -> ResponseBase:
|
||||
async def clear_upload_sessions(
|
||||
session: SessionDep,
|
||||
user: Annotated[User, Depends(AuthRequired)],
|
||||
) -> ResponseBase:
|
||||
"""
|
||||
Clear all upload sessions endpoint.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for clearing all sessions.
|
||||
"""
|
||||
pass
|
||||
清除所有上传会话端点
|
||||
|
||||
@file_router.put(
|
||||
path='/update/{id}',
|
||||
summary='更新文件',
|
||||
description='Update file information endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
:param session: 数据库会话
|
||||
:param user: 当前登录用户
|
||||
:return: 清除结果
|
||||
"""
|
||||
# 获取所有会话
|
||||
sessions = await UploadSession.get(
|
||||
session,
|
||||
UploadSession.owner_id == user.id,
|
||||
fetch_mode="all"
|
||||
)
|
||||
|
||||
deleted_count = 0
|
||||
for upload_session in sessions:
|
||||
# 删除临时文件
|
||||
policy = await Policy.get(session, Policy.id == upload_session.policy_id)
|
||||
if policy and policy.type == PolicyType.LOCAL and upload_session.storage_path:
|
||||
storage_service = LocalStorageService(policy)
|
||||
await storage_service.delete_file(upload_session.storage_path)
|
||||
|
||||
await UploadSession.delete(session, upload_session)
|
||||
deleted_count += 1
|
||||
|
||||
l.info(f"清除用户 {user.id} 的所有上传会话，共 {deleted_count} 个")
|
||||
|
||||
return ResponseBase(data={"deleted": deleted_count})
|
||||
|
||||
|
||||
# ==================== 文件下载 ====================
|
||||
|
||||
@file_upload_router.get(
|
||||
path='/download/{file_id}',
|
||||
summary='下载文件',
|
||||
description='下载指定文件。',
|
||||
)
|
||||
def router_file_update(id: str) -> ResponseBase:
|
||||
async def download_file(
|
||||
session: SessionDep,
|
||||
user: Annotated[User, Depends(AuthRequired)],
|
||||
file_id: UUID,
|
||||
) -> FileResponse:
|
||||
"""
|
||||
Update file information endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file to update.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file update.
|
||||
下载文件端点
|
||||
|
||||
:param session: 数据库会话
|
||||
:param user: 当前登录用户
|
||||
:param file_id: 文件UUID
|
||||
:return: 文件响应
|
||||
"""
|
||||
pass
|
||||
file_obj = await Object.get(session, Object.id == file_id)
|
||||
if not file_obj or file_obj.owner_id != user.id:
|
||||
raise HTTPException(status_code=404, detail="文件不存在")
|
||||
|
||||
if not file_obj.is_file:
|
||||
raise HTTPException(status_code=400, detail="对象不是文件")
|
||||
|
||||
if not file_obj.source_name:
|
||||
raise HTTPException(status_code=500, detail="文件存储路径丢失")
|
||||
|
||||
# 获取策略
|
||||
policy = await Policy.get(session, Policy.id == file_obj.policy_id)
|
||||
if not policy:
|
||||
raise HTTPException(status_code=500, detail="存储策略不存在")
|
||||
|
||||
if policy.type == PolicyType.LOCAL:
|
||||
storage_service = LocalStorageService(policy)
|
||||
if not await storage_service.file_exists(file_obj.source_name):
|
||||
raise HTTPException(status_code=404, detail="物理文件不存在")
|
||||
|
||||
return FileResponse(
|
||||
path=file_obj.source_name,
|
||||
filename=file_obj.name,
|
||||
media_type="application/octet-stream",
|
||||
)
|
||||
else:
|
||||
raise HTTPException(status_code=501, detail="S3 存储暂未实现")
|
||||
|
||||
|
||||
# ==================== 创建空白文件 ====================
|
||||
|
||||
@file_router.post(
|
||||
path='/create',
|
||||
summary='创建空白文件',
|
||||
description='Create a blank file endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='在指定目录下创建空白文件。',
|
||||
)
|
||||
def router_file_create() -> ResponseBase:
|
||||
async def create_empty_file(
|
||||
session: SessionDep,
|
||||
user: Annotated[User, Depends(AuthRequired)],
|
||||
request: CreateFileRequest,
|
||||
) -> ResponseBase:
|
||||
"""
|
||||
Create a blank file endpoint.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file creation.
|
||||
创建空白文件端点
|
||||
|
||||
:param session: 数据库会话
|
||||
:param user: 当前登录用户
|
||||
:param request: 创建请求
|
||||
:return: 创建结果
|
||||
"""
|
||||
pass
|
||||
# 存储 user.id，避免后续 save() 导致 user 过期后无法访问
|
||||
user_id = user.id
|
||||
|
||||
# 验证文件名
|
||||
if not request.name or '/' in request.name or '\\' in request.name:
|
||||
raise HTTPException(status_code=400, detail="无效的文件名")
|
||||
|
||||
# 验证父目录
|
||||
parent = await Object.get(session, Object.id == request.parent_id)
|
||||
if not parent or parent.owner_id != user_id:
|
||||
raise HTTPException(status_code=404, detail="父目录不存在")
|
||||
|
||||
if not parent.is_folder:
|
||||
raise HTTPException(status_code=400, detail="父对象不是目录")
|
||||
|
||||
# 检查是否已存在同名文件
|
||||
existing = await Object.get(
|
||||
session,
|
||||
(Object.owner_id == user_id) &
|
||||
(Object.parent_id == parent.id) &
|
||||
(Object.name == request.name)
|
||||
)
|
||||
if existing:
|
||||
raise HTTPException(status_code=409, detail="同名文件已存在")
|
||||
|
||||
# 确定存储策略
|
||||
policy_id = request.policy_id or parent.policy_id
|
||||
policy = await Policy.get(session, Policy.id == policy_id)
|
||||
if not policy:
|
||||
raise HTTPException(status_code=404, detail="存储策略不存在")
|
||||
|
||||
# 生成存储路径并创建空文件
|
||||
storage_path: str | None = None
|
||||
if policy.type == PolicyType.LOCAL:
|
||||
storage_service = LocalStorageService(policy)
|
||||
dir_path, storage_name, full_path = await storage_service.generate_file_path(
|
||||
user_id=user_id,
|
||||
original_filename=request.name,
|
||||
)
|
||||
await storage_service.create_empty_file(full_path)
|
||||
storage_path = full_path
|
||||
else:
|
||||
raise HTTPException(status_code=501, detail="S3 存储暂未实现")
|
||||
|
||||
# 创建 PhysicalFile 记录
|
||||
physical_file = PhysicalFile(
|
||||
storage_path=storage_path,
|
||||
size=0,
|
||||
policy_id=policy_id,
|
||||
reference_count=1,
|
||||
)
|
||||
physical_file = await physical_file.save(session)
|
||||
|
||||
# 创建 Object 记录
|
||||
file_object = Object(
|
||||
name=request.name,
|
||||
type=ObjectType.FILE,
|
||||
size=0,
|
||||
physical_file_id=physical_file.id,
|
||||
parent_id=request.parent_id,
|
||||
owner_id=user_id,
|
||||
policy_id=policy_id,
|
||||
)
|
||||
file_object = await file_object.save(session)
|
||||
|
||||
l.info(f"创建空白文件: {file_object.name}, id={file_object.id}")
|
||||
|
||||
return ResponseBase(data={
|
||||
"id": str(file_object.id),
|
||||
"name": file_object.name,
|
||||
"size": file_object.size,
|
||||
})
|
||||
|
||||
|
||||
# ==================== 文件外链（保留原有端点结构） ====================
|
||||
|
||||
@file_router.get(
|
||||
path='/get/{id}/{name}',
|
||||
summary='文件外链（直接输出文件数据）',
|
||||
description='通过外链直接获取文件内容。',
|
||||
)
|
||||
async def router_file_get(
|
||||
session: SessionDep,
|
||||
id: str,
|
||||
name: str,
|
||||
) -> FileResponse:
|
||||
"""
|
||||
文件外链端点（直接输出）
|
||||
|
||||
TODO: 实现签名验证和权限控制
|
||||
"""
|
||||
raise HTTPException(status_code=501, detail="外链功能暂未实现")
|
||||
|
||||
|
||||
@file_router.get(
|
||||
path='/source/{id}/{name}',
|
||||
summary='文件外链(301跳转)',
|
||||
description='通过外链获取文件重定向地址。',
|
||||
)
|
||||
async def router_file_source_redirect(id: str, name: str) -> ResponseBase:
|
||||
"""
|
||||
文件外链端点（301跳转）
|
||||
|
||||
TODO: 实现签名验证和重定向
|
||||
"""
|
||||
raise HTTPException(status_code=501, detail="外链功能暂未实现")
|
||||
|
||||
|
||||
@file_router.put(
|
||||
path='/download/{id}',
|
||||
summary='创建文件下载会话',
|
||||
description='Create a file download session endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
path='/update/{id}',
|
||||
summary='更新文件',
|
||||
description='更新文件内容。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
def router_file_download(id: str) -> ResponseBase:
|
||||
"""
|
||||
Create a file download session endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file to download.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file download session.
|
||||
"""
|
||||
pass
|
||||
async def router_file_update(id: str) -> ResponseBase:
|
||||
"""更新文件内容"""
|
||||
raise HTTPException(status_code=501, detail="更新文件功能暂未实现")
|
||||
|
||||
|
||||
@file_router.get(
|
||||
path='/preview/{id}',
|
||||
summary='预览文件',
|
||||
description='Preview file endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='获取文件预览。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
def router_file_preview(id: str) -> ResponseBase:
|
||||
"""
|
||||
Preview file endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file to preview.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file preview.
|
||||
"""
|
||||
pass
|
||||
async def router_file_preview(id: str) -> ResponseBase:
|
||||
"""预览文件"""
|
||||
raise HTTPException(status_code=501, detail="预览功能暂未实现")
|
||||
|
||||
|
||||
@file_router.get(
|
||||
path='/content/{id}',
|
||||
summary='获取文本文件内容',
|
||||
description='Get text file content endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='获取文本文件内容。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
def router_file_content(id: str) -> ResponseBase:
|
||||
"""
|
||||
Get text file content endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the text file.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the text file content.
|
||||
"""
|
||||
pass
|
||||
async def router_file_content(id: str) -> ResponseBase:
|
||||
"""获取文本文件内容"""
|
||||
raise HTTPException(status_code=501, detail="文本内容功能暂未实现")
|
||||
|
||||
|
||||
@file_router.get(
|
||||
path='/doc/{id}',
|
||||
summary='获取Office文档预览地址',
|
||||
description='Get Office document preview URL endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='获取Office文档在线预览地址。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
def router_file_doc(id: str) -> ResponseBase:
|
||||
"""
|
||||
Get Office document preview URL endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the Office document.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the Office document preview URL.
|
||||
"""
|
||||
pass
|
||||
async def router_file_doc(id: str) -> ResponseBase:
|
||||
"""获取Office文档预览地址"""
|
||||
raise HTTPException(status_code=501, detail="Office预览功能暂未实现")
|
||||
|
||||
|
||||
@file_router.get(
|
||||
path='/thumb/{id}',
|
||||
summary='获取文件缩略图',
|
||||
description='Get file thumbnail endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='获取文件缩略图。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
def router_file_thumb(id: str) -> ResponseBase:
|
||||
"""
|
||||
Get file thumbnail endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file to get the thumbnail for.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file thumbnail.
|
||||
"""
|
||||
pass
|
||||
async def router_file_thumb(id: str) -> ResponseBase:
|
||||
"""获取文件缩略图"""
|
||||
raise HTTPException(status_code=501, detail="缩略图功能暂未实现")
|
||||
|
||||
|
||||
@file_router.post(
|
||||
path='/source/{id}',
|
||||
summary='取得文件外链',
|
||||
description='Get file external link endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='获取文件的外链地址。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
def router_file_source(id: str) -> ResponseBase:
|
||||
"""
|
||||
Get file external link endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file to get the external link for.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file external link.
|
||||
"""
|
||||
pass
|
||||
async def router_file_source(id: str) -> ResponseBase:
|
||||
"""获取文件外链"""
|
||||
raise HTTPException(status_code=501, detail="外链功能暂未实现")
|
||||
|
||||
|
||||
@file_router.post(
|
||||
path='/archive',
|
||||
summary='打包要下载的文件',
|
||||
description='Archive files for download endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='将多个文件打包下载。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
def router_file_archive(id: str) -> ResponseBase:
|
||||
"""
|
||||
Archive files for download endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file to archive.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the archived files.
|
||||
"""
|
||||
pass
|
||||
async def router_file_archive() -> ResponseBase:
|
||||
"""打包文件"""
|
||||
raise HTTPException(status_code=501, detail="打包功能暂未实现")
|
||||
|
||||
|
||||
@file_router.post(
|
||||
path='/compress',
|
||||
summary='创建文件压缩任务',
|
||||
description='Create file compression task endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='创建文件压缩任务。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
def router_file_compress(id: str) -> ResponseBase:
|
||||
"""
|
||||
Create file compression task endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file to compress.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file compression task.
|
||||
"""
|
||||
pass
|
||||
async def router_file_compress() -> ResponseBase:
|
||||
"""创建压缩任务"""
|
||||
raise HTTPException(status_code=501, detail="压缩功能暂未实现")
|
||||
|
||||
|
||||
@file_router.post(
|
||||
path='/decompress',
|
||||
summary='创建文件解压任务',
|
||||
description='Create file extraction task endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='创建文件解压任务。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
def router_file_decompress(id: str) -> ResponseBase:
|
||||
"""
|
||||
Create file extraction task endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file to decompress.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file extraction task.
|
||||
"""
|
||||
pass
|
||||
async def router_file_decompress() -> ResponseBase:
|
||||
"""创建解压任务"""
|
||||
raise HTTPException(status_code=501, detail="解压功能暂未实现")
|
||||
|
||||
|
||||
@file_router.post(
|
||||
path='/relocate',
|
||||
summary='创建文件转移任务',
|
||||
description='Create file relocation task endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='创建文件转移任务。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
def router_file_relocate(id: str) -> ResponseBase:
|
||||
"""
|
||||
Create file relocation task endpoint.
|
||||
|
||||
Args:
|
||||
id (str): The ID of the file to relocate.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file relocation task.
|
||||
"""
|
||||
pass
|
||||
async def router_file_relocate() -> ResponseBase:
|
||||
"""创建转移任务"""
|
||||
raise HTTPException(status_code=501, detail="转移功能暂未实现")
|
||||
|
||||
|
||||
@file_router.get(
|
||||
path='/search/{type}/{keyword}',
|
||||
summary='搜索文件',
|
||||
description='Search files by keyword endpoint.',
|
||||
dependencies=[Depends(SignRequired)]
|
||||
description='按关键字搜索文件。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
def router_file_search(type: str, keyword: str) -> ResponseBase:
|
||||
"""
|
||||
Search files by keyword endpoint.
|
||||
|
||||
Args:
|
||||
type (str): The type of search (e.g., 'name', 'content').
|
||||
keyword (str): The keyword to search for.
|
||||
|
||||
Returns:
|
||||
ResponseBase: A model containing the response data for the file search.
|
||||
"""
|
||||
pass
|
||||
async def router_file_search(type: str, keyword: str) -> ResponseBase:
|
||||
"""搜索文件"""
|
||||
raise HTTPException(status_code=501, detail="搜索功能暂未实现")
|
||||
|
||||
|
||||
@file_upload_router.get(
|
||||
path='/archive/{sessionID}/archive.zip',
|
||||
summary='打包并下载文件',
|
||||
description='获取打包后的文件。',
|
||||
)
|
||||
async def router_file_archive_download(sessionID: str) -> ResponseBase:
|
||||
"""打包下载"""
|
||||
raise HTTPException(status_code=501, detail="打包下载功能暂未实现")
|
||||
|
||||
|
||||
@file_router.put(
|
||||
path='/download/{id}',
|
||||
summary='创建文件下载会话',
|
||||
description='创建文件下载会话。',
|
||||
dependencies=[Depends(AuthRequired)]
|
||||
)
|
||||
async def router_file_download_session(id: str) -> ResponseBase:
|
||||
"""创建下载会话"""
|
||||
raise HTTPException(status_code=501, detail="下载会话功能暂未实现")
|
||||
|
||||
Reference in New Issue
Block a user