haiwei-module-admin 1.1.6 → 1.1.7

package/package.json

@@ -2,7 +2,7 @@
   "id": 0,
   "name": "haiwei-module-admin",
   "code": "admin",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "description": "haiwei前端Admin模块组件",
   "author": "Eric",
   "license": "ISC",  
@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "haiwei-skins-classics": "^1.0.7",
-    "haiwei-ui": "^1.2.4"
+    "haiwei-ui": "^1.2.7"
   },
   "devDependencies": {
     "@vue/cli-plugin-babel": "^4.4.4",

package/src/api/components/file.js

@@ -3,9 +3,7 @@ import module from '../../module'
 export default name => {
   const root = `${module.code}/${name}/`
   const crud = $http.crud(root)
-
   console.log('crud', crud)
-
   const urls = {
     upload: root + 'Upload',
     hardDelete: root + 'HardDelete'
@@ -15,6 +13,72 @@ export default name => {
     return `${$http.axios.defaults.baseURL}${urls.upload}`
   }
 
+  /**
+   * 简单文件上传接口
+   * @param {File} file - 要上传的文件对象
+   * @param {string} moduleCode - 模块编码，标识文件所属的模块
+   * @param {string} group - 文件分组，用于对文件进行分类管理
+   * @param {number} [accessMode=0] - 文件访问方式：0-私有，1-公开，2-授权，默认为0（私有）
+   * @param {string} [accounts=''] - 授权模式下关联的账户ID，多个账户使用英文逗号分隔，仅在accessMode=2时有效
+   * @returns {Promise} 返回Promise对象，成功时返回包含文件信息的响应数据
+   * @example
+   * // 基本使用示例
+   * const fileInput = document.getElementById('fileInput')
+   * const file = fileInput.files[0]
+   *
+   * $api.admin.file.upload(
+   *   file,
+   *   'user-module',
+   *   'avatar',
+   *   1, // 公开访问
+   *   ''
+   * ).then(response => {
+   *   if (response.code === 1) {
+   *     console.log('上传成功:', response.data)
+   *     // response.data 包含 { fullPath: '文件完整路径', url: '文件访问URL' }
+   *   } else {
+   *     console.error('上传失败:', response.msg)
+   *   }
+   * }).catch(error => {
+   *   console.error('请求错误:', error)
+   * })
+   *
+   * @description
+   * 此方法封装了文件上传的核心逻辑，使用FormData格式发送multipart/form-data请求。
+   * 文件字段名为'formFile'，与后端接口保持一致。
+   * 上传成功后的响应格式为：{ code: 1, data: { fullPath: '...', url: '...' }, msg: '...' }
+   * 上传失败的响应格式为：{ code: 0, msg: '错误信息' }
+   */
+  const upload = (file, moduleCode, group, accessMode = 0, accounts = '') => {
+    // 创建FormData对象，用于构建multipart/form-data格式的请求体
+    const formData = new FormData()
+
+    // 添加文件字段，字段名必须为'formFile'以匹配后端接口
+    formData.append('formFile', file)
+
+    // 添加模块编码参数，标识文件所属的业务模块
+    formData.append('moduleCode', moduleCode)
+
+    // 添加文件分组参数，用于对上传的文件进行分类管理
+    formData.append('group', group)
+
+    // 添加访问方式参数：0-私有，1-公开，2-授权
+    formData.append('accessMode', accessMode)
+
+    // 如果提供了账户ID参数，则添加到请求中（仅在授权模式下需要）
+    if (accounts) {
+      formData.append('accounts', accounts)
+    }
+
+    // 发送POST请求到文件上传接口
+    // 使用multipart/form-data内容类型，适合文件上传
+    return $http.post(urls.upload, formData, {
+      headers: {
+        'Content-Type': 'multipart/form-data'
+      }
+    })
+  }
+
   const hardDelete = id => {
     return $http.delete(urls.hardDelete, { id })
   }
@@ -36,6 +100,7 @@ export default name => {
   return {
     ...crud,
     getUploadUrl,
+    upload,
     hardDelete,
     getByFullPath,
     preview,