修改文件上传功能的文档。

code/java/car_dealer/src/main/java/com/cpic/xim/car_dealer/controllers/fileupload/FileUploadController.java

@@ -2,7 +2,7 @@
  * @Author: Kane
  * @Date: 2022-09-28 15:47:02
  * @LastEditors: Kane
- * @LastEditTime: 2022-10-09 10:44:45
+ * @LastEditTime: 2022-10-11 09:40:45
  * @FilePath: \car_dealer\src\main\java\com\cpic\xim\car_dealer\controllers\fileupload\FileUploadController.java
  * @Description: 用于实现跨域功能的过滤器对象。
  * Copyright (c) ${2022} by Kane, All Rights Reserved. 
@@ -13,7 +13,6 @@ package com.cpic.xim.car_dealer.controllers.fileupload;
 import java.io.File;
 import java.io.IOException;
 import java.nio.channels.IllegalSelectorException;
-import javax.servlet.ServletException;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 import org.springframework.context.annotation.Scope;
@@ -27,19 +26,16 @@ import org.springframework.web.multipart.MultipartFile;
 @RequestMapping( path = "/upload")
 public class FileUploadController
 {
-    @RequestMapping( value = "/test.do")
-    public void test() throws ServletException, IOException
-    {
-        // PrintWriter writer = response.getWriter();
-
-        // writer.write( "测试！" );
-    }
-
     /*****************************************************
-     * @param request
-     * @param response
-     * @param uploadFile
-     * @return FileUploadResult 
+     * 接收上传文件，并保存到临时目录：
+     * 1、临时目录下再用sessionID作为子目录保存文件。
+     * 2、保存时不更改文件名，会覆盖同名文件。
+     * 3、MultipartFile参数形参名称必须和请求form中file标签的name属性一致，否则值为null。
+     * 4、返回值为接收结果和文件保存路径。
+     * @param request 请求对象。
+     * @param response 响应对象。
+     * @param uploadFile 文件上传对象，形参名称要和请求参数中file标签的name属性一致，否则值为null。
+     * @return FileUploadResult 文件上传结果，会被转换成json。
      *****************************************************/
     @RequestMapping( path = "/upload_file.do")
     @ResponseBody