[实用小代码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();
        }
    }
}
相关推荐
callJJ21 分钟前
从 0 开始理解 Spring 的核心思想 —— IoC 和 DI(2)
java·开发语言·后端·spring·ioc·di
wangjialelele23 分钟前
Linux中的线程
java·linux·jvm·c++
谷咕咕26 分钟前
windows下python3,LLaMA-Factory部署以及微调大模型,ollama运行对话,开放api,java,springboot项目调用
java·windows·语言模型·llama
没有bug.的程序员1 小时前
MVCC(多版本并发控制):InnoDB 高并发的核心技术
java·大数据·数据库·mysql·mvcc
在下村刘湘1 小时前
maven pom文件中<dependencyManagement><dependencies><dependency> 三者的区别
java·maven
不务专业的程序员--阿飞2 小时前
JVM无法分配内存
java·jvm·spring boot
李昊哲小课2 小时前
Maven 完整教程
java·maven
tritone2 小时前
我在阿贝云免费服务器上搭建RustDesk自建服务器(Self-Hosting)的真实体验【推荐】
运维·服务器
Lin_Aries_04213 小时前
容器化简单的 Java 应用程序
java·linux·运维·开发语言·docker·容器·rpc
脑花儿3 小时前
ABAP SMW0下载Excel模板并填充&&剪切板方式粘贴
java·前端·数据库