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

流程是這樣的:點擊「選擇檔案」並挑好圖片後,立即上傳到伺服器;伺服器回傳檔名與可存取路徑,頁面隨即顯示檔名並把圖片渲染出來。
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。
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 物件。
@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() 後就能直接取用欄位,比手工拼接字串可靠得多。