中国 帮助

目录中心化与版本形态

这一页讲 wujiesappmarket 里两个部署拓扑开关的语义、互相约束与失败表现: 开关 谁读它 它决定什么 appmarket.catalog.mode LocalAppCatalogService /

目录中心化与版本形态
封面

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

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

这一页讲 wujies-app-market 里两个部署拓扑开关的语义、互相约束与失败表现:

开关谁读它它决定什么
app-market.catalog.modeLocalAppCatalogService / RemoteAppCatalogService(@ConditionalOnProperty 二选一)目录(应用 / 版本 / 分类)从本机库读,还是从另一台部署读
app-market.editionMarketEdition这套部署是官方版(含上架端)还是用户版(不含上架端)

两者互相牵制:edition=client 必须配 catalog.mode=remote,否则启动直接失败。组合错了有两种坏结果 —— 起不来,或者更糟的看着成功、实际无效(在用户版的上架端"上架成功",而安装读的是远端目录)。

要装这样的多套部署(1Panel 包、端口、令牌分发、链路验证)见 [/deploy/multi-deployment](/docs/wujies/1.x/deploy/multi-deployment);每一项配置的默认值与环境变量名见 [/deploy/configuration](/docs/wujies/1.x/deploy/configuration) 与 [/reference/config](/docs/wujies/1.x/reference/config);本页讲的是代码里为什么这么写、改哪一行会坏什么。

一、目录中心化(app-market.catalog.mode)

### 1.1 前提:三类数据必须先分家

三种数据混在同一套表里,才会出现"多部署一套系统,上架一次要同步 N 遍"。它们的边界是表上有没有 tenant_id,判据落在两处:DDL 在 wujies-platform/script/sql/update/app_market.sql,全局表白名单在 wujies-platform/wujies-admin/src/main/resources/application.yml 的 security.tenant.excludes。

类别表应处位置依据
目录app_info、app_version、app_category、app_dependency、app_plan、app_version_menu中心一份(多部署时可远程读)表上没有 tenant_id,已列入 security.tenant.excludes
安装实例app_install、app_install_task每套部署各一份表上有 tenant_id,不在 excludes 里,由多租户插件隔离
迁移账本app_schema_history每套部署各一份同上;唯一键是 (app_code, script),见 [/advanced/lifecycle](/docs/wujies/1.x/advanced/lifecycle)

因为目录这几张表不带租户参数,目录接口 /app/catalog/ 的请求里不需要传租户** —— 这是整件事能干净做掉的原因,也是"目录能被搬到另一台机器"的全部前提。表间关系见 [/design/data-model](/docs/wujies/1.x/design/data-model)。

它是"版本 → 菜单"的映射,属于目录的一部分(部署内共享)。租户维度的过滤不靠多租户插件,而是 SQL 自己带条件:AppVersionMenuMapper.selectInvisibleMenuIds(tenantId),消费方是 AppMenuFilterImpl。菜单归属本身的规则见 [/advanced/menu-ownership](/docs/wujies/1.x/advanced/menu-ownership)。

### 1.2 唯一入口:IAppCatalogService

安装侧的代码只允许通过它读目录,不要直接注入 AppInfoMapper / AppVersionMapper。接口是"按业务语义取用"而不是"把 Mapper 包一层",所以远程实现只用 URL + 参数就能做出来,不必把 LambdaQueryWrapper 这种本地 ORM 概念漏到远端。

契约共 9 个方法(wujies-platform/wujies-modules/wujies-app-market/src/main/java/cn/wujies/appmarket/catalog/IAppCatalogService.java),每个都有真实消费方:

方法语义消费方(都在 appmarket/ 下)
requireOnShelf(appCode)取已上架应用,未上架即抛异常service/impl/AppInstallServiceImpl(安装入口)
requireApp(appId)按 ID 取应用AppInstallServiceImpl、service/AppPackageDeployService、controller/AppRuntimeController
appsByIds(appIds)批量取应用(列表展示补齐,缺的不返回)AppInstallServiceImpl
requireVersion(versionId)取指定版本AppPackageDeployService、spi/impl/PluginAppInstaller、controller/AppInstallController、controller/AppRuntimeController、AppInstallServiceImpl
requireLatestVersion(appId)取该应用最新已发布版本AppInstallServiceImpl
countOnShelf()已上架数量(为 0 时菜单过滤可短路)service/impl/AppMenuFilterImpl.enabled()
searchOnShelf(keyword, categoryId, audience, limit)市场列表(按可见范围筛选)controller/AppMarketController.list
findApp(appCode)按编码取,不校验上架状态,找不到返回 nullAppMarketController.detail、service/AppRouteHintResolver
releasedVersions(appId)已发布版本列表(草稿/弃用不暴露)AppMarketController.versions、service/AppPurgeService

AppPackageDeployService.deploy(...) 里的两处调用是"这条规矩的主路径":以前它直接 selectById 读 app_version / app_info,远程模式下本地没有目录数据,安装会在"下载并落位"这一步报"版本不存在"。

判断标准是一句话:这段代码会跑在别人的部署上吗?

  • 会(安装 / 升级 / 市场页 / 卸载 / 运行时答复)→ 必须走目录接口;
  • 不会(上架端与控制台就是目录的所有者)→ 直接用 Mapper 是正常的。实际这么做的有 controller/AppConsoleController、controller/AppVersionController、controller/AppPackageController、security/SignatureReadinessService(签名就绪度要按状态查全部版本,目录接口没有也不需要这种查询)。

AppInstallServiceImpl 里仍声明着 appInfoMapper / appVersionMapper 两个字段,但已经没有任何调用(目录读取全部走 appCatalogService,见该类 574 行附近的注释);AppPackageDeployService 顶部也留着这两个 Mapper 的 import。它们不影响行为,只是改造期的残留。

### 1.3 两种实现怎么二选一

remote 与 local 用 @ConditionalOnProperty 二选一,刻意不用 @ConditionalOnMissingBean —— 后者依赖 bean 定义的先后顺序,换个扫描顺序就可能两个都在或两个都不在,而条件属性是确定的。

实现装配条件行为
catalog/LocalAppCatalogServiceapp-market.catalog.mode=local,matchIfMissing = true(不配就是它

本文导览

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

章节导览
THE END

喜欢就支持以下吧

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

回到内容