Java Web實(shí)現(xiàn)文件下載和亂碼處理方法
文件上傳和下載是web開發(fā)中常遇到的問題,這幾天在做一個(gè)項(xiàng)目又用到了文件下載,之前也零零散散記了些筆記,今天來做一下整理。文件上傳還有待進(jìn)一步測(cè)試,這里先說一下文件下載。
一、文件下載處理流程
文件下載處理流程其實(shí)很清晰,即:
1、根據(jù)文件名或者文件路徑定位文件,具體的策略主要根據(jù)自己的需求,總之需要系統(tǒng)能找到的文件全路徑。
2、獲取輸入流,從目標(biāo)文件獲取輸入流。
3、獲取輸出流,從response中獲取輸出流。
4、從輸入流讀入文件,通過輸出流輸出文件。這是真正的下載執(zhí)行過程。
5、關(guān)閉IO流。
主要流程就是這個(gè),另外就是一些必要的屬性設(shè)置,比如比較重要的有設(shè)置文件的contentType類型等。
二、不啰嗦了了,上代碼
我是用Springmvc做的,但其實(shí)用其他的也一樣,主要需要HttpServletResponse對(duì)象和有效的目標(biāo)文件。
1、前臺(tái)代碼
/*
* 下載上傳的文件
*/
function downloadFromUpload(fileName){
window.location.href = path + "/download?dir=upload&fileName="+encodeURI(encodeURI(fileName));
}
/*
* 普通下載
*/
function download(fileName){
window.location.href = path + "/download?dir=download&fileName="+encodeURI(encodeURI(fileName));
}
2、controller代碼
/**
* 文件下載(從上傳路徑下載)
*
* @param request
* @param response
* @throws IOException
*/
@ResponseBody
@RequestMapping(value = "/download")
public void downloadFile(HttpServletRequest request,
HttpServletResponse response, FileModel model) throws Exception {
String fileName = URLDecoder.decode(model.getFileName(), "UTF-8");
/*
* 限制只有upload和download文件夾里的文件可以下載
*/
String folderName = "download";
if (!StringUtils.isEmpty(model.getDir())
&& model.getDir().equals("upload")) {
folderName = "upload";
} else {
folderName = "download";
}
String fileAbsolutePath = request.getSession().getServletContext()
.getRealPath("/")
+ "/WEB-INF/" + folderName + "/" + fileName;
FileTools.downloadFile(request, response, fileAbsolutePath);
log.warn("用戶Id:"
+ (Integer) (request.getSession().getAttribute("userId"))
+ ",用戶名:"
+ (String) (request.getSession().getAttribute("username"))
+ ",下載了文件:" + fileAbsolutePath);
}
這里的下載邏輯是,前臺(tái)只需要請(qǐng)求/download,并給出文件名參數(shù)即可。為了避免中文亂碼,前臺(tái)的文件名在作為參數(shù)時(shí),使用了js的encodeURI()將其變?yōu)閁nicode碼,然后后臺(tái)解碼轉(zhuǎn)換為中文。另外由于項(xiàng)目的特殊性,我這里要下載的文件可能會(huì)在upload和download兩個(gè)文件夾中,所以這里多了一部分判斷邏輯。另外,我這里將文件名和請(qǐng)求的文件夾名稱都封裝在了FileModel中。
3、下載邏輯實(shí)現(xiàn)。
這里沒有用service了,直接用的靜態(tài)方法實(shí)現(xiàn)。
/**
* 下載文件時(shí)指定下載名
*
* @param request
* HttpServletRequest
* @param response
* HttpServletResponse
* @param filePath
* 文件全路徑
* @param fileName
* 指定客戶端下載時(shí)顯示的文件名
* @throws IOException
*/
public static void downloadFile(HttpServletRequest request,
HttpServletResponse response, String filePath, String fileName)
throws IOException {
BufferedInputStream bis = null;
BufferedOutputStream bos = null;
bis = new BufferedInputStream(new FileInputStream(filePath));
bos = new BufferedOutputStream(response.getOutputStream());
long fileLength = new File(filePath).length();
response.setCharacterEncoding("UTF-8");
response.setContentType("multipart/form-data");
/*
* 解決各瀏覽器的中文亂碼問題
*/
String userAgent = request.getHeader("User-Agent");
byte[] bytes = userAgent.contains("MSIE") ? fileName.getBytes()
: fileName.getBytes("UTF-8"); // fileName.getBytes("UTF-8")處理safari的亂碼問題
fileName = new String(bytes, "ISO-8859-1"); // 各瀏覽器基本都支持ISO編碼
response.setHeader("Content-disposition",
String.format("attachment; filename=\"%s\"", fileName));
response.setHeader("Content-Length", String.valueOf(fileLength));
byte[] buff = new byte[2048];
int bytesRead;
while (-1 != (bytesRead = bis.read(buff, 0, buff.length))) {
bos.write(buff, 0, bytesRead);
}
bis.close();
bos.close();
}
/**
* 下載文件時(shí)不指定下載文件名稱
*
* @param request
* HttpServletRequest
* @param response
* HttpServletResponse
* @param filePath
* 文件全路徑
* @throws IOException
*/
public static void downloadFile(HttpServletRequest request,
HttpServletResponse response, String filePath) throws IOException {
File file = new File(filePath);
downloadFile(request, response, filePath, file.getName());
}
這里提供了重載的下載方法,解決有時(shí)需要指定客戶端下載的文件名的需求。
三、注意事項(xiàng)
1、關(guān)于MIME類型的選擇
之前對(duì)MIME類型不是很了解,發(fā)現(xiàn)網(wǎng)上有很多下載的源碼的MIME類型設(shè)置的不一樣。即這句
response.setContentType("multipart/form-data");
查了下這里設(shè)置MIME類型的一個(gè)作用是告訴客戶端瀏覽器以什么格式處理要下載的文件。具體的對(duì)應(yīng)網(wǎng)上有很多講解,這I類設(shè)置成這種格式,一般會(huì)自動(dòng)匹配格式。
2、指定客戶端下載文件名
有時(shí)我們可能需要指定客戶端下載文件時(shí)的文件名,即這句代碼
response.setHeader("Content-disposition", String.format("attachment; filename=\"%s\"", fileName));
中的fileName,可以自定義。前面的部分一般不要?jiǎng)印?/p>
3、中文亂碼問題的解決
中文文件亂碼太常見了,在項(xiàng)目系統(tǒng)架構(gòu)剛搭建時(shí),就應(yīng)該統(tǒng)一所有的中文編碼,包括編輯器中、頁(yè)面中以及數(shù)據(jù)庫(kù)中,推薦UTF-8編碼。如果用的Spring,還可以配置Spring的字符集過濾器,進(jìn)一步避免中文亂碼。
(1)客戶端下載請(qǐng)求過程文件名亂碼
有時(shí)我們會(huì)遇到,前臺(tái)頁(yè)面顯示中文文件名下載列表時(shí)正常的,但我們到后臺(tái)發(fā)現(xiàn)請(qǐng)求中的文件名亂碼了,這時(shí)采用前面所說的encodeURI可以解決。
(2)客戶端下載執(zhí)行時(shí)文件名亂碼
在實(shí)際測(cè)試中發(fā)現(xiàn),在其他瀏覽器都可以執(zhí)行的情況下,ie下中文文件名可能會(huì)出現(xiàn)亂碼。在網(wǎng)上看到了這樣一段代碼,經(jīng)測(cè)試,完美解決了不同瀏覽器的中文亂碼問題
/*
* 解決各瀏覽器的中文亂碼問題
*/
String userAgent = request.getHeader("User-Agent");
byte[] bytes = userAgent.contains("MSIE") ? fileName.getBytes()
: fileName.getBytes("UTF-8"); // fileName.getBytes("UTF-8")處理safari的亂碼問題
fileName = new String(bytes, "ISO-8859-1"); // 各瀏覽器基本都支持ISO編碼
response.setHeader("Content-disposition",
String.format("attachment; filename=\"%s\"", fileName));
(3)服務(wù)器上文件亂碼
不同的服務(wù)器可能因平臺(tái)的不同編碼方式也不同,這里也需要注意。具體的解決方案請(qǐng)參見之前寫過的一篇文章:文件下載過程中中文亂碼處理
以上所述是小編給大家介紹的Java Web實(shí)現(xiàn)文件下載和亂碼處理方法,希望對(duì)大家有所幫助,如果大家有任何疑問請(qǐng)給我留言,小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)腳本之家網(wǎng)站的支持!
相關(guān)文章
Java數(shù)組擴(kuò)容實(shí)現(xiàn)方法解析
這篇文章主要介紹了Java數(shù)組擴(kuò)容實(shí)現(xiàn)方法解析,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2019-11-11
Swagger注解-@ApiModel和@ApiModelProperty的用法
這篇文章主要介紹了Swagger注解-@ApiModel和@ApiModelProperty的用法,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2022-06-06
詳解springboot通過Async注解實(shí)現(xiàn)異步任務(wù)及回調(diào)的方法
這篇文章主要介紹了springboot通過Async注解實(shí)現(xiàn)異步任務(wù)及回調(diào),文中通過一個(gè)簡(jiǎn)單示例來直觀的理解什么是同步調(diào)用,在單元測(cè)試用例中,注入?SyncTask?對(duì)象,并在測(cè)試用例中執(zhí)行?doTaskOne(),doTaskTwo(),doTaskThree()?三個(gè)方法,具體實(shí)現(xiàn)方式跟隨小編一起看看吧2022-05-05
java實(shí)現(xiàn)讀取帶合并單元格的Excel
這篇文章主要為大家詳細(xì)介紹了java如何實(shí)現(xiàn)讀取帶合并單元格的Excel,文中的示例代碼講解詳細(xì), 感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2023-12-12
Java實(shí)現(xiàn)動(dòng)態(tài)數(shù)據(jù)源切換的實(shí)踐指南
在 Java 開發(fā)中,許多場(chǎng)景需要訪問多個(gè)數(shù)據(jù)庫(kù),例如多租戶系統(tǒng)或讀寫分離架構(gòu),為了靈活高效地管理這些場(chǎng)景,動(dòng)態(tài)數(shù)據(jù)源切換技術(shù)應(yīng)運(yùn)而生,所以本文給大家介紹了Java實(shí)現(xiàn)動(dòng)態(tài)數(shù)據(jù)源切換的實(shí)踐指南,需要的朋友可以參考下2025-03-03

