[实用小代码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();
        }
    }
}
相关推荐
异常君9 分钟前
分布式锁隐患解析:当业务执行时间超过锁过期时间的完整对策
java·redis·后端
V功夫兔11 分钟前
Spring_MVC 快速入门指南
java·笔记·spring·springmvc
掘金詹姆斯13 分钟前
在项目中如何进行分库分表?
java·mysql
gzgenius13 分钟前
警惕阿里云中的yum update操作不当导致:/sbin/init被清空导致Linux无法正常启动
linux·服务器·阿里云
旅行的狮子14 分钟前
二、在springboot 中使用 AIService
java·spring boot·langchain4j
扎瓦15 分钟前
Java 动态代理
java·后端·面试
码农小灰21 分钟前
Java 自动装箱与拆箱:基本数据类型与包装类的转换
java
Ares-Wang21 分钟前
kubernetes》》k8s》》Endpoint
java·容器·kubernetes
Run1.36 分钟前
深入解析 Linux 文件系统中的软硬链接:从原理到实践
linux·运维·服务器
学网络的APang37 分钟前
APang网联科技项目报告(服务器域管理篇)
运维·服务器·网络·科技