Java导出文件如何自定义保存文件（设置文件在浏览器打开还是下载）

在用Java编写项目时，常常遇到文件下载或导出excel、word等文档功能。在实现该功能时常常遇到输出路径如何设置的问题。

问题：当固定输出路径后，若客户端没有该路径怎么办？代码如下：

// 以导出一个excel文件为例
HSSFWorkbook workbook = new HSSFWorkbook();
String outputUrl = "E:/example.xls";
//导出（输出）Excel文件(指定导出路径)
try {
    FileOutputStream fileOutputStream = new FileOutputStream(outputUrl);
    workbook.write(fileOutputStream);
    fileOutputStream.flush();
    fileOutputStream.close();
} catch (FileNotFoundException e) {
    e.printStackTrace();
} catch (IOException e) {
    e.printStackTrace();
}

该种情况固定了保存位置，若客户端不知道存储路径或缺少对应的路径，将会影响功能使用。同时该种设置方式交互性比较差。

【解决方式】——导出文件自定义保存位置

如何设置文件响应给客户端时，浏览器会自动弹出弹框告诉用户文件（附件）保存到哪里？以何种方式打开？
弹出保存框——代码如下：

// 以导出一个excel文件为例
HSSFWorkbook workbook = new HSSFWorkbook();
//导出（输出）Excel文件(自定义导出路径)
try {
    // 取得输出流
    OutputStream outputStream = response.getOutputStream();
    response.reset();// 清空输出流
    // 设置输出文件头
    response.setHeader("Content-disposition", "attachment; filename=" + java.net.URLEncoder.encode(fileName, "UTF-8"));
    // 设置输出类型
    response.setContentType("application/vnd.ms-excel");
    // 将数据写入输出流
    workbook.write(outputStream);
    outputStream.close();
} catch (IOException e) {
    e.printStackTrace();
}

Excel在页面内打开——代码如下：

// 以导出一个excel文件为例
HSSFWorkbook workbook = new HSSFWorkbook();
//导出（输出）Excel文件(自定义导出路径)
try {
    // 取得输出流
    OutputStream outputStream = response.getOutputStream();
    response.reset();// 清空输出流
    // 设置输出文件头
    response.setHeader("Content-disposition", "inline; filename=" + java.net.URLEncoder.encode(fileName, "UTF-8"));
    // 设置输出类型
    response.setContentType("application/vnd.ms-excel");
    // 将数据写入输出流
    workbook.write(outputStream);
    outputStream.close();
} catch (IOException e) {
    e.printStackTrace();
}

【注意】该方法不能通过ajax进行请求，否则不会弹出存储框

【讲解】——Content-Disposition
header中Content-Disposition的作用与使用方法
Content-disposition 是 MIME 协议的扩展，MIME 协议指示 MIME 用户代理如何显示附加的文件。
Content-Disposition 响应头指示回复的内容浏览器该以何种形式展示，是 ①以内联的形式（即网页或者页面的一部分），还是 ②以附件的形式下载并保存（弹出文件下载对话框）到本地并且它的文件名框自动填充headers指定的文件名。

• Content-disposition属性有两种类型：
  • inline：将文件内容直接显示在页面
  • attachment：弹出对话框让用户下载具体例子（自定义附件存储位置）

服务器向浏览器发送文件时，如果是浏览器支持的文件类型，一般会默认使用浏览器打开，比如txt、jpg等。如果需要提示用户保存，就要利用Content-Disposition进行处理，关键在于一定要加上attachment

【讲解】——Content-type
MediaType，即Internet Media Type，互联网媒体类型；也叫做MIME类型，在Http协议消息头中，使用Content-Type来表示具体请求中的媒体类型信息。
用于定义网络文件的类型和网页的编码，决定浏览器将以什么形式、什么编码读取这个文件。

文件扩展名与 Content-type 的对应关系，参见 http://tool.oschina.net/commons

---

参考资料：
https://www.jianshu.com/p/d4a85d025768 （下载文件中文乱码）
https://www.jianshu.com/p/01d61e18fbe9 （Content-Type（内容类型）详解）
https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Content-Dispositio （Content-Disposition更多用法）
https://www.cnblogs.com/wq-9/articles/12165056.html