Java Web实现文件下载和乱码处理方法

 更新时间:2016年10月19日 15:22:08   投稿:mrr  
文件上传和下载是web开发中常遇到的问题。今天小编给大家分享下Java Web实现文件下载和乱码处理方法的相关资料,需要的朋友可以参考下

文件上传和下载是web开发中常遇到的问题,这几天在做一个项目又用到了文件下载,之前也零零散散记了些笔记,今天来做一下整理。文件上传还有待进一步测试,这里先说一下文件下载。

一、文件下载处理流程

文件下载处理流程其实很清晰,即:

1、根据文件名或者文件路径定位文件,具体的策略主要根据自己的需求,总之需要系统能找到的文件全路径。

2、获取输入流,从目标文件获取输入流。

3、获取输出流,从response中获取输出流。

4、从输入流读入文件,通过输出流输出文件。这是真正的下载执行过程。

5、关闭IO流。

主要流程就是这个,另外就是一些必要的属性设置,比如比较重要的有设置文件的contentType类型等。

二、不啰嗦了了,上代码

我是用Springmvc做的,但其实用其他的也一样,主要需要HttpServletResponse对象和有效的目标文件。

1、前台代码

/*
* 下载上传的文件
*/
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);
}

这里的下载逻辑是,前台只需要请求/download,并给出文件名参数即可。为了避免中文乱码,前台的文件名在作为参数时,使用了js的encodeURI()将其变为Unicode码,然后后台解码转换为中文。另外由于项目的特殊性,我这里要下载的文件可能会在upload和download两个文件夹中,所以这里多了一部分判断逻辑。另外,我这里将文件名和请求的文件夹名称都封装在了FileModel中。

3、下载逻辑实现。

这里没有用service了,直接用的静态方法实现。

/**
* 下载文件时指定下载名
* 
* @param request
* HttpServletRequest
* @param response
* HttpServletResponse
* @param filePath
* 文件全路径
* @param fileName
* 指定客户端下载时显示的文件名
* @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();
}
/**
* 下载文件时不指定下载文件名称
* 
* @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());
}

这里提供了重载的下载方法,解决有时需要指定客户端下载的文件名的需求。

三、注意事项

1、关于MIME类型的选择

之前对MIME类型不是很了解,发现网上有很多下载的源码的MIME类型设置的不一样。即这句

response.setContentType("multipart/form-data");

查了下这里设置MIME类型的一个作用是告诉客户端浏览器以什么格式处理要下载的文件。具体的对应网上有很多讲解,这I类设置成这种格式,一般会自动匹配格式。

2、指定客户端下载文件名

有时我们可能需要指定客户端下载文件时的文件名,即这句代码

response.setHeader("Content-disposition", String.format("attachment; filename=\"%s\"", fileName));
中的fileName,可以自定义。前面的部分一般不要动。

3、中文乱码问题的解决

中文文件乱码太常见了,在项目系统架构刚搭建时,就应该统一所有的中文编码,包括编辑器中、页面中以及数据库中,推荐UTF-8编码。如果用的Spring,还可以配置Spring的字符集过滤器,进一步避免中文乱码。

(1)客户端下载请求过程文件名乱码

有时我们会遇到,前台页面显示中文文件名下载列表时正常的,但我们到后台发现请求中的文件名乱码了,这时采用前面所说的encodeURI可以解决。

(2)客户端下载执行时文件名乱码

在实际测试中发现,在其他浏览器都可以执行的情况下,ie下中文文件名可能会出现乱码。在网上看到了这样一段代码,经测试,完美解决了不同浏览器的中文乱码问题

/*
* 解决各浏览器的中文乱码问题
*/
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)服务器上文件乱码

不同的服务器可能因平台的不同编码方式也不同,这里也需要注意。具体的解决方案请参见之前写过的一篇文章:文件下载过程中中文乱码处理

以上所述是小编给大家介绍的Java Web实现文件下载和乱码处理方法,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对脚本之家网站的支持!

相关文章

  • Java数组扩容实现方法解析

    Java数组扩容实现方法解析

    这篇文章主要介绍了Java数组扩容实现方法解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-11-11
  • Swagger注解-@ApiModel和@ApiModelProperty的用法

    Swagger注解-@ApiModel和@ApiModelProperty的用法

    这篇文章主要介绍了Swagger注解-@ApiModel和@ApiModelProperty的用法,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-06-06
  • Java中的@Async异步功能详解

    Java中的@Async异步功能详解

    这篇文章主要介绍了Java中的@Async异步功能详解,@Async注解,可以实现异步处理的功能,它可以有返回值,或者直接在新线程时并行执行一个任务,对于异步来说,它的执行是有条件的,你需要把异步代码块放在单独的类里,需要的朋友可以参考下
    2023-11-11
  • 详解springboot通过Async注解实现异步任务及回调的方法

    详解springboot通过Async注解实现异步任务及回调的方法

    这篇文章主要介绍了springboot通过Async注解实现异步任务及回调,文中通过一个简单示例来直观的理解什么是同步调用,在单元测试用例中,注入 SyncTask 对象,并在测试用例中执行 doTaskOne(),doTaskTwo(),doTaskThree() 三个方法,具体实现方式跟随小编一起看看吧
    2022-05-05
  • Java爬虫爬取漫画示例

    Java爬虫爬取漫画示例

    这篇文章主要介绍了Java爬虫爬取漫画示例,大部分的爬虫入门教学都是爬取图片的,本文就来测试一下爬取网站的漫画,需要的朋友可以参考下
    2023-04-04
  • java实现读取带合并单元格的Excel

    java实现读取带合并单元格的Excel

    这篇文章主要为大家详细介绍了java如何实现读取带合并单元格的Excel,文中的示例代码讲解详细, 感兴趣的小伙伴可以跟随小编一起学习一下
    2023-12-12
  • Java设计模式之GOF23全面讲解

    Java设计模式之GOF23全面讲解

    这篇文章主要介绍了Java设计模式之GOF23全面讲解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
    2021-07-07
  • Java实现动态数据源切换的实践指南

    Java实现动态数据源切换的实践指南

    在 Java 开发中,许多场景需要访问多个数据库,例如多租户系统或读写分离架构,为了灵活高效地管理这些场景,动态数据源切换技术应运而生,所以本文给大家介绍了Java实现动态数据源切换的实践指南,需要的朋友可以参考下
    2025-03-03
  • Java中常见对象映射工具的使用详解

    Java中常见对象映射工具的使用详解

    对象映射是 Java 开发中的重要环节,尤其在处理数据转换时,就需要将一种结构的数据转换为另一种结构的数据(例如 DTO 和 Entity 之间),在这篇博客中,我们将认识并解析几种常用的对象映射工具,并提供详细样例,需要的朋友可以参考下
    2025-03-03
  • jdbc与druid连接池的使用详解

    jdbc与druid连接池的使用详解

    这篇文章主要介绍了jdbc与druid连接池的使用详解,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-03-03

最新评论