@ibiz-template/runtime 0.7.41-alpha.105 → 0.7.41-alpha.106

package/src/controller/control/calendar/calendar.controller.ts

@@ -0,0 +1,873 @@
+/* eslint-disable no-case-declarations */
+import dayjs from 'dayjs';
+import { ISysCalendar, ISysCalendarItem } from '@ibiz/model-core';
+import { RuntimeError, RuntimeModelError } from '@ibiz-template/core';
+import {
+  CodeListItem,
+  ICalendarState,
+  ICalendarEvent,
+  IUILogicParams,
+  IUIActionResult,
+  MDCtrlLoadParams,
+  ICalendarItemData,
+  ICalendarController,
+} from '../../../interface';
+import { MDControlController } from '../../common';
+import { CalendarService, ILoadMoreItem } from './calendar.service';
+import { ViewLogicScheduler } from '../../../logic-scheduler';
+import { calcDeCodeNameById, getViewLogics } from '../../../model';
+import { ContextMenuController } from '../context-menu';
+import { UIActionUtil } from '../../../ui-action';
+import { Srfuf } from '../../../service';
+
+/**
+ * 日历部件控制器
+ *
+ * @author zk
+ * @date 2023-08-09 11:08:46
+ * @export
+ * @class CalendarController
+ * @extends {MDControlController<ISysCalendar, ICalendarState, ICalendarEvent>}
+ * @implements {ICalendarController}
+ */
+export class CalendarController
+  extends MDControlController<ISysCalendar, ICalendarState, ICalendarEvent>
+  implements ICalendarController
+{
+  /**
+   * 多数据部件服务
+   *
+   * @author zk
+   * @date 2023-08-08 01:08:56
+   * @type {CalendarService}
+   * @memberof CalendarController
+   */
+  declare service: CalendarService;
+
+  /**
+   * 视图逻辑触发器
+   *
+   * @type {ViewLogicScheduler}
+   * @memberof CalendarService
+   */
+  viewScheduler?: ViewLogicScheduler;
+
+  /**
+   * 上下文菜单控制器
+   * @author lxm
+   * @date 2023-08-21 10:56:24
+   * @type {{ [p: string]: ContextMenuController }}
+   */
+  contextMenus: { [p: string]: ContextMenuController } = {};
+
+  /**
+   * @description 时光轴时间戳格式化串
+   * @type {string}
+   * @memberof CalendarController
+   */
+  public timelineCaptionFormat: string = 'YYYY-MM-DD';
+
+  /**
+   * @description 获取加载更多信息数据
+   * @readonly
+   * @type {{
+   *       [modelId: string]: ILoadMoreItem;
+   *     }}
+   * @memberof CalendarController
+   */
+  get loadMoreItems(): {
+    [modelId: string]: ILoadMoreItem;
+  } {
+    return this.service.loadMore;
+  }
+
+  /**
+   * @description 分组时间属性
+   * @readonly
+   * @type {('beginTime' | 'endTime')} 开始时间 | 结束时间
+   * @memberof CalendarController
+   */
+  get groupTimeField(): 'beginTime' | 'endTime' {
+    if (this.controlParams.grouptimefield)
+      return this.controlParams.grouptimefield;
+    return 'beginTime';
+  }
+
+  /**
+   * @description 时间范围模式
+   * @readonly
+   * @type {('custom' | 'quarter' | 'year' | 'halfYear')}
+   * @memberof CalendarController
+   */
+  get timeRangeMode(): 'custom' | 'quarter' | 'year' | 'halfYear' {
+    if (this.controlParams.timerangemode)
+      return this.controlParams.timerangemode;
+    return 'year';
+  }
+
+  /**
+   * 初始化状态
+   *
+   * @author zk
+   * @date 2023-08-09 11:08:05
+   * @protected
+   * @memberof CalendarController
+   */
+  protected initState(): void {
+    super.initState();
+    // 初始化默认时间 配置控件参数时指定值格式为： YYYY-MM-DD 示例： 2025-01-01
+    if (this.model.controlParam?.ctrlParams?.DEFAULTDATETIME) {
+      this.state.selectedDate = new Date(
+        this.model.controlParam?.ctrlParams?.DEFAULTDATETIME,
+      );
+    } else {
+      this.state.selectedDate = new Date();
+    }
+    this.state.size = 1000;
+    this.state.legends = [];
+    this.state.groups = [];
+    this.state.timeRange = [];
+    this.state.calendarTitle = this.model.logicName || '';
+    this.state.showDetail = false;
+  }
+
+  /**
+   * 生命周期-创建完成
+   *
+   * @author zk
+   * @date 2023-08-09 11:08:13
+   * @protected
+   * @return {*}  {Promise<void>}
+   * @memberof CalendarController
+   */
+  protected async onCreated(): Promise<void> {
+    await super.onCreated();
+    // 初始化时间轴标题格式,默认值为YYYY-MM-DD
+    if (this.model.controlParam?.ctrlParams?.TIMELINECAPTIONFORMAT) {
+      this.timelineCaptionFormat =
+        this.model.controlParam.ctrlParams.TIMELINECAPTIONFORMAT;
+    }
+    // 日历标题多语言
+    if (this.controlParams.calendartitle) {
+      this.state.calendarTitle = ibiz.appUtil.resolveI18nText(
+        this.controlParams.calendartitle,
+      );
+    }
+    this.state.showDetail =
+      this.model.controlParam?.ctrlParams?.SHOWDETAIL ||
+      this.controlParams.showdetail === 'true' ||
+      false;
+
+    this.service = new CalendarService(this.model);
+    await this.service.init(this.context);
+    this.initTimeRange();
+    this.initViewScheduler();
+    this.initCalendarLegends();
+
+    this.model.sysCalendarItems?.forEach((item: IData) => {
+      if (item.decontextMenu?.detoolbarItems?.length) {
+        this.contextMenus[item.decontextMenu.id!] = new ContextMenuController(
+          item.decontextMenu,
+          this.context,
+          this.params,
+          this.ctx,
+        );
+      }
+    });
+
+    // 上下文菜单控制器初始化
+    await Promise.all(
+      Object.values(this.contextMenus).map(menu => menu.created()),
+    );
+  }
+
+  /**
+   * @description 初始化时间范围
+   * @protected
+   * @memberof CalendarController
+   */
+  protected initTimeRange(): void {
+    const { calendarStyle } = this.model;
+    if (calendarStyle !== 'USER2') return;
+    switch (this.timeRangeMode) {
+      case 'year':
+        this.state.timeRange = [
+          dayjs().startOf('year').toDate(),
+          dayjs().endOf('year').toDate(),
+        ];
+        break;
+      case 'halfYear':
+        const year = dayjs().year();
+        const isFirstHalf = dayjs().month() < 6;
+        if (isFirstHalf) {
+          // 上半年：1月1日 至 6月30日
+          this.state.timeRange = [
+            dayjs(`${year}-01-01`).toDate(),
+            dayjs(`${year}-06-30`).toDate(),
+          ];
+        } else {
+          // 下半年：7月1日 至 12月31日
+          this.state.timeRange = [
+            dayjs(`${year}-07-01`).toDate(),
+            dayjs(`${year}-12-31`).toDate(),
+          ];
+        }
+        break;
+      case 'quarter':
+        this.state.timeRange = [
+          dayjs().startOf('quarter').toDate(),
+          dayjs().endOf('quarter').toDate(),
+        ];
+        break;
+      case 'custom':
+        const { begintime } = this.controlParams;
+        const { endtime } = this.controlParams;
+        if (
+          !begintime ||
+          !dayjs(begintime).isValid() ||
+          !endtime ||
+          !dayjs(endtime).isValid()
+        )
+          throw new RuntimeError(
+            ibiz.i18n.t('runtime.controller.control.calendar.illegalTime'),
+          );
+        this.state.timeRange = [
+          dayjs(begintime).toDate(),
+          dayjs(endtime).toDate(),
+        ];
+        break;
+      default:
+        break;
+    }
+  }
+
+  /**
+   * @description 执行行为
+   * @param {string} uiActionId
+   * @param {ICalendarItemData} data
+   * @param {MouseEvent} event
+   * @param {string} appId
+   * @returns {*}  {Promise<void>}
+   * @memberof CalendarController
+   */
+  async doUIAction(
+    uiActionId: string,
+    item: ICalendarItemData,
+    event: MouseEvent,
+    appId: string,
+  ): Promise<void> {
+    const eventArgs = this.getEventArgs();
+    const result = await UIActionUtil.exec(
+      uiActionId!,
+      {
+        ...eventArgs,
+        data: [item.deData],
+        context: this.context.clone(),
+        params: this.params,
+        event,
+      },
+      appId,
+    );
+    if (result.closeView) {
+      this.view.closeView();
+    } else if (result.refresh) {
+      // 整个日历数据刷新
+      this.refresh();
+    }
+  }
+
+  /**
+   * 初始化日历图例
+   *
+   * @protected
+   * @memberof CalendarController
+   */
+  protected initCalendarLegends(): void {
+    const { sysCalendarItems } = this.model;
+    if (!sysCalendarItems)
+      throw new RuntimeError(
+        ibiz.i18n.t('runtime.controller.control.calendar.noFoundModel'),
+      );
+    this.state.legends = sysCalendarItems.map(item => {
+      const { itemType = '', name = '', bkcolor, color } = item;
+      return {
+        name,
+        color,
+        bkcolor,
+        id: itemType,
+      };
+    });
+  }
+
+  /**
+   * 初始化视图触发器
+   *
+   * @protected
+   * @memberof CalendarService
+   */
+  protected initViewScheduler(): void {
+    const viewLogics = getViewLogics(this.model);
+    if (viewLogics.length !== 0) {
+      this.viewScheduler = ibiz.scheduler.createViewScheduler(viewLogics);
+      this.viewScheduler.defaultParamsCb = (): IUILogicParams => {
+        return this.getEventArgs();
+      };
+      if (this.viewScheduler.hasViewEventTrigger) {
+        // 监听视图事件触发视图事件触发器
+        this.evt.onAll((_eventName, event) => {
+          this.viewScheduler!.triggerViewEvent(event);
+        });
+      }
+    }
+  }
+
+  /**
+   * 销毁
+   *
+   * @protected
+   * @return {*}  {Promise<void>}
+   * @memberof LightCalendarController
+   */
+  protected async onDestroyed(): Promise<void> {
+    await super.onDestroyed();
+    if (this.viewScheduler) {
+      this.viewScheduler.destroy();
+    }
+  }
+
+  /**
+   * 设置激活数据
+   *
+   * @param {ICalendarItemData} item
+   * @return {*}  {Promise<void>}
+   * @memberof CalendarService
+   */
+  async setActive(item: ICalendarItemData): Promise<void> {
+    this._evt.emit('onActive', {
+      data: item ? [item] : [],
+    });
+    if (!item) return;
+    await this.openData(item.deData);
+  }
+
+  /**
+   * @description 打开编辑数据视图
+   * @param {IData} item
+   * @param {MouseEvent} [event]
+   * @returns {*}  {Promise<IUIActionResult>}
+   * @memberof CalendarController
+   */
+  async openData(item: IData, event?: MouseEvent): Promise<IUIActionResult> {
+    const calendarItem = this.getItemModelByKey(item.srfkey);
+    if (!calendarItem)
+      throw new RuntimeError(
+        ibiz.i18n.t('runtime.controller.control.calendar.noFoundModel'),
+      );
+    // 添加选中数据的主键
+    const context = this.context.clone();
+    const deName = calcDeCodeNameById(calendarItem.appDataEntityId!);
+    context[deName!.toLowerCase()] = item.srfkey;
+    context.srfnavctrlid = this.ctrlId;
+    const result = await this.viewScheduler?.triggerCustom(
+      `${calendarItem.itemType!.toLowerCase()}_opendata`,
+      {
+        event,
+        context,
+        params: this.params,
+        data: [item],
+        view: this.view,
+        ctrl: this,
+      },
+    );
+    if (result === -1)
+      throw new RuntimeModelError(
+        calendarItem,
+        ibiz.i18n.t('runtime.controller.common.md.logicOpendata', {
+          itemType: calendarItem.itemType!.toLowerCase(),
+        }),
+      );
+    return {
+      cancel: result ? result.ok : true,
+    };
+  }
+
+  /**
+   * @description 打开新建编辑视图
+   * @param {IData} item
+   * @returns {*}  {Promise<IUIActionResult>}
+   * @memberof CalendarController
+   */
+  async newData(item: IData, event?: MouseEvent): Promise<IUIActionResult> {
+    const calendarItem = this.getItemModelByKey(item.srfkey);
+    if (!calendarItem)
+      throw new RuntimeError(
+        ibiz.i18n.t('runtime.controller.control.calendar.noFoundModel'),
+      );
+    const context = this.context.clone();
+    context.srfnavctrlid = this.ctrlId;
+    const result = await this.viewScheduler?.triggerCustom(
+      `${calendarItem.itemType!.toLowerCase()}_newdata`,
+      {
+        event,
+        context: this.context,
+        params: this.params,
+        view: this.view,
+        ctrl: this,
+      },
+    );
+    if (result === -1)
+      throw new RuntimeModelError(
+        calendarItem,
+        ibiz.i18n.t('runtime.controller.common.md.logicNewdata', {
+          itemType: calendarItem.itemType!.toLowerCase(),
+        }),
+      );
+    return {
+      cancel: result ? result.ok : true,
+    };
+  }
+
+  /**
+   * 计算表格展示模式
+   * @author fzh
+   * @date 2024-05-29 19:18:42
+   * @return {*}  {void}
+   */
+  calcShowMode(items: IData): void {
+    this.state.hideNoDataImage = false;
+    // SHOWMODE = 'DEFAULT'|'ONLYDATA'|'MIXIN'
+    // DEFAULT  默认逻辑
+    const showmode = this.controlParams.showmode || 'DEFAULT';
+
+    // ONLYDATA 无论有无数据 仅仅显示数据区域，表格头和分页栏都不要
+    if (showmode === 'ONLYDATA') {
+      if (items.length === 0) {
+        this.state.hideNoDataImage = true;
+      }
+    }
+    // MIXIN 无数据时，仅仅显示数据区域，表格头和分页栏都不要；有数据时，展示还是和默认一样
+    if (showmode === 'MIXIN') {
+      if (items.length === 0) {
+        this.state.hideNoDataImage = true;
+      }
+    }
+  }
+
+  /**
+   * 日历加载
+   *
+   * @author zk
+   * @date 2023-08-08 01:08:24
+   * @param {MDCtrlLoadParams} [args={}]
+   * @return {*}  {Promise<IData[][]>}
+   * @memberof CalendarController
+   */
+  async load(args: MDCtrlLoadParams = {}): Promise<ICalendarItemData[]> {
+    if (this.state.isSimple) {
+      this.state.isLoaded = true;
+      return [];
+    }
+    const isInitialLoad = args.isInitialLoad === true;
+    let isLoadMore = args.isLoadMore === true;
+    // *查询参数处理
+    const { context } = this.handlerAbilityParams(args);
+    const params = await this.getFetchParams(args?.viewParam);
+    const { calendarStyle } = this.model;
+    if (calendarStyle === 'USER') {
+      const { srfstartdate } = params;
+      this.state.selectedDate = new Date(srfstartdate);
+    } else if (calendarStyle === 'TIMELINE' && isInitialLoad) {
+      // 初始化加载时间轴时标记加载更多
+      isLoadMore = true;
+    }
+    // *发起请求
+    await this.startLoading();
+    let items;
+    try {
+      items = await this.service.search(context, params, {
+        isLoadMore,
+        sortField: this.groupTimeField,
+      });
+    } finally {
+      await this.endLoading();
+    }
+    this.state.items = items;
+    await this.afterLoad(args, items);
+    this.state.isLoaded = true;
+    await this.evt.emit('onLoadSuccess', {
+      isInitialLoad,
+    });
+    return items;
+  }
+
+  /**
+   * 部件加载后处理
+   *
+   * @param {MDCtrlLoadParams} args
+   * @param {IData[]} items
+   * @return {*}  {Promise<IData[]>}
+   * @memberof CalendarController
+   */
+  async afterLoad(args: MDCtrlLoadParams, items: IData[]): Promise<IData[]> {
+    super.afterLoad(args, items);
+    this.sortItems(this.state.items, this.groupTimeField);
+    this.calcShowMode(this.state.items);
+    await this.handleDataGroup();
+    return items;
+  }
+
+  /**
+   * 处理数据分组
+   *
+   * @protected
+   * @return {*}  {Promise<void>}
+   * @memberof CalendarController
+   */
+  protected async handleDataGroup(): Promise<void> {
+    const { enableGroup, groupMode, groupAppDEFieldId, groupCodeListId } =
+      this.model;
+    if (enableGroup && groupMode && groupAppDEFieldId) {
+      const groupMap = new Map<string | number, ICalendarItemData[]>();
+      let codeList: readonly CodeListItem[] = [];
+      if (groupMode === 'CODELIST' && groupCodeListId) {
+        const app = ibiz.hub.getApp(this.context.srfappid);
+        codeList = await app.codeList.get(
+          groupCodeListId,
+          this.context,
+          this.params,
+        );
+        codeList.forEach(c => {
+          groupMap.set(c.value, []);
+        });
+      }
+      this.state.items.forEach(item => {
+        const value = item.deData[groupAppDEFieldId?.toLowerCase()];
+        if (value) {
+          if (groupMode !== 'CODELIST' && !groupMap.has(value)) {
+            groupMap.set(value, []);
+          }
+          if (groupMap.has(value)) {
+            groupMap.get(value)!.push(item);
+          }
+        }
+      });
+      groupMap.forEach((value, key) => {
+        this.state.groups.push({
+          key: `${key}`,
+          caption: codeList.find(c => c.value === key)?.text || `${key}`,
+          children: value,
+        });
+      });
+    }
+  }
+
+  /**
+   * 日历项排序
+   * - 默认开始时间倒序
+   * @protected
+   * @param {ICalendarItemData[]} items 日历项集合
+   * @param {('beginTime' | 'endTime')} [sortField='beginTime']
+   * @memberof CalendarController
+   */
+  protected sortItems(
+    items: ICalendarItemData[],
+    sortField: 'beginTime' | 'endTime' = 'beginTime',
+  ): void {
+    items.sort((a, b) => {
+      let result = 0;
+      const x = a[sortField];
+      const y = b[sortField];
+      if (dayjs(x).isAfter(y)) {
+        result = -1;
+      } else if (dayjs(x).isBefore(y)) {
+        result = 1;
+      }
+      return result;
+    });
+  }
+
+  /**
+   * 获取当前选中的日期
+   *
+   * @author zk
+   * @date 2023-08-08 11:08:44
+   * @protected
+   * @param {IParams} param
+   * @return {*}  {IData}
+   * @memberof CalendarController
+   */
+  protected getCurSelectDate(param: IParams): IData {
+    const { selectedDate, timeRange } = this.state;
+    const { calendarStyle } = this.model;
+    let { srfstartdate, srfenddate } = param;
+    if (!srfstartdate || !srfenddate) {
+      switch (calendarStyle) {
+        case 'DAY':
+          srfstartdate = new Date(
+            selectedDate.getFullYear(),
+            selectedDate.getMonth(),
+            selectedDate.getDate(),
+          );
+          srfenddate = new Date(
+            new Date(
+              selectedDate.getFullYear(),
+              selectedDate.getMonth(),
+              selectedDate.getDate() + 1,
+            ).getTime() - 1,
+          );
+          break;
+        case 'WEEK':
+        case 'USER':
+          // 获取当前日期是星期几（0表示星期日，1表示星期一，以此类推）
+          const currentDayOfWeek = selectedDate.getDay();
+          // 获取当前日期与当前周的第一天的偏移量（负数表示前面的日期，正数表示后面的日期）
+          const offset = currentDayOfWeek > 0 ? -currentDayOfWeek + 1 : -6;
+          // 获取当前周的起始时间
+          srfstartdate = new Date(
+            selectedDate.getFullYear(),
+            selectedDate.getMonth(),
+            selectedDate.getDate() + offset,
+          );
+
+          // 获取当前周的终止时间
+          srfenddate = new Date(
+            new Date(
+              srfstartdate.getFullYear(),
+              srfstartdate.getMonth(),
+              srfstartdate.getDate() + 7,
+            ).getTime() - 1,
+          );
+          break;
+        case 'MONTH':
+          // 获取当前月份的第一天
+          srfstartdate = new Date(
+            selectedDate.getFullYear(),
+            selectedDate.getMonth(),
+            1,
+          );
+          // 获取下个月的第一天，然后减去一天
+          srfenddate = new Date(
+            new Date(
+              selectedDate.getFullYear(),
+              selectedDate.getMonth() + 1,
+              1,
+            ).getTime() - 1,
+          );
+          break;
+        case 'USER2':
+          srfstartdate = dayjs(timeRange[0]).format('YYYY-MM-DD');
+          srfenddate = dayjs(timeRange[1]).format('YYYY-MM-DD');
+          break;
+        default:
+          break;
+      }
+      return {
+        srfstartdate: dayjs(srfstartdate).format('YYYY-MM-DD HH:mm:ss'),
+        srfenddate: dayjs(srfenddate).format('YYYY-MM-DD HH:mm:ss'),
+      };
+    }
+    return { srfstartdate, srfenddate };
+  }
+
+  /**
+   * 获取请求参数
+   *
+   * @author zk
+   * @date 2023-08-09 11:08:35
+   * @param {IParams} [extraParams={}]
+   * @return {*}  {Promise<IParams>}
+   * @memberof CalendarController
+   */
+  async getFetchParams(extraParams: IParams = {}): Promise<IParams> {
+    const { curPage, size, sortQuery, noSort } = this.state;
+    const resultParams: IParams = {
+      ...this.params,
+    };
+
+    // 排序条件
+    if (!noSort && sortQuery) {
+      resultParams.sort = sortQuery;
+    }
+    // *请求参数处理
+    await this._evt.emit('onBeforeLoad', { params: resultParams });
+    // 合并搜索条件参数，这些参数在onBeforeLoad监听里由外部填入
+    Object.assign(resultParams, {
+      ...this.state.searchParams,
+    });
+    // 有size才给page和size。size默认值给0就不传分页和大小
+    if (size) {
+      resultParams.page = curPage - 1;
+      resultParams.size = size;
+    }
+
+    // 额外附加参数
+    if (extraParams) {
+      Object.assign(resultParams, extraParams);
+    }
+
+    // 时间轴类型不需要开始结束时间参数
+    if (this.model.calendarStyle !== 'TIMELINE') {
+      const timeParam = this.getCurSelectDate(resultParams);
+      Object.assign(resultParams, timeParam);
+    }
+    return resultParams;
+  }
+
+  /**
+   * 行单击事件
+   *
+   * @author zk
+   * @date 2023-08-08 05:08:15
+   * @param {ICalendarItemData} data
+   * @return {*}  {Promise<void>}
+   * @memberof CalendarController
+   */
+  async onRowClick(_data: ICalendarItemData): Promise<void> {
+    const data = this.state.items.find(item => item.id === _data.id);
+    if (!data) {
+      this.setSelection([]);
+      return;
+    }
+    // 选中相关处理
+    const { selectedData } = this.state;
+    // 选中里没有则添加，有则删除
+    const filterArr = selectedData.filter(
+      item => item.deData.srfkey !== data.deData.srfkey,
+    );
+    if (filterArr.length === selectedData.length) {
+      this.setSelection(
+        this.state.singleSelect ? [data] : selectedData.concat([data]),
+      );
+    } else {
+      this.setSelection(filterArr);
+    }
+
+    // 设置导航数据
+    this.setNavData(data);
+    // 默认就走激活事件
+    await this.setActive(data);
+  }
+
+  /**
+   * 双击事件
+   *
+   * @param {ICalendarItemData} data
+   * @return {*}  {Promise<void>}
+   * @memberof CalendarController
+   */
+  async onDbRowClick(_data: ICalendarItemData): Promise<void> {
+    const data = this.state.items.find(item => item.id === _data.id);
+    if (this.state.mdctrlActiveMode === 2 && data) {
+      await this.setActive(data);
+    }
+  }
+
+  /**
+   * 设置选中日期
+   *
+   * @author zk
+   * @date 2023-08-08 11:08:08
+   * @param {Date} date
+   * @memberof CalendarController
+   */
+  setSelectDate(date: Date): void {
+    this.state.selectedDate = date;
+  }
+
+  /**
+   * @description 根据数据主键获取日历项模型
+   * @param {string} key
+   * @returns {*}  {(ISysCalendarItem | undefined)}
+   * @memberof CalendarController
+   */
+  getItemModelByKey(key: string): ISysCalendarItem | undefined {
+    const item = this.state.items.find(_item => _item.srfkey === key);
+    return this.model.sysCalendarItems?.find(
+      sysItem => sysItem.itemType === item?.itemType,
+    );
+  }
+
+  /**
+   * @description 处理项删除
+   * @param {ICalendarItemData} item 日历项
+   * @param {IContext} context 上下文
+   * @param {IParams} params 视图参数
+   * @returns {*}  {Promise<boolean>}
+   * @memberof CalendarController
+   */
+  async handleItemRemove(
+    item: IData,
+    context: IContext,
+    params: IParams,
+  ): Promise<boolean> {
+    let needRefresh = false;
+    const calendarItem = this.getItemModelByKey(item.srfkey);
+    if (!calendarItem)
+      throw new RuntimeError(
+        ibiz.i18n.t('runtime.controller.control.calendar.noFoundModel'),
+      );
+    if (calendarItem.appDataEntityId && item.srfuf !== Srfuf.CREATE) {
+      // 删除后台的数据
+      const deName = calcDeCodeNameById(calendarItem.appDataEntityId);
+      const tempContext = context.clone();
+      tempContext[deName] = item.srfkey;
+      await this.service.removeItem(
+        calendarItem.appDataEntityId,
+        tempContext,
+        params,
+        calendarItem.removeAppDEActionId,
+      );
+      needRefresh = true;
+    }
+    return needRefresh;
+  }
+
+  /**
+   * @description 跳转第一页
+   * @returns {*}  {Promise<IData[]>}
+   * @memberof CalendarController
+   */
+  async goToFirstPage(): Promise<IData[]> {
+    return [];
+  }
+
+  /**
+   * @description 跳转上一页
+   * @returns {*}  {Promise<IData[]>}
+   * @memberof CalendarController
+   */
+  async goToPreviousPage(): Promise<IData[]> {
+    return [];
+  }
+
+  /**
+   * @description 跳转下一页
+   * @returns {*}  {Promise<IData[]>}
+   * @memberof CalendarController
+   */
+  async goToNextPage(): Promise<IData[]> {
+    return [];
+  }
+
+  /**
+   * @description 跳转最后一页
+   * @returns {*}  {Promise<IData[]>}
+   * @memberof CalendarController
+   */
+  async goToLastPage(): Promise<IData[]> {
+    return [];
+  }
+
+  /**
+   * @description 转换各类多语言
+   * @protected
+   * @memberof CalendarController
+   */
+  protected convertMultipleLanguages(): void {
+    const { sysCalendarItems = [] } = this.model;
+    sysCalendarItems.forEach((item: ISysCalendarItem) => {
+      if (item.nameLanguageRes?.lanResTag)
+        item.name = ibiz.i18n.t(item.nameLanguageRes.lanResTag, item.name);
+    });
+  }
+}