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 web验证码实现代码分享