[实用小代码java]-如何将对象存储服务器上的文件下载到客户端

本文依据作者实际工作经历,介绍了如何在非主R的项目里添加一个文件下载工具类的过程,希望能对您有所启发。

1 交待一下背景

最近要在团队其他同学主R的一个项目里添加一个页面,该页面会有一个文件下载的功能。

调研后发现:

  • 该项目的后端代码没有类似的工具类

由于该项目不是我负责的小组主R,所以不想实现的太重(例如不想通过引入hutool工具包的方式来搞)

  • 要下载的文件存储于公司自研的对象存储服务器上
  • 可以拿到文件存储的URL,但该URL只可以在内网访问
  • 也可以通过公司自研对象存储服务器提供的SDK获取到存储文件对应的流文件(更安全)

2 前置知识

2.1 下载文件所需的响应头

application/octet-stream

可参考文章:
https://juejin.cn/post/7211401380770349115

2.2 java文件下载所需知识

其实这个很简单,相信很多初学java的都知道,就是将输入流(InputStream)拷贝到输出流(OutputStream)。

3 内部系统可行方案

考虑到文件存储对应的URL只可以在内网访问,所以不会将URL直接塞给客户端,而是后端服务读取URL,将其转为流,再输出到客户端。因此最初的实现方案如下:

java 复制代码
/***
 *
 * @param fileName 文件名
 * @param filePath 文件路径 -- 往往该路径只能在内部系统使用,外网访问会失败
 * @param response
 * @throws IOException
 */
public static void downloadFile(String fileName, String filePath,
        HttpServletResponse response) throws IOException {

    //设置响应头:我不知道这个传输过来的东西是什么,
    //把它存储为一个文件,文件名叫做fileName(如x1.pdf,x2.ppt)
    response.setHeader("Content-Disposition", "attachment;filename="
            + URLEncoder.encode(fileName, "UTF-8"));
    response.setContentType("application/octet-stream");

    ServletOutputStream outputStream = null;
    InputStream inputStream = null;
    try {
        URL url = new URL(filePath);
        inputStream = url.openStream();
        outputStream = response.getOutputStream();

        IOUtils.copy(inputStream, outputStream);
        outputStream.close();
    } catch (IOException ioException) {
        throw new RuntimeException(ioException);
    } finally {
        if (inputStream != null) {
            inputStream.close();
        }
        if (outputStream != null) {
            outputStream.flush();
        }
    }
}

该方案在staging环境运行正常,但将其推到prt环境进行测试时会报403异常authority forbidden提示。

也就是说在prt或prod环境,服务端也无法通过URL来读取到相应的文件。

进一步验证:进入staging环境,去ping相应环境对应URL的域名可以ping通,但是在prt和prod却都无法ping通。

因此,该方案无法应用到线上。

4 通用方案

回看一下第3节对应的方案,其实下面这段代码的目的就是要获取一个输入流

java 复制代码
URL url = new URL(filePath);
inputStream = url.openStream();
outputStream = response.getOutputStream();

而对象存储服务器提供的SDK可以安全地获取到存储文件对应的流文件,因此完全可以用其SDK来获取该流。

于是下载文件的方案就变成了如下更通用的方式:

java 复制代码
/***
 * @param fileName 文件名
 * @param inputStream 文件流通过文件存储服务器对应SDK获取
 * @param response
 * @throws IOException
 */
public void downloadFile2(String fileName, InputStream inputStream,
        HttpServletResponse response) throws IOException {

    //设置响应头:我不知道这个传输过来的东西是什么,
    //把它存储为一个文件,文件名叫做fileName(如x1.pdf,x2.ppt)
    response.setHeader("Content-Disposition", "attachment;filename="
            + URLEncoder.encode(fileName, "UTF-8"));
    response.setContentType("application/octet-stream");

    ServletOutputStream outputStream = null;
    try {
        outputStream = response.getOutputStream();
        IOUtils.copy(inputStream, outputStream);
        outputStream.close();
    } catch (IOException ioException) {
        throw new RuntimeException(ioException);
    } finally {
        if (inputStream != null) {
            inputStream.close();
        }
        if (outputStream != null) {
            outputStream.flush();
        }
    }
}
相关推荐
嶔某2 分钟前
网络:应用层
linux·服务器·网络·c++
丶小鱼丶1 小时前
栈算法之【有效括号】
java·算法
郝学胜-神的一滴2 小时前
SpringBoot实战指南:从快速入门到生产级部署(2025最新版)
java·spring boot·后端·程序人生
鼠鼠我捏,要死了捏4 小时前
Java 虚拟线程在高并发微服务中的实战经验分享
java·microservices·virtualthreads
武子康5 小时前
Java-82 深入浅出 MySQL 内部架构:服务层、存储引擎与文件系统全覆盖
java·开发语言·数据库·学习·mysql·spring·微服务
Rancemy5 小时前
rabbitmq 03
java·分布式·rabbitmq
Dcs7 小时前
“SQL注入即服务”:一个10年历史系统的奇幻演变
java
秃了也弱了。7 小时前
reflections:Java非常好用的反射工具包
java·开发语言
南玖yy8 小时前
Linux 桌面市场份额突破 5%:开源生态的里程碑与未来启示
linux·运维·服务器·汇编·科技·开源·gradle
Amagi.8 小时前
Java设计模式-代理模式
java·代理模式