[实用小代码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();
        }
    }
}
相关推荐
码农老起1 小时前
与Aspose.pdf类似的jar库分享
java·pdf·jar
程序猿小D1 小时前
第三百八十九节 JavaFX教程 - JavaFX WebEngine
java·eclipse·intellij-idea·vr·javafx
self-discipline6343 小时前
【Java】Java核心知识点与相应面试技巧(七)——类与对象(二)
java·开发语言·面试
wei3872452323 小时前
java笔记02
java·开发语言·笔记
zjj5873 小时前
Docker使用ubuntu
java·docker·eureka
士别三日&&当刮目相看3 小时前
JAVA学习*简单的代理模式
java·学习·代理模式
我是唐青枫4 小时前
Linux ar 命令使用详解
linux·运维·服务器
余华余华4 小时前
计算机等级考试数据库三级(笔记3)
服务器·数据库·oracle
今夜有雨.4 小时前
HTTP---基础知识
服务器·网络·后端·网络协议·学习·tcp/ip·http
ShareBeHappy_Qin4 小时前
设计模式——设计模式理念
java·设计模式