前陣子的項目需要用到多文件上傳與管理。項目本身是基於 Bootstrap 開發的,於是對比了幾款上傳插件,最後還是覺得 bootstrap-fileinput 最耐看,多文件上傳與管理它都能勝任(官方地址:https://plugins.krajee.com/file-input)。

這個插件不限於圖片,普通文件也支持,只是圖片有縮略圖更好辨識,所以下面以圖片為例。
先把項目裡關於圖片管理的需求列清楚:
1、可以一次上傳多張圖片;
2、只有點擊保存按鈕時,圖片信息才寫入數據庫;
3、能夠加載數據庫中已有的圖片,並支持刪除。
對應地,可以定義三種文件狀態:
已選擇:已放進插件但還沒上傳到服務器。如上圖第 3 張,下方帶一個上傳按鈕。
已上傳:文件已到達服務器,但信息尚未落庫。如上圖第 2 張,下方顯示 100% 進度條。
已保存:信息已寫入數據庫。如上圖第 1 張,下方是刪除按鈕,點擊會把記錄從庫裡移除。
<link href="<%=path%>/static/css/bootstrap-3.3.5/bootstrap.min.css" rel="stylesheet"> <link href="<%=path%>/static/css/bootstrap-3.3.5/fileinput.css" rel="stylesheet"> <script src="<%=path%>/static/js/jquery-1.11.3.js"></script> <script src="<%=path%>/static/js/angularjs-1.3.9/angular.min.js"></script> <script src="<%=path%>/static/js/bootstrap-3.3.5/bootstrap.min.js"></script> <script src="<%=path%>/static/js/bootstrap-3.3.5/fileinput.js"></script> <script src="<%=path%>/static/js/bootstrap-3.3.5/fileinput_locale_zh.js"></script>
其中 fileinput.js 與漢化包都在插件官方壓縮包裡。
先在頁面裡聲明 file 控件,注意 multiple 關鍵字:
<input id="input-images" type="file" multiple class="file-loading" accept="image/*">
然後初始化:
$("#input-images").fileinput({
uploadUrl: "<%=path%>" + "/album/pictureFileUpload",
allowedFileExtensions: ["jpg", "png", "gif"],
resizePreference: 'height',
maxFileCount: 10,
language: 'zh',
overwriteInitial: false,
resizeImage: true
});
後端(這裡用 JFinal):
public void pictureFileUpload() {
UploadFile uploadFile = getFile();
renderJson("{\"link\":" + "\"/fileinput/upload/" + uploadFile.getFileName() + "\"" +
",\"fileName\":\"" + uploadFile.getOriginalFileName() + "\"}");
}
要特別注意:後端一定要返回 JSON,哪怕是一個空對象 "{}"。返回的內容會保存在前端的 data.response 中。
所謂「已有文件加載」,就是把服務器上已存在的文件回顯到控件裡,讓用戶能繼續管理。這一步主要靠 initialPreview 和 initialPreviewConfig 兩個配置完成。
var initPreview = new Array(); //展示元素
var initPreviewConfig = new Array(); //展示設置
$.post("<%=path%>" + "/album/getPicsByAlbum", { albumId: albumId }, function (result) {
for (var i = 0; i < result.length; i++) {
var pictureFile = result[i];
//用於展示已經上傳的圖片
initPreview.push("<img src='" + pictureFile.PICADDRESS +
"' class='file-preview-image' alt='" + pictureFile.PICNAME +
"' title='" + pictureFile.PICNAME + "'>");
var config = new Object();
config.caption = pictureFile.PICNAME;
config.url = "<%=path%>" + "/album/deletePicById";
config.key = pictureFile.ID;
initPreviewConfig.push(config);
}
initFileInput($scope);
$("#input-images").fileinput('refresh', {
initialPreview: initPreview,
initialPreviewConfig: initPreviewConfig
});
});
點擊刪除圖標時,插件會默認把 config 裡的 key 值提交到 config.url,後端只需接一下:
public void deletePicById() {
String picId = getPara("key");
service.deletePicById(Integer.valueOf(picId));
renderJson("{}");
}
Q1:model 裡沒有定義屬性,為什麼前端能拿到值?
這裡用的是 JFinal 的 ActiveRecord 模式,不需要寫屬性和 setter/getter,值都映射在 model 的 attrs 這個鍵值對裡,key 就是數據庫字段名。要提醒的是:SQL 語句不區分大小寫,但字段名是區分的。如果字段名是大寫,映射到 model 裡的 key 也是大寫,同時 JFinal 默認以 id 為主鍵的策略會失效,需要在 configPlugin 中顯式聲明,例如 arp.addMapping("pictures", "ID", Picture.class)。建議還是按 Java 命名規範給數據庫字段命名。
Q2:初始化時為什麼要先 clear、destroy?
因為插件在選完文件後,無論是否上傳,都會把文件保留在 file 域裡,再點一次會看到上次選的文件,這不符合多相冊管理的預期。按官方文檔 clear 應該能清空 file 域,但實測並沒有,所以只能先 clear、destroy 再重新初始化控件。這一點我也不太確定,歡迎指正。
Q3:保存時怎麼判斷哪些圖片需要入庫?
$scope 上有個 selectedPics 數組,負責記錄最終會寫入數據庫的文件。選檔後把信息 push 進這個數組,hasUpload 為 false;上傳成功後把對應項的 hasUpload 改為 true;上傳後但未落庫就刪除的,會把元素從數組中移除。
有人會問:選了文件不上傳直接刪除,數組豈不是會錯位?其實不會。fileuploaded 事件中更新的是數組對應位置的元素,而下標是通過圖片所在 DIV 的 data-fileindex 屬性取得的。這個值只遞增、不回填,也不會因刪圖而變動,正好和 selectedPics 的索引對齊。
var idx = $("#" + previewId).attr("data-fileindex");
舉例:選了 3 張圖此時未上傳,data-fileindex 依次是 0、1、2;刪掉中間那張再選新圖,三個值會變成 0、2、3。
整套方案的關鍵點就三處:多選靠 input 上的 multiple,回顯靠 initialPreview + initialPreviewConfig,刪除靠 config 裡的 url 與 key 約定。把這三處串起來,多圖上傳與管理就完整了。
示例代碼與數據庫腳本(MySQL,files.sql)可一併下載參考。