struts2文件上传

来源:互联网 发布:萧然问政网络平台 编辑:程序博客网 时间:2024/06/04 01:35
1.    文件上传的原理:表单元素的enctype属性指定的是表单数据的编码方式,该属性有3个值:1)      application/x-www-form-urlencoded:这是默认编码方式,它只处理表单域里的value属性值,采用这种编码方式的表单会将表单域的值处理成URL编码方式。2)      multipart/form-data:这种编码方式的表单会以二进制流的方式来处理表单数据,这种编码方式会把文件域指定文件的内容也封装到请求参数里。3)      text/plain:这种方式主要适用于直接通过表单发送邮件的方式。文件上传是web应用经常用到的一个知识。原理是,通过为表单元素设置enctype=”multipart/form-data”属性,让表 单提交的数据以二进制编码的方式提交,在接收此请求的Servlet中用二进制流来获取内容,就可以取得上传文件的内容,从而实现文件的上传。在Java领域中,有两个常用的文件上传项目:一个是Apache组织Jakarta的Common-FileUpload组件 (http://commons.apache.org/fileupload/),另一个是Oreilly组织的COS框架(http: //www.servlets.com/cos/)。利用这两个框架都能很方便的实现文件的上传。2.    Struts2的文件上传:Struts2并未提供自己的请求解析器,也就是就Struts2不会自己去处理multipart/form-data的请求,它需要调用其 他请求解析器,将HTTP请求中的表单域解析出来。但Struts2在原有的上传解析器基础上做了进一步封装,更进一步简化了文件上传。Struts2默认使用的是Jakarta的Common-FileUpload框架来上传文件,因此,要在web应用中增加两个Jar文 件:commons-fileupload-1.2.jar和commons-io-1.3.1.jar。它在原上传框架上做了进一步封装,简化了文件上 传的代码实现,取消了不同上传框架上的编程差异。如果要改成其它的文件上传框架,可以修改struts.multipart.parser常量的值为cos/pell,默认值是jakata。并在classpath中增加相应上传组件的类库。2.1.    步骤一:创建带上传表单域的页面<%@ page language="java" contentType="text/html; charset=UTF-8"%><html><head>    <title>Struts2 File Upload</title></head><body>    <form action="fileUpload.action" method="POST" enctype="multipart/form-data">        文件标题:<input type="text" name="title" size="50"/><br/>        选择文件:<input type="file" name="upload" size="50"/><br/>       <input type="submit" value=" 上传 "/>          </form></body></html>此页面特殊之处只是把表单的enctype属性设置为multipart/form-data。2.2.    步骤二:创建处理上传请求的Action类package org.qiujy.web.struts2; import java.io.BufferedInputStream;import java.io.BufferedOutputStream;import java.io.File;import java.io.FileInputStream;import java.io.FileOutputStream;import java.io.InputStream;import java.io.OutputStream; import org.apache.struts2.ServletActionContext; import com.opensymphony.xwork2.ActionSupport; /** *处理文件上传的Action类 *@authorqiujy *@version1.0 */publicclass FileUploadAction extends ActionSupport {    privatestaticfinalintBUFFER_SIZE = 16 * 1024;    // 文件标题    private String title;    // 上传文件域对象    private File upload;    // 上传文件名    private String uploadFileName;    // 上传文件类型    private String uploadContentType;    // 保存文件的目录路径(通过依赖注入)    private String savePath;     //以下省略getter和setter......     //自己封装的一个把源文件对象复制成目标文件对象    privatestaticvoid copy(File src, File dst) {        InputStream in = null;        OutputStream out = null;        try {            in = new BufferedInputStream(new FileInputStream(src), BUFFER_SIZE);            out = new BufferedOutputStream(new FileOutputStream(dst),                    BUFFER_SIZE);            byte[] buffer = newbyte[BUFFER_SIZE];            int len = 0;            while ((len = in.read(buffer)) > 0) {                out.write(buffer, 0, len);            }        } catch (Exception e) {            e.printStackTrace();        } finally {            if (null != in) {                try {                    in.close();                } catch (IOException e) {                    e.printStackTrace();                }            }            if (null != out) {                try {                    out.close();                } catch (IOException e) {                    e.printStackTrace();                }            }        }    }     @Override    public String execute() throws Exception {        //根据服务器的文件保存地址和原文件名创建目录文件全路径        String dstPath = ServletActionContext.getServletContext()                                .getRealPath(this.getSavePath())                                + "//" + this.getUploadFileName();              System.out.println("上传的文件的类型:"+ this.getUploadContentType());              File dstFile = new File(dstPath);         copy(this.upload, dstFile);         returnSUCCESS;    }}上面这个Action类中,提供了title和upload两个属性来分别对应页面的两个表单域属性,用来封装表单域的请求参数。但是,值得注意的是,此Action中还有两个属性:uploadFileName和uploadContentType,这两个属性分别用于 封装上传文件的文件名、文件类型。这是Struts2设计的独到之处:Strut2的Action类直接通过File类型属性直接封装了上传文件的文件内 容,但这个File属性无法获取上传文件的文件名和文件类型,所以Struts2就直接将文件域中包含的上传文件名和文件类型的信息封装到 uploadFileName和uploadContentType属性中,也就是说Struts2针对表单中名为xxx的文件域,在对应的Action类中使用3个属性来封装该文件域信息:l 类型为File的xxx属性:用来封装页面文件域对应的文件内容。l 类型为String的xxxFileName属性:用来封装该文件域对应的文件的文件名。l 类型为String的xxxContentType属性:用来封装该文件域应用的文件的文件类型。另外,在这个Action类中还有一个savePath属性,它的值是通过配置文件来动态设置的,这也是Strut2设计中的一个依赖注入特性的使用。2.3.    步骤三:配置struts.xml文件:<!DOCTYPE struts PUBLIC        "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"        "http://struts.apache.org/dtds/struts-2.0.dtd"><struts>    <package name ="fileUploadDemo" extends ="struts-default">        <action name ="fileUpload"class ="org.qiujy.web.struts2.FileUploadAction"><!-- 动态设置Action中的savePath属性的值 -->            <param name="savePath">/upload</param>            <result name ="success">/showupload.jsp</result>        </action >    </package ></struts>       在这个文件中跟以前配置唯一不同的是给action配置了一个<param …/>元素,用来为该Action的savePath属性动态注入值。web.xml中的配置跟以前的应用一样。说明一点:好多网络文章说Struts2上传时要在web.xml中配置一个名为 ActionContextUp的过滤器,说是有一些莫名的错误,可是是我用了Struts2新版本2.0.9GA版,测了n次,没出现什么问题,所以没 配置。2.4.    运行调试:运行前要在根目录下创建一个名为upload的文件夹,用来存放上传后的文件。上传结果:3.    文件类型及错误输出:Struts2提供了一个文件上传的拦截器(名为fileUpload),通过配置这个拦截器能轻松地实现文件类型的过滤。在上例中,若要配置上传的文件只能是一些普通的图片文件格式:image/bmp、image/png、image/gif、image/jpeg、image/jpg等,则可在struts.xml文件中按如下方式配置:<!DOCTYPE struts PUBLIC        "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"        "http://struts.apache.org/dtds/struts-2.0.dtd"><struts>    <constant name="struts.custom.i18n.resources" value="messages"/>    <package name="fileUploadDemo" extends="struts-default">        <action name="fileUpload"            class="org.qiujy.web.struts2.FileUploadAction">            <interceptor-ref name="fileUpload">              <!-- 配置允许上传的文件类型,多个用","分隔 -->              <param name="allowedTypes">          image/bmp,image/png,image/gif,image/jpeg,image/jpg,image/x-png, image/pjpeg              </param>              <!-- 配置允许上传的文件大小,单位字节 -->              <param name="maximumSize">102400</param>           </interceptor-ref>           <interceptor-ref name="defaultStack" />             <!-- 动态设置Action中的savePath属性的值 -->            <param name="savePath">/upload</param>             <result name="input">/index.jsp</result>            <result name="success">/showupload.jsp</result>        </action>    </package></struts> 如果上传文件失败,系统返回到input对应的页面,要在input对应的页面输出文件过滤失败信息,可以在input对应的页面中增加 <s:fielderror/>来显示错误信息。运行调试:结果:         显然,这样的提示不太友好,应用使用国际化信息。在国际化资源文件中添加如下三句:#更改上传文件类型不允许的提示信息struts.messages.error.content.type.not.allowed=文件上传失败:你要上传的文件类型不允许#更改上传文件太大的提示信息struts.messages.error.file.too.large=文件上传失败:你要上传的文件太大#文件上传其它错误信息struts.messages.error.uploading=文件上传失败:发生内部错误         别忘了要用native2ascii.exe进行编码转换哦。再运行调试:Unable to find 'struts.multipart.saveDir' property setting. Defaulting to javax.servlet.context.tempdirRemoving file upload D:/tomcat6.0.13/work/Catalina/localhost/fileload_struts2/upload__4b616fd1_115a3d5d9dc__7fff_00000005.tmp另外,在控制台会看到一条消息:第一个说是找不以struts.multipart.saveDir,即没有指定临时文件夹,这个很好解决,只需指定一个 <constant name="struts.multipart.saveDir" value="c:\"></constant> 常量值为某个目录来解决。第二个说正在删除一个临时文件,这个临时文件是上传过程中产生的,属正常。4.    多文件上传:Struts2也可以很方便地实现多文件上传。         在输入表单域增加多个文件域:multifileupload.jsp<%@ page language="java" contentType="text/html; charset=UTF-8"%><%@ taglib uri="/struts-tags" prefix="s" %><html><head>    <title>多文件上传</title></head><body>    <font color="red"><s:fielderror/></font>    <form action="multiFileUpload.action" method="POST" enctype="multipart/form-data">        文件标题:<input type="text" name="title" size="50" value="${param.title }"/><br/>       <!-- 设置二个文件域,名字相同 -->        选择第一个文件:<input type="file" name="upload" size="50"/><br/>        选择第二个文件:<input type="file" name="upload" size="50"/><br/>       <input type="submit" value=" 上传 "/>          </form></body></html>         在Action类中用数组来封装该多个文件域:MultiFileUploadAction.javapackage org.qiujy.web.struts2; import java.io.BufferedInputStream;import java.io.BufferedOutputStream;import java.io.File;import java.io.FileInputStream;import java.io.FileOutputStream;import java.io.IOException;import java.io.InputStream;import java.io.OutputStream; import org.apache.struts2.ServletActionContext; import com.opensymphony.xwork2.ActionSupport; /** *处理多文件上传的Action类 * *@authorqiujy *@version1.0 */publicclass MultiFileUploadAction extends ActionSupport {    privatestaticfinalintBUFFER_SIZE = 16 * 1024;    // 文件标题    private String title;    // 用File数组来封装多个上传文件域对象    private File[] upload;    // 用String数组来封装多个上传文件名    private String[] uploadFileName;    // 用String数组来封装多个上传文件类型    private String[] uploadContentType;    // 保存文件的目录路径(通过依赖注入)    private String savePath;     //以下为所有属性的getter和setter。省略。。。     // 自己封装的一个把源文件对象复制成目标文件对象    privatestaticvoid copy(File src, File dst) {        InputStream in = null;        OutputStream out = null;        try {            in = new BufferedInputStream(new FileInputStream(src), BUFFER_SIZE);            out = new BufferedOutputStream(new FileOutputStream(dst),                    BUFFER_SIZE);            byte[] buffer = newbyte[BUFFER_SIZE];            int len = 0;            while ((len = in.read(buffer)) > 0) {                out.write(buffer, 0, len);            }        } catch (Exception e) {            e.printStackTrace();        } finally {            if (null != in) {                try {                    in.close();                } catch (IOException e) {                    e.printStackTrace();                }            }            if (null != out) {                try {                    out.close();                } catch (IOException e) {                    e.printStackTrace();                }            }        }    }     @Override    public String execute() throws Exception {         File[] srcFiles = this.getUpload();        // 处理每个要上传的文件        for (int i = 0; i < srcFiles.length; i++) {            // 根据服务器的文件保存地址和原文件名创建目录文件全路径            String dstPath = ServletActionContext.getServletContext()                    .getRealPath(this.getSavePath())                    + "//" + this.getUploadFileName()[i];            File dstFile = new File(dstPath);            this.copy(srcFiles[i], dstFile);        }         returnSUCCESS;    } } 运行结果:5.    Struts2的文件下载:文件下载相对简单一些,一般只需在页面上提供一个超链接,该链接的href属性等于要下载文件的文件名就行了。但当文件名有中文时,就会导致失败;或者要在用户下载前进行权限判断,这时用Struts2提供的文件下载功能就能简单的解决这些问题。1 使用Struts2控制文件下载可能很多人会觉得,文件下载太简单,直接在页面上给出一个超级链接,该链接的href属性等于要下载文件的文件名,不就可以实现文件下载了吗?大 部分时候的确可以实现文件下载,但如果该文件的文件名为中文文件名,则会导致下载失败;或者应用程序需要在让用户下载之前进行进一步检查,比如判断用户是 否有足够权限来下载该文件等。看下面的一个原始的下载页面代码片段:<h1>原始的下载</h1><ul><li><!-- 包含中文文件名的下载链接 -->下载Struts2的Logo:<a href="images/中.gif">下载图形文件</a></li><li>下载Struts2的Logo的压缩文件:<a href="images/struts-gif.zip">下载压缩文件</a></li></ul>上面页面的包含两个下载的超级链接,两个链接的资源都是存在的,但因为第一个资源文件的文件名是中文文件名,如果单击第一个超级链接,将出现如下图所示的页面。从图中页面中椭圆形框包围的地方,我们看到被下载的文件名变成了包含大量%的字符串,很明显,这种文件名显然无法取得需要下载的文件。为了解决这个问题,我们使用Struts2的文件下载支持来下载该文件。2 实现文件下载的ActionStruts2的文件下载Action与普通的Action并没有太大的不同,仅仅是该Action需要提供一个返回InputStream流的方法,该输入流代表了被下载文件的入口。该Action类的代码如下:public class FileDownloadAction implements Action{//该属性是依赖注入的属性,该属性可以在配置文件中动态指定该属性值private String inputPath;//依赖注入该属性值的setter方法public void setInputPath(String value){inputPath = value;}/*下载用的Action应该返回一个InputStream实例,该方法对应在result里的inputName属性值为targetFile*/public InputStream getTargetFile() throws Exception{return ServletActionContext.getServletContext().getResourceAsStream(inputPath);}//处理用户请求的execute方法,该方法返回success字符串public String execute() throws Exception{return SUCCESS;}}从上面的Action中看到,该Action中包含了一个getTargetFile()方法,该方法返回一个InputStream输入流,这 个输入流返回的是下载目标文件的入口。该方法的方法名为getTargetFile,表明该Action有一个targetFile属性来返回下载文件。一旦我们定义了该Action,就可通过该Action来实现文件下载。3 配置Action配置该文件下载的Action与配置普通的Action并没有太大的不同,需要在配置普通Action的基础之上,在加上额外的download的拦截器引用。除此之外,关键是需要配置一个类型为stream的结果,配置stream类型的结果时需要指定如下四个属性:? contentType:指定被下载文件的文件类型。? inputName:指定被下载文件的入口输入流。? contentDisposition:指定下载的文件名。? bufferSize:指定下载文件时的缓冲大小。因为stream结果类型的逻辑视图是返回给客户端一个输入流,因此无需指定location属性。提示:配置stream类型的结果时,因为无需指定实际的显示的物理资源,所以无需指定location属性,只需要指定inputName属性,该属性指向被下载文件。下面是配置该下载所用的Action类的配置文件片段:<?xml version="1.0" encoding="GBK"?><!-- 指定Struts2配置文件的DTD信息 --><!DOCTYPE struts PUBLIC"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN""http://struts.apache.org/dtds/struts-2.0.dtd"><struts><!-- 配置Struts2国际化资源文件的baseName --><constant name="struts.custom.i18n.resources" value="globalMessages"/><!-- 配置Struts2应用的编码集 --><constant name="struts.i18n.encoding" value="GBK"/><package name="lee" extends="struts-default"><!-- 配置下载的拦截器引用 --><default-action-ref name="download"/><action name="download" class="lee.FileDownloadAction"><!-- 指定被下载资源的位置 --><param name="inputPath">\images\中.gif</param><!-- 配置结果类型为stream的结果 --><result name="success" type="stream"><!-- 指定下载文件的文件类型 --><param name="contentType">image/gif</param><!-- 指定下载文件的文件位置 --><param name="inputName">targetFile</param><param name="contentDisposition">filename="struts.gif"</param><!-- 指定下载文件的缓冲大小 --><param name="bufferSize">4096</param></result></action></package></struts>

0 0