java文件下载功能代码（单文件下载、多文件批量打包下载）——普遍适用

一、前言
  程序员在做web等项目的时候，往往都需要添加文件上传、下载、删除的功能，有时是单文件，有时多文件批量 操作，而这些功能的代码程序员可以自己收藏起来当成工具使用，这样，程序员在进行程序设计的时候就会事半功倍 了，那么接下来的博客将会介绍各个框架的文件上传和下载功能的使用方法。
  这篇博客的重点放在各个框架都能适用的文件下载功能代码，话不多说，直接切入主题：

二、实例

  1.一般需要加入的jar包：
   commons.fileupload-1.2.1.jar和commons.io-1.4.0.jar，点击下载jar包

   2.方法实例：

    /**
     * -普通java文件下载方法，适用于所有框架 
     * -注意：
     *     1.  response.setContentType设置下载内容类型，常用下载类型：
     *         application/octet-stream（二进制流，未知文件类型）；
     *         application/vnd.ms-excel（excel）；
     *         text/plain（纯文本）； text/xml（xml）；text/html（html）；image/gif（GIF）；image/jpeg（JPG）等
     *         如果不写，则匹配所有；
     *     2.  response.setHeader("Content-Disposition","attachment; filename="+fileName +".zip"); 设置下载文件名；
     *         文件名可能会出现乱码，解决名称乱码：fileName  = new String(fileName.getBytes(), "iso8859-1");
     */ 
	public String downloadFilesTest(HttpServletRequest request,HttpServletResponse res) throws IOException {
	    try{
			//获取文件根目录，不同框架获取的方式不一样，可自由切换  
		    String basePath = request.getSession().getServletContext().getRealPath("/upload/fileDir");  
	
		    //获取文件名称（包括文件格式）  
		    String fileName = "1.jpg";  
	
		    //组合成完整的文件路径  
		    String targetPath = basePath+File.separator+fileName;  
	
		    //模拟多一个文件，用于测试多文件批量下载  
		    String targetPath1 = basePath+File.separator+"2.jpg";  
		    //模拟文件路径下再添加个文件夹，验证穷举
		    String targetPath2 = basePath+File.separator+"test";
		    
		    System.out.println("文件名："+fileName);  
		    System.out.println("文件路径："+targetPath);  
	
		    //方法1：IO流实现下载的功能  
		    res.setCharacterEncoding("UTF-8"); //设置编码字符
		    res.setContentType("application/octet-stream;charset=UTF-8"); //设置下载内容类型
		    res.setHeader("Content-disposition", "attachment;filename="+fileName);//设置下载的文件名称  
		    OutputStream out = res.getOutputStream();   //创建页面返回方式为输出流，会自动弹出下载框   
	
	
	/*	  //方法1-1：IO字节流下载，用于小文件  
		    System.out.println("字节流下载");  
		    InputStream is = new FileInputStream(targetPath);  //创建文件输入流  
		    byte[] Buffer = new byte[2048];  //设置每次读取数据大小，即缓存大小  
		    int size = 0;  //用于计算缓存数据是否已经读取完毕，如果数据已经读取完了，则会返回-1  
		    while((size=is.read(Buffer)) != -1){  //循环读取数据，如果数据读取完毕则返回-1  
		        out.write(Buffer, 0, size); //将每次读取到的数据写入客户端  
		    }
		    is.close();
		    */  
	    

	/*	  //方法1-2：IO字符流下载，用于大文件  
		    System.out.println("字符流");  
		    File file = new File(targetPath);  //创建文件  
		    FileInputStream fis=new FileInputStream(file);  //创建文件字节输入流  
		    BufferedInputStream bis=new BufferedInputStream(fis); //创建文件缓冲输入流  
		    byte[] buffer = new byte[bis.available()];//从输入流中读取不受阻塞
			bis.read(buffer);//读取数据文件
			bis.close();
			out.write(buffer);//输出数据文件
			out.flush();//释放缓存
			out.close();//关闭输出流
	*/   
	
	/*	  //方法1-3：将附件中多个文件进行压缩，批量打包下载文件  
		    //创建压缩文件需要的空的zip包  
		    String zipBasePath=request.getSession().getServletContext().getRealPath("/upload/zip");  
		    String zipName = "temp.zip";
		    String zipFilePath = zipBasePath+File.separator+zipName;  
	
		    //创建需要下载的文件路径的集合
		    List<String> filePaths = new ArrayList<String>();  
		    filePaths.add(targetPath);  
		    filePaths.add(targetPath1); 
		    filePaths.add(targetPath2);
		    
		    //压缩文件
		    File zip = new File(zipFilePath);  
		    if (!zip.exists()){     
		        zip.createNewFile();     
		    }
		    //创建zip文件输出流  
		    ZipOutputStream zos = new ZipOutputStream(new FileOutputStream(zip));
		    this.zipFile(zipBasePath,zipName, zipFilePath,filePaths,zos);
		    zos.close();
		    res.setHeader("Content-disposition", "attachment;filename="+zipName);//设置下载的压缩文件名称
	
		    //将打包后的文件写到客户端，输出的方法同上，使用缓冲流输出  
		    BufferedInputStream bis = new BufferedInputStream(new FileInputStream(zipFilePath));  
		    byte[] buff = new byte[bis.available()];  
		    bis.read(buff);
		    bis.close();
			out.write(buff);//输出数据文件
			out.flush();//释放缓存
			out.close();//关闭输出流
	*/
	    }catch(Exception e) {
			e.printStackTrace();
			res.reset();
			res.setCharacterEncoding("UTF-8");
			res.setContentType("text/html;charset=UTF-8"); 
			res.getWriter().print("<div align=\"center\" style=\"font-size: 30px;font-family: serif;color: red;\">系统内部错误，下载未成功，请联系管理员！</div>"
					+ "<div>错误信息："+e.getMessage()+"</div>");
			res.getWriter().flush();
			res.getWriter().close();
		}
		return null;
	}
	
	/**
	 * 压缩文件
	 * @param zipBasePath 临时压缩文件基础路径
	 * @param zipName 临时压缩文件名称
	 * @param zipFilePath 临时压缩文件完整路径
	 * @param filePaths 需要压缩的文件路径集合
	 * @throws IOException
	 */
	private String zipFile(String zipBasePath, String zipName, String zipFilePath, List<String> filePaths,ZipOutputStream zos) throws IOException {

	    //循环读取文件路径集合，获取每一个文件的路径  
	    for(String filePath : filePaths){  
	        File inputFile = new File(filePath);  //根据文件路径创建文件  
	        if(inputFile.exists()) { //判断文件是否存在  
                if (inputFile.isFile()) {  //判断是否属于文件，还是文件夹  
                    //创建输入流读取文件  
                    BufferedInputStream bis = new BufferedInputStream(new FileInputStream(inputFile));  

                    //将文件写入zip内，即将文件进行打包  
                    zos.putNextEntry(new ZipEntry(inputFile.getName()));  

                    //写入文件的方法，同上                  
                    int size = 0;  
                    byte[] buffer = new byte[1024];  //设置读取数据缓存大小
                    while ((size = bis.read(buffer)) > 0) {  
                    	zos.write(buffer, 0, size);  
                    }  
                    //关闭输入输出流  
                    zos.closeEntry();  
                    bis.close(); 
                    
                } else {  //如果是文件夹，则使用穷举的方法获取文件，写入zip  
                    try {  
                        File[] files = inputFile.listFiles();  
                        List<String> filePathsTem = new ArrayList<String>();  
                        for (File fileTem:files) {  
                        	filePathsTem.add(fileTem.toString());
                        }  
                        return zipFile(zipBasePath, zipName, zipFilePath, filePathsTem,zos);
                    } catch (Exception e) {  
                        e.printStackTrace();  
                    }  
                }  
            }  
	    }  
	    return null;
	} 

三、总结

  1. 该方法结合了字节流、字符流进行单文件和多文件打包下载，方法1-1、方法1-2和方法1-3分别属于不同形式的下载方法，都是在方法1的基础之上进行的操作，三种方法不可同时使用，需要使用哪种类型的方法则去掉注释即可；

  2、实践是检验认识真理性的唯一标准，根据代码和注释多进行尝试，则很快就会明白其中的原理