Spring MVC，文件下载

本文引用自：《Java EE企业级应用开发教程》

假定你已经阅读：Spring MVC，文件上传，基本环境都已经具备，下载目录暂定与上传目录一致：WebContent\upload

在Spring MVC环境中，实现文件下载大概可分为两个步骤：

一、在客户端页面使用一个文件下载的超链接

该链接的href属性指定后台文件下载的方法以及文件名，比如：

<%@ page language="java" contentType="text/html; charset=UTF-8"
     pageEncoding="UTF-8"%>
<%@page import="java.net.URLEncoder"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
     "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>下载页面</title>
</head>
<body>
    <a href="${pageContext.request.contextPath }/download?filename=1.jpg">
        文件下载 
    </a>
    <br/>
    <a href="${pageContext.request.contextPath }/download?filename=<%=URLEncoder.encode("壁纸.jpg", "UTF-8")%>">
        中文名称文件下载 
    </a>
</body>
</html>

上述文件名为：download.jsp，位于WebContent根目录。

对于使用中文名称的附件，在前端页面使用URLEncoder对中文进行编码，然后在后台控制器类中对文件名进行相应的解码即可。

二、在后台控制类中，使用Spring MVC提供的文件下载方法进行文件下载

Spring MVC提供一个ResponseEntity类型的对象，使用它可以很方便地定义返回的HttpHeaders对象和HttpStatus对象，通过对这两个对象的设置，即可完成下载文件时所需的配置信息。

package com.itheima.controller;
import java.io.File;
import java.net.URLEncoder;

import javax.servlet.http.HttpServletRequest;

import org.apache.commons.io.FileUtils;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
 * 文件下载
 */
@Controller
public class FileDownloadController {
    @RequestMapping("/download")
    public ResponseEntity<byte[]> fileDownload(HttpServletRequest request,
                                               String filename) throws Exception{
        // 指定要下载的文件所在路径
        String path = request.getServletContext().getRealPath("/upload/");
        // 创建该文件对象
        File file = new File(path+File.separator+filename);
        // 对文件名编码，防止中文文件乱码
        filename = this.getFilename(request, filename);
        // 设置响应头
        HttpHeaders headers = new HttpHeaders();
        // 通知浏览器以下载的方式打开文件
        headers.setContentDispositionFormData("attachment", filename);
        // 定义以流的形式下载返回文件数据
        headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
        // 使用Sring MVC框架的ResponseEntity对象封装返回下载数据
       return new ResponseEntity<byte[]>(FileUtils.readFileToByteArray(file),
                                               headers,HttpStatus.OK);
    }
    /**
     * 根据浏览器的不同进行编码设置，返回编码后的文件名
     */
    public String getFilename(HttpServletRequest request,
                                                String filename) throws Exception { 
        // IE不同版本User-Agent中出现的关键词
        String[] IEBrowserKeyWords = {"MSIE", "Trident", "Edge"};  
        // 获取请求头代理信息
        String userAgent = request.getHeader("User-Agent");  
        for (String keyWord : IEBrowserKeyWords) { 
             if (userAgent.contains(keyWord)) { 
                  //IE内核浏览器，统一为UTF-8编码显示
                  return URLEncoder.encode(filename, "UTF-8");
             }
        }  
        //火狐等其它浏览器统一为ISO-8859-1编码显示
        return new String(filename.getBytes("UTF-8"), "ISO-8859-1");  
    }  
}

三、测试，打开页面：http://localhost:8080/ssm/download.jsp

 单击链接，即可以完成附件的下载：

 

posted @ 2021-10-08 10:30  那些年的事儿  阅读(754)  评论(0)  编辑  收藏  举报