背景
最近做了一些附件上传下载的功能,附件都是上传第三方平台,例如青云。该章记录一下附件下载。
目的
有一些浏览器在打开第三方附件下载地址的时候,会直接打开文件,看到的都是二进制乱码,而不是弹出下载框,例如火狐浏览器,该实现方式是为了兼容这种情况。
流程
第一步:前端把第三方下载地址传递给服务端,或者服务端自己从业务数据库直接获取。
第二步:前端把附件的名称传递给服务端,或者服务端自己从业务数据库直接获取,或自动生成。
第三步:通过http请求的方式获取附件的二进制流。
第四步:通过HttpServletResponse输出,浏览器会自动匹配,直接弹出下载框。
实现
备注:文章结尾有源码下载地址,下载之后,可直接用eclipse导入maven项目运行。
一)DownloadController对外接口类代码
package com.oysept.attachment.controller;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.URLDecoder;
import javax.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Controller;
import org.springframework.util.StringUtils;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import com.oysept.attachment.utils.DownloadUtils;
import com.oysept.attachment.utils.HttpUtils;
/**
* 附件下载controller
* @author ouyangjun
* 由于下载时返回一个流给前端,所以不能使用@RestController注解
*/
@Controller
@RequestMapping(value = "/attachment")
public class DownloadController {
/**
* 首页测试接口
* 地址: http://localhost:8080/attachment/download/home
* @return
*/
@RequestMapping(value = "/download/home", method = RequestMethod.GET, produces = "application/json;charset=UTF-8")
@ResponseBody
public String home(){
return "oysept attachment download home!";
}
/**
* 通过第三方下载地址,获取流返回给前端
* 原因: 有一些浏览器,直接输入第三方下载地址,会直接打开文件,不会直接下载,需要手动在浏览器配置之后才ok
* 注意: fileUrl和fileName需要urlencode
*/
@RequestMapping(value = "/download/urlDownload", method = RequestMethod.GET, produces = "application/json;charset=UTF-8")
public void urlDownload(@RequestParam(value="fileUrl") String fileUrl,
@RequestParam(value="fileName") String fileName, HttpServletResponse response) {
if (StringUtils.isEmpty(fileUrl) || StringUtils.isEmpty(fileName)) {
System.out.println("fileUrl or fileName is null!");
return;
}
try {
// 获取文件类型
String fileType = fileName.substring(fileName.lastIndexOf(".")+1,fileName.length())
.toLowerCase();
// 解码
String decodeFileUrl = URLDecoder.decode(fileUrl, "UTF-8");
System.out.println("decodeFileUrl: " + decod