net.sohelp.boot.dev.web.cloud.application

类 CloudAppController

java.lang.Object

net.sohelp.boot.admin.core.base.BaseController

net.sohelp.boot.dev.web.cloud.application.CloudAppController

@RestController(value="dev-cloud-app")
 @RequestMapping(value="/dev/cloud/app")
public class CloudAppController
extends BaseController

生态应用管理控制器 提供生态应用的分页查询、列表展示、上传、下载、安装、卸载等功能接口

字段概要

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

request, response

构造器概要

构造器

构造器和说明
CloudAppController()

方法概要

限定符和类型	方法和说明
ApiResult	download(Map<String,Object> paramMap) 下载云端应用到本地服务器存储路径
ApiResult	downloadToLocal(Map<String,Object> paramMap) 直接将云端应用下载到浏览器客户端（提供给前端直接下载）
ApiResult<Map<String,Object>>	getById(Map<String,Object> paramMap) 获取指定云端应用的详细信息，并标记本地是否已下载或安装
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

构造器详细资料

CloudAppController

public CloudAppController()

方法详细资料

page

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

分页获取云端应用列表，并标记本地是否已下载或安装

参数:

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

返回:

返回处理后的应用列表结果

抛出:

Exception - 可能抛出网络请求异常或其他IO异常

list

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

获取用户上传至云端的应用列表，并与本地应用对比判断是否已上传

参数:

paramMap - 请求参数，包含云访问令牌(cloud_access_token)

返回:

返回本地应用列表并标注上传状态

抛出:

Exception - 可能抛出网络请求异常或其他IO异常

getMyUploadList

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

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

参数:

paramMap - 请求参数，包含云访问令牌(cloud_access_token)

返回:

返回用户上传的应用列表

removeMyUpload

@PostMapping(value="/removeMyUpload")
 @Permission(value="ADMIN")
public ApiResult removeMyUpload(@RequestBody
                                                                                                    Map<String,Object> paramMap)
                                                                                             throws Exception

删除用户上传到云端的某个应用

参数:

paramMap - 请求参数，包含云访问令牌(cloud_access_token)和要删除的应用ID(id)

返回:

成功则返回"删除成功!"的消息

抛出:

Exception - 可能抛出网络请求异常或其他IO异常

upload

@PostMapping(value="/upload")
 @Permission(value="ADMIN")
public ApiResult upload(@RequestBody
                                                                                    Map<String,Object> paramMap)
                                                                             throws Exception

将本地应用打包后上传到云端

参数:

paramMap - 请求参数，包含应用目录(app_dir)等信息

返回:

成功则返回"上传成功"

抛出:

Exception - 可能抛出文件操作异常或网络请求异常

getById

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

获取指定云端应用的详细信息，并标记本地是否已下载或安装

参数:

paramMap - 请求参数，包含应用UUID(uuid)等信息

返回:

返回应用详细信息及本地状态

抛出:

Exception - 可能抛出网络请求异常或其他数据库查询异常

getDownloadList

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

获取当前用户已下载或已安装的应用列表

参数:

type - 类型标识：1表示已下载；2表示已安装

返回:

返回符合条件的应用列表

抛出:

Exception - 可能抛出数据库查询异常

getMyId

@GetMapping(value="/getMyId")
 @Permission(value="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="ADMIN")
public ApiResult download(@RequestParam
                                                                                                                                               Map<String,Object> paramMap)
                                                                                                                                        throws Exception

下载云端应用到本地服务器存储路径

参数:

paramMap - 请求参数，包含应用UUID(uuid)和云访问令牌(cloud_access_token)

返回:

成功则返回"下载成功"

抛出:

Exception - 可能抛出网络请求异常或文件操作异常

downloadToLocal

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

直接将云端应用下载到浏览器客户端（提供给前端直接下载）

参数:

paramMap - 请求参数，包含应用UUID(uuid)、云访问令牌(cloud_access_token)和文件名(name)

返回:

返回null，实际通过response输出流发送文件

抛出:

Exception - 可能抛出网络请求异常或文件操作异常

install

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

安装已下载的应用包到系统中

参数:

paramMap - 请求参数，包含应用UUID(uuid)和目标安装目录(dir)

返回:

成功则返回"安装成功"

抛出:

Exception - 可能抛出文件操作异常或数据库更新异常

remove

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

卸载本地已安装的应用

参数:

paramMap - 请求参数，包含应用UUID(uuid)

返回:

成功则返回"卸载成功"

抛出:

Exception - 可能抛出文件删除异常或数据库删除异常