struts2实现文件下载功能

下面我为你详细讲解“struts2实现文件下载功能”的完整攻略。

1. 确定文件路径和文件名

在进行文件下载功能的实现之前，我们需要先确定文件的路径和文件名。一般而言，可以将文件路径和文件名存储在数据库或配置文件中。在本次实例中，我们将文件保存在了项目根目录下的uploads目录中，因此文件路径和文件名可以如下方式进行定义：

String filePath = servletContext.getRealPath("/uploads/"); // 文件的存储路径
String fileName = "test.txt"; // 文件的名称（包含扩展名）

2. 编写Action

在确定文件的路径和文件名之后，我们需要编写一个Action来实现文件的下载功能。具体操作如下：

// 定义一个名为FileDownloadAction的Action类
public class FileDownloadAction extends ActionSupport {
    // 获取ServletContext对象
    ServletContext servletContext = ServletActionContext.getServletContext();
    // 定义一个名为filePath的String类型的变量，并赋值为文件的存储路径
    String filePath = servletContext.getRealPath("/uploads/");
    // 定义一个名为fileName的String类型的变量，并赋值为文件的名称（包含扩展名）
    String fileName = "test.txt";

    // 实现文件下载功能的方法
    public InputStream getDownloadFile() throws FileNotFoundException {
        // 构造一个文件输入流对象
        FileInputStream inputStream = new FileInputStream(new File(filePath + fileName));

        return inputStream;
    }
}

在上述代码中，我们通过调用ServletActionContext类中的getServletContext()方法获取到ServletContext对象，并通过getRealPath()方法获取到文件的存储路径。然后在getDownloadFile()方法中，我们构造了一个文件输入流对象并返回该对象，以实现文件的下载功能。

需要注意的是，getDownloadFile()方法应当是一个公有的、返回类型为InputStream的方法。

3. 在struts.xml中配置Action

下一步我们需要在struts.xml文件中配置Action，具体操作如下：

<!-- 配置Action -->
<action name="fileDownloadAction" class="com.example.action.FileDownloadAction" method="getDownloadFile">
    <!-- 配置返回类型 -->
    <result name="success" type="stream">
        <!-- 配置文件的类型 -->
        <param name="contentType">application/octet-stream</param>
        <!-- 配置文件的长度 -->
        <param name="contentLength">${contentLength}</param>
        <!-- 配置文件的名称 -->
        <param name="contentDisposition">attachment;filename="${fileName}"</param>
        <!-- 配置文件的流对象 -->
        <param name="inputStream">${inputStream}</param>
    </result>
</action>

在上述代码中，我们配置了一个名为fileDownloadAction的Action，该Action的类为com.example.action.FileDownloadAction，方法为getDownloadFile。同时，我们还配置了返回类型为stream，用于实现文件的下载功能。同时，我们配置了contentType、contentLength、contentDisposition和inputStream等参数，以确定文件的类型、长度、名称和下载流。

4. 在JSP页面中添加下载链接

最后一步我们需要在JSP页面中添加下载链接，具体操作如下：

<a href="<s:url action='fileDownloadAction'/>" target="_blank">下载文件</a>

在上述代码中，我们通过s:url标签生成了一个链接，然后通过a标签将该链接展示在了页面上。在用户点击“下载文件”链接时，系统将自动调用名为fileDownloadAction的Action实现文件的下载功能，最终将文件下载到用户端。

示例1：下载文本文件

假设我们现在要下载的文件是一个文本文件，我们可以按照上述步骤进行操作，然后访问JSP页面，点击链接即可进行文件下载。具体操作可参照下述代码：

// 定义一个名为FileDownloadAction的Action类
public class FileDownloadAction extends ActionSupport {
    // 获取ServletContext对象
    ServletContext servletContext = ServletActionContext.getServletContext();
    // 定义一个名为filePath的String类型的变量，并赋值为文件的存储路径
    String filePath = servletContext.getRealPath("/uploads/");
    // 定义一个名为fileName的String类型的变量，并赋值为文件的名称（包含扩展名）
    String fileName = "test.txt";

    // 实现文件下载功能的方法
    public InputStream getDownloadFile() throws FileNotFoundException {
        // 构造一个文件输入流对象
        FileInputStream inputStream = new FileInputStream(new File(filePath + fileName));

        return inputStream;
    }
}

示例2：下载图片文件

如果我们需要下载的是一张图片文件，我们需要在struts.xml文件中添加配置项，用于确定文件的类型。具体操作可参照下述代码：

<!-- 配置Action -->
<action name="fileDownloadAction" class="com.example.action.FileDownloadAction" method="getDownloadFile">
    <!-- 配置返回类型 -->
    <result name="success" type="stream">
        <!-- 配置文件的类型 -->
        <param name="contentType">image/jpeg</param>
        <!-- 配置文件的长度 -->
        <param name="contentLength">${contentLength}</param>
        <!-- 配置文件的名称 -->
        <param name="contentDisposition">attachment;filename="${fileName}"</param>
        <!-- 配置文件的流对象 -->
        <param name="inputStream">${inputStream}</param>
    </result>
</action>

其中，contentType的值为image/jpeg，表示文件的类型为JPEG图片。

然后，我们可以按照上述步骤进行操作，访问JSP页面，点击链接即可进行文件下载。