前两天给客户的新电脑上部署系统忽然发现一个问题,同样的代码在自己的开发环境(
Tomcat7
)中下载中文名的文件没有任何问题。但是在客户的电脑环境(Tomcat8
)上,却遇到了文件找不到和找到文件后下载包含中文的文件,文件名乱码问题。静下心对比各个可能出问题的环节,猜想问题可能出在web
服务器上,又忽然想起之前看过的一篇关于Tomcat7
和Tomcat8
不同点对比的文章,其中有一个点就是说Tomcat7
的默认编码为ISO8859-1
,Tomcat8
以后则为UTF-8
。这个思路的出现也让上述的所有问题迎刃而解。
上代码
import java.io.File;
import java.io.FileNotFoundException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.commons.io.FileUtils;
import org.apache.commons.lang3.StringUtils;
import org.apache.ibatis.annotations.Param;
import org.apache.log4j.Logger;
import org.springframework.context.annotation.Scope;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import com.ev_image.util.CommonUtil;
@Controller
@RequestMapping("/download")
public class DownloadController {
private static final Logger logger = Logger.getLogger(DownloadController.class);
private static final String javaVersion = "8";
/**
* @Title: downloadCommonFile
* @Description: Tomcat7 的默认编码为 ISO8859-1 , Tomcat8 以后则为 UTF-8
* @param fileName
* @param req
* @param resp
* @return ResponseEntity<byte[]>
* @throws null
*/
@RequestMapping("/commonFile")
@Scope("prototype")
public ResponseEntity<byte[]> downloadCommonFile(@Param("fileName") String fileName, HttpServletRequest req, HttpServletResponse resp) {
try {
if (StringUtils.isNoneBlank(fileName)) {
// 转换文件名称编码格式,否则编码出错后便导致找不到文件
String file = null;
if("7".equals(javaVersion)){
file = new String(fileName.getBytes("ISO-8859-1"), "utf-8");
}else{
file = fileName;
}
// 获取配置在 web.xml 中的文件路径
String filePath = CommonUtil.getReportGeneratorPath();
logger.info("正在下载文件:___________"+filePath+file);
// 设置响应头,确保文件名最终编码格式为 ISO-8859-1
HttpHeaders headers = new HttpHeaders();
// 根据不同 Tomcat 版本设定编码格式,否则会导致下载的文件名中,中文部分乱码
if("7".equals(javaVersion)){
// Tomcat7 默认编码格式为 ISO-8859-1 所以这里不用转码
headers.setContentDispositionFormData("attachment", fileName);
}else{
// Tomcat8 默认编码格式为 UTF-8 所以这里需将文件名转码为 ISO-8859-1 编码
headers.setContentDispositionFormData("attachment", new String(fileName.getBytes("utf-8"), "ISO-8859-1"));
}
// 设置响应内容类型
headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
// 判断文件是否存在
File downloadFile = new File(filePath + file);
if(downloadFile.exists()){
// 返回文件流
return new ResponseEntity<byte[]>(FileUtils.readFileToByteArray(downloadFile), headers, HttpStatus.CREATED);
}else{
// 抛出文件未找到异常
throw new FileNotFoundException();
}
}
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
}