網上看了很多關于文件上傳的帖子,眾口不一,感覺有點亂,最近正好公司的項目里用到JQuery的uploadify控件做文件上傳,所以整理下頭緒,搞篇文檔出來,供親們分享。
Uploadify控件的主要優勢是可以實現批量文件上傳,并且提供了onSelect(選中文件)、onUploadSuccess(上傳成功回調函數)等多個事件監聽函數,可以操控上傳的整個流程。
對uploadify有個簡單的了解后,廢話不多說,開始吧...
(由于這次項目中用到的是ssm框架,所以就以sPRingmvc的后臺處理為例)。
一、在工程中導入uploadify
1、首先,下載uploadify包文件
Uploadify官網 :下載地址 <a>http://www.uploadify.com/</a>
2、解壓包文件,得到如下結構:

background.jpg 是上傳框的背景圖片
jquery.uploadify.min.js 迷你版的uploadify js文件,主要功能就靠它了
jquery-1.9.1.js 都懂得,版本沒啥要求
uploadify.CSS 上傳組件的美化文件
uploadify.swf 上傳時的動態效果,進度條等
Uploadify-cancel.png 取消上傳按鈕圖片
3、將uplodify文件夾放到webapp下

4、導入必須的jar包
commons-fileupload-1.3.1.jar
commons-io-2.2.jar
使用maven時pom.xml中添加如下依賴即可:
- <dependency>
- <groupId>commons-fileupload</groupId>
- <artifactId>commons-fileupload</artifactId>
- <version>1.3.1</version>
- </dependency>
5、在springmvc.xml文件中加入multipart 的解析器
Java代碼

- <bean
-
- id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
-
- <property name="maxUploadSize" value="1024000"></property>
-
- <property name="defaultEncoding" value="utf-8"/><!--屬性:編碼-->
-
- </bean>
:這個必須配置,一會在controller里抓取上傳文件時要用。否則會報錯。
二、在需要做上傳的頁面中配置
6、在頁頭導入

7、在頁面中需要上傳附件的位置插入
Java代碼

- <div id="uploadfileQueue"></div> //存放選擇文件的 圖片按鈕的 Div
-
- <input type="file" id="file_upload">
-
- <input type="button" value="上傳"
- onclick="Javascript:$('#file_upload').uplodify('upload','*')" >
-
- <input type="button" value="取消上傳"
- onclick="javascript:$('#file_upload').uplodify('cancel','*')" >
-
- (固定寫法)
8、js中設置
代碼 
- <script type="text/javascript">
-
- $(document).ready(function() {
-
- $("#file_upload").uploadify({
-
- //是否自動上傳 true or false
- 'auto':false,
-
- //超時時間上傳成功后,將等待服務器的響應時間。
- //在此時間后,若服務器未響應,則默認為成功(因為已經上傳,等待服務器的響應) 單位:秒
- 'successTimeout':99999,
-
- //附帶值 JSON對象數據,將與每個文件一起發送至服務器端。
- //如果為動態值,請在onUploadStart()中使用settings()方法更改該JSON值
- 'formData':{ //可以不寫
- 'user.username':'',
- 'user.age':''
- },
- 'onUploadStart': function(file) {
- var name=$('#username').val();
- var age=$('#age').val();
- $("#file_upload").uploadify(
- "settings",
- "formData",
- {'user.username':name,'user.age':age});
- },
- //Flash
- 'swf': "${pageContext.request.contextPath}/uplodify/uploadify.swf",
-
- //文件選擇后的容器div的id值
- 'queueID':'uploadfileQueue',
-
- //將要上傳的文件對象的名稱 必須與后臺controller中抓取的文件名保持一致
- 'fileObjName':'pic',
-
- //上傳地址
- 'uploader':'${pageContext.request.contextPath}/upload/uploadFile',
-
- //瀏覽將要上傳文件按鈕的背景圖片路徑
- 'buttonImage':'${pageContext.request.contextPath}/uplodify/background.jpg',
-
- //瀏覽按鈕的寬度
- 'width':'100',
-
- //瀏覽按鈕的高度
- 'height':'32',
-
- //在瀏覽窗口底部的文件類型下拉菜單中顯示的文本
- 'fileTypeDesc':'支持的格式:',
-
- //允許上傳的文件后綴
- 'fileTypeExts':'*.jpg;*.jpge;*.gif;*.png', 有哪些??
-
- /*上傳文件的大小限制允許上傳文件的最大 大小。 這個值可以是一個數字或字 符串。
- 如果它是一個字符串,它接受一個單位(B, KB, MB, or GB)。
- 默認單位為KB您可以將此值設置為0 ,沒有限制,
- 單個文件不允許超過所設置的值 如果超過 onSelectError時間被觸發*/
- 'fileSizeLimit':'100KB',
-
- //允許上傳的文件的最大數量。當達到或超過這個數字,onSelectError事件被觸發。
- 'queueSizeLimit' : 3,
-
- //選擇上傳文件后調用
- 'onSelect' : function(file) {
- //alert("123");
- },
-
- //返回一個錯誤,選擇文件的時候觸發
- 'onSelectError':function(file, errorCode, errorMsg){
- switch(errorCode) {
- case -100:
- alert("上傳的文件數量已經超出系統限制的"
- +$('#file_upload').uploadify('settings','queueSizeLimit')+"個文件!");
- break;
-
- case -110:
- alert("文件 ["+file.name+"] 大小超出系統限制的"
- +$('#file_upload').uploadify('settings','fileSizeLimit')+"大小!");
- break;
-
- case -120:
- alert("文件 ["+file.name+"] 大小異常!");
- break;
-
- case -130:
- alert("文件 ["+file.name+"] 類型不正確!");
- break;
- }
- },
-
- //上傳到服務器,服務器返回相應信息到data里
- 'onUploadSuccess':function(file, data, response){
- alert("上傳成功");
- },
-
- //當單個文件上傳出錯時觸發
- 'onUploadError': function (file, errorCode, errorMsg, errorString) {
- alert("上傳失敗");
- }
- });
-
- });
-
- </script>
9、在controller中,實現上傳
Java代碼

- //接收上傳文件
-
- @RequestMapping(value="uploadFile",method=RequestMethod.POST,produces="text/html;charset=utf-8")
-
- @ResponseBody
-
- public String uploadFile(@RequestParam("pic")CommonsMultipartFile pic,HttpServletRequest req,HttpServletResponse response) throws IOException{
-
- //設置文件保存的本地路徑
-
- String filePath = req.getsession().getServletContext().getRealPath("/uploadFiles/");
-
- String fileName = pic.getOriginalFilename();
-
- String fileType = fileName.split("[.]")[1];
-
- //為了避免文件名重復,在文件名前加UUID
-
- String uuid = UUID.randomUUID().toString().replace("-","");
-
- String uuidFileName = uuid + fileName;
-
- File f = new File(filePath+"/"+uuid+"."+fileType);
-
- //將文件保存到服務器
-
- FileUtil.upFile(pic.getInputStream(), uuidFileName, filePath);
-
- return uuidFileName;
-
- }
這個過程中要用到FileUtil工具類:
10、效果圖


三、總結
1、多文件的上傳其實是多次調用單文件上傳的方法,我們看到的批量上傳其實是分步執行的,上傳一次調用一次單文件上傳的方法,不要被假象迷惑。
2、上傳成功后可以返回文件的信息,在onUploadSuccess函數中可以獲取到,這樣就可以在頁面上設置一個隱藏域存放返回來的值,比如說文件的id,多文件的話可以在隱藏域中抓取數組。然后隨表單提交,更新表數據,這樣就能方便的把上傳文件的信息添加到數據庫表中。下載地址
3、有的朋友問,上傳的東西在服務器中,項目重啟就會丟失,怎么辦,其實這個在真實項目中會做專門處理,不需要考慮。