程序包 net.sohelp.boot.dev.web.cloud.module

类 CloudModuleController

java.lang.Object
net.sohelp.boot.admin.core.base.BaseController
net.sohelp.boot.dev.web.cloud.module.CloudModuleController
@RestController("dev-cloud-module") @RequestMapping("/dev/cloud/module/") public class CloudModuleController extends BaseController
生态功能模块管理控制器 提供云端模块的浏览、下载、安装、卸载等功能接口

  • 构造器详细资料

    • CloudModuleController

      public CloudModuleController()

  • 方法详细资料

    • page

      @GetMapping("/page") @Permission("ADMIN") public ApiResult page(@RequestParam Map<String,Object> paramMap) throws Exception
      获取云端模块分页数据，并与本地已下载模块进行合并展示
      参数:
      paramMap - 请求参数集合，可能包含过滤条件如状态(state)和搜索关键词(monicker)
      返回:
      返回处理后的模块列表结果集
      抛出:
      Exception - 网络请求或数据库操作异常时抛出

    • list

      @GetMapping("/list") @Permission("ADMIN") public ApiResult list(@RequestParam Map<String,Object> paramMap) throws Exception
      获取模块列表（预留空实现）
      参数:
      paramMap - 请求参数集合
      返回:
      成功响应对象
      抛出:
      Exception - 异常信息

    • getMyUploadList

      @GetMapping("/getMyUploadList") @Permission("ADMIN") public ApiResult getMyUploadList(@RequestParam Map<String,Object> paramMap) throws Exception
      获取当前用户上传到云端的模块列表
      参数:
      paramMap - 包含访问令牌等参数的映射表
      返回:
      当前用户的上传模块列表
      抛出:
      Exception - 网络请求或解析异常时抛出

    • removeMyUpload

      @PostMapping("/removeMyUpload") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("is_admin") public ApiResult removeMyUpload(@RequestBody Map<String,Object> paramMap) throws Exception
      删除用户在云端上传的模块记录
      参数:
      paramMap - 包含模块ID及访问令牌的参数映射
      返回:
      操作是否成功的提示消息
      抛出:
      Exception - 网络请求或事务回滚异常时抛出

    • upload

      @PostMapping("/upload") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("is_admin") public ApiResult upload(@RequestBody Map<String,Object> paramMap) throws Exception
      上传模块文件至云端（暂未完成具体逻辑）
      参数:
      paramMap - 包含模块名称等相关参数的映射表
      返回:
      上传成功与否的状态信息
      抛出:
      Exception - 解析或验证过程中的异常

    • getById

      @GetMapping("/getById") @Permission("is_admin") public ApiResult<Map<String,Object>> getById(@RequestParam Map<String,Object> paramMap) throws Exception
      根据UUID获取云端模块详细信息，并判断其是否已被本地下载/安装
      参数:
      paramMap - 请求参数，必须包含uuid字段用于查询
      返回:
      模块详细信息及其本地状态标识
      抛出:
      Exception - 数据库查询或网络请求异常时抛出

    • getDownloadList

      @GetMapping("/getMyList") @Permission("is_admin") public ApiResult getDownloadList(@RequestParam int type) throws Exception
      获取本地已下载或已安装的模块列表
      参数:
      type - 类型筛选：1表示所有已下载；2表示仅已安装
      返回:
      符合条件的模块列表
      抛出:
      Exception - 数据库查询异常时抛出

    • getMyId

      @GetMapping("/getMyId") @Permission("is_admin") public ApiResult getMyId(@RequestParam Map<String,Object> paramMap) throws Exception
      根据ID获取本地存储的模块信息
      参数:
      paramMap - 请求参数，应包含id字段
      返回:
      对应ID的模块信息
      抛出:
      Exception - 数据库查询异常时抛出

    • download

      @GetMapping("/download") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("is_admin") public ApiResult download(@RequestParam Map<String,Object> paramMap) throws Exception
      下载指定UUID的云端模块并保存到本地数据库中
      参数:
      paramMap - 请求参数，需提供uuid和cloud_access_token
      返回:
      下载成功与否的消息反馈
      抛出:
      Exception - 文件流读写或数据库插入异常时抛出

    • downloadToLocal

      @GetMapping("/downloadToLocal") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("is_admin") public ApiResult downloadToLocal(@RequestParam Map<String,Object> paramMap) throws Exception
      将云端模块直接下载到浏览器端作为附件下载
      参数:
      paramMap - 请求参数，包括uuid、cloud_access_token和name
      返回:
      响应输出流供前端下载使用，无返回值
      抛出:
      Exception - 流传输过程中发生的IO异常

    • install

      @PostMapping("/install") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("is_admin") public ApiResult install(@RequestBody Map<String,Object> paramMap) throws Exception
      安装本地已下载的模块到系统资源目录中
      参数:
      paramMap - 请求参数，包含uuid、dir和fileName字段
      返回:
      安装成功与否的结果反馈
      抛出:
      Exception - 文件路径检查或数据库更新异常时抛出

    • remove

      @PostMapping("/remove") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("is_admin") public ApiResult remove(@RequestBody Map<String,Object> paramMap) throws Exception
      卸载本地已安装的模块，同时清理相关文件和数据库记录
      参数:
      paramMap - 请求参数，包含要卸载模块的uuid
      返回:
      卸载成功与否的信息反馈
      抛出:
      Exception - 文件删除或数据库操作异常时抛出