DIV CSS 佈局教程網

React 搭配自製 AJAX 封裝:圖片上傳與即時預覽
編輯:AJAX基礎知識     

上網找 AJAX 上傳圖片的寫法,大部分都用 jQuery。但在一個 React 專案裡為了上傳而引入 jQuery,顯得有點本末倒置,所以我乾脆自己封裝了一個精簡的請求模組。

流程是這樣的:點擊「選擇檔案」並挑好圖片後,立即上傳到伺服器;伺服器回傳檔名與可存取路徑,頁面隨即顯示檔名並把圖片渲染出來。

React 元件

import React from 'react';
import Http from './http';

const URL = 'https://localhost:8080/fileuploadExample/UploadServlet';

export default class App extends React.Component {
  constructor(props) {
    super(props);
    this.state = {
      uploadedFile: "",
      uploadedFileGetUrl: ''
    };
  }

  error() {
    alert('error');
  }

  callback(result) {
    this.setState({
      uploadedFile: result.uploadedFile,
      uploadedFileGetUrl: result.uploadedFileGetUrl
    });
  }

  handleImageUpload(e) {
    e.preventDefault();
    let file = e.target;
    Http.post(URL, file, this.callback.bind(this), this.error);
  }

  render() {
    return (
      <div>
        <input type="file" onChange={this.handleImageUpload.bind(this)} />
        <div>
          {this.state.uploadedFileGetUrl === '' ? null :
            <div>
              <p>{this.state.uploadedFile}</p>
              <img src={this.state.uploadedFileGetUrl} alt="你選擇的圖片" />
            </div>
          }
        </div>
      </div>
    );
  }
}

上傳結果存在 state 裡,render() 依 uploadedFileGetUrl 是否為空決定要不要顯示預覽區,完全交由 React 的狀態驅動,不必手動操作 DOM。

自製的 AJAX 模組

var Http = (function () {
  var http = {};

  if (typeof window.XMLHttpRequest === "undefined") {
    window.XMLHttpRequest = function () {
      return new window.ActiveXObject(
        navigator.userAgent.indexOf("MSIE 5") >= 0
          ? "Microsoft.XMLHTTP" : "Msxml2.XMLHTTP"
      );
    };
  }

  http.post = function (url, data, callback, error) {
    if (typeof data === "function") {   // data 可省略
      callback = data;
      data = null;
    }

    var timeout = setTimeout(function () {
      error();   // 逾時處理
    }, 10000);

    var xhr = new XMLHttpRequest();
    xhr.open('post', url);

    xhr.onreadystatechange = function () {
      if (xhr.readyState === 4) {
        clearTimeout(timeout);
        if (xhr.status === 200) {
          callback(JSON.parse(xhr.responseText));
        } else {
          error();
        }
        xhr = null;   // 釋放物件,避免記憶體堆積
      }
    };

    xhr.onerror = function () {
      clearTimeout(timeout);
      error();
    };

    xhr.send(http.formDataCode(data));
  };

  // 把資料轉成 FormData
  http.formDataCode = function (data) {
    if (!data) { return null; }

    var fd = new FormData();
    for (var key in data) {
      if (data.files) {
        fd.append("image", data.files[0]);
      } else {
        fd.append(key, data[key]);
      }
    }
    return fd;
  };

  return http;
})();

export default Http;

這個封裝做了三件 jQuery 預設會幫你處理、但自己寫容易漏掉的事:逾時中斷、錯誤回呼、以及請求結束後釋放 xhr 物件。

Java 後端上傳

@WebServlet("/UploadServlet")
public class UploadServlet extends HttpServlet {
    private static String PATH_FOLDER = "/";
    private static String TEMP_FOLDER = "/";

    @Override
    public void init(ServletConfig config) throws ServletException {
        super.init();
        ServletContext ctx = config.getServletContext();
        PATH_FOLDER = ctx.getRealPath("/upload");      // 最終存放目錄
        TEMP_FOLDER = ctx.getRealPath("/uploadTemp");  // 暫存目錄
    }

    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        response.setHeader("Access-Control-Allow-Origin", "https://localhost:3000");
        response.setHeader("Access-Control-Allow-Credentials", "true");
        request.setCharacterEncoding("utf-8");
        response.setContentType("text/html;charset=UTF-8");

        DiskFileItemFactory factory = new DiskFileItemFactory();
        // 先寫入暫存區,再由程式搬到正式目錄
        factory.setRepository(new File(TEMP_FOLDER));
        // 超過 1MB 才落磁碟,其餘留在記憶體
        factory.setSizeThreshold(1024 * 1024);

        ServletFileUpload upload = new ServletFileUpload(factory);
        try {
            List<FileItem> list = upload.parseRequest(request);
            FileItem item = getUploadFileItem(list);
            String filename = getUploadFileName(item);

            // 以時間戳重新命名,避免同名覆蓋
            String saveName = new Date().getTime()
                              + filename.substring(filename.lastIndexOf("."));

            String picUrl = request.getScheme() + "://" + request.getServerName()
                          + ":" + request.getServerPort() + request.getContextPath()
                          + "/upload/" + saveName;

            item.write(new File(PATH_FOLDER, saveName));

            JSONObject result = new JSONObject();
            result.put("uploadedFile", filename);
            result.put("uploadedFileGetUrl", picUrl);

            PrintWriter writer = response.getWriter();
            writer.write(result.toString());
            writer.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    private FileItem getUploadFileItem(List<FileItem> list) {
        for (FileItem fileItem : list) {
            if (!fileItem.isFormField()) {
                return fileItem;
            }
        }
        return null;
    }

    private String getUploadFileName(FileItem item) {
        String value = item.getName();
        int start = value.lastIndexOf("/");
        return value.substring(start + 1);
    }

    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        doGet(request, response);
    }
}

相比網路上常見的版本,這裡調整了兩處:

1. 加上跨域標頭

response.setHeader("Access-Control-Allow-Origin", "https://localhost:3000");
response.setHeader("Access-Control-Allow-Credentials", "true");

因為 React 開發伺服器與後端連接埠不同,屬於跨來源請求。正式環境請把來源改成你的實際網域,避免使用 * 搭配 credentials。

2. 用 JSON 物件回應

JSONObject result = new JSONObject();
result.put("uploadedFile", filename);
result.put("uploadedFileGetUrl", picUrl);
writer.write(result.toString());

頁面與伺服器之間以 JSON 傳輸,前端 JSON.parse() 後就能直接取用欄位,比手工拼接字串可靠得多。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved