簡介
upload4j是一款輕量級http文件上傳框架，使用簡單，實現高效，功能專一，擺脫傳統http文件上傳框架的繁瑣。
upload4j的誕生並不是為了解決所有上傳需求，而是專注於基礎通用需求。
upload4j帶來的
· 實現直接文件流上傳、html表單流上傳兩種上傳模式。
· io操作部分采用nio機制。
· 支持文件過濾，並且基於二進制文件頭進行過濾，而非傳統的文件擴展名過濾。
· 上傳文件大小不受內存大小限制。
upload4j給不了的
· 文件上傳進度。
· 批量上傳。
upload4j使用示例
直接文件流上傳
啟用過濾功能
1 // 過濾器 2 MetaFilter metaFilter = new MetaFilter(); 3 metaFilter.add(".jpg", "FFD8FF"); // 允許的文件類型，params: 文件后綴名, 文件頭十六進制字符串 4 Map<String, String> metaMap = new HashMap<String, String>(); 5 metaMap.put(".png", "89504E47"); 6 metaFilter.fromMap(metaMap); // 批量添加允許的文件類型 7 8 // 配置 9 MetaFilterConfig metaFilterConfig = MetaFilterConfig.custom().setBufferSize(8192) // 默認8192B，單位B 10 .setMaxFileSize(1024 * 1024) // 限制文件最大1M，單位B 11 .setFilter(metaFilter) // 過濾器 12 .setRequest(request) // 從request對象的body中讀取文件流 13 .setFileNameWithoutSuffix("123") // 保存文件名(不帶擴展名，自動識別) 14 .setSavePath("/home/user1/upload/img/2015/09/24/"); // 保存路徑 15 16 // 上傳 17 StreamUpload streamUpload = new StreamUpload(); 18 SimpleUploadResponse response = streamUpload.upload(metaFilterConfig); 19 20 // 上傳結果 21 if(response.isSuccess()){ // 成功 22 // 獲取文件保存完整路徑 23 response.getFilePath(); 24 // ...... 25 }else{ // 失敗 26 // 判斷失敗是否可控 27 if(response.getException() == null){ // 可控 28 // 獲取失敗原因 29 response.getErrmsg(); 30 // ...... 31 }else{ // 不可控 32 // 直接拋出異常 33 throw response.getException(); 34 } 35 }
不啟用過濾功能
1 // 配置 2 StreamConfig streamConfig = StreamConfig.custom().setBufferSize(8192) // 默認8192B，單位B 3 .setMaxFileSize(1024 * 1024) // 限制文件最大1M，單位B 4 .setRequest(request) // 從request對象的body中讀取文件流 5 .setFileNameWithSuffix("123.jpg") // 保存完整文件名(帶擴展名) 6 .setSavePath("/home/user1/upload/img/2015/09/24/"); // 保存路徑 7 8 // 上傳 9 StreamUpload streamUpload = new StreamUpload(); 10 SimpleUploadResponse response = streamUpload.upload(streamConfig); 11 12 // 上傳結果 13 if(response.isSuccess()){ // 成功 14 // 獲取文件保存完整路徑 15 response.getFilePath(); 16 // ...... 17 }else{ // 失敗 18 // 判斷失敗是否可控 19 if(response.getException() == null){ // 可控 20 // 獲取失敗原因 21 response.getErrmsg(); 22 // ...... 23 }else{ // 不可控 24 // 直接拋出異常 25 throw response.getException(); 26 } 27 }
html表單流上傳
啟用過濾功能
1 // 過濾器 2 MetaFilter metaFilter = new MetaFilter(); 3 metaFilter.add(".jpg", "FFD8FF"); // 允許的文件類型，params: 文件后綴名, 文件頭十六進制字符串 4 Map<String, String> metaMap = new HashMap<String, String>(); 5 metaMap.put(".png", "89504E47"); 6 metaFilter.fromMap(metaMap); // 批量添加允許的文件類型 7 8 // 配置 9 MetaFilterConfig metaFilterConfig = MetaFilterConfig.custom().setBufferSize(8192) // 默認8192B，單位B 10 .setMaxFileSize(1024 * 1024) // 限制文件最大1M，單位B 11 .setFilter(metaFilter) // 過濾器 12 .setRequest(request) // 從request對象的body中讀取文件流 13 .setFileNameWithoutSuffix("123") // 保存文件名(不帶擴展名，自動識別) 14 .setSavePath("/home/user1/upload/img/2015/09/24/"); // 保存路徑 15 16 // 上傳 17 FormUpload formUpload = new FormUpload(); 18 SimpleUploadResponse response = formUpload.upload(metaFilterConfig); 19 20 // 上傳結果 21 if(response.isSuccess()){ // 成功 22 // 獲取文件保存完整路徑 23 response.getFilePath(); 24 // ...... 25 }else{ // 失敗 26 // 判斷失敗是否可控 27 if(response.getException() == null){ // 可控 28 // 獲取失敗原因 29 response.getErrmsg(); 30 // ...... 31 }else{ // 不可控 32 // 直接拋出異常 33 throw response.getException(); 34 } 35 }
不啟用過濾功能
1 // 配置 2 FormConfig formConfig = FormConfig.custom().setBufferSize(8192) // 默認8192B，單位B 3 .setMaxFileSize(1024 * 1024) // 限制文件最大1M，單位B 4 .setRequest(request) // 從request對象的body中讀取文件流 5 .setFileNameWithoutSuffix("123") // 保存文件名(不帶擴展名，自動提取) 6 .setSavePath("/home/user1/upload/img/2015/09/24/"); // 保存路徑 7 8 // 上傳 9 FormUpload formUpload = new FormUpload(); 10 SimpleUploadResponse response = formUpload.upload(formConfig); 11 12 // 上傳結果 13 if(response.isSuccess()){ // 成功 14 // 獲取文件保存完整路徑 15 response.getFilePath(); 16 // ...... 17 }else{ // 失敗 18 // 判斷失敗是否可控 19 if(response.getException() == null){ // 可控 20 // 獲取失敗原因 21 response.getErrmsg(); 22 // ...... 23 }else{ // 不可控 24 // 直接拋出異常 25 throw response.getException(); 26 } 27 }