cloud-web-corejs 1.0.54-dev.78 → 1.0.54-dev.781

package/src/utils/resolveViewComponent.js

@@ -0,0 +1,203 @@
+/**
+ * 动态详情页组件解析（qiankun 微前端兼容）。
+ *
+ * 全库有一批「用运行时字符串 require 视图组件、就地渲染详情页」的站点
+ * （wf 单据详情、消息通知、外链单页、表单文件引用…），历史上各自散着
+ * 4 套前缀判断（白名单 / @base·@/ 前缀嗅探 / form 硬分叉 / 裸拼）。本文件
+ * 把解析逻辑收敛到一处，并让它在微前端下正确区分组件归属。
+ *
+ * 归属三类（对齐 docs/qiankun接入协议.md 的命名空间语义）：
+ *   ① base       —— 组件在 cloud-web-corejs 包内（@base/views），任何应用都有
+ *   ② localPrivate —— 渲染方自己的私有视图（@/views）
+ *   ③ remote     —— 归属别的子应用的私有视图；组件不在当前 bundle，
+ *                   不能本地 require，交调用方走 micro-view-host 装载或兜底
+ *                   （详见 docs/qiankun动态详情页承载方案.md 第 5 节）
+ *
+ * 核心归属/剥前缀/base 命名空间的判断复用 menuAdapter.resolveComponentPath，
+ * 本文件只在其上加：白名单、.vue 归一、remote 判定、require 落地、缺文件兜底。
+ * 因此无需注册表——归属靠访问路径结构 + 本应用 appCode 比较即可；独立运行 /
+ * 主应用态（appCode 为空、无 /micro/ 前缀）会自动退化为与历史一致的本地解析。
+ *
+ * webpack 硬约束：@base/views 与 @/views 两条动态 require 必须保留字面前缀，
+ * 不可把前缀变量化，否则 webpack 无法收集 context。包被消费时 @base 指向包内
+ * views、@/ 指向消费应用 views——这正是 base / localPrivate 的语义来源。
+ */
+import {
+  getOwnerSegment,
+  resolveComponentPath,
+  MICRO_SEGMENT,
+  MICRO_DEBUG_SEGMENT,
+} from "@base/utils/menuAdapter";
+
+const BASE_VIEW_PREFIX = "@base/views";
+const APP_VIEW_PREFIX = "@/views";
+
+/**
+ * 历史遗留的包内共享组件：以普通 /user/... 写法表达（未走 /base 命名空间），
+ * 必须落到 @base。微前端下的包内组件应改用 /base/... 或 @base/views 前缀，
+ * 由 resolveComponentPath 正确处理；本白名单只兜底存量写法。
+ */
+export const BASE_VIEW_WHITELIST = [
+  "/user/bill_setting/h5_view",
+  "/user/form/view/list",
+  "/user/form/view/edit",
+];
+
+function stripVue(p) {
+  return p.replace(/\.vue$/i, "");
+}
+
+function ensureVue(p) {
+  return /\.vue$/i.test(p) ? p : p + ".vue";
+}
+
+function ensureLeadingSlash(p) {
+  if (!p) return p;
+  return p.charAt(0) === "/" ? p : "/" + p;
+}
+
+function firstSegment(p) {
+  return String(p || "").replace(/^\//, "").split("?")[0].split("/")[0];
+}
+
+function isMicroPath(p) {
+  const seg = firstSegment(p);
+  return seg === MICRO_SEGMENT || seg === MICRO_DEBUG_SEGMENT;
+}
+
+/** 剥掉 /micro/<appCode> 或 /micro_debug/<appCode> 两段，得子应用内部路径 */
+function stripMicroPrefix(p) {
+  const clean = ensureLeadingSlash(String(p || ""));
+  const parts = clean.split("/"); // ["", "micro", "appA", "user", ...]
+  return "/" + parts.slice(3).join("/");
+}
+
+/**
+ * 解析组件来源（纯函数，无 require、无副作用，可完整单测）。
+ *
+ * @param {string} rawUrl 组件来源路径：menu url / option.url / row.url /
+ *                        row.billUrl / row.mobileurl / defaultHomePage 等，
+ *                        可带或不带 .vue 尾缀。
+ * @param {object} options
+ * @param {string} [options.route]   访问路径，用于归属判断（双字段写法下
+ *                                   url 是组件来源、route 才带 /micro/ 归属段）
+ * @param {string} [options.appCode] 本应用（渲染方）appCode；主应用为空字符串
+ * @returns {object} 三态描述：
+ *   { kind: 'empty' }
+ *   { kind: 'base',         base: true,  rel: '/user/xxx.vue' }
+ *   { kind: 'localPrivate', base: false, rel: '/user/xxx.vue' }
+ *   { kind: 'remote', owner: 'appB', targetPath: '/user/xxx' }
+ *   { kind: 'unknown', raw: '@other/xxx' }   // 罕见的其它 @ 别名，调用方自行决定
+ */
+export function resolveViewPath(rawUrl, options = {}) {
+  const raw = String(rawUrl == null ? "" : rawUrl);
+  if (!raw) return { kind: "empty" };
+
+  const route = options.route;
+  const appCode = options.appCode || "";
+
+  // 1. 白名单：存量普通写法的包内共享组件 → @base
+  if (BASE_VIEW_WHITELIST.indexOf(stripVue(raw)) >= 0) {
+    return { kind: "base", base: true, rel: ensureVue(raw) };
+  }
+
+  // 2. 委托 menuAdapter：处理 @ 前缀、/micro/ 剥离与归属、/base 命名空间
+  const path = resolveComponentPath({ url: raw }, appCode);
+  if (!path) return { kind: "empty" };
+
+  // 3. 单字段 remote：/micro/<别家>/... 时 resolveComponentPath 原样返回
+  if (isMicroPath(path)) {
+    return {
+      kind: "remote",
+      owner: getOwnerSegment(path),
+      targetPath: stripMicroPrefix(path),
+    };
+  }
+
+  // 4. 双字段 remote 防御：url 无 /micro/ 前缀，但 route 归属别家
+  const routeOwner = getOwnerSegment(String(route || ""));
+  if (routeOwner && routeOwner !== appCode) {
+    return { kind: "remote", owner: routeOwner, targetPath: ensureLeadingSlash(raw) };
+  }
+
+  // 5. 落位到 @base/views 或 @/views
+  if (path.indexOf(BASE_VIEW_PREFIX) === 0) {
+    return { kind: "base", base: true, rel: ensureVue(path.slice(BASE_VIEW_PREFIX.length)) };
+  }
+  if (path.indexOf(APP_VIEW_PREFIX) === 0) {
+    return { kind: "localPrivate", base: false, rel: ensureVue(path.slice(APP_VIEW_PREFIX.length)) };
+  }
+  if (path.charAt(0) === "@") {
+    // 其它 @ 别名（罕见）：不猜测归属，交回调用方
+    return { kind: "unknown", raw: path };
+  }
+
+  // 原始 /xxx → 渲染方私有 @/views
+  return { kind: "localPrivate", base: false, rel: ensureVue(ensureLeadingSlash(path)) };
+}
+
+// ——— 以下为 require 落地层（依赖 webpack context，不进纯函数单测） ———
+
+function requireBaseView(rel) {
+  return require("@base/views" + rel);
+}
+
+function requireAppView(rel) {
+  return require("@/views" + rel);
+}
+
+/**
+ * 惰性读取本应用（渲染方）appCode，避免把 settings 拉进 resolveViewPath 的纯函数单测。
+ * 子应用取 settings.appCode（qiankun mount 会写入 props.appCode，与派生一致）；
+ * 主应用 appCode 恒空、身份是 WEB_PREFIX 去斜杠（/sys → sys）——故回落 WEB_PREFIX。
+ * 与 store/modules/permission.js 的 getOwnAppCode 同口径：使 /micro/<自己>/... 被判成本地，
+ * 不误判成 remote 去自装载（也修掉子应用独立运行时 micro.appCode 为空的老坑）。
+ */
+function getRendererAppCode() {
+  const webPrefix = (window.WEB_PREFIX || "").replace(/^\/+/, "");
+  try {
+    // settings.js 是 CommonJS（module.exports），取 .default 会拿到 undefined，
+    // 必须兼容两种形态，否则 appCode 永远读不到、退化成 WEB_PREFIX 派生值，
+    // 与 store/modules/permission.js 的 getOwnAppCode 口径不一致（appCode 与
+    // WEB_PREFIX 不同名的应用会误判归属）。
+    const mod = require("@/settings");
+    const settings = (mod && mod.default) || mod;
+    return (settings && settings.appCode) || webPrefix;
+  } catch (e) {
+    return webPrefix;
+  }
+}
+
+/**
+ * 解析并加载详情页组件。resolveViewPath 的运行时外壳。
+ *
+ * @param {string} rawUrl 同 resolveViewPath
+ * @param {object} [options] 同 resolveViewPath；appCode 缺省时从 store 读取
+ * @returns {object} resolveViewPath 的结果，附加 component 字段：
+ *   - base / localPrivate：component 为组件对象（require 失败或缺文件时为 null，附 error）
+ *   - remote / empty / unknown：component 为 null，由调用方决定后续（装载子应用 / 兜底提示）
+ */
+export function loadViewComponent(rawUrl, options = {}) {
+  const opts = Object.assign({}, options);
+  if (opts.appCode == null) opts.appCode = getRendererAppCode();
+
+  const result = resolveViewPath(rawUrl, opts);
+  if (result.kind !== "base" && result.kind !== "localPrivate") {
+    return Object.assign({ component: null }, result);
+  }
+  try {
+    const mod = result.base ? requireBaseView(result.rel) : requireAppView(result.rel);
+    return Object.assign({ component: mod && mod.default }, result);
+  } catch (e) {
+    return Object.assign({ component: null, error: e }, result);
+  }
+}
+
+/**
+ * 兼容旧签名的便捷封装：直接返回组件对象（或 null）。
+ * 供 components/wf/wf.js、mobile wfModifyDialogMixin.js 的 requireView 平滑替换——
+ * 它们历史上返回 require(...).default。remote / 缺文件时返回 null（不再抛错崩溃）。
+ */
+export function requireViewCompat(rawUrl, options = {}) {
+  return loadViewComponent(rawUrl, options).component;
+}