feat: 添加路径收藏功能

2025-05-23 18:47:04 +08:00
parent f8282fe9c0
commit ae60e0c398
15 changed files with 1269 additions and 7 deletions
@@ -0,0 +1,227 @@
+import { Request, Response } from 'express';
+import * as FavoritePathsService from '../services/favorite-paths.service';
+import { FavoritePathSortBy } from '../services/favorite-paths.service';
+
+/**
+ * 处理添加新收藏路径的请求
+ */
+export const createFavoritePath = async (req: Request, res: Response): Promise<void> => {
+    const { name, path } = req.body;
+
+    if (!path || typeof path !== 'string' || path.trim().length === 0) {
+        res.status(400).json({ message: '路径内容不能为空' });
+        return;
+    }
+    if (name !== null && typeof name !== 'string') {
+         res.status(400).json({ message: '名称必须是字符串或 null' });
+         return;
+    }
+
+    try {
+        const newId = await FavoritePathsService.addFavoritePath(name, path);
+        const newFavoritePath = await FavoritePathsService.getFavoritePathById(newId);
+        if (newFavoritePath) {
+            res.status(201).json({ message: '收藏路径已添加', favoritePath: newFavoritePath });
+        } else {
+             console.error(`[Controller] 添加收藏路径后未能找到 ID: ${newId}`);
+             res.status(201).json({ message: '收藏路径已添加，但无法检索新记录', id: newId });
+        }
+    } catch (error: any) {
+        console.error('[Controller] 添加收藏路径失败:', error.message);
+        res.status(500).json({ message: error.message || '无法添加收藏路径' });
+    }
+};
+
+/**
+ * 处理获取所有收藏路径的请求 (支持排序)
+ */
+export const getAllFavoritePaths = async (req: Request, res: Response): Promise<void> => {
+    const sortBy = req.query.sortBy as FavoritePathSortBy | undefined;
+    const validSortByOptions: FavoritePathSortBy[] = ['name', 'last_used_at'];
+    const validSortBy: FavoritePathSortBy = sortBy && validSortByOptions.includes(sortBy) ? sortBy : 'name';
+
+    try {
+        const favoritePaths = await FavoritePathsService.getAllFavoritePaths(validSortBy);
+        res.status(200).json(favoritePaths);
+    } catch (error: any) {
+        console.error('获取收藏路径控制器出错:', error);
+        res.status(500).json({ message: error.message || '无法获取收藏路径' });
+    }
+};
+
+/**
+ * 处理根据 ID 获取单个收藏路径的请求
+ */
+export const getFavoritePathById = async (req: Request, res: Response): Promise<void> => {
+    const id = parseInt(req.params.id, 10);
+
+    if (isNaN(id)) {
+        res.status(400).json({ message: '无效的 ID' });
+        return;
+    }
+
+    try {
+        const favoritePath = await FavoritePathsService.getFavoritePathById(id);
+        if (favoritePath) {
+            res.status(200).json(favoritePath);
+        } else {
+            res.status(404).json({ message: '未找到指定的收藏路径' });
+        }
+    } catch (error: any) {
+        console.error('获取单个收藏路径控制器出错:', error);
+        res.status(500).json({ message: error.message || '无法获取收藏路径' });
+    }
+};
+
+
+/**
+ * 处理更新收藏路径的请求
+ */
+export const updateFavoritePath = async (req: Request, res: Response): Promise<void> => {
+    const id = parseInt(req.params.id, 10);
+    const { name, path } = req.body;
+
+    if (isNaN(id)) {
+        res.status(400).json({ message: '无效的 ID' });
+        return;
+    }
+    if (!path || typeof path !== 'string' || path.trim().length === 0) {
+        res.status(400).json({ message: '路径内容不能为空' });
+        return;
+    }
+    if (name !== null && typeof name !== 'string') {
+         res.status(400).json({ message: '名称必须是字符串或 null' });
+         return;
+    }
+
+    try {
+        const success = await FavoritePathsService.updateFavoritePath(id, name, path);
+        if (success) {
+            const updatedFavoritePath = await FavoritePathsService.getFavoritePathById(id);
+            if (updatedFavoritePath) {
+                 res.status(200).json({ message: '收藏路径已更新', favoritePath: updatedFavoritePath });
+            } else {
+                 console.error(`[Controller] 更新收藏路径后未能找到 ID: ${id}`);
+                 res.status(200).json({ message: '收藏路径已更新，但无法检索更新后的记录' });
+            }
+        } else {
+            const pathExists = await FavoritePathsService.getFavoritePathById(id);
+            if (!pathExists) {
+                 res.status(404).json({ message: '未找到要更新的收藏路径' });
+            } else {
+                 console.error(`[Controller] 更新收藏路径 ${id} 失败，但路径存在。`);
+                 res.status(500).json({ message: '更新收藏路径时发生未知错误' });
+            }
+        }
+    } catch (error: any) {
+        console.error('更新收藏路径控制器出错:', error);
+        res.status(500).json({ message: error.message || '无法更新收藏路径' });
+    }
+};
+
+/**
+ * 处理删除收藏路径的请求
+ */
+export const deleteFavoritePath = async (req: Request, res: Response): Promise<void> => {
+    const id = parseInt(req.params.id, 10);
+
+    if (isNaN(id)) {
+        res.status(400).json({ message: '无效的 ID' });
+        return;
+    }
+
+    try {
+        const success = await FavoritePathsService.deleteFavoritePath(id);
+        if (success) {
+            res.status(200).json({ message: '收藏路径已删除' });
+        } else {
+            res.status(404).json({ message: '未找到要删除的收藏路径' });
+        }
+    } catch (error: any) {
+        console.error('删除收藏路径控制器出错:', error);
+        res.status(500).json({ message: error.message || '无法删除收藏路径' });
+    }
+};
+
+/**
+ * 处理更新收藏路径上次使用时间的请求
+ */
+export const incrementUsage = async (req: Request, res: Response): Promise<void> => {
+    const id = parseInt(req.params.id, 10);
+
+    if (isNaN(id)) {
+        res.status(400).json({ message: '无效的 ID' });
+        return;
+    }
+
+    try {
+        // 更新上次使用时间
+        const lastUsedSuccess = await FavoritePathsService.updateFavoritePathLastUsed(id);
+
+        if (lastUsedSuccess) {
+            const updatedPath = await FavoritePathsService.getFavoritePathById(id);
+            if (updatedPath) {
+                res.status(200).json({ message: '上次使用时间已更新', favoritePath: updatedPath });
+            } else {
+                 // 这种情况理论上不应该发生，因为 updateFavoritePathLastUsed 内部应该处理了路径不存在的情况
+                 // 收藏路径 (ID: ${id}) 上次使用时间已更新，但无法检索该路径。
+                 console.error(`[Controller] 收藏路径 (ID: ${id}) 上次使用时间已更新，但无法检索该路径。`);
+                 res.status(404).json({ message: '上次使用时间已更新，但无法检索更新后的收藏路径' });
+            }
+        } else {
+            // 更新失败，检查路径是否存在以提供更具体的错误信息
+            const pathExists = await FavoritePathsService.getFavoritePathById(id);
+            if (!pathExists) {
+                res.status(404).json({ message: '未找到要更新上次使用时间的收藏路径' });
+            } else {
+                // 路径存在，但更新操作失败
+                console.warn(`[Controller] 尝试更新收藏路径 (ID: ${id}) 的上次使用时间失败，但路径存在。`);
+                res.status(500).json({ message: '更新上次使用时间失败' });
+            }
+        }
+    } catch (error: any) {
+        console.error('更新收藏路径上次使用时间控制器出错:', error);
+        res.status(500).json({ message: error.message || '无法更新上次使用时间' });
+    }
+};
+
+/**
+ * 处理更新收藏路径上次使用时间戳的请求 (PUT)
+ */
+export const updateLastUsedTimestamp = async (req: Request, res: Response): Promise<void> => {
+    const id = parseInt(req.params.id, 10);
+
+    if (isNaN(id)) {
+        res.status(400).json({ message: '无效的 ID' });
+        return;
+    }
+
+    try {
+        // 更新上次使用时间
+        const success = await FavoritePathsService.updateFavoritePathLastUsed(id);
+
+        if (success) {
+            const updatedPath = await FavoritePathsService.getFavoritePathById(id);
+            if (updatedPath) {
+                res.status(200).json({ message: '上次使用时间戳已更新', favoritePath: updatedPath });
+            } else {
+                 // 这种情况理论上不应该发生，因为 updateFavoritePathLastUsed 内部应该处理了路径不存在的情况
+                 console.error(`[Controller] 收藏路径 (ID: ${id}) 上次使用时间戳已更新，但无法检索该路径。`);
+                 res.status(404).json({ message: '上次使用时间戳已更新，但无法检索更新后的收藏路径' });
+            }
+        } else {
+            // 更新失败，检查路径是否存在以提供更具体的错误信息
+            const pathExists = await FavoritePathsService.getFavoritePathById(id);
+            if (!pathExists) {
+                res.status(404).json({ message: '未找到要更新上次使用时间戳的收藏路径' });
+            } else {
+                // 路径存在，但更新操作失败
+                console.warn(`[Controller] 尝试更新收藏路径 (ID: ${id}) 的上次使用时间戳失败，但路径存在。`);
+                res.status(500).json({ message: '更新上次使用时间戳失败' });
+            }
+        }
+    } catch (error: any) {
+        console.error('更新收藏路径上次使用时间戳控制器出错:', error);
+        res.status(500).json({ message: error.message || '无法更新上次使用时间戳' });
+    }
+};
@@ -0,0 +1,18 @@
+import { Router } from 'express';
+import * as FavoritePathsController from './favorite-paths.controller';
+import { isAuthenticated } from '../auth/auth.middleware';
+
+const router = Router();
+
+// 应用认证中间件，确保所有路径收藏相关的API都需要用户认证
+router.use(isAuthenticated);
+
+// 定义路由
+router.post('/', FavoritePathsController.createFavoritePath); // POST /api/favorite-paths
+router.get('/', FavoritePathsController.getAllFavoritePaths); // GET /api/favorite-paths?sortBy=name|usage_count
+router.get('/:id', FavoritePathsController.getFavoritePathById); // GET /api/favorite-paths/:id
+router.put('/:id', FavoritePathsController.updateFavoritePath); // PUT /api/favorite-paths/:id
+router.delete('/:id', FavoritePathsController.deleteFavoritePath); // DELETE /api/favorite-paths/:id
+router.put('/:id/update-last-used', FavoritePathsController.updateLastUsedTimestamp); // PUT /api/favorite-paths/:id/update-last-used
+
+export default router;