@ibiz-template/runtime 0.0.3-beta.2 → 0.0.3-beta.4

package/src/ui-logic/ui-logic-link/ui-logic-link.ts

@@ -0,0 +1,112 @@
+import { IBizContext } from '@ibiz-template/core';
+import { UILogicLinkModel, UnsupportedModelError } from '@ibiz-template/model';
+import { UILogicContext } from '../ui-logic-context';
+import { UILogicNode } from '../ui-logic-node/ui-logic-node';
+import { UILogicLinkGroupCond } from './ui-logic-link-group-cond/ui-logic-link-group-cond';
+
+/**
+ * 界面逻辑连接
+ *
+ * @author chitanda
+ * @date 2023-02-08 16:02:10
+ * @export
+ * @class UILogicLink
+ */
+export class UILogicLink {
+  /**
+   * 源节点
+   *
+   * @author chitanda
+   * @date 2023-02-08 21:02:53
+   * @type {UILogicNode}
+   */
+  srcNode: UILogicNode | null = null;
+
+  /**
+   * 目标节点
+   *
+   * @author chitanda
+   * @date 2023-02-08 21:02:59
+   * @type {UILogicNode}
+   */
+  dstNode: UILogicNode | null = null;
+
+  /**
+   * 连接条件组
+   *
+   * @author chitanda
+   * @date 2023-02-15 17:02:49
+   * @type {(UILogicLinkGroupCond | null)}
+   */
+  groupCond: UILogicLinkGroupCond | null = null;
+
+  /**
+   * Creates an instance of UILogicLink.
+   *
+   * @author chitanda
+   * @date 2023-02-08 16:02:19
+   * @param {UILogicLinkModel} model
+   */
+  constructor(public model: UILogicLinkModel) {
+    const { linkMode, source } = this.model;
+    if (linkMode === 0) {
+      const cond = source.getPSDEUILogicLinkGroupCond();
+      if (cond) {
+        this.groupCond = new UILogicLinkGroupCond(cond);
+      }
+    }
+  }
+
+  /**
+   * 执行连接
+   *
+   * @author chitanda
+   * @date 2023-02-08 22:02:18
+   * @param {UILogicContext} ctx
+   * @param {IBizContext} context
+   * @param {IData} data
+   * @param {IParams} [opt]
+   * @return {*}  {Promise<boolean>} 是否连接成功
+   */
+  async exec(
+    ctx: UILogicContext,
+    context: IBizContext,
+    data: IData[] | null,
+    _params: IParams,
+    _opt?: IParams,
+  ): Promise<boolean> {
+    const { linkMode } = this.model;
+    switch (linkMode) {
+      case 0: {
+        // 常规
+        if (this.groupCond) {
+          return this.groupCond.test(
+            ctx,
+            context,
+            data && data.length > 0 ? data[0] : {},
+          );
+        }
+        return true;
+      }
+      case 1: // 默认连接
+        return true;
+      case 2: // 异步结束
+        throw new UnsupportedModelError(
+          this.model.source,
+          `未支持的逻辑连接类型: 异步结束`,
+        );
+      case 3: // 异步拒绝
+        throw new UnsupportedModelError(
+          this.model.source,
+          `未支持的逻辑连接类型: 异步拒绝`,
+        );
+      case 9: // 异常处理
+        throw new UnsupportedModelError(
+          this.model.source,
+          `未支持的逻辑连接类型: 异常处理`,
+        );
+      default:
+        return false;
+    }
+  }
+}

package/src/ui-logic/ui-logic-node/de-action-node/de-action-node.ts

@@ -0,0 +1,50 @@
+import { IBizContext } from '@ibiz-template/core';
+import { DefectModelError, IPSDEUIDEActionLogic } from '@ibiz-template/model';
+import { UILogicContext } from '../../ui-logic-context';
+import { UILogicNode } from '../ui-logic-node';
+
+/**
+ * 界面行为节点
+ *
+ * @author chitanda
+ * @date 2023-02-09 17:02:56
+ * @export
+ * @class DEActionNode
+ * @extends {UILogicNode}
+ */
+export class DEActionNode extends UILogicNode {
+  async exec(
+    ctx: UILogicContext,
+    context: IBizContext,
+    data: IData[] | null,
+    params: IParams,
+    _opt?: IParams | undefined,
+  ): Promise<void> {
+    const model = this.model.source as IPSDEUIDEActionLogic;
+    const entity = model.getDstPSAppDataEntity();
+    if (!entity) {
+      throw new DefectModelError(this.model.source, `未指定应用实体`);
+    }
+    const deAction = model.getDstPSAppDEAction();
+    if (!deAction) {
+      throw new DefectModelError(this.model.source, `未指定实体行为`);
+    }
+    const app = ibiz.hub.getApp(this.model.modelService.app);
+    const service = await app.es.getService(entity.codeName);
+    let actionData = data && data.length > 0 ? data[0] : undefined;
+    const dstParam = model.getDstPSDEUILogicParam();
+    const retParam = model.getRetPSDEUILogicParam();
+    if (dstParam) {
+      actionData = ctx.params[dstParam.codeName];
+    }
+    const res = await service.exec(
+      deAction.codeName,
+      context,
+      actionData,
+      params,
+    );
+    if (res.ok && retParam) {
+      ctx.params[retParam.codeName] = res.data;
+    }
+  }
+}

package/src/ui-logic/ui-logic-node/de-ui-action-node/de-ui-action-node.ts

@@ -0,0 +1,52 @@
+import { IBizContext } from '@ibiz-template/core';
+import {
+  DefectModelError,
+  getPSUIActionByModelObject,
+  IPSAppDEUIAction,
+  IPSDEUIActionLogic,
+} from '@ibiz-template/model';
+import { AppDEUIActionUtil } from '../../../utils';
+import { UILogicContext } from '../../ui-logic-context';
+import { UILogicNode } from '../ui-logic-node';
+
+/**
+ * 实体界面行为
+ *
+ * @author chitanda
+ * @date 2023-02-09 19:02:09
+ * @export
+ * @class DEUIActionNode
+ * @extends {UILogicNode}
+ */
+export class DEUIActionNode extends UILogicNode {
+  async exec(
+    ctx: UILogicContext,
+    context: IBizContext,
+    data: IData[] | null,
+    params: IParams,
+    opt?: IParams | undefined,
+  ): Promise<void> {
+    const m = this.model.source as IPSDEUIActionLogic;
+    const uiAction = await getPSUIActionByModelObject(m);
+    if (!uiAction) {
+      throw new DefectModelError(this.model.source, `未配置界面行为`);
+    }
+    let actionData = data;
+    const dstParam = m.getDstPSDEUILogicParam();
+    if (dstParam) {
+      const param = ctx.params[dstParam.codeName];
+      if (param instanceof Array) {
+        actionData = param;
+      } else {
+        actionData = [param];
+      }
+    }
+    await AppDEUIActionUtil.exec(
+      uiAction as unknown as IPSAppDEUIAction,
+      context,
+      actionData,
+      params,
+      opt,
+    );
+  }
+}

package/src/ui-logic/ui-logic-node/end-node/end-node.ts

@@ -0,0 +1,44 @@
+import { IBizContext } from '@ibiz-template/core';
+import { IPSDEUIEndLogic, UnsupportedModelError } from '@ibiz-template/model';
+import { UILogicContext } from '../../ui-logic-context';
+import { UILogicNode } from '../ui-logic-node';
+
+/**
+ * 结束节点
+ *
+ * @author chitanda
+ * @date 2023-02-09 21:02:00
+ * @export
+ * @class EndNode
+ * @extends {UILogicNode}
+ */
+export class EndNode extends UILogicNode {
+  async exec(
+    ctx: UILogicContext,
+    _context: IBizContext,
+    _data: IData[] | null,
+    _params: IParams,
+    _opt?: IParams | undefined,
+  ): Promise<void> {
+    const { returnType, rawValue } = this.model.source as IPSDEUIEndLogic;
+    // eslint-disable-next-line default-case
+    switch (returnType) {
+      case 'NONEVALUE': // 无值（NONE）
+        ctx.result = undefined;
+        break;
+      case 'NULLVALUE': // 空值（NULL）
+        ctx.result = null;
+        break;
+      case 'SRCVALUE': // 直接值
+        ctx.result = rawValue;
+        break;
+      case 'LOGICPARAM': // 逻辑参数对象
+      case 'LOGICPARAMFIELD': // 逻辑参数属性
+      case 'BREAK': // 跳出循环（BREAK）
+        throw new UnsupportedModelError(
+          this.model.source,
+          `暂未支持的结束节点返回值类型: ${returnType}`,
+        );
+    }
+  }
+}

package/src/ui-logic/ui-logic-node/index.ts

@@ -0,0 +1,6 @@
+export { DEActionNode } from './de-action-node/de-action-node';
+export { DEUIActionNode } from './de-ui-action-node/de-ui-action-node';
+export { StartNode } from './start-node/start-node';
+export { EndNode } from './end-node/end-node';
+export { PrepareJSParamNode } from './prepare-js-param-node/prepare-js-param-node';
+export { UILogicNode } from './ui-logic-node';

package/src/ui-logic/ui-logic-node/prepare-js-param-node/prepare-js-param-node.ts

@@ -0,0 +1,24 @@
+import { IBizContext } from '@ibiz-template/core';
+import { UILogicContext } from '../../ui-logic-context';
+import { UILogicNode } from '../ui-logic-node';
+
+/**
+ * 准备参数
+ *
+ * @author chitanda
+ * @date 2023-02-09 21:02:20
+ * @export
+ * @class PrepareJSParamNode
+ * @extends {UILogicNode}
+ */
+export class PrepareJSParamNode extends UILogicNode {
+  exec(
+    _ctx: UILogicContext,
+    _context: IBizContext,
+    _data: IData[] | null,
+    _params: IParams,
+    _opt?: IParams | undefined,
+  ): Promise<void> {
+    throw new Error('Method not implemented.');
+  }
+}

package/src/ui-logic/ui-logic-node/start-node/start-node.ts

@@ -0,0 +1,24 @@
+import { IBizContext } from '@ibiz-template/core';
+import { UILogicContext } from '../../ui-logic-context';
+import { UILogicNode } from '../ui-logic-node';
+
+/**
+ * 启动节点
+ *
+ * @author chitanda
+ * @date 2023-02-09 21:02:30
+ * @export
+ * @class StartNode
+ * @extends {UILogicNode}
+ */
+export class StartNode extends UILogicNode {
+  async exec(
+    _ctx: UILogicContext,
+    _context: IBizContext,
+    _data: IData[] | null,
+    _params: IParams,
+    _opt?: IParams | undefined,
+  ): Promise<void> {
+    // 启动节点，无任何操作
+  }
+}

package/src/ui-logic/ui-logic-node/ui-logic-node.ts

@@ -0,0 +1,53 @@
+import { IBizContext } from '@ibiz-template/core';
+import { UILogicNodeModel } from '@ibiz-template/model';
+import { UILogicContext } from '../ui-logic-context';
+import { UILogicLink } from '../ui-logic-link/ui-logic-link';
+
+/**
+ * 逻辑节点
+ *
+ * @author chitanda
+ * @date 2023-02-07 19:02:16
+ * @export
+ * @class UILogicNode
+ */
+export abstract class UILogicNode {
+  /**
+   * 节点连接
+   *
+   * @author chitanda
+   * @date 2023-02-08 21:02:57
+   * @type {UILogicLink[]}
+   */
+  readonly links: UILogicLink[];
+
+  /**
+   * Creates an instance of UILogicNode.
+   *
+   * @author chitanda
+   * @date 2023-02-08 16:02:19
+   * @param {UILogicNodeModel} model
+   */
+  constructor(public model: UILogicNodeModel) {
+    this.links = model.links.map(link => new UILogicLink(link));
+  }
+
+  /**
+   * 执行界面行为
+   *
+   * @description 此实现无需关心是否循环后续处理问题
+   * @author chitanda
+   * @date 2023-02-08 22:02:44
+   * @param {UILogicContext} ctx
+   * @param {IBizContext} context
+   * @param {IData} data
+   * @param {IParams} [opt]
+   */
+  abstract exec(
+    ctx: UILogicContext,
+    context: IBizContext,
+    data: IData[] | null,
+    params: IParams,
+    opt?: IParams,
+  ): Promise<void>;
+}

package/src/ui-logic/ui-logic-param/ui-logic-param.ts

@@ -0,0 +1,86 @@
+import { IBizContext } from '@ibiz-template/core';
+import { UILogicParamModel, UnsupportedModelError } from '@ibiz-template/model';
+import { UILogicContext } from '../ui-logic-context';
+
+/**
+ * 界面逻辑参数
+ *
+ * @author chitanda
+ * @date 2023-02-07 21:02:45
+ * @export
+ * @class UILogicParam
+ */
+export class UILogicParam {
+  /**
+   * Creates an instance of UILogicParam.
+   *
+   * @author chitanda
+   * @date 2023-02-08 16:02:22
+   * @param {UILogicParamModel} model
+   */
+  constructor(public model: UILogicParamModel) {}
+
+  /**
+   * 向界面逻辑中计算基础参数
+   *
+   * @author chitanda
+   * @date 2023-02-08 20:02:33
+   * @param {UILogicContext} ctx
+   * @param {IBizContext} context
+   * @param {IData} data
+   * @param {IParams} [opt]
+   */
+  calc(
+    ctx: UILogicContext,
+    context: IBizContext,
+    data: IData[] | null,
+    _params: IParams,
+    opt?: IParams,
+  ): void {
+    const { source: m, codeName: tag } = this.model;
+    const app = ibiz.hub.getApp(this.model.modelService.app);
+    if (m.default) {
+      ctx.params[tag] = data && data.length > 0 ? data[0] : {};
+    } else if (m.activeContainerParam) {
+      ctx.params[tag] = opt?.container;
+    } else if (m.activeCtrlParam || m.ctrlParam) {
+      // 当前部件
+      ctx.params[tag] = opt?.control;
+    } else if (m.activeViewParam) {
+      // 当前视图
+      ctx.params[tag] = opt?.view;
+    } else if (m.appGlobalParam) {
+      // 应用全局变量
+      ctx.params[tag] = ibiz.env;
+    } else if (m.applicationParam) {
+      // 当前应用
+      ctx.params[tag] = app;
+    } else if (m.entityListParam) {
+      // 数据对象列表
+      ctx.params[tag] = [];
+    } else if (m.entityPageParam) {
+      throw new UnsupportedModelError(m, `未支持的逻辑参数类型: 分页查询结果`);
+    } else if (m.entityParam) {
+      // 数据对象变量
+      ctx.params[tag] = [];
+    } else if (m.lastReturnParam) {
+      throw new UnsupportedModelError(m, `未支持的逻辑参数类型: 上次调用返回`);
+    } else if (m.navContextParam) {
+      // 应用上下文
+      ctx.params[tag] = context;
+    } else if (m.navViewParamParam) {
+      throw new UnsupportedModelError(m, `未支持的逻辑参数类型: 视图路由参数`);
+    } else if (m.routeViewSessionParam) {
+      throw new UnsupportedModelError(m, `未支持的逻辑参数类型: 路由视图会话`);
+    } else if (m.simpleListParam) {
+      // 简单数据列表
+      ctx.params[tag] = [];
+    } else if (m.simpleParam) {
+      throw new UnsupportedModelError(m, `未支持的逻辑参数类型: 简单数据`);
+    } else if (m.viewNavDataParam) {
+      throw new UnsupportedModelError(m, `未支持的逻辑参数类型: 视图导航数据`);
+    } else if (m.viewSessionParam) {
+      throw new UnsupportedModelError(m, `未支持的逻辑参数类型: 当前视图会话`);
+    }
+  }
+}

package/src/ui-logic/ui-logic.ts

@@ -0,0 +1,197 @@
+/* eslint-disable no-await-in-loop */
+import { IBizContext } from '@ibiz-template/core';
+import { UILogicModel, UnsupportedModelError } from '@ibiz-template/model';
+import { UILogicContext } from './ui-logic-context';
+import {
+  DEActionNode,
+  DEUIActionNode,
+  EndNode,
+  PrepareJSParamNode,
+  StartNode,
+  UILogicNode,
+} from './ui-logic-node';
+import { UILogicParam } from './ui-logic-param/ui-logic-param';
+
+/**
+ * 界面逻辑
+ *
+ * @author chitanda
+ * @date 2023-02-07 16:02:48
+ * @export
+ * @class UILogic
+ */
+export class UILogic {
+  /**
+   * 所有节点实例
+   *
+   * @author chitanda
+   * @date 2023-02-08 21:02:38
+   * @protected
+   * @type {Map<string, UILogicNode>}
+   */
+  protected nodes: Map<string, UILogicNode> = new Map();
+
+  /**
+   * 所有参数实例
+   *
+   * @author chitanda
+   * @date 2023-02-08 21:02:25
+   * @protected
+   * @type {Map<string, UILogicParam>}
+   */
+  protected params: Map<string, UILogicParam> = new Map();
+
+  /**
+   * Creates an instance of UILogic.
+   * @author chitanda
+   * @date 2023-02-08 17:02:26
+   * @param {UILogicModel} model
+   */
+  constructor(protected model: UILogicModel) {
+    model.nodes.forEach(node => {
+      const { logicNodeType } = node.source;
+      let logicNode;
+      switch (logicNodeType) {
+        case 'BEGIN': // 开始
+          logicNode = new StartNode(node);
+          break;
+        case 'END': // 结束
+          logicNode = new EndNode(node);
+          break;
+        case 'DEACTION': // 实体行为
+          logicNode = new DEActionNode(node);
+          break;
+        case 'DEUIACTION': // 实体界面行为调用
+          logicNode = new DEUIActionNode(node);
+          break;
+        case 'PREPAREJSPARAM': // 准备参数
+          logicNode = new PrepareJSParamNode(node);
+          break;
+        case 'RESETPARAM': // 重置参数
+        case 'COPYPARAM': // 拷贝参数
+        case 'BINDPARAM': // 绑定参数
+        case 'VIEWCTRLINVOKE': // 视图部件调用
+        case 'VIEWCTRLFIREEVENT': // 视图部件事件触发
+        case 'APPENDPARAM': // 附加到数组参数
+        case 'SORTPARAM': // 排序数组参数
+        case 'RENEWPARAM': // 重新建立参数
+        case 'PFPLUGIN': // 前端插件调用
+        case 'MSGBOX': // 消息弹窗
+        case 'DEDATASET': // 实体数据集
+        case 'DELOGIC': // 实体逻辑
+        case 'THROWEXCEPTION': // 抛出异常
+        case 'DEBUGPARAM': // 调试逻辑参数
+        default:
+          throw new UnsupportedModelError(
+            node.source,
+            `未支持的逻辑节点类型: ${logicNodeType}`,
+          );
+      }
+      this.nodes.set(node.codeName, logicNode);
+    });
+    model.params.forEach(param => {
+      this.params.set(param.codeName, new UILogicParam(param));
+    });
+    // 将已经实例化的逻辑节点挂载到逻辑连接上
+    this.nodes.forEach(node => {
+      node.links.forEach(link => {
+        const { srcNode, dstNode } = link.model;
+        if (this.nodes.has(srcNode.codeName)) {
+          link.srcNode = this.nodes.get(srcNode.codeName)!;
+        }
+        if (this.nodes.has(dstNode.codeName)) {
+          link.dstNode = this.nodes.get(dstNode.codeName)!;
+        }
+      });
+    });
+  }
+
+  /**
+   * 初始化逻辑参数
+   *
+   * @author chitanda
+   * @date 2023-02-08 21:02:58
+   * @protected
+   * @param {UILogicContext} ctx
+   * @param {IBizContext} context
+   * @param {IData} data
+   * @param {IParams} [opt]
+   */
+  protected initLogicParams(
+    ctx: UILogicContext,
+    context: IBizContext,
+    data: IData[] | null,
+    params: IParams,
+    opt?: IParams,
+  ): void {
+    this.params.forEach(param => {
+      param.calc(ctx, context, data, params, opt);
+    });
+  }
+
+  /**
+   * 执行视图逻辑
+   *
+   * @author chitanda
+   * @date 2023-02-08 21:02:09
+   * @param {IBizContext} context
+   * @param {IData} data
+   * @param {IParams} [opt]
+   * @return {*}  {Promise<IData>}
+   */
+  async exec(
+    context: IBizContext,
+    data: IData[] | null,
+    params: IParams,
+    opt?: IParams,
+  ): Promise<unknown> {
+    const ctx = new UILogicContext();
+    this.initLogicParams(ctx, context, data, params, opt);
+    if (this.model.startNode && this.nodes.has(this.model.startNode.codeName)) {
+      const start = this.nodes.get(this.model.startNode.codeName)!;
+      await this.deepExec(start, ctx, context, data, params, opt);
+    } else {
+      throw new UnsupportedModelError(this.model.source, `未设置起始节点`);
+    }
+    return ctx.result || ctx.params.default || null;
+  }
+
+  /**
+   * 开始根据连线递归执行逻辑
+   *
+   * @author chitanda
+   * @date 2023-02-09 15:02:32
+   * @protected
+   * @param {UILogicNode} node
+   * @param {UILogicContext} ctx
+   * @param {IBizContext} context
+   * @param {(IData[] | null)} data
+   * @param {IParams} params
+   * @param {IParams} [opt]
+   * @return {*}  {(Promise<IData | null>)}
+   */
+  protected async deepExec(
+    node: UILogicNode,
+    ctx: UILogicContext,
+    context: IBizContext,
+    data: IData[] | null,
+    params: IParams,
+    opt?: IParams,
+  ): Promise<void> {
+    // 执行逻辑节点
+    await node.exec(ctx, context, data, params, opt);
+    const { links } = node;
+    // 遍历所有节点连接，递归执行下级连接节点
+    for (let index = 0; index < links.length; index++) {
+      const link = links[index];
+      const bol = await link.exec(ctx, context, data, params, opt);
+      if (bol && link.dstNode) {
+        await this.deepExec(link.dstNode, ctx, context, data, params, opt);
+        // 平行输出: 在满足连接条件并逻辑执行完毕后若是非平行输出则执行完成
+        if (node.model.parallel === false) {
+          break;
+        }
+      }
+    }
+  }
+}

package/src/utils/app-de-ui-action-util/handler/backend-ui-action-handler.ts

@@ -1,5 +1,6 @@
 import { IBizContext } from '@ibiz-template/core';
 import { IPSAppDEUIAction } from '@ibiz-template/model';
+import { isArray } from 'lodash-es';
 import { IUIActionResult } from '../../../interface';
 import { UIActionHandler } from './ui-action-handler';
 
@@ -32,13 +33,26 @@ export class BackendUIActionHandler extends UIActionHandler {
       data,
       params,
     );
+
     const app = ibiz.hub.getApp(action.getPSModelService().app);
     const deService = await app.es.getService(entityName);
     const _data =
       resultData.length > 0
         ? resultData[0]?.getRequestData() || resultData[0]
         : {};
-    await deService.exec(methodName, resultContext, _data, resultParams);
-    return {};
+    const res = await deService.exec(
+      methodName,
+      resultContext,
+      _data,
+      resultParams,
+    );
+
+    // 适配界面行为成功提示信息
+    if (res.ok && action.successMsg) {
+      ibiz.message.success(action.successMsg);
+    }
+    return {
+      data: isArray(res.data) ? res.data : [res.data],
+    };
   }
 }