`
mywhy
  • 浏览: 66494 次
  • 性别: Icon_minigender_1
  • 来自: 西安
社区版块
存档分类
最新评论

struts2 文件下载方式 此法解决下载中文文件问题。不错

阅读更多
最近用到了struts2的文件下载,找了些网上关于下载的文章,摘录如下:
原文:http://www.blogjava.net/beansoft/archive/2008/03/03/183468.html

在BlogJava上已经有一位作者阐述了文件上传的问题,地址是在Struts 2中实现文件上传,因此我就不再讨论那个话题了。我今天简单介绍一下Struts 2的文件下载问题。

我们的项目名为 struts2hello,所使用的开发环境是MyEclipse 6,当然其实用哪个IDE都是一样的,只要把类库放进去就行了,文件下载不需要再加入任何额外的包。读者可以参考文档:http://beansoft.java-cn.org/myeclipse_doc_cn/struts2_demo.pdf,来了解怎么下载和配置基本的Struts 2开发环境。

为了便于大家对比,我把完整的struts.xml的配置信息列出来:

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>
    <package name="default" extends="struts-default" >
        <!-- 在这里添加Action定义 -->

        <!-- 简单文件下载 -->
        <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 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>
                <!-- 使用经过转码的文件名作为下载文件名,downloadFileName属性
                对应action类中的方法 getDownloadFileName() -->
                <param name="contentDisposition">attachment;filename="${downloadFileName}"</param>
                <param name="bufferSize">4096</param>
            </result>
        </action>
       
        <!-- 下载现有文件 -->
        <action name="download3" class="example.FileDownloadAction3">
            <param name="inputPath">/download/系统说明.doc</param>
            <!-- 初始文件名 -->
            <param name="fileName">系统说明.doc</param>
            <result name="success" type="stream">
                <param name="contentType">application/octet-stream;charset=ISO8859-1</param>
                <param name="inputName">inputStream</param>
                <!-- 使用经过转码的文件名作为下载文件名,downloadFileName属性
                对应action类中的方法 getDownloadFileName() -->
                <param name="contentDisposition">attachment;filename="${downloadFileName}"</param>
                <param name="bufferSize">4096</param>
            </result>
        </action>
       
    </package>

</struts>


Struts 2中对文件下载做了直接的支持,相比起自己辛辛苦苦的设置种种HTTP头来说,现在实现文件下载无疑要简便的多。说起文件下载,最直接的方式恐怕是直接写一个超链接,让地址等于被下载的文件,例如:<a href=”file1.zip”>下载file1.zip</a>,之后用户在浏览器里面点击这个链接,就可以进行下载了。但是它有一些缺陷,例如如果地址是一个图片,那么浏览器会直接打开它,而不是显示保存文件的对话框。再比如如果文件名是中文的,它会显示一堆URL编码过的文件名例如%3457...。而假设你企图这样下载文件:http://localhost:8080/struts2hello/download/系统说明.doc,Tomcat会告诉你一个文件找不到的404错误:HTTP Status 404 - /struts2hello/download/ϵͳ˵Ã÷.doc。虽然目前还没发现直接配置Struts 2来正确的下载中文名字的附件,不过好在作者对JSP中的文件下载比较了解,因此我们另有办法解决这个问题。另外一个最大的用途,就是动态的生成并下载文件了,例如动态的下载生成的EXCEL,PDF,验证码图片等等。本节内容就依次讨论简单的下载文件代码,下载中文附件,最后介绍如何下载已经存在的文件。

先说文件下载,编写一个普通的Action就可以了,只需要提供一个返回InputStream流的方法,该输入流代表了被下载文件的入口,这个方法用来给被下载的数据提供输入流,意思是从这个流读出来,再写到浏览器那边供下载。这个方法需要由开发人员自己来编写,只需要返回值为InputStream即可。在我们的例子中方法的签名是:public InputStream getInputStream() throws Exception,当然它也可以是别的名字,例如getDownloadFile()。好了,现在我们所写的这个进行文件下载的Action类example.FileDownloadAction 的源代码清单如下:

package example;

import java.io.ByteArrayInputStream;

import java.io.InputStream;

import com.opensymphony.xwork2.Action;

public class FileDownloadAction implements Action {

public InputStream getInputStream() throws Exception {

return new ByteArrayInputStream("Struts 2 下载示例".getBytes());

}

public String execute() throws Exception {

return SUCCESS;

}

}

。注意这里唯一特殊的方法就是getInputStream(),在这个方法里面我们使用了一个数组输入流来从字符串转换成的数组作为数据的来源进行读取。也许方法体中使用这样的实现代码:

return new java.io.FileInputStream(“c:\\test.txt”);//从系统磁盘文件读取数据

这样会更直观一些。

文件下载的第二步,乃是在struts.xml中对action进行配置,其代码清单如下所示:

<!-- 简单文件下载 -->

<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特殊的地方在于result的类型是一个流(stream),配置stream类型的结果时,因为无需指定实际的显示的物理资源,所以无需指定location属性,只需要指定inputName属性,该属性指向被下载文件的来源,对应着Action类中的某个属性,类型为InputStream。下面则列出了和下载有关的一些参数列表:

参数

说明

contentType

内容类型,和互联网MIME标准中的规定类型一致,例如text/plain代表纯文本,text/xml表示XML,image/gif代表GIF图片,image/jpeg代表JPG图片

inputName

下载文件的来源流,对应着action类中某个类型为Inputstream的属性名,例如取值为inputStream的属性需要编写getInputStream()方法

contentDisposition

文件下载的处理方式,包括内联(inline)和附件(attachment)两种方式,而附件方式会弹出文件保存对话框,否则浏览器会尝试直接显示文件。取值为:

attachment;filename="struts2.txt",表示文件下载的时候保存的名字应为struts2.txt。如果直接写filename="struts2.txt",那么默认情况是代表inline,浏览器会尝试自动打开它,等价于这样的写法:inline; filename="struts2.txt"

bufferSize

下载缓冲区的大小

。在这里面,contentType属性和contentDisposition分别对应着HTTP响应中的头Content-Type和Content-disposition头。好,我们先来看看这个例子,发布运行项目后键入测试地址:http://localhost:8080/struts2hello/download.action,将会看到浏览器弹出一个文件保存对话框,如图12.12所示。





图12.12 文件下载对话框(IE 7和Firefox 3)

如果此时使用某些工具来探测浏览器返回的HTTP头,将会看到下列内容:

HTTP/1.1 200 OK

Server: Apache-Coyote/1.1

Content-disposition: attachment;filename="struts2.txt"

Content-Type: text/plain

Transfer-Encoding: chunked

Date: Sun, 02 Mar 2008 02:58:25 GMT

。所以用来下载的action配置中,只有两个是和浏览器有关的:contentType和contentDisposition。关于contentType的取值,如果是未知的文件类型,或者说出现了浏览器不能打开的文件,例如.bean文件,或者说这个action是用来做动态文件下载的,事先并不知道未来的文件类型是什么,那么我们可以把它的值设置成为:application/octet-stream;charset=ISO8859-1 ,注意一定要加入charset,否则某些时候会导致下载的文件出错;有人说这时也可以设置成为application/x-download,根据笔者的实践,这个头也能正常工作,然而个别时候会出现浏览器无法识别的问题。而contentDisposition,如果其取值是filename="struts2.txt",或者是inline; filename="struts2.txt",运行后你可以看到浏览器直接显示了文件的内容:

Struts 2 下载示例,而不再弹出对话框提示用户保存文件到硬盘上。所以读者如果想确保文件是被下载而不是被打开,务必使用格式attachment;filename="struts2.txt",不要丢了attachment;这个类型信息。

至此,关于文件下载的技术内容,已经告一段落。然而做中文系统,不可避免的要解决中文附件的下载问题。关于这个内容,也无权威的资料可查,我们只能用实践中得到的解决方案来处理。也许有读者以为将filename属性设置为filename=”struts2中文.txt”就能解决问题了,好,就来试试,把contentDisposition修改成:

<param name="contentDisposition">attachment;filename="struts2中文.txt"</param>

。再次键入地址进行测试,看看显示的结果,如图12.13所示。唉,真是完全不给面子!IE压根就不能显示出来文件名,草草敷衍了download_action了事。Firefox稍好点,还出来了一个对话框,但是很显然,那个显示的struts2--txt绝对不是我们日思夜想的struts2中文.txt。怎么办?解决方法是有,那就是用ISO8859-1编码来显示这个中文字符,可以阅读12.8参考资料一节中的JSP 文件下载的相对完整代码(解决中文问题和Weblogic报错)这篇文章,可以这样认为,所有的文件下载代码都是基于同样的纯Servlet的方式来进行的。如果是Java代码,我们可以这样做:





图12.13 IE和Firefox下的中文文件下载对话框

String downFileName = new String(“struts2中文.txt”.getBytes(), "ISO8859-1");

然后把生成的结果字符串放到XML文件中就行了,然而它的输出类似于struts2??.txt,是无法直接写道我们的XML配置文件中的。所以,我们想到的的办法,就是在Action类中写一个方法来做转码,使它成为某个属性,所以要以get开头。然后,再用12.3.8 给Action注入参数(param)值一节的内容,将文件名以正常的方式设置为action类的某个属性,最后呢,再利用一个小小的param参数取值中的伎俩:${属性名},它可以直接从action类中动态获取某个属性值。好了,现在让我们来看看第二个文件下载类FileDownloadAction2的代码:

package example;

import java.io.ByteArrayInputStream;

import java.io.InputStream;

import java.io.UnsupportedEncodingException;

import com.opensymphony.xwork2.Action;

public class FileDownloadAction2 implements Action {

private String fileName;// 初始的通过param指定的文件名属性

public InputStream getInputStream() throws Exception {

return new ByteArrayInputStream("Struts 2 下载示例".getBytes());

}

public String execute() throws Exception {

return SUCCESS;

}

public void setFileName(String fileName) {

this.fileName = fileName;

}

/** 提供转换编码后的供下载用的文件名 */

public String getDownloadFileName() {

String downFileName = fileName;

try {

downFileName = new String(downFileName.getBytes(), "ISO8859-1");

} catch (UnsupportedEncodingException e) {

e.printStackTrace();

}

return downFileName;

}

}

。这个类有两个属性,第一个是fileName,它是需要被指定的下载文件名;第二个则是动态的仅仅由getDownloadFileName()这个方法定义的属性downloadFileName,它的值随着fileName而动态变动,仅仅是把它转换成了ISO8859方式的西欧字符集。

接下来就是如何配置这个action了,这是关键的地方所在,现在配置一个新的action,名为download2,其源代码如下:

<!-- 文件下载,支持中文附件名 -->

<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>

<!-- 使用经过转码的文件名作为下载文件名,downloadFileName属性

对应action类中的方法 getDownloadFileName() -->

<param name="contentDisposition">attachment;filename="${downloadFileName}"</param>

<param name="bufferSize">4096</param>

</result>

</action>

。其中特殊的代码就是${downloadFileName},它的效果相当于运行的时候将action对象的属性的取值动态的填充在${}中间的部分,我们可以认为它等价于+action. getDownloadFileName()。

好了,现在让我们重新发布然后运行这个项目,键入地址:

http://localhost:8080/struts2hello/download2.action 进行访问,可以看到运行结果完全正确,如图12.14所示。





图 12.14 正确显示了文件下载名的对话框(IE和Firefox)

在本节的最后部分,我们来讨论一下如何下载已经存在于当前Web应用目录下的已经存在的文件。一般的网站可能会把要下载的文件放在某个固定的目录下,例如WebRoot/download,在这个子目录下,我们放了一个名为系统说明.doc的文件,希望最后我们的action能够正确的下载这个文件。要检验下载是否成功非常简单,文件内容仅仅是粗体的系统说明书这五个字,而word文件坏一个字节的话都是打不开的,所以下载后再用word打开即可检验是否成功。现在我们创建第三个文件下载的Action类,名为example. FileDownloadAction3,其源代码清单如下所示:

package example;

import java.io.InputStream;

import java.io.UnsupportedEncodingException;

import org.apache.struts2.ServletActionContext;

import com.opensymphony.xwork2.Action;

public class FileDownloadAction3 implements Action {

private String fileName;// 初始的通过param指定的文件名属性

private String inputPath;// 指定要被下载的文件路径


public InputStream getInputStream() throws Exception {

// 通过 ServletContext,也就是application 来读取数据

return ServletActionContext.getServletContext().getResourceAsStream(inputPath);

}

public String execute() throws Exception {

return SUCCESS;

}

public void setInputPath(String value) {

inputPath = value;

}

public void setFileName(String fileName) {

this.fileName = fileName;

}

/** 提供转换编码后的供下载用的文件名 */

public String getDownloadFileName() {

String downFileName = fileName;

try {

downFileName = new String(downFileName.getBytes(), "ISO8859-1");

} catch (UnsupportedEncodingException e) {

e.printStackTrace();

}

return downFileName;

}

}

。代码中被改动的部分已经用粗斜体的方式显示出来了。首先是新加入了一个名为inputPath的属性,用来制定被下载文件的路径。接着就是ServletActionContext.getServletContext()这段代码,它的意义我们将在12.6节详细讨论,在这里读者只需要知道它获取了当前Servlet容器的ServletContext,也就是大家常说的jsp中的application对象,然后用它来打开文件的输入流。

接着要做的就是配置action,它和刚刚配置过的download2的内容差不多,只是多了一个被下载的资源的路径属性。现在我们在struts.xml中加入这个新的action定义:

<!-- 下载现有文件 -->

<action name="download3" class="example.FileDownloadAction3">

<param name="inputPath">/download/系统说明.doc</param>

<!-- 初始文件名 -->

<param name="fileName">系统说明.doc</param>

<result name="success" type="stream">

<param name="contentType">application/octet-stream;charset=ISO8859-1</param>

<param name="inputName">inputStream</param>

<!-- 使用经过转码的文件名作为下载文件名,downloadFileName属性

对应action类中的方法 getDownloadFileName() -->

<param name="contentDisposition">attachment;filename="${downloadFileName}"</param>

<param name="bufferSize">4096</param>

</result>

</action>

。查看粗斜体的部分,首先就是自定了被下载文件的路径,inputPath,接着就是修改了contentType为二进制方式。最后重新发布项目并运行,键入地址进行访问:http://localhost:8080/struts2hello/download3.action 。很好,可以看到文件下载对话框,保存系统说明.doc后再用word打开它,内容正确。

注意:而这种文件下载方式却是存在安全隐患的,因为访问者如果精通Struts 2的话,它可能使用这样的带有表单参数的地址来访问:http://localhost:8080/struts2hello/download3.action?inputPath=/WEB-INF/web.xml,这样的结果就是下载后的文件内容是您系统里面的web.xml的文件的源代码,甚至还可以用这种方式来下载任何其它JSP文件的源码。这对系统安全是个很大的威胁。作为一种变通的方法,读者最好是从数据库中进行路径配置,然后把Action类中的设置inputPath的方法统统去掉,简言之就是删除这个方法定义:

public void setInputPath(String value) {

inputPath = value;

}

。而实际情况则应该成为 download3.action?fileid=1 类似于这样的形式来进行。或者呢,读者可以在execute()方法中进行路径检查,如果发现有访问不属于download下面文件的代码,就一律拒绝,不给他们返回文件内容。例如,我们可以把刚才类中的execute()方法加以改进,成为这样:

public String execute() throws Exception {

// 文件下载目录路径

String downloadDir = ServletActionContext.getServletContext().getRealPath("/download");

// 文件下载路径

String downloadFile = ServletActionContext.getServletContext().getRealPath(inputPath);

java.io.File file = new java.io.File(downloadFile);

downloadFile = file.getCanonicalPath();// 真实文件路径,去掉里面的..等信息

// 发现企图下载不在 /download 下的文件, 就显示空内容

if(!downloadFile.startsWith(downloadDir)) {

return null;

}

return SUCCESS;

}

。这时候如果访问者再企图下载web.xml的内容,它只能得到一个空白页,现在访问者只能下载位于/download目录下的文件。
原文来源:http://hi.baidu.com/darkbreaker/blog/item/0a41e21f391dc4c4a7866997.html
分享到:
评论

相关推荐

    struts2命名规范

    Action名与Struts2配置文件中的Action配置相关,比如在struts.xml中,你会看到类似这样的配置: ```xml &lt;result name="success"&gt;/pages/user/saveSuccess.jsp ``` 在这个例子中,`saveUser`是Action名,它将...

    Struts2漏洞检查工具2018版.zip

    解决这个问题的方法通常是升级到修复此漏洞的Struts2最新版本,或者修改应用程序的配置来限制OGNL表达式的使用。 S2-057,又名"Struts2 REST插件远程代码执行漏洞",是REST插件的一个漏洞,允许攻击者通过发送精心...

    Struts2的配置文件方法小结

    在Struts2中,配置文件起着至关重要的作用,它定义了应用的行为和组件之间的交互。下面我们将深入探讨Struts2配置文件中的关键元素,特别是`result`节点,以及各种结果类型和通配符映射。 首先,Struts2的核心功能...

    MyI18N-struts国际化实例

    Struts是Java Web开发中的一款经典MVC框架,它的国际化(i18n)功能使得开发者可以轻松地为应用程序提供多语言支持。本实例“MyI18N-struts国际化实例”将指导我们如何在Struts项目中实现国际化。下面我们将深入探讨...

    企业Java EE软件开发规范

    - `struts.xml`、`struts1.xml`、`struts2.xml`:Struts配置文件。 - `validators.xml`:Struts验证配置文件。 - `template`:模板文件。 - `WebRoot`:Web目录。 - `common`:公共文件。 - `css`:CSS文件。 ...

    面试编程题

    【编程面试题详解】 在Java面试中,常常会遇到一些基础到中等难度的编程题目,这些题目旨在考察应聘者的编程功底、逻辑思维以及对...在面试中,能够熟练解答这些题目,将有助于展现候选人的技术水平和解决问题的能力。

    简单的ssh框架(以登录为例)

    1. **环境配置**:首先,需要在项目中引入Struts2、Spring和Hibernate的依赖库,并配置相应的XML配置文件,如struts.xml、spring-context.xml和hibernate.cfg.xml。 2. **模型定义**:创建User实体类,包含用户名和...

    基于SSH的自动排课管理系统源码.zip

    【标题】"基于SSH的自动排课管理系统源码"是一个典型的Java Web开发项目,它利用Struts、Spring和Hibernate这三大框架(SSH)构建。SSH是Java领域中广泛使用的MVC(模型-视图-控制器)架构模式的实现,旨在简化企业...

    jsp导出身份证到excel时候格式不对但以X结尾的却可以

    上述代码中的`&lt;s:property value="id_card"/&gt;`是根据Struts2框架中的Action对象的id_card属性值来获取身份证号码,然后通过添加单引号的方式,确保在Excel中以文本形式显示。 然而,许多开发者可能仍然觉得在数据前...

    基于项目的Java Web的教学研究.zip

    在“基于项目的Java Web的教学研究”这一主题中,我们探讨的是如何通过实践项目来教授...通过这样的教学方式,不仅能够提升学生的编程技能,还能培养他们的团队协作能力和问题解决能力,为未来的职业生涯打下坚实基础。

    J2EE编程规范TXT版

    - **dao.hbm**:Hibernate映射文件存放于此。 - **global**:全局配置类存放于此。 - **util**:工具类存放于此。 #### 3. 编码风格 - 变量和方法命名应使用小驼峰命名法。 - 类和接口命名应使用大驼峰命名法。 - ...

    计算机软件资格考试高级-系统架构设计师真题整理.rar

    此压缩包文件"计算机软件资格考试高级-系统架构设计师真题整理.rar"包含了历年的考试真题和答案解析,是备考者进行考前复习的重要参考资料。通过深入研究这些真题,考生可以了解考试的题型、难度以及重点考察的知识...

    java和数据库编码规范

    - **配置文件**:Struts、Spring、国际化等配置文件的命名将在后续的目录结构划分中详细说明。 #### 结语 遵循上述编码规范,不仅有助于构建高质量的软件产品,还能促进团队间的协作与交流,提升开发效率。通过...

    最新Java-培训大纲.pdf

    此大纲由魔乐科技软件学院(MLDN)制定,该学院坐落在中关村科技园区,由各大型软件公司的技术骨干组成,专注在Linux、Oracle数据库、Java EE技术和Android开发等领域培养中高级软件人才。 **培养目标** 培训的目标...

    网上办公自动化毕业设计论文.doc

    9. 文件管理模块:用户可以上传、下载和查看文件,方便共享资料和协作。 系统开发技术上,选用了Dreamweaver作为页面制作工具,结合Photoshop等图形设计软件,创建出美观且用户友好的界面。JSP动态页面设计技术与...

    整理后java开发全套达内学习笔记(含练习)

    //此语句会抛异常,需处理 System.out.println("您输入了文字:" + next); }catch(Exception e){} }} 数值保存方式: 正数= 二进制 负数= 补码 补码= 反码 +1 正数=负数的补码(反码+1) 反码= 非(二...

    基于J2EE框架的个人博客系统项目毕业设计论文(源码和论文)

    随着博客人数的增加, Blog 作为一种新的生活方式、新的工作方式、新的学习方式已经被越来越多的人所接受,并且在改变传统的网络和社会结构:网络信息不再是虚假不可验证的,交流和沟通更有明确的选择和方向性,单一...

Global site tag (gtag.js) - Google Analytics