Wujies 无界平台
平台功能(自研)应用市场

应用目录

应用目录(应用 / 版本 / 分类)由中心上架服务 wujies-market 维护,安装侧统一经 IAppCatalogService 读取。

应用目录是「能装哪些应用」的数据:应用、版本、分类、依赖与版本菜单。目录在中心一份, 各部署只装自己的安装实例;当前默认配置下本部署读的是自己库里那份目录(本机目录)。

这一页讲三件事:目录数据与安装数据怎么分家、安装侧为什么只能经 IAppCatalogService 读、 路由清单怎么随目录分发。读本机还是读中心怎么切换见 /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),见 应用生命周期

目录表不带租户列,是「目录对所有租户可见」的原因,不是「目录能被另一台部署读取」的前提 —— 目录由中心上架服务维护一份,本部署这份只是它的读取来源。表间关系见 /design/data-model。

app_version_menu 也在全局表里

它是「版本 → 菜单」的映射,属于目录的一部分(部署内共享)。租户维度的过滤不靠多租户插件, 而是 SQL 自己带条件:AppVersionMenuMapper.selectInvisibleMenuIds(tenantId),消费方是 AppMenuFilterImpl。菜单归属本身的规则见 /advanced/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)按编码取,不校验上架状态,找不到返回 nullAppMarketController.detail、service/AppRouteHintResolver
releasedVersions(appId)已发布版本列表(草稿/弃用不暴露)AppMarketController.versions、service/AppPurgeService
listRoutePatterns()全部应用的插件路由清单(按应用编码分组)service/CatalogRouteIndexSyncService

AppPackageDeployService.deploy(...) 走的是同一条路:安装的「下载并落位」先经目录接口取版本, 不自己查表。

「不许直接读目录表」只针对安装侧

判断标准是一句话:这段代码属于「装应用」吗?

  • 是(安装 / 升级 / 市场页 / 卸载 / 运行时答复)→ 必须走目录接口;
  • 不是(上架中心就是目录的所有者)→ 直接用 Mapper 是正常的,wujies-market 里的 应用 / 版本 / 分类 / 包管理接口都这么写。平台侧实际这么做的有 security/SignatureReadinessService(签名就绪度要按状态查全部版本, 目录接口没有也不需要这种查询)。

三、两个实现:本机目录与中心目录

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-key 留空)时任何凭证都判无效 ⇒ 一个私有条目也看不见, 并会明确告诉你是这台没配信任锚,不会静默按社区版处理。

写入侧两道闸(都在中心,见 授权与版本):发布时不许 licenseRequired=true 的清单挂在 public 应用上;已有已发布商业件的应用不许把可见性改回 public。

为什么不加缓存

目录读取的频率是「安装 / 升级 / 逛市场时几次」,不是热路径;而本机目录下写入(上架、发版) 与读取在同一个库里,写完立刻可见。加缓存只能靠 TTL 猜,反而会让「刚上架却装到旧版本」变得不可解释。 宁可每次直查:慢一点,但结果可解释。

四、路由清单随目录分发

本地墓碑表 app_route_index 是加载时写的:一台从来没装过某个应用的部署,连墓碑都没有, 打它的接口只能回普通 404,而用户期望的是 4610「应用不可用」。

解决办法是把路由清单放进目录:app_version_route(目录侧)记录「哪个应用的哪个包里有这些路由模式」。 链路是:

  1. 写:应用包上传(上架中心 POST /app/package/parse)时扫出清单落库 —— 优先读包内 route-index.json, 存量包没有它就从包内 jar 的注解扫(不加载插件的类)。清单的键是包指纹 package_sha256,版本行 id 用不了: 解析发生在上传那一刻,版本行还没建,手里只有包字节;同一个包被两个版本引用时清单也只存一份。
  2. 读:安装侧经 IAppCatalogService.listRoutePatterns() 取到。
  3. 同步:service/CatalogRouteIndexSyncService 把它灌进本部署的 app_route_index(只增不删)—— 启动预热一次,运行时由 /app/runtime/enabled-apps 顺手触发,按 10 分钟节流。
  4. 兜底:404 路径只读「内存墓碑 ∪ 本地表快照」,不查目录。

app_route_index 是墓碑表,不是目录的镜像:判据是「这台部署曾经有过哪些路由」, 所以同步只增不删。墓碑与 4610 的完整规则见 /advanced/plugin-runtime。

五、怎么核对

# 1) 市场列表:应返回目录里的已上架应用
curl.exe -H "Authorization: Bearer <token>" "http://localhost:8086/app/market/list"

# 2) 目录侧路由清单是否有数据(按你的库名替换)
docker exec <mysql容器> bash -c 'mysql -uroot -p$MYSQL_ROOT_PASSWORD -N -B -e \
  "select count(*) from `<库名>`.app_version_route"'

# 3) 本地墓碑是否已同步
docker exec <mysql容器> bash -c 'mysql -uroot -p$MYSQL_ROOT_PASSWORD -N -B -e \
  "select count(*) from `<库名>`.app_route_index"'

市场页是空的先查目录里有没有已发布版本(上架中心 → 版本 → 发布),而不是查网络。

相关阅读

目录