MultipartFile[]如何在apipost文档设置

`MultipartFile[]` 是 Spring MVC 中用于处理文件上传的数组类型，通常在处理表单提交尤其是批量文件上传时会用到。在 API 文档中设置这个参数，你需要明确描述它：

**API 示例：**

假设你在创建一个 RESTful API 接口，允许用户上传多个文件，可以这样描述：

POST /api/upload-multiple-files
{
  "description": "上传多个文件",
  "parameters": [
    {
      "name": "files[]",
      "in": "formData", // 表示这是通过请求体发送的数据
      "type": "array",
      "items": {
        "type": "file", // 文件类型
        "format": "image/*, application/pdf" // 可接受的文件格式
      },
      "required": true,
      "description": "一个包含要上传文件的数组"
    }
  ],
  "requestBody": {
    "content": {
      "multipart/form-data": {
        "schema": {
          "$ref": "#/components/schemas/MultiPartFilesUpload"
        }
      }
    }
  },
  "responses": {
    "200": { "description": "文件上传成功" },
    "400": { "description": "文件上传失败，可能是格式错误或其他验证问题" }
  }
}

// 其中 MultiPartFilesUpload 是一个自定义的 schema，例如：
{
  "title": "MultiPartFilesUpload",
  "type": "object",
  "properties": {
    "files": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/FileItem"
      }
    }
  }
}

在这个例子中，`files[]` 参数说明了接收一个文件数组，每个元素是一个 `FileItem` 对象。记得更新实际的 `FileItem` schema 根据你的需求。