Struts 2 实现文件下载功能

用struts 2 实现文件下载功能，主要是3个部分代码的编写：

1. Web前端传入文件名参数；

2. 编写寻找文件并返回InputStream的Action；

3. 在struts.xml中进行配置。

 本文将给出一个对上述二、三部分代码编写的一个例子。

 

Action：

代码

package  a.b.c;

import  java.io.InputStream;
import  java.io.FileInputStream;
import  org.apache.struts2.ServletActionContext;
import  com.opensymphony.xwork2.ActionSupport;

public   class  DownloadAction  extends  ActionSupport {

     private   static   final   long  serialVersionUID  =   1656950476675155655L ;
     private  String md5;
     private  String filename;
     private  String directory;

    @Override
     public  String execute()  throws  Exception {
         // 这里进行参数验证，保证请求的下载文件合法性
         //  本例对传入参数md5进行验证并将其值赋予filename
         if  (md5.matches( " [\\w&&[^_]]{32}? " )) {
            filename  =  md5.toLowerCase();
             return  SUCCESS;
        }
         return  INPUT;
    }

     public  InputStream getInputStream()  throws  Exception {
        String dir  =  directory  +  filename  +   " .txt " ;
         return   new  FileInputStream(dir);     // 如果dir是绝对路径
//         return ServletActionContext.getServletContext().getResourceAsStream(dir);     // 如果dir是Resource下的相对路径
    }

     /**
     *  @return  the md5
      */
     public  String getMd5() {
         return  md5;
    }

     /**
     *  @param  md5
     *            the md5 to set
      */
     public   void  setMd5(String md5) {
         this .md5  =  md5;
    }

     /**
     *  @return  the filename
      */
     public  String getFilename() {
         return  filename;
    }

     /**
     *  @param  filename
     *            the filename to set
      */
     public   void  setFilename(String filename) {
         this .filename  =   this .getMd5();
    }

     /**
     *  @param  directory
     *            the directory to set
      */
     public   void  setDirectory(String directory) {
         this .directory  =  directory;
    }

}

 

 

Action中没有给出directory的get方法，其目的为保护文件路径不被访问到。

execute()方法对传入参数进行验证，若验证成功，返回success，否则返回input。

getInputStream()方法将返回一个InputStream，在struts.xml中，配置了一个参数inputStream，通过这个方法获得流对象。

 

struts.xml：

 代码

< action  name ="download"  class ="a.b.c.DownloadAction"   >
     < param  name ="directory" > D:/download/ </ param >
     < result  name ="success"  type ="stream" >
         <!--  指定下载文件的内容类型，text/plain是默认类型  -->
         < param  name ="contentType" > text/plain </ param >
         <!--  inputName默认值是inputStream，如果action中用于读取下载文件内容的属性名是inputStream，那么可以省略这个参数  -->
         < param  name ="inputName" > inputStream </ param >
         <!-- 动态获取文件名，从Action中的取得filename -->
         < param  name ="contentDisposition" >
            attachment;filename="${filename}"
         </ param >
         < param  name ="bufferSize" > 2048 </ param >
     </ result >
     < result  name ="input" > /WEB-INF/pages/inputError.jsp </ result >
</ action >

 

 参考API SteamResult（http://struts.apache.org/2.0.14/struts2-core/apidocs/org/apache/struts2/dispatcher/StreamResult.html），其中

contentType是内容类型，根据不同文件类型参照MIME标准设置，本例是文本。

contentDisposition是文件下载的处理方式，包括内联(inline)和附件(attachment)，默认是inline, 使用附件时这样配置：attachment;filename="文件名" 。

 

若Action中验证失败，转到inputError页面。