中国 帮助

应用市场模块

wujiesplatform/wujiesmodules/wujiesappmarket/ 是「应用外置」整套机制的落点: 目录数据、安装编排、插件运行时、包安全都在这一个模块里。 这一页只回答三个问题: 1. 数据该怎么分 —— 哪些

应用市场模块
封面

> 本文整理自平台文档 docs/wujies/1.x/advanced/app-market.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-4252451b56fe-cover.svg)

wujies-platform/wujies-modules/wujies-app-market/ 是「应用外置」整套机制的落点: 目录数据、安装编排、插件运行时、包安全都在这一个模块里。

这一页只回答三个问题:

1. 数据该怎么分 —— 哪些表的真相只有一个、哪些必须在每个部署各存一份; 2. 动作由谁编排 —— 部署 / 安装 / 升级 / 停用 / 卸载分别落到哪个类; 3. 代码该进哪个包 —— catalog/、plugin/、service/、spi/ 各自的边界在哪。

具体的坑与推导不在这里:改代码前先扫 wujies-platform/AGENTS.md 的 §2「必须遵守的不变量」 与 §3「应用市场架构」,那一份是权威约束,本页是它的导读;每个深水区在本章都有专页(见文末)。

> wujies-modules/ 下没有 *-api 契约模块(2026-09-30 起数量为 0): > 实体 / BO / VO / Mapper 接口与 Mapper XML / Service / controller 全在插件自己的 > wujies/wujies-plugins/wujies-<app>/ 里。见 [必须遵守的不变量](/docs/wujies/1.x/plugin-dev/basics/invariants)。

一、三种数据,别混

类别表应处位置怎么认出来
目录app_info、app_version、app_category、app_plan(预留)中心一份,平台方维护不带 tenant_id,且已列入 security.tenant.excludes(wujies-platform/wujies-admin/src/main/resources/application.yml)
安装实例app_install、app_install_task每个部署各一份带 tenant_id,由多租户插件自动隔离
迁移记录app_schema_history每个部署各一份带 tenant_id(只记「谁最先应用」),但去重判据不带租户,见 [数据库表](/docs/wujies/1.x/reference/database)

另有两处要单独交代:

script/sql/update/app_market.sql 里,但 domain/ 与 mapper/ 下没有任何对应 Java:属预留。

  • app_version_menu —— 版本 → 菜单的归属映射,「菜单归属保护」与「彻底删除」都读它
  • app_dependency、app_subscription、app_audit_log、app_plan —— DDL 都在

这三类分不清的代价是具体的:目录和安装实例混在一套表里,多部署一套系统就要同步一遍目录。

安装侧只允许通过 IAppCatalogService 读目录(catalog/IAppCatalogService.java,9 个方法), 不要直接注入 AppInfoMapper / AppVersionMapper。这样把目录搬到中心服务时只换实现 (LocalAppCatalogService → RemoteAppCatalogService),安装侧一行都不用改。

上架端 / 控制台是目录的所有者,它直接用 Mapper 是正常的。判断标准是一句话: 这段代码跑在别人的部署上吗? 跑在别人那里 → 必须走目录接口。

> mapper/ 下正好 7 个 Mapper,对应 app_info、app_version、app_category、app_install、 > app_install_task、app_version_menu、app_schema_history 这 7 张表;domain/ 下另有 > AppManifest(app.json 的模型)、AppMenuPlan、AppMenuSyncResult 三个非表模型。 > 逐字段说明见 [数据库表](/docs/wujies/1.x/reference/database)。

二、包地图

每个包只做一件事,改动前先确认自己进的是哪个包。

包职责代表类
catalog/目录访问的唯一入口 + 服务间接口IAppCatalogService、LocalAppCatalogService、RemoteAppCatalogService、AppCatalogApiController、CatalogApiContract
edition/版本形态:官方版 / 用户版MarketEdition、MarketEditionGuardFilter、MarketEditionStartupCheck
plugin/插件运行时:类加载器、子上下文、独立路由、Mapper 与 Converter 的运行期注册PluginClassLoader、PluginApplicationContext、PluginHandlerMapping、PluginRuntimeManager、PluginMapperRegistrar、PluginConverterRegistrar、PluginEventRelay、PluginContextRegistry
security/包安全:摘要规范化、白名单 + 验签、离线签名工具、签名就绪度自检PackageDigest、PackageSecurityInspector、PackageSignerMain、PackageKeys、SignatureReadinessService
service/生命周期编排与各项落地服务IAppInstallService(实现 service/impl/AppInstallServiceImpl)、AppPackageDeployService、AppPurgeService、AppMigrationService、AppMenuPlanner、AppMenuSyncServiceImpl、AppMenuOwnershipProvider、AppMenuTreeExpander、AppManifestValidator、AppRouteHintResolver、AppMenuFilterImpl、AppMenuGrantServiceImpl、AppMenuCache、AppConsoleMenuResolver
spi/安装器扩展点与生命周期监听AppInstaller、AppInstallContext、AppLifecycleListener、AppExtensionPoint、AppHealth;实现见 spi/impl/ModuleAppInstaller、spi/impl/PluginAppInstaller
state/安装状态机(8 个状态、合法迁移、对外可见性)AppLifecycleStateMachine
support/任务进度落库与卡死任务清扫AppTaskRecorder、AppTaskTimeoutSweeper
controller/HTTP 入口,controller/ 下 9 个控制器AppMarketController(/app/market)、AppInstallController(/app/install)、AppConsoleController(/app/console)、AppVersionController(/app/version)、AppPackageController(/app/package)、AppCategoryController(/app/category)、AppRuntimeController(/app/runtime)、AppWorkbenchController(/app/workbench)、AppEditionController(/app/edition)
domain/ mapper/实体 + bo/ + vo/;mapper/ 是 MyBatis-Plus 的 Mapper 接口AppInfo、AppVersion、AppInstall、AppInstallTask、AppManifest 等
enums/安装状态、任务状态、任务类型AppInstallStatus(8 个取值)、`AppT

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-4252451b56fe-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容