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(value="dev-cloud-module")
 @RequestMapping(value="/dev/cloud/module/")
public class CloudModuleController
extends BaseController

生态功能模块管理控制器 提供云端模块的浏览、下载、安装、卸载等功能接口

字段概要

从类继承的字段 net.sohelp.boot.admin.core.base.BaseController

request, response

构造器概要

构造器

构造器和说明
CloudModuleController()

方法概要

限定符和类型	方法和说明
ApiResult	download(Map<String,Object> paramMap) 下载指定UUID的云端模块并保存到本地数据库中
ApiResult	downloadToLocal(Map<String,Object> paramMap) 将云端模块直接下载到浏览器端作为附件下载
ApiResult<Map<String,Object>>	getById(Map<String,Object> paramMap) 根据UUID获取云端模块详细信息，并判断其是否已被本地下载/安装
ApiResult	getDownloadList(int type) 获取本地已下载或已安装的模块列表
ApiResult	getMyId(Map<String,Object> paramMap) 根据ID获取本地存储的模块信息
ApiResult	getMyUploadList(Map<String,Object> paramMap) 获取当前用户上传到云端的模块列表
ApiResult	install(Map<String,Object> paramMap) 安装本地已下载的模块到系统资源目录中
ApiResult	list(Map<String,Object> paramMap) 获取模块列表（预留空实现）
ApiResult	page(Map<String,Object> paramMap) 获取云端模块分页数据，并与本地已下载模块进行合并展示
ApiResult	remove(Map<String,Object> paramMap) 卸载本地已安装的模块，同时清理相关文件和数据库记录
ApiResult	removeMyUpload(Map<String,Object> paramMap) 删除用户在云端上传的模块记录
ApiResult	upload(Map<String,Object> paramMap) 上传模块文件至云端（暂未完成具体逻辑）

从类继承的方法 net.sohelp.boot.admin.core.base.BaseController

error, error, fail, fail, fail, getLoginID, getLoginName, getLoginOrgID, getLoginOrgName, getLoginUser, getNickname, getTenantId, getUserName, getUserNo, i18n, i18n, isAdministrator, isDeveloper, limit, offset, ok, ok, response, success, success, success, success, validateToken

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

CloudModuleController

public CloudModuleController()

方法详细资料

page

@GetMapping(value="/page")
 @Permission(value="ADMIN")
public ApiResult page(@RequestParam
                                                                               Map<String,Object> paramMap)
                                                                        throws Exception

获取云端模块分页数据，并与本地已下载模块进行合并展示

参数:

paramMap - 请求参数集合，可能包含过滤条件如状态(state)和搜索关键词(monicker)

返回:

返回处理后的模块列表结果集

抛出:

Exception - 网络请求或数据库操作异常时抛出

list

@GetMapping(value="/list")
 @Permission(value="ADMIN")
public ApiResult list(@RequestParam
                                                                               Map<String,Object> paramMap)
                                                                        throws Exception

获取模块列表（预留空实现）

参数:

paramMap - 请求参数集合

返回:

成功响应对象

抛出:

Exception - 异常信息

getMyUploadList

@GetMapping(value="/getMyUploadList")
 @Permission(value="ADMIN")
public ApiResult getMyUploadList(@RequestParam
                                                                                                     Map<String,Object> paramMap)
                                                                                              throws Exception

获取当前用户上传到云端的模块列表

参数:

paramMap - 包含访问令牌等参数的映射表

返回:

当前用户的上传模块列表

抛出:

Exception - 网络请求或解析异常时抛出

removeMyUpload

@PostMapping(value="/removeMyUpload")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="is_admin")
public ApiResult removeMyUpload(@RequestBody
                                                                                                                                                               Map<String,Object> paramMap)
                                                                                                                                                        throws Exception

删除用户在云端上传的模块记录

参数:

paramMap - 包含模块ID及访问令牌的参数映射

返回:

操作是否成功的提示消息

抛出:

Exception - 网络请求或事务回滚异常时抛出

upload

@PostMapping(value="/upload")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="is_admin")
public ApiResult upload(@RequestBody
                                                                                                                                               Map<String,Object> paramMap)
                                                                                                                                        throws Exception

上传模块文件至云端（暂未完成具体逻辑）

参数:

paramMap - 包含模块名称等相关参数的映射表

返回:

上传成功与否的状态信息

抛出:

Exception - 解析或验证过程中的异常

getById

@GetMapping(value="/getById")
 @Permission(value="is_admin")
public ApiResult<Map<String,Object>> getById(@RequestParam
                                                                                                            Map<String,Object> paramMap)
                                                                                                     throws Exception

根据UUID获取云端模块详细信息，并判断其是否已被本地下载/安装

参数:

paramMap - 请求参数，必须包含uuid字段用于查询

返回:

模块详细信息及其本地状态标识

抛出:

Exception - 数据库查询或网络请求异常时抛出

getDownloadList

@GetMapping(value="/getMyList")
 @Permission(value="is_admin")
public ApiResult getDownloadList(@RequestParam
                                                                                                  int type)
                                                                                           throws Exception

获取本地已下载或已安装的模块列表

参数:

type - 类型筛选：1表示所有已下载；2表示仅已安装

返回:

符合条件的模块列表

抛出:

Exception - 数据库查询异常时抛出

getMyId

@GetMapping(value="/getMyId")
 @Permission(value="is_admin")
public ApiResult getMyId(@RequestParam
                                                                                        Map<String,Object> paramMap)
                                                                                 throws Exception

根据ID获取本地存储的模块信息

参数:

paramMap - 请求参数，应包含id字段

返回:

对应ID的模块信息

抛出:

Exception - 数据库查询异常时抛出

download

@GetMapping(value="/download")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="is_admin")
public ApiResult download(@RequestParam
                                                                                                                                                  Map<String,Object> paramMap)
                                                                                                                                           throws Exception

下载指定UUID的云端模块并保存到本地数据库中

参数:

paramMap - 请求参数，需提供uuid和cloud_access_token

返回:

下载成功与否的消息反馈

抛出:

Exception - 文件流读写或数据库插入异常时抛出

downloadToLocal

@GetMapping(value="/downloadToLocal")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="is_admin")
public ApiResult downloadToLocal(@RequestParam
                                                                                                                                                                Map<String,Object> paramMap)
                                                                                                                                                         throws Exception

将云端模块直接下载到浏览器端作为附件下载

参数:

paramMap - 请求参数，包括uuid、cloud_access_token和name

返回:

响应输出流供前端下载使用，无返回值

抛出:

Exception - 流传输过程中发生的IO异常

install

@PostMapping(value="/install")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="is_admin")
public ApiResult install(@RequestBody
                                                                                                                                                 Map<String,Object> paramMap)
                                                                                                                                          throws Exception

安装本地已下载的模块到系统资源目录中

参数:

paramMap - 请求参数，包含uuid、dir和fileName字段

返回:

安装成功与否的结果反馈

抛出:

Exception - 文件路径检查或数据库更新异常时抛出

remove

@PostMapping(value="/remove")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="is_admin")
public ApiResult remove(@RequestBody
                                                                                                                                               Map<String,Object> paramMap)
                                                                                                                                        throws Exception

卸载本地已安装的模块，同时清理相关文件和数据库记录

参数:

paramMap - 请求参数，包含要卸载模块的uuid

返回:

卸载成功与否的信息反馈

抛出:

Exception - 文件删除或数据库操作异常时抛出