Struts2 文件下载

1. Struts2 文件下载简介

Struts2 提供了 stream 结果类型,该结果类型就是专门支持文件下载功能的。指定 stream 结果类型时,需要指定一个 inputName 参数,该参数指定了一个输入流,这个输入流是被下载文件的入口。通过 Struts2 的文件下载支持,允许系统控制浏览器下载文件的权限,包括实现文件名为非西欧字符的文件下载等。

通常情况下,文件下载只需要在页面上给出一个超链接,该超链接的 href 属性指向需下载文件的文件名(该文件所在服务器上的完整路径),就可以实现简单的文件下载功能。但如果该文件的文件名中包含中文,则会导致下载失败(因为在编码失败的情况下,是无法在服务器端找到该乱码 url 对应的文件的)一种解决方案为修改 Tomcat 服务器的编码方式,但不推荐,建议使用 Struts2 来控制下载;如果应用程序需要在用户下载之前进行进一步的检查,如:用户是否登陆、是否具有下载该文件的权限等,那么就需要让 Struts2 来控制下载。

2. 文件下载 JSP

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>File Download Page</title>
</head>
<body>
    <a href="${pageContext.request.contextPath}/filedownload/FileDownload.action">文件下载</a>
</body>
</html>

3. 文件下载 Action

@Namespace("/filedownload")
public class FileDownload extends ActionSupport {

    private String inputPath; // 文件下载的路径,可通过注解配置,如果硬编码在程序中,此参数省略
    private String fileName; // 下载时显示的文件名,用于处理中文文件名的乱码问题,如果不需要,可省略此参数

    // 省略 getter 和 setter

    @Action(value = "FileDownload", params = { "inputPath", "tempFile/文件下载测试.txt" }, results = {
            @Result(type = "stream", params = { "ContentType", "text/plain", "inputName", "targetFile",
                    "contentDisposition", "attachment;fileName=${fileName}", "bufferSize", "1024*1024" }) })
    @Override
    public String execute() throws Exception {
        return SUCCESS;
    }

    public InputStream getTargetFile() throws Exception {

        // 相关权限控制等操作

        this.fileName = new String(inputPath.split("/")[inputPath.split("/").length - 1].getBytes(), "ISO-8859-1"); // 编码处理,编码方式视系统环境而定
        return ServletActionContext.getServletContext().getResourceAsStream(inputPath);
    }
}

说明:

  • 从上面的 Action 中看到,该 Action 中包含了一个 getTargetFile() 方法,该方法返回一个 InputStream 输入流,这个输入流返回的是下载目标文件的入口。该方法的方法名为 getTargetFile,则 stream 类型的结果映射中 inputName 参数值为 targetFile
  • 配置 stream 类型的结果需要如下 4 个属性:
    • contentType:指定被下载文件的文件类型,常见后缀名对应的 MIME 类型可查看 TOMCAT_HOME\conf\web.xml 文件
    • inputName:指定被下载文件的入口输入流
    • conentDisposition:指定文件下载的处理方式(attachment)和文件名
    • bufferSize:指定下载文件时的缓冲大小
  • stream 结果类型的逻辑视图是返回给客户端一个输入流,因此无须指定 location 属性

解决方案:指定 Tomcat 默认配置文件 server.xml 中的编码方式

<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" URIEncoding="UTF-8"/>
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值