網上看了很多關於文件上傳的帖子,眾口不一,感覺有點亂,最近正好公司的項目里用到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 的解析器
- <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、在頁面中需要上傳附件的位置插入
- <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中,實現上傳
- //接收上傳文件
- @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工具類:
- package com.baidu.util;
- import java.io.BufferedInputStream;
- import java.io.BufferedOutputStream;
- import java.io.File;
- import java.io.FileInputStream;
- import java.io.FileOutputStream;
- import java.io.IOException;
- import java.io.InputStream;
- import java.io.OutputStream;
- import java.util.List;
- import java.util.zip.ZipEntry;
- import java.util.zip.ZipOutputStream;
- import javax.servlet.http.HttpServletRequest;
- import javax.servlet.http.HttpServletResponse;
- public class FileUtil {
- /**
- * 單個文件上傳
- * @param is
- * @param fileName
- * @param filePath
- */
- public static void upFile(InputStream is,String fileName,String filePath){
- FileOutputStream fos = null;
- BufferedOutputStream bos = null;
- BufferedInputStream bis = null;
- File file = new File(filePath);
- if(!file.exists()){
- file.mkdirs();
- }
- File f = new File(filePath+"/"+fileName);
- try {
- bis = new BufferedInputStream(is);
- fos = new FileOutputStream(f);
- bos = new BufferedOutputStream(fos);
- byte[] bt = new byte[4096];
- int len;
- while((len = bis.read(bt))>0){
- bos.write(bt, 0, len);
- }
- } catch (Exception e) {
- e.printStackTrace();
- }finally {
- try {
- if(null != bos){
- bos.close();
- bos = null;}
- if(null != fos){
- fos.close();
- fos= null;
- }
- if(null != is){
- is.close();
- is=null;
- }
- if (null != bis) {
- bis.close();
- bis = null;
- }
- } catch (Exception e) {
- e.printStackTrace();
- }
- }
- }
- }
10、效果圖
三、總結
1、多文件的上傳其實是多次調用單文件上傳的方法,我們看到的批量上傳其實是分步執行的,上傳一次調用一次單文件上傳的方法,不要被假象迷惑。
2、上傳成功后可以返回文件的信息,在onUploadSuccess函數中可以獲取到,這樣就可以在頁面上設置一個隱藏域存放返回來的值,比如說文件的id,多文件的話可以在隱藏域中抓取數組。然后隨表單提交,更新表數據,這樣就能方便的把上傳文件的信息添加到數據庫表中。下載地址
3、有的朋友問,上傳的東西在服務器中,項目重啟就會丟失,怎么辦,其實這個在真實項目中會做專門處理,不需要考慮。