官網地址先放這裡:https://fex-team.github.io/webuploader/,裡面的 demo 與文檔相當完整。本文的做法是在官方範例基礎上補了大量註解,幾乎每行都有說明,方便理解插件的事件模型與參數含義。
先看檔案上傳:
jQuery(function () {
var $ = jQuery,
$list = $('#thelist'),
$btn = $('#ctlBtn'),
state = 'pending',
uploader;
uploader = WebUploader.create({
resize: false, // 不壓縮 image
swf: BASE_URL + '/js/Uploader.swf',
server: 'https://webuploader.duapp.com/server/fileupload.php',
pick: '#picker' // 選擇檔案的按鈕
});
// 檔案進入佇列
uploader.on('fileQueued', function (file) {
$list.append('<div id="' + file.id + '" class="item">' +
'<h4 class="info">' + file.name + '</h4>' +
'<p class="state">等待上傳...</p>' +
'</div>');
});
// 上傳中,percentage 為 0~1 的進度
uploader.on('uploadProgress', function (file, percentage) {
var $li = $('#' + file.id),
$percent = $li.find('.progress .progress-bar');
if (!$percent.length) { // 避免重複建立進度條
$percent = $('<div class="progress progress-striped active"><div class="progress-bar" role="progressbar" style="width: 0%"></div></div>')
.appendTo($li).find('.progress-bar');
}
$li.find('p.state').text('上傳中');
$percent.css('width', percentage * 100 + '%');
});
uploader.on('uploadSuccess', function (file) {
$('#' + file.id).find('p.state').text('已上傳');
});
uploader.on('uploadError', function (file) {
$('#' + file.id).find('p.state').text('上傳出錯');
});
uploader.on('uploadComplete', function (file) {
$('#' + file.id).find('.progress').fadeOut();
});
// all 事件會收到所有觸發的型別
uploader.on('all', function (type) {
if (type === 'startUpload') { state = 'uploading'; }
else if (type === 'stopUpload') { state = 'paused'; }
else if (type === 'uploadFinished') { state = 'done'; }
if (state === 'uploading') { $btn.text('暫停上傳'); } else { $btn.text('開始上傳'); }
});
$btn.on('click', function () {
if (state === 'uploading') { uploader.stop(); } else { uploader.upload(); }
});
});
接著是圖片上傳,相比檔案上傳多了縮圖預覽與檔案類型限制:
jQuery(function () {
var $ = jQuery,
$list = $('#fileList'),
ratio = window.devicePixelRatio || 1, // 優化 retina 顯示
thumbnailWidth = 100 * ratio,
thumbnailHeight = 100 * ratio,
uploader;
uploader = WebUploader.create({
auto: true,
swf: BASE_URL + '/js/Uploader.swf',
server: 'https://webuploader.duapp.com/server/fileupload.php',
pick: '#filePicker',
accept: {
title: 'Images',
extensions: 'gif,jpg,jpeg,bmp,png',
mimeTypes: 'image/*'
}
});
uploader.on('fileQueued', function (file) {
var $li = $('<div id="' + file.id + '" class="file-item thumbnail"><img><div class="info">' + file.name + '</div></div>'),
$img = $li.find('img');
$list.append($li);
// 生成縮圖,非同步,失敗時回傳 error
uploader.makeThumb(file, function (error, src) {
if (error) { $img.replaceWith('<span>不能預覽</span>'); return; }
$img.attr('src', src);
}, thumbnailWidth, thumbnailHeight);
});
uploader.on('uploadProgress', function (file, percentage) {
var $li = $('#' + file.id),
$percent = $li.find('.progress span');
if (!$percent.length) {
$percent = $('<p class="progress"><span></span></p>').appendTo($li).find('span');
}
$percent.css('width', percentage * 100 + '%');
});
uploader.on('uploadSuccess', function (file) {
$('#' + file.id).addClass('upload-state-done');
});
uploader.on('uploadError', function (file) {
var $li = $('#' + file.id),
$error = $li.find('div.error');
if (!$error.length) { $error = $('<div class="error"></div>').appendTo($li); }
$error.text('上傳失敗');
});
uploader.on('uploadComplete', function (file) {
$('#' + file.id).find('.progress').remove();
});
});
後端這裡用 Java Servlet 接收並落盤。
1.先準備臨時目錄與真實目錄,兩者都要取絕對路徑:
ServletContext application = this.getServletContext(); String tempDirectory = application.getRealPath(Constant.TEMP_DIRECTORY) + "/"; String realDirectory = application.getRealPath(Constant.REAL_DIRECTORY) + "/";
然後建立檔案工廠,第一個參數是超過多少位元組就改用磁碟暫存:
參考程式碼
FileItemFactory factory = new DiskFileItemFactory(Constant.SIZE_THRESHOLD, new File(tempDirectory)); ServletFileUpload upload = new ServletFileUpload(factory);
2.設定上傳限制並解析請求
upload.setSizeMax(500 * 1024 * 1024); // 單次上傳上限 500M
List<FileItem> list = upload.parseRequest(request);
Iterator<FileItem> iter = list.iterator();
while (iter.hasNext()) {
FileItem item = iter.next();
// isFormField() 為 true 代表普通表單欄位,不是檔案
if (item.isFormField()) {
System.out.println("普通表單域" + item.getFieldName());
System.out.println(item.getString("utf-8"));
} else {
// 只有 file 表單域才需要寫入真實目錄
String lastpath = item.getName();
lastpath = lastpath.substring(lastpath.lastIndexOf("."));
String filename = UUID.randomUUID().toString().replace("-", "") + lastpath;
item.write(new File(realDirectory + filename));
完整 Servlet 如下,這裡示範了型別判斷、大小限制、副檔名推斷與回傳 JSON 位址:
package com.lanyou.support.servlet;
import java.io.File;
import java.io.IOException;
import java.util.List;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import net.sf.json.JSONObject;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileItemFactory;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
public class FileUpload extends HttpServlet {
private static final long serialVersionUID = 1L;
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doPost(req, resp);
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// t:1 一般事件上傳,2 apk
String t = req.getParameter("t") == null ? "1" : req.getParameter("t").trim();
String path = "";
JSONObject ob = new JSONObject();
try {
FileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload servletFileUpload = new ServletFileUpload(factory);
servletFileUpload.setSizeMax(1024 * 1024 * 2); // 最大 2M
servletFileUpload.setFileSizeMax(2 * 1024 * 1024);
servletFileUpload.setHeaderEncoding("UTF-8"); // 解決檔名亂碼
List<FileItem> fileItemsList = servletFileUpload.parseRequest(req);
for (FileItem item : fileItemsList) {
if (!item.isFormField()) {
if (item.getSize() > 2 * 1024 * 1024) { return; }
String fileName = item.getName();
String ent = "";
// 依 contentType 推斷副檔名
if (item.getContentType().equalsIgnoreCase("image/x-png")
|| item.getContentType().equalsIgnoreCase("image/png")) { ent = ".png"; }
else if (item.getContentType().equalsIgnoreCase("image/gif")) { ent = ".gif"; }
else if (item.getContentType().equalsIgnoreCase("image/bmp")) { ent = ".bmp"; }
else if (item.getContentType().equalsIgnoreCase("image/pjpeg")
|| item.getContentType().equalsIgnoreCase("image/jpeg")) { ent = ".jpg"; }
if (fileName.lastIndexOf(".") != -1) { ent = fileName.substring(fileName.lastIndexOf(".")); }
fileName = "ev_" + System.currentTimeMillis() + ent;
if (t.equals("1")) { path = "upload/ev/" + fileName; } else { path = "upload/pk/" + fileName; }
File file = new File(req.getSession().getServletContext().getRealPath(path));
if (!file.getParentFile().exists()) { file.getParentFile().mkdirs(); }
item.write(file);
ob.accumulate("url", path);
}
}
resp.setContentType("text/html; charset=UTF-8");
resp.getWriter().write(ob.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
實作上特別提醒幾點:副檔名不要直接信任使用者上傳的檔名,建議用 UUID 重命名並自行判斷型別;setHeaderEncoding("UTF-8") 能避免中文檔名亂碼;另外正式環境記得加上副檔名白名單與圖片內容校驗,只靠 contentType 是可以被偽造的。