web-文件接口

This commit is contained in:
2025-10-16 10:45:44 +08:00
parent 6858899c4c
commit 40ef609ea3
191 changed files with 2379 additions and 1593 deletions

View File

@@ -8,7 +8,7 @@ import java.util.List;
/**
* @description Banner服务接口
* @filename BannerService.java
* @author system
* @author yslg
* @copyright xyzh
* @since 2025-10-15
*/
@@ -18,7 +18,7 @@ public interface BannerService {
* @description 获取Banner列表
* @param status 状态(可选)
* @return ResultDomain<TbBanner> Banner列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbBanner> getBannerList(Integer status);
@@ -27,7 +27,7 @@ public interface BannerService {
* @description 根据ID获取Banner详情
* @param bannerID BannerID
* @return ResultDomain<TbBanner> Banner详情
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbBanner> getBannerById(String bannerID);
@@ -36,7 +36,7 @@ public interface BannerService {
* @description 创建Banner
* @param banner Banner信息
* @return ResultDomain<TbBanner> 创建结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbBanner> createBanner(TbBanner banner);
@@ -45,7 +45,7 @@ public interface BannerService {
* @description 更新Banner
* @param banner Banner信息
* @return ResultDomain<TbBanner> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbBanner> updateBanner(TbBanner banner);
@@ -54,7 +54,7 @@ public interface BannerService {
* @description 删除Banner
* @param bannerID BannerID
* @return ResultDomain<Boolean> 删除结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> deleteBanner(String bannerID);
@@ -64,7 +64,7 @@ public interface BannerService {
* @param bannerID BannerID
* @param status 状态
* @return ResultDomain<TbBanner> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbBanner> updateBannerStatus(String bannerID, Integer status);
@@ -74,7 +74,7 @@ public interface BannerService {
* @param bannerID BannerID
* @param orderNum 排序号
* @return ResultDomain<TbBanner> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbBanner> updateBannerOrder(String bannerID, Integer orderNum);
@@ -83,7 +83,7 @@ public interface BannerService {
* @description 获取启用的Banner列表按排序号排序
* @param limit 限制数量(可选)
* @return ResultDomain<TbBanner> 启用的Banner列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbBanner> getActiveBanners(Integer limit);
@@ -92,7 +92,7 @@ public interface BannerService {
* @description 批量更新Banner排序
* @param bannerOrders Banner排序信息BannerID -> 排序号)
* @return ResultDomain<Boolean> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> batchUpdateBannerOrder(java.util.Map<String, Integer> bannerOrders);

View File

@@ -8,7 +8,7 @@ import java.util.List;
/**
* @description 资源分类服务接口
* @filename ResourceCategoryService.java
* @author system
* @author yslg
* @copyright xyzh
* @since 2025-10-15
*/
@@ -17,7 +17,7 @@ public interface ResourceCategoryService {
/**
* @description 获取所有分类列表
* @return ResultDomain<TbResourceCategory> 分类列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceCategory> getAllCategories();
@@ -25,7 +25,7 @@ public interface ResourceCategoryService {
/**
* @description 获取分类树形结构
* @return ResultDomain<TbResourceCategory> 分类树
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceCategory> getCategoryTree();
@@ -34,7 +34,7 @@ public interface ResourceCategoryService {
* @description 根据ID获取分类详情
* @param categoryID 分类ID
* @return ResultDomain<TbResourceCategory> 分类详情
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceCategory> getCategoryById(String categoryID);
@@ -43,7 +43,7 @@ public interface ResourceCategoryService {
* @description 根据父ID获取子分类
* @param parentID 父分类ID
* @return ResultDomain<TbResourceCategory> 子分类列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceCategory> getCategoriesByParent(String parentID);
@@ -52,7 +52,7 @@ public interface ResourceCategoryService {
* @description 创建分类
* @param category 分类信息
* @return ResultDomain<TbResourceCategory> 创建结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceCategory> createCategory(TbResourceCategory category);
@@ -61,7 +61,7 @@ public interface ResourceCategoryService {
* @description 更新分类
* @param category 分类信息
* @return ResultDomain<TbResourceCategory> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceCategory> updateCategory(TbResourceCategory category);
@@ -70,7 +70,7 @@ public interface ResourceCategoryService {
* @description 删除分类
* @param categoryID 分类ID
* @return ResultDomain<Boolean> 删除结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> deleteCategory(String categoryID);
@@ -80,7 +80,7 @@ public interface ResourceCategoryService {
* @param categoryID 分类ID
* @param orderNum 排序号
* @return ResultDomain<TbResourceCategory> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceCategory> updateCategoryOrder(String categoryID, Integer orderNum);
@@ -89,7 +89,7 @@ public interface ResourceCategoryService {
* @description 检查分类是否有子分类
* @param categoryID 分类ID
* @return ResultDomain<Boolean> 是否有子分类
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> hasChildCategories(String categoryID);
@@ -98,7 +98,7 @@ public interface ResourceCategoryService {
* @description 检查分类下是否有资源
* @param categoryID 分类ID
* @return ResultDomain<Boolean> 是否有资源
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> hasResources(String categoryID);

View File

@@ -10,7 +10,7 @@ import java.util.List;
/**
* @description 数据采集服务接口
* @filename DataCollectionService.java
* @author system
* @author yslg
* @copyright xyzh
* @since 2025-10-15
*/
@@ -22,7 +22,7 @@ public interface DataCollectionService {
* @description 获取采集配置列表
* @param status 状态(可选)
* @return ResultDomain<TbDataCollectionConfig> 配置列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionConfig> getConfigList(Integer status);
@@ -31,7 +31,7 @@ public interface DataCollectionService {
* @description 根据ID获取配置详情
* @param configID 配置ID
* @return ResultDomain<TbDataCollectionConfig> 配置详情
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionConfig> getConfigById(String configID);
@@ -40,7 +40,7 @@ public interface DataCollectionService {
* @description 创建采集配置
* @param config 配置信息
* @return ResultDomain<TbDataCollectionConfig> 创建结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionConfig> createConfig(TbDataCollectionConfig config);
@@ -49,7 +49,7 @@ public interface DataCollectionService {
* @description 更新采集配置
* @param config 配置信息
* @return ResultDomain<TbDataCollectionConfig> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionConfig> updateConfig(TbDataCollectionConfig config);
@@ -58,7 +58,7 @@ public interface DataCollectionService {
* @description 删除采集配置
* @param configID 配置ID
* @return ResultDomain<Boolean> 删除结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> deleteConfig(String configID);
@@ -68,7 +68,7 @@ public interface DataCollectionService {
* @param configID 配置ID
* @param status 状态
* @return ResultDomain<TbDataCollectionConfig> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionConfig> updateConfigStatus(String configID, Integer status);
@@ -78,7 +78,7 @@ public interface DataCollectionService {
* @param configID 配置ID
* @param lastCollectTime 最后采集时间
* @return ResultDomain<TbDataCollectionConfig> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionConfig> updateLastCollectTime(String configID, Date lastCollectTime);
@@ -91,7 +91,7 @@ public interface DataCollectionService {
* @param startDate 开始日期(可选)
* @param endDate 结束日期(可选)
* @return ResultDomain<TbDataCollectionLog> 日志列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionLog> getLogList(String configID, Date startDate, Date endDate);
@@ -100,7 +100,7 @@ public interface DataCollectionService {
* @description 根据ID获取日志详情
* @param logID 日志ID
* @return ResultDomain<TbDataCollectionLog> 日志详情
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionLog> getLogById(String logID);
@@ -109,7 +109,7 @@ public interface DataCollectionService {
* @description 创建采集日志
* @param log 日志信息
* @return ResultDomain<TbDataCollectionLog> 创建结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionLog> createLog(TbDataCollectionLog log);
@@ -118,7 +118,7 @@ public interface DataCollectionService {
* @description 获取配置的采集统计
* @param configID 配置ID
* @return ResultDomain<TbDataCollectionLog> 采集统计
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionLog> getConfigStatistics(String configID);
@@ -129,7 +129,7 @@ public interface DataCollectionService {
* @description 执行数据采集
* @param configID 配置ID
* @return ResultDomain<TbDataCollectionLog> 采集结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionLog> executeCollection(String configID);
@@ -138,7 +138,7 @@ public interface DataCollectionService {
* @description 批量执行数据采集
* @param configIDs 配置ID列表
* @return ResultDomain<TbDataCollectionLog> 采集结果列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbDataCollectionLog> batchExecuteCollection(List<String> configIDs);
@@ -147,7 +147,7 @@ public interface DataCollectionService {
* @description 停止采集任务
* @param configID 配置ID
* @return ResultDomain<Boolean> 停止结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> stopCollection(String configID);
@@ -156,7 +156,7 @@ public interface DataCollectionService {
* @description 获取采集任务状态
* @param configID 配置ID
* @return ResultDomain<String> 任务状态
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<String> getCollectionStatus(String configID);

View File

@@ -8,7 +8,7 @@ import java.util.List;
/**
* @description 资源推荐服务接口
* @filename ResourceRecommendService.java
* @author system
* @author yslg
* @copyright xyzh
* @since 2025-10-15
*/
@@ -17,7 +17,7 @@ public interface ResourceRecommendService {
/**
* @description 获取推荐资源列表
* @return ResultDomain<TbResourceRecommend> 推荐资源列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceRecommend> getRecommendList();
@@ -26,7 +26,7 @@ public interface ResourceRecommendService {
* @description 添加推荐资源
* @param recommend 推荐信息
* @return ResultDomain<TbResourceRecommend> 添加结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceRecommend> addRecommend(TbResourceRecommend recommend);
@@ -35,7 +35,7 @@ public interface ResourceRecommendService {
* @description 移除推荐资源
* @param resourceID 资源ID
* @return ResultDomain<Boolean> 移除结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> removeRecommend(String resourceID);
@@ -45,7 +45,7 @@ public interface ResourceRecommendService {
* @param resourceID 资源ID
* @param orderNum 排序号
* @return ResultDomain<TbResourceRecommend> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceRecommend> updateRecommendOrder(String resourceID, Integer orderNum);
@@ -55,7 +55,7 @@ public interface ResourceRecommendService {
* @param resourceID 资源ID
* @param reason 推荐理由
* @return ResultDomain<TbResourceRecommend> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceRecommend> updateRecommendReason(String resourceID, String reason);
@@ -64,7 +64,7 @@ public interface ResourceRecommendService {
* @description 检查资源是否已推荐
* @param resourceID 资源ID
* @return ResultDomain<Boolean> 是否已推荐
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> isResourceRecommended(String resourceID);
@@ -74,7 +74,7 @@ public interface ResourceRecommendService {
* @param resourceIDs 资源ID列表
* @param reason 推荐理由
* @return ResultDomain<TbResourceRecommend> 添加结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceRecommend> batchAddRecommends(List<String> resourceIDs, String reason);
@@ -83,7 +83,7 @@ public interface ResourceRecommendService {
* @description 批量移除推荐资源
* @param resourceIDs 资源ID列表
* @return ResultDomain<Boolean> 移除结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> batchRemoveRecommends(List<String> resourceIDs);
@@ -92,7 +92,7 @@ public interface ResourceRecommendService {
* @description 获取推荐资源详情
* @param resourceID 资源ID
* @return ResultDomain<TbResourceRecommend> 推荐详情
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceRecommend> getRecommendDetail(String resourceID);

View File

@@ -8,7 +8,7 @@ import java.util.List;
/**
* @description 资源服务接口
* @filename ResourceService.java
* @author system
* @author yslg
* @copyright xyzh
* @since 2025-10-15
*/
@@ -18,7 +18,7 @@ public interface ResourceService {
* @description 获取资源列表
* @param filter 过滤条件
* @return ResultDomain<TbResource> 资源列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> getResourceList(TbResource filter);
@@ -27,7 +27,7 @@ public interface ResourceService {
* @description 根据ID获取资源详情
* @param resourceID 资源ID
* @return ResultDomain<TbResource> 资源详情
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> getResourceById(String resourceID);
@@ -36,7 +36,7 @@ public interface ResourceService {
* @description 创建资源
* @param resource 资源信息
* @return ResultDomain<TbResource> 创建结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> createResource(TbResource resource);
@@ -45,7 +45,7 @@ public interface ResourceService {
* @description 更新资源
* @param resource 资源信息
* @return ResultDomain<TbResource> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> updateResource(TbResource resource);
@@ -54,7 +54,7 @@ public interface ResourceService {
* @description 删除资源
* @param resourceID 资源ID
* @return ResultDomain<Boolean> 删除结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> deleteResource(String resourceID);
@@ -64,7 +64,7 @@ public interface ResourceService {
* @param resourceID 资源ID
* @param status 状态
* @return ResultDomain<TbResource> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> updateResourceStatus(String resourceID, Integer status);
@@ -73,7 +73,7 @@ public interface ResourceService {
* @description 发布资源
* @param resourceID 资源ID
* @return ResultDomain<TbResource> 发布结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> publishResource(String resourceID);
@@ -82,7 +82,7 @@ public interface ResourceService {
* @description 下架资源
* @param resourceID 资源ID
* @return ResultDomain<TbResource> 下架结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> unpublishResource(String resourceID);
@@ -91,7 +91,7 @@ public interface ResourceService {
* @description 增加浏览次数
* @param resourceID 资源ID
* @return ResultDomain<TbResource> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> incrementViewCount(String resourceID);
@@ -100,7 +100,7 @@ public interface ResourceService {
* @description 增加点赞次数
* @param resourceID 资源ID
* @return ResultDomain<TbResource> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> incrementLikeCount(String resourceID);
@@ -109,7 +109,7 @@ public interface ResourceService {
* @description 增加收藏次数
* @param resourceID 资源ID
* @return ResultDomain<TbResource> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> incrementCollectCount(String resourceID);
@@ -119,7 +119,7 @@ public interface ResourceService {
* @param resourceID 资源ID
* @param isRecommend 是否推荐
* @return ResultDomain<TbResource> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> setResourceRecommend(String resourceID, Boolean isRecommend);
@@ -129,7 +129,7 @@ public interface ResourceService {
* @param resourceID 资源ID
* @param isBanner 是否轮播
* @return ResultDomain<TbResource> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> setResourceBanner(String resourceID, Boolean isBanner);
@@ -138,7 +138,7 @@ public interface ResourceService {
* @description 获取推荐资源列表
* @param limit 限制数量
* @return ResultDomain<TbResource> 推荐资源列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> getRecommendResources(Integer limit);
@@ -147,7 +147,7 @@ public interface ResourceService {
* @description 获取轮播资源列表
* @param limit 限制数量
* @return ResultDomain<TbResource> 轮播资源列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> getBannerResources(Integer limit);
@@ -158,7 +158,7 @@ public interface ResourceService {
* @param categoryID 分类ID可选
* @param status 状态(可选)
* @return ResultDomain<TbResource> 搜索结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> searchResources(String keyword, String categoryID, Integer status);

View File

@@ -9,7 +9,7 @@ import java.util.List;
/**
* @description 标签服务接口
* @filename TagService.java
* @author system
* @author yslg
* @copyright xyzh
* @since 2025-10-15
*/
@@ -18,7 +18,7 @@ public interface TagService {
/**
* @description 获取所有标签
* @return ResultDomain<TbTag> 标签列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbTag> getAllTags();
@@ -27,7 +27,7 @@ public interface TagService {
* @description 根据ID获取标签详情
* @param tagID 标签ID
* @return ResultDomain<TbTag> 标签详情
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbTag> getTagById(String tagID);
@@ -36,7 +36,7 @@ public interface TagService {
* @description 创建标签
* @param tag 标签信息
* @return ResultDomain<TbTag> 创建结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbTag> createTag(TbTag tag);
@@ -45,7 +45,7 @@ public interface TagService {
* @description 更新标签
* @param tag 标签信息
* @return ResultDomain<TbTag> 更新结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbTag> updateTag(TbTag tag);
@@ -54,7 +54,7 @@ public interface TagService {
* @description 删除标签
* @param tagID 标签ID
* @return ResultDomain<Boolean> 删除结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> deleteTag(String tagID);
@@ -63,7 +63,7 @@ public interface TagService {
* @description 根据名称搜索标签
* @param name 标签名称
* @return ResultDomain<TbTag> 标签列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbTag> searchTagsByName(String name);
@@ -74,7 +74,7 @@ public interface TagService {
* @description 获取资源的标签
* @param resourceID 资源ID
* @return ResultDomain<TbTag> 标签列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbTag> getResourceTags(String resourceID);
@@ -84,7 +84,7 @@ public interface TagService {
* @param resourceID 资源ID
* @param tagID 标签ID
* @return ResultDomain<TbResourceTag> 添加结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceTag> addResourceTag(String resourceID, String tagID);
@@ -94,7 +94,7 @@ public interface TagService {
* @param resourceID 资源ID
* @param tagIDs 标签ID列表
* @return ResultDomain<TbResourceTag> 添加结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceTag> batchAddResourceTags(String resourceID, List<String> tagIDs);
@@ -104,7 +104,7 @@ public interface TagService {
* @param resourceID 资源ID
* @param tagID 标签ID
* @return ResultDomain<Boolean> 移除结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> removeResourceTag(String resourceID, String tagID);
@@ -113,7 +113,7 @@ public interface TagService {
* @description 清空资源的所有标签
* @param resourceID 资源ID
* @return ResultDomain<Boolean> 清空结果
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<Boolean> clearResourceTags(String resourceID);
@@ -122,7 +122,7 @@ public interface TagService {
* @description 根据标签获取资源列表
* @param tagID 标签ID
* @return ResultDomain<String> 资源ID列表
* @author system
* @author yslg
* @since 2025-10-15
*/
ResultDomain<String> getResourcesByTag(String tagID);