Struts2是一个流行的Java web应用程序框架，用于构建MVC（模型-视图-控制器）架构的应用。在Struts2中，文件下载是一个常见的需求，尤其是处理用户请求获取服务器上存储的文件，例如文档、图片或者视频。在处理中文文件名时，可能会遇到编码问题，导致文件名显示为乱码。本篇文章将详细介绍如何在Struts2中实现文件下载，并解决中文文件名的编码问题。
我们需要在`struts.xml`配置文件中定义一个Action，这个Action将会处理文件下载的请求。例如，我们可以创建一个名为`FileDownloadAction`的类，该类需要继承自Struts2的Action支持类，并实现相应的文件读取和流处理方法。在配置文件中，我们为这个Action指定一个结果类型为`stream`的结果，这样Struts2会知道我们需要通过流来发送文件内容。
以下是一个简单的`struts.xml`配置示例：
```xml
<package name="default" extends="struts-default">
<action name="download" class="example.FileDownloadAction">
<result name="success" type="stream">
<param name="contentType">text/plain</param>
<param name="inputName">inputStream</param>
<param name="contentDisposition">attachment;filename="struts2中文 .txt"</param>
<param name="bufferSize">4096</param>
</result>
</action>
<!-- 更多Action配置... -->
</package>
```
在这个例子中，`contentDisposition`参数用于设置HTTP响应头的`Content-Disposition`字段，告诉浏览器如何处理文件，`attachment`表示作为附件下载，`filename`参数指定文件名。然而，对于包含中文字符的文件名，直接使用会导致乱码问题。为了解决这个问题，我们需要对文件名进行编码转换。
在Struts2中，可以通过`FileDownloadAction2`类和对应的配置来处理中文文件名。类中需要有一个`getDownloadFileName()`方法，该方法用于返回经过编码转换后的文件名。配置文件如下：
```xml
<action name="download2" class="example.FileDownloadAction2">
<param name="fileName">Struts中文附件 .txt</param>
<result name="success" type="stream">
<param name="contentType">text/plain</param>
<param name="inputName">inputStream</param>
<param name="contentDisposition">attachment;filename="${downloadFileName}"</param>
<param name="bufferSize">4096</param>
</result>
</action>
```
在`contentDisposition`中使用`${downloadFileName}`引用Action中的方法，Struts2会自动调用这个方法获取编码后的文件名。
在`FileDownloadAction2`类中，`getDownloadFileName()`方法需要将中文文件名转换为符合HTTP协议的编码格式，通常是采用`URLEncoder.encode(fileName, "UTF-8")`来编码。这样，浏览器接收到的文件名将是正确编码的，用户可以正常下载并识别文件。
另外，当下载的文件位于服务器的某个路径下时，可以使用`FileDownloadAction3`类，通过`inputPath`参数指定文件的路径，同时需要确保文件名经过编码处理。
总结来说，Struts2中实现文件下载的关键在于正确配置`struts.xml`，使用`stream`类型的结果，并处理好`Content-Disposition`中的文件名编码。对于中文文件名，需要在Action中提供编码转换的方法，并在配置文件中引用。通过这种方式，我们可以在Struts2应用中实现安全、高效的文件下载功能，同时解决了中文文件名的显示问题。
