@skyfox2000/webui 1.0.14 → 1.2.0

package/src/utils/data.ts

@@ -0,0 +1,189 @@
+import { AnyControl, ExecuteOptions, PostOptions } from '@/typings/data.d';
+import { ApiResponse, httpPost, IUrlInfo, ResStatus } from '@skyfox2000/fapi';
+import message from 'vue-m-message';
+import { isEmpty } from './isEmpty';
+
+const combineUrl = (control: AnyControl, options: ExecuteOptions<any>) => {
+   const pageCtrl = control.page;
+   const url: IUrlInfo | undefined = {
+      url: '',
+      ...pageCtrl.urls?.[options.urlKey],
+      ...control.url,
+      ...options.url,
+      loadingText: options.loadingText,
+   };
+   return url;
+};
+
+/**
+ * 合并调用方法
+ */
+const doPost = <T>(control: AnyControl, options: PostOptions<T>): Promise<ApiResponse<T> | null> => {
+   // 获取页面控制器和URL
+   const pageCtrl = control.page;
+   const url = options.url;
+   // 验证URL
+   if (!url || !url.url) {
+      const errorMsg = `URL未设置: ${options.urlKey}`;
+      console.warn(errorMsg);
+      return Promise.reject(new Error(errorMsg));
+   }
+
+   // 配置URL参数
+   if (!url.api) url.api = pageCtrl.api;
+   if (url.authorize === undefined) url.authorize = pageCtrl.authorize;
+
+   // 合并请求参数
+   let newParams = JSON.parse(JSON.stringify(options.params));
+
+   // 处理特殊参数
+   if (options.processParams) {
+      newParams = options.processParams(newParams);
+   }
+
+   // 标记为加载中
+   if (options.loadingState) {
+      options.loadingState.value = true;
+   }
+   if (options.hideErrorToast) {
+      url.hideErrorToast = true;
+   }
+   // 发起请求
+   return httpPost<T>(url, newParams)
+      .then((result: ApiResponse<T> | null) => {
+         // 更新加载状态
+         if (options.loadingState) {
+            options.loadingState.value = false;
+         }
+
+         return result;
+      })
+      .catch((_) => {
+         // 更新加载状态
+         if (options.loadingState) {
+            options.loadingState.value = false;
+         }
+
+         return null;
+      });
+};
+
+/**
+ * 通用数据查询方法
+ * @param control 控制对象 (TreeControl, GridControl等)
+ * @param options 查询选项
+ * @returns Promise<ApiResponse<T> | null>
+ */
+export const doQuery = <T>(control: AnyControl, options: PostOptions<T>): Promise<ApiResponse<T> | null> => {
+   // 设置默认参数
+   if (!options.params) options.params = {};
+   if (!options.params!.Query) options.params!.Query = {};
+
+   const url = combineUrl(control, options);
+   options.url = url;
+
+   return doPost<T>(control, options);
+};
+
+/**
+ * 通用数据执行方法（自定义执行方法）
+ * @param control 控制对象
+ * @param options 执行选项
+ * @returns Promise<ApiResponse<T> | null>
+ */
+export const doExecute = <T>(control: AnyControl, options: ExecuteOptions<T>): Promise<ApiResponse<T> | null> => {
+   if (!options.params) options.params = {};
+   if (!options.params!.Query) options.params!.Query = {};
+
+   options.loadingText = options.loadingText === false ? false : options.loadingText || '开始执行...';
+   options.url = combineUrl(control, options);
+
+   return doPost<T>(control, options).then((result) => {
+      if (result?.status === ResStatus.SUCCESS) {
+         if (!options.hideErrorToast) message.success('执行成功！');
+      }
+      return result as ApiResponse<T> | null;
+   });
+};
+
+/**
+ * 保存数据的简便方法（新增、更新、保存等）
+ * @param control 控制对象
+ * @param options 额外的执行选项
+ * @returns Promise<ApiResponse<T> | null>
+ */
+export const doSave = <T>(
+   control: AnyControl,
+   options: Partial<ExecuteOptions<T>> = {},
+): Promise<ApiResponse<T> | null> => {
+   const primaryKey = options.primaryKey || 'Id';
+   if (!options.params) options.params = {};
+   if (!options.params!.Query) options.params!.Query = {};
+   if (!options.params!.Data) {
+      message.error('错误！无保存数据！');
+      return Promise.resolve(null);
+   }
+
+   const execOptions: ExecuteOptions<T> = {
+      ...(options as ExecuteOptions<T>),
+      urlKey: options.urlKey || 'save',
+      loadingText: options.loadingText === false ? false : options.loadingText || '数据保存中...',
+   };
+
+   // 如果有主键，添加到查询条件中
+   execOptions.params!.Query![primaryKey] = execOptions.params!.Data[primaryKey];
+
+   const url = combineUrl(control, execOptions);
+   execOptions.url = url;
+
+   return doPost(control, execOptions).then((result) => {
+      if (result?.status === ResStatus.SUCCESS) {
+         if (!options.hideErrorToast) message.success('保存成功！');
+      }
+      return result as ApiResponse<T> | null;
+   });
+};
+
+/**
+ * 删除数据方法
+ * @param control 控制对象
+ * @param record 需要删除的记录或ID数组
+ * @param options 额外的执行选项
+ * @returns Promise<ApiResponse<T> | null>
+ */
+export const doDelete = <T>(
+   control: AnyControl,
+   record: string[] | Record<string, any>,
+   options: Partial<ExecuteOptions<T>> = {},
+): Promise<ApiResponse<T> | null> => {
+   const primaryKey = options.primaryKey || 'Id';
+   if (!options.params) options.params = {};
+   if (!options.params!.Query) options.params!.Query = {};
+
+   const execOptions: ExecuteOptions<T> = {
+      ...(options as ExecuteOptions<T>),
+      urlKey: 'delete',
+      loadingText: options.loadingText === false ? false : options.loadingText || '数据删除中...',
+   };
+
+   // 处理记录
+   if (Array.isArray(record)) {
+      execOptions.params!.Query![primaryKey] = record;
+   } else {
+      execOptions.params!.Query![primaryKey] = record[primaryKey];
+   }
+
+   if (isEmpty(execOptions.params!.Query) || isEmpty(execOptions.params!.Query![primaryKey])) {
+      message.error('错误！禁止无条件删除数据！');
+      return Promise.resolve(null);
+   }
+   const url = combineUrl(control, execOptions);
+   execOptions.url = url;
+
+   return doPost(control, execOptions).then((result) => {
+      if (result?.status === ResStatus.SUCCESS) {
+         if (!options.hideErrorToast) message.success('删除成功！');
+      }
+      return result as ApiResponse<T> | null;
+   });
+};

package/src/utils/download.ts

@@ -0,0 +1,80 @@
+import { MinioFile } from '@/typings/upload.d';
+import { PageControl } from '@/typings/page.d';
+import { ApiResponse, httpPost, IUrlInfo, ReqParams, ResStatus } from '@skyfox2000/fapi';
+import message from 'vue-m-message';
+import { combineParams } from '@skyfox2000/microbase';
+
+/** 通用 Blob 下载方法
+ *
+ * @param blob 文件Blob对象
+ * @param fileName 文件名
+ */
+export const downloadBlob = (blob: Blob, fileName: string) => {
+   // // IE 兼容处理
+   // if (window.navigator.msSaveOrOpenBlob) {
+   //    window.navigator.msSaveBlob(blob, fileName);
+   //    return;
+   // }
+
+   // 现代浏览器处理方式
+   const link = document.createElement('a');
+   const url = URL.createObjectURL(blob);
+
+   link.href = url;
+   link.download = fileName;
+   link.style.display = 'none';
+
+   document.body.appendChild(link);
+   link.click();
+
+   // 清理资源
+   URL.revokeObjectURL(url);
+   document.body.removeChild(link);
+};
+
+/** 从 Minio 下载文件
+ *
+ * @param url 请求地址
+ * @param pageCtrl 页面控制器
+ * @returns
+ */
+export const donwloadFromMinio = <T>(url: IUrlInfo, params?: ReqParams, pageCtrl?: PageControl<T>) => {
+   try {
+      if (pageCtrl) {
+         if (!url.api) url.api = pageCtrl.api;
+         if (url.authorize === undefined) url.authorize = pageCtrl.authorize;
+      }
+      const newParams = combineParams(url.params, params);
+
+      return httpPost<T>(url, newParams).then((result: ApiResponse<T> | null) => {
+         if (result?.status === ResStatus.SUCCESS && result.data) {
+            const minioFile: MinioFile = result.data as unknown as MinioFile;
+            // 提取内容和文件名
+            const base64String = minioFile.Content!;
+            const fileName = minioFile.FileName!;
+
+            // 解码 Base64 字符串
+            const byteCharacters = atob(base64String);
+            const byteArrays = [];
+            for (let b = 0; b < byteCharacters.length; b++) {
+               byteArrays.push(byteCharacters.charCodeAt(b));
+            }
+
+            // 创建 Blob
+            const blob = new Blob([new Uint8Array(byteArrays)], {
+               type: minioFile.Type!,
+            });
+
+            // 调用下载方法
+            downloadBlob(blob, fileName);
+         } else {
+            message.error('下载文件失败！');
+         }
+         return undefined;
+      });
+   } catch (error) {
+      console.error('下载失败:', error);
+      // throw new Error('文件导出失败，请稍后重试');
+      message.error('文件下载失败，请稍后重试');
+   }
+};

package/src/utils/eventbus.ts

@@ -0,0 +1,78 @@
+/**
+ * 设置事件前缀，防止滥用事件总线
+ */
+export enum EventPrefix {
+   SelectReload = 'Select.Reload',
+   RadioReload = 'Radio.Reload',
+   CheckboxReload = 'Checkbox.Reload',
+   TreeSelectReload = 'TreeSelect.Reload',
+   TreeCheckReload = 'TreeCheck.Reload',
+   // 可以根据需要添加更多前缀
+}
+
+class EventBus {
+   private listeners: Record<string, ((...args: any[]) => void)[]> = {};
+
+   // 检查事件名是否符合前缀
+   private isValidPrefix(event: string): boolean {
+      return Object.values(EventPrefix).some((prefix) => event.startsWith(prefix + '.'));
+   }
+
+   /**
+    * 事件订阅
+    * @param event 事件名
+    * @param listener 处理器
+    */
+   on(event: string, listener: (...args: any[]) => void) {
+      if (!this.isValidPrefix(event)) {
+         console.error(`事件前缀不正确: ${event}`);
+         return;
+      }
+
+      if (!this.listeners[event]) {
+         this.listeners[event] = [];
+      }
+      this.listeners[event].push(listener);
+   }
+
+   /**
+    * 取消订阅事件
+    * @param event 事件名
+    * @param listener 处理器
+    */
+   off(event: string, listener: (...args: any[]) => void) {
+      if (!this.isValidPrefix(event)) {
+         console.error(`事件前缀不正确: ${event}`);
+         return;
+      }
+
+      if (!this.listeners[event]) return;
+      this.listeners[event] = this.listeners[event].filter((l) => l !== listener);
+   }
+
+   //
+   /**
+    * 触发事件
+    * @param event 事件名
+    * @param args 参数
+    */
+   emit(event: string, ...args: any[]) {
+      if (!this.isValidPrefix(event)) {
+         console.error(`事件前缀不正确: ${event}`);
+         return;
+      }
+
+      if (!this.listeners[event]) return;
+      this.listeners[event].forEach((listener) => listener(event, ...args));
+   }
+}
+
+/**
+ * 全局的 EventBus 实例
+ */
+const eventBus = new EventBus();
+
+/**
+ * 全局的 EventBus 实例
+ */
+export default eventBus;

package/src/utils/export-table.ts

@@ -0,0 +1,155 @@
+import { GridControl } from '@/typings/table.d';
+import { ApiResponse, httpPost, IUrlInfo, ResStatus } from '@skyfox2000/fapi';
+import dayjs from 'dayjs';
+import message from 'vue-m-message';
+import { downloadBlob } from './download';
+
+// 下载当前选择行
+// 表头相同
+
+// 表格列类型定义 (适配 ant-design-vue)
+export interface TableColumn {
+   title: string;
+   dataIndex?: string;
+   key?: string;
+   visible?: boolean; // 是否显示列
+   export?: boolean; // 是否导出列
+   customRender?: (value: any, record: Record<string, any>) => any;
+}
+
+/**
+ * 导出选中行数据为 CSV 文件
+ * @param fileName 文件名（支持 {YYYY}、{YY}、{MM}、{DD}、{HH}、{mm}、{ss} 时间格式）
+ * @param columns 表格列配置
+ * @param selectRows 选中的数据行
+ */
+export const exportSelectedRows = async <T extends Record<string, any>>(
+   fileName: string,
+   columns: TableColumn[],
+   selectRows: T[],
+) => {
+   try {
+      const mod = await import('@json2csv/plainjs');
+      const JSON2CSVParser = mod.Parser;
+      // 1. 处理文件名中的日期格式
+      const processedFileName = formatFileName(fileName);
+
+      // 2. 过滤需要导出的列
+      const exportColumns = columns.filter((col) => col.visible !== false && col.export !== false);
+
+      // 3. 准备 CSV 字段配置
+      const fields = exportColumns.map((col) => ({
+         label: col.title,
+         value: col.dataIndex || col.key || '',
+      }));
+
+      // 4. 处理数据行
+      const processedData = selectRows.map((row) => {
+         const newRow: Record<string, any> = { ...row };
+
+         exportColumns.forEach((col) => {
+            const field = col.dataIndex || col.key;
+            if (!field) return;
+
+            // 应用自定义渲染
+            if (col.customRender) {
+               newRow[field] = col.customRender(row[field], row);
+            }
+         });
+         return newRow;
+      });
+
+      // 5. 生成 CSV 内容
+      const parser = new JSON2CSVParser({ fields });
+      const csvContent = parser.parse(processedData);
+
+      // 6. 创建并下载文件
+      const blob = new Blob([`\uFEFF${csvContent}`], { type: 'text/csv' });
+      downloadBlob(blob, processedFileName);
+   } catch (error) {
+      console.error('导出失败:', error);
+      // throw new Error('文件导出失败，请稍后重试');
+      message.error('文件导出失败，请稍后重试');
+   }
+};
+
+/** 格式化文件名 */
+const formatFileName = (fileName: string) => {
+   const datePattern = /\{([^}]+)\}/g;
+   return fileName.replace(datePattern, (_, formatStr) => {
+      return dayjs().format(formatStr);
+   });
+};
+// 下载当前条件全部数据
+// 表头相同
+
+export const exportResults = async <T extends Record<string, any>>(
+   fileName: string,
+   columns: TableColumn[],
+   gridCtrl: GridControl<T>,
+   url: IUrlInfo,
+) => {
+   try {
+      const mod = await import('@json2csv/plainjs');
+      const JSON2CSVParser = mod.Parser;
+      // 1. 处理文件名中的日期格式
+      const processedFileName = formatFileName(fileName);
+
+      // 2. 过滤需要导出的列
+      const exportColumns = columns.filter((col) => col.visible !== false);
+
+      // 3. 准备 CSV 字段配置
+      const fields = exportColumns.map((col) => ({
+         label: col.title,
+         value: col.dataIndex || col.key || '',
+      }));
+
+      // 4. 获取数据
+      let pageCtrl = gridCtrl.page;
+      let newParams = gridCtrl.gridQuery!;
+
+      if (!url.api) url.api = pageCtrl.api;
+      if (url.authorize === undefined) url.authorize = pageCtrl.authorize;
+
+      gridCtrl.isGridLoading.value = true;
+      return httpPost<T>(url, newParams).then((result: ApiResponse<T> | null) => {
+         gridCtrl.isGridLoading.value = false;
+         if (result?.status === ResStatus.SUCCESS) {
+            if (result.data) {
+               // 5. 处理数据行
+               let results = result.data as unknown as T[];
+               const processedData = results.map((row) => {
+                  const newRow: Record<string, any> = { ...row };
+
+                  exportColumns.forEach((col) => {
+                     const field = col.dataIndex || col.key;
+                     if (!field) return;
+
+                     // 应用自定义渲染
+                     if (col.customRender) {
+                        newRow[field] = col.customRender(row[field], row);
+                     }
+                  });
+                  return newRow;
+               });
+
+               // 5. 生成 CSV 内容
+               const parser = new JSON2CSVParser({ fields });
+               const csvContent = parser.parse(processedData);
+
+               // 6. 创建并下载文件
+               const blob = new Blob([`\uFEFF${csvContent}`], { type: 'text/csv' });
+               downloadBlob(blob, processedFileName);
+            }
+         }
+         return undefined;
+      });
+   } catch (error) {
+      console.error('导出失败:', error);
+      // throw new Error('文件导出失败，请稍后重试');
+      message.error('文件导出失败，请稍后重试');
+   }
+};
+
+// 后端处理
+// 下载文件或二进制输出文件