From 1808cd0769da0a746a93430ba1a3258856b92741 Mon Sep 17 00:00:00 2001
From: yn147 <2270338776@qq.com>
Date: 星期二, 04 四月 2023 09:59:55 +0800
Subject: [PATCH] 学生档案管理
---
src/main/java/com/qxueyou/scc/teach/res/service/IResService.java | 200 +++++++++++++++++++++++++-------------------------
1 files changed, 100 insertions(+), 100 deletions(-)
diff --git a/src/main/java/com/qxueyou/scc/teach/res/service/IResService.java b/src/main/java/com/qxueyou/scc/teach/res/service/IResService.java
index 0dca1c9..7e05147 100644
--- a/src/main/java/com/qxueyou/scc/teach/res/service/IResService.java
+++ b/src/main/java/com/qxueyou/scc/teach/res/service/IResService.java
@@ -11,47 +11,47 @@
public interface IResService {
/**
- * 初始化个人资源库
+ * 鍒濆鍖栦釜浜鸿祫婧愬簱
*
* @return
*/
Result initUserLib();
/**
- * 获取个人资源库
+ * 鑾峰彇涓汉璧勬簮搴�
*
* @return
*/
ResLib readUserLib();
/**
- * 读取个人资源库
+ * 璇诲彇涓汉璧勬簮搴�
*
- * @param type 资源库类型
+ * @param type 璧勬簮搴撶被鍨�
* @return
*/
ResLib getResLib(String type, String ownerId);
/**
- * 新增资源
+ * 鏂板璧勬簮
*
- * @param dirId 文件夹id
- * @param itemDestId 如果为视频，文档，文章等，则为文件id，如果为练习，则为exerciseGroupId
- * @param name 资源名称
- * @param remark 说明
- * @param type 资源类型
- * @param coverPageUrl 封面文件id，如果为练习，则为空
- * @return 上传结果:{"success":true,msg:"success",attrs:{"resId","90023afwe32300fee23"}},若成功，则返回resId
+ * @param dirId 鏂囦欢澶筰d
+ * @param itemDestId 濡傛灉涓鸿棰戯紝鏂囨。锛屾枃绔犵瓑锛屽垯涓烘枃浠秈d锛屽鏋滀负缁冧範锛屽垯涓篹xerciseGroupId
+ * @param name 璧勬簮鍚嶇О
+ * @param remark 璇存槑
+ * @param type 璧勬簮绫诲瀷
+ * @param coverPageUrl 灏侀潰鏂囦欢id锛屽鏋滀负缁冧範锛屽垯涓虹┖
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{"resId","90023afwe32300fee23"}},鑻ユ垚鍔燂紝鍒欒繑鍥瀝esId
*/
Result add(String dirId, String itemDestId, String name, String remark, String type, String coverPageUrl);
/**
- * 批量上传资源
+ * 鎵归噺涓婁紶璧勬簮
*/
Result addBatchRes(String dirId, String type, List<FileMeta> items);
/**
- * 返回资源
+ * 杩斿洖璧勬簮
*
* @param resId
* @return
@@ -59,179 +59,179 @@
Res read(String resId);
/**
- * 修改资源
+ * 淇敼璧勬簮
*
- * @param resId 资源id
- * @param name 名称
- * @param remark 说明
- * @param coverPageUrl 封面文件id，如果为练习，则为空
- * @return 上传结果:{"success":true,msg:"success",attrs:{}}
+ * @param resId 璧勬簮id
+ * @param name 鍚嶇О
+ * @param remark 璇存槑
+ * @param coverPageUrl 灏侀潰鏂囦欢id锛屽鏋滀负缁冧範锛屽垯涓虹┖
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{}}
*/
Result update(String resId, String name, String remark, String coverPageUrl);
/**
- * 删除资源
+ * 鍒犻櫎璧勬簮
*
- * @param resIds 资源id数组
- * @return 上传结果:{"success":true,msg:"success",attrs:{}}
+ * @param resIds 璧勬簮id鏁扮粍
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{}}
*/
Result delete(String[] resIds);
/**
- * 复制资源
+ * 澶嶅埗璧勬簮
*
- * @param resId 资源id数组
- * @param destDirId 目标文件夹id
- * @param name 资源名称
- * @return 上传结果:{"success":true,msg:"success",attrs:{}}
+ * @param resId 璧勬簮id鏁扮粍
+ * @param destDirId 鐩爣鏂囦欢澶筰d
+ * @param name 璧勬簮鍚嶇О
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{}}
*/
Result doCopy(String resId, String destDirId, String name);
/**
- * 移动资源
+ * 绉诲姩璧勬簮
*
- * @param resId 资源id数组
- * @param destDirId 目标文件夹id
- * @param name 资源名称
- * @return 上传结果:{"success":true,msg:"success",attrs:{}}
+ * @param resId 璧勬簮id鏁扮粍
+ * @param destDirId 鐩爣鏂囦欢澶筰d
+ * @param name 璧勬簮鍚嶇О
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{}}
*/
Result doMove(String resId, String destDirId, String name);
/**
- * 查询资源
+ * 鏌ヨ璧勬簮
*
- * @param dirId 资源文件夹id
- * @param text 搜索文本
- * @param pageNo 页码
- * @param pageNum 每页显示行数
- * @param type 资源类型
- * @return 返回资源列表
+ * @param dirId 璧勬簮鏂囦欢澶筰d
+ * @param text 鎼滅储鏂囨湰
+ * @param pageNo 椤电爜
+ * @param pageNum 姣忛〉鏄剧ず琛屾暟
+ * @param type 璧勬簮绫诲瀷
+ * @return 杩斿洖璧勬簮鍒楄〃
*/
List<Res> listRes(String dirId, String text, Integer pageSize, Integer pageNum, String type);
/**
- * 查询我的所有资源
+ * 鏌ヨ鎴戠殑鎵�鏈夎祫婧�
*
- * @param text 搜索文本
- * @param pageNo 页码
- * @param pageNum 每页显示行数
- * @param type 资源类型
- * @return 返回资源列表
+ * @param text 鎼滅储鏂囨湰
+ * @param pageNo 椤电爜
+ * @param pageNum 姣忛〉鏄剧ず琛屾暟
+ * @param type 璧勬簮绫诲瀷
+ * @return 杩斿洖璧勬簮鍒楄〃
*/
List<Res> listMyRes(String text, Integer pageSize, Integer pageNum, String type);
/**
- * 根据资源库类型查找资源
+ * 鏍规嵁璧勬簮搴撶被鍨嬫煡鎵捐祫婧�
*
- * @param libType 资源库类型
- * @param ownerId 所有者id
- * @param text 搜索文本
- * @param pageSize 每页显示行数
- * @param pageNum 页码
- * @param resType 资源类型
- * @return 返回资源列表
+ * @param libType 璧勬簮搴撶被鍨�
+ * @param ownerId 鎵�鏈夎�卛d
+ * @param text 鎼滅储鏂囨湰
+ * @param pageSize 姣忛〉鏄剧ず琛屾暟
+ * @param pageNum 椤电爜
+ * @param resType 璧勬簮绫诲瀷
+ * @return 杩斿洖璧勬簮鍒楄〃
*/
List<Res> listResByLib(String libType, String ownerId, String text, Integer pageSize, Integer pageNum,
String resType);
/**
- * 根据资源库类型查找资源总数
+ * 鏍规嵁璧勬簮搴撶被鍨嬫煡鎵捐祫婧愭�绘暟
*
- * @param libType 资源库类型
- * @param ownerId 所有者id
- * @param text 搜索文本
- * @param resType 资源类型
- * @return 返回资源列表
+ * @param libType 璧勬簮搴撶被鍨�
+ * @param ownerId 鎵�鏈夎�卛d
+ * @param text 鎼滅储鏂囨湰
+ * @param resType 璧勬簮绫诲瀷
+ * @return 杩斿洖璧勬簮鍒楄〃
*/
int listResCountByLib(String libType, String ownerId, String text, String resType);
/**
- * 我的所有资源的数量
+ * 鎴戠殑鎵�鏈夎祫婧愮殑鏁伴噺
*
- * @param text 搜索文本
- * @param type 资源类型
- * @return 返回资源列表
+ * @param text 鎼滅储鏂囨湰
+ * @param type 璧勬簮绫诲瀷
+ * @return 杩斿洖璧勬簮鍒楄〃
*/
int listMyResCount(String text, String type);
/**
- * 查询资源个数
+ * 鏌ヨ璧勬簮涓暟
*
- * @param dirId 资源文件夹id
- * @param text 搜索文本
- * @param pageNo 页码
- * @param pageNum 每页显示行数
- * @param type 资源类型
- * @return 返回资源总数
+ * @param dirId 璧勬簮鏂囦欢澶筰d
+ * @param text 鎼滅储鏂囨湰
+ * @param pageNo 椤电爜
+ * @param pageNum 姣忛〉鏄剧ず琛屾暟
+ * @param type 璧勬簮绫诲瀷
+ * @return 杩斿洖璧勬簮鎬绘暟
*/
int listResCount(String dirId, String text, String type);
/**
- * 读取资源真实文件访问路径
+ * 璇诲彇璧勬簮鐪熷疄鏂囦欢璁块棶璺緞
*
- * @param resId 资源id数组
- * @param attribute 资源附加属性
- * @return 上传结果:{"success":true,msg:"success",attrs:{"type":"",path:""}}
+ * @param resId 璧勬簮id鏁扮粍
+ * @param attribute 璧勬簮闄勫姞灞炴��
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{"type":"",path:""}}
*/
Result readAccessPath(String resId, String attribute);
/**
- * 新增资源文件夹
+ * 鏂板璧勬簮鏂囦欢澶�
*
- * @param parentDirId 父级资源文件夹id
- * @param name 文件夹名称
- * @return 上传结果:{"success":true,msg:"success",attrs:{"dirId","90023afwe32300fee23"}},若成功，则返回dirId
+ * @param parentDirId 鐖剁骇璧勬簮鏂囦欢澶筰d
+ * @param name 鏂囦欢澶瑰悕绉�
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{"dirId","90023afwe32300fee23"}},鑻ユ垚鍔燂紝鍒欒繑鍥瀌irId
*/
Result addDir(String parentDirId, String name);
/**
- * 读取资源文件夹
+ * 璇诲彇璧勬簮鏂囦欢澶�
*
- * @param dirId 资源文件夹id
- * @return 上传结果:{"success":true,msg:"success",attrs:{"dirId","90023afwe32300fee23"}},若成功，则返回dirId
+ * @param dirId 璧勬簮鏂囦欢澶筰d
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{"dirId","90023afwe32300fee23"}},鑻ユ垚鍔燂紝鍒欒繑鍥瀌irId
*/
ResDir readDir(String dirId);
/**
- * 修改资源文件夹
+ * 淇敼璧勬簮鏂囦欢澶�
*
- * @param dirId 文件夹id
- * @param name 名称
- * @return 上传结果:{"success":true,msg:"success",attrs:{}}
+ * @param dirId 鏂囦欢澶筰d
+ * @param name 鍚嶇О
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{}}
*/
Result updateDir(String dirId, String name);
/**
- * 删除资源文件夹
+ * 鍒犻櫎璧勬簮鏂囦欢澶�
*
- * @param dirIds 资源文件夹id数组
- * @return 上传结果:{"success":true,msg:"success",attrs:{}}
+ * @param dirIds 璧勬簮鏂囦欢澶筰d鏁扮粍
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{}}
*/
Result deleteDir(String[] dirIds);
/**
- * 返回个人资源库下级资源文件夹列表
+ * 杩斿洖涓汉璧勬簮搴撲笅绾ц祫婧愭枃浠跺す鍒楄〃
*
- * @param parentDirId 父级资源文件夹id
- * @return 返回资源列表
+ * @param parentDirId 鐖剁骇璧勬簮鏂囦欢澶筰d
+ * @return 杩斿洖璧勬簮鍒楄〃
*/
List<ResDir> doGetMyLibChildDirs(String parentDirId);
/**
- * 返回下级资源文件夹列表
+ * 杩斿洖涓嬬骇璧勬簮鏂囦欢澶瑰垪琛�
*
- * @param parentDirId 父级资源文件夹id
- * @param type 资源库类型
- * @return 返回资源列表
+ * @param parentDirId 鐖剁骇璧勬簮鏂囦欢澶筰d
+ * @param type 璧勬簮搴撶被鍨�
+ * @return 杩斿洖璧勬簮鍒楄〃
*/
List<ResDir> doGetChildDirs(String parentDirId, String type);
/**
- * 返回资源库根节点
+ * 杩斿洖璧勬簮搴撴牴鑺傜偣
*
- * @param type 类型
- * @param ownerId 拥有者id
- * @return 返回资源库根节点
+ * @param type 绫诲瀷
+ * @param ownerId 鎷ユ湁鑰卛d
+ * @return 杩斿洖璧勬簮搴撴牴鑺傜偣
*/
ResDir doGetRootDir(String type, String ownerId);
--
Gitblit v1.8.0