> 本文整理自平台文档 docs/wujies/5.x/platform/app-market/catalog.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-e7435c56243a-cover.svg)
应用目录是「能装哪些应用」的数据:应用、版本、分类、依赖与版本菜单。目录在中心一份, 各部署只装自己的安装实例;当前默认配置下本部署读的是自己库里那份目录(本机目录)。
这一页讲三件事:目录数据与安装数据怎么分家、安装侧为什么只能经 IAppCatalogService 读、 路由清单怎么随目录分发。读本机还是读中心怎么切换见 [/deploy/multi-deployment](/docs/wujies/5.x/deploy/multi-deployment)。
一、三类数据先分家
判据是表上有没有 tenant_id,落在两处:DDL 在 wujies-platform/script/sql/app_market_schema.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、app_version_route | 本部署的库 | 表上没有 tenant_id,已列入 security.tenant.excludes |
| 安装实例 | app_install、app_install_task | 本部署的库 | 表上有 tenant_id,不在 excludes 里,由多租户插件隔离 |
| 迁移账本 | app_schema_history | 本部署的库 | 同上;唯一键是 (app_code, script),见 [应用生命周期](/docs/wujies/5.x/platform/app-market/lifecycle) |
目录表不带租户列,是「目录对所有租户可见」的原因,不是「目录能被另一台部署读取」的前提 —— 目录由中心上架服务维护一份,本部署这份只是它的读取来源。表间关系见 [/design/data-model](/docs/wujies/5.x/platform/architecture/data-model)。
它是「版本 → 菜单」的映射,属于目录的一部分(部署内共享)。租户维度的过滤不靠多租户插件, 而是 SQL 自己带条件:AppVersionMenuMapper.selectInvisibleMenuIds(tenantId),消费方是 AppMenuFilterImpl。菜单归属本身的规则见 [/advanced/menu-ownership](/docs/wujies/5.x/platform/app-market/menu-ownership)。
二、唯一入口:IAppCatalogService
安装侧的代码只允许通过它读目录,不要直接注入 AppInfoMapper / AppVersionMapper。 接口是「按业务语义取用」而不是「把 Mapper 包一层」,这样目录读取的边界只有一处, 排查「市场页看到的东西和安装用的不一样」时不必翻遍 Mapper。
契约共 15 个方法(wujies-platform/wujies-modules/wujies-market-core/src/main/java/cn/wujies/appmarket/catalog/IAppCatalogService.java): find* 是查询、由各个实现提供,require* 是在查询之上做非空判定的 default 方法。 下表列出常用的一些,每个都有真实消费方:
| 方法 | 语义 | 消费方(都在 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) | 按编码取,不校验上架状态,找不到返回 null | AppMarketController.detail、service/AppRouteHintResolver |
releasedVersions(appId) | 已发布版本列表(草稿/弃用不暴露) | AppMarketController.versions、service/AppPurgeService |
listRoutePatterns() | 全部应用的插件路由清单(按应用编码分组) | service/CatalogRouteIndexSyncService |
AppPackageDeployService.deploy(...) 走的是同一条路:安装的「下载并落位」先经目录接口取版本, 不自己查表。
判断标准是一句话:这段代码属于「装应用」吗?
应用 / 版本 / 分类 / 包管理接口都这么写。平台侧实际这么做的有 security/SignatureReadinessService(签名就绪度要按状态查全部版本, 目录接口没有也不需要这种查询)。
- 是(安装 / 升级 / 市场页 / 卸载 / 运行时答复)→ 必须走目录接口;
- 不是(上架中心就是目录的所有者)→ 直接用 Mapper 是正常的,
wujies-market里的
三、两个实现:本机目录与中心目录
LocalAppCatalogService(在 wujies-market-core,直连 AppInfoMapper / AppVersionMapper / AppVersionRouteMapper)永远装配; 平台侧还有 RemoteAppCatalogService(在 wujies-app-market,走 HTTP 并合并本机开发台登记的草稿行)。 用哪一个由 app-market.catalog.base-url 决定:留空 = 本机目录(当前部署默认就是这个), 填地址 = 读中心目录。环境变量是 APP_MARKET_CATALOG_BASE_URL 与 APP_MARKET_CATALOG_TOKEN, 远程读取带 X-Catalog-Token 头。
### 中心服务自己怎么装配
wujies-market 是一个独立 Spring Boot 应用,扫描 cn.wujies.market 与 cn.wujies.appmarket 两个包:目录服务与包判据都住在共用内核 wujies-market-core(包名 cn.wujies.appmarket)里,靠组件扫描装配进来。
范围扩到整个 cn.wujies 会启动失败:common-core 的 UserInfoFillUtil 要 UserService 与 OssService,那两个实现住在 wujies-system,中心没有它们。公共能力一律走各 common 模块自己的 AutoConfiguration.imports 生效,不靠扫包。
### 目录还有第二层收件人:app_info.visibility
public 对所有部署可见(默认);private 只发给本机授权凭证名单覆盖得到它的那台部署。 判据在 LicensedApps / LicenseVisibilityRule 一处算完,两端同口径:
- 列表里剔掉、单条返回空体、包下载回 404(不是 403 —— 403 会把"这条记录存在"说出去);
- 安装侧请求目录与包时上行
X-License-Credential; - 本机没配验签公钥(`app-market.license.public-ke
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-e7435c56243a-guide.svg)


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