struts2 upload

最新推荐文章于 2024-03-31 12:23:21 发布

iteye_12332

最新推荐文章于 2024-03-31 12:23:21 发布

阅读量59

点赞数

文章标签： java

本文介绍Struts2框架下的文件上传实现过程，包括使用Jakarta Common-FileUpload处理multipart/form-data请求，自定义Action处理文件保存，并通过配置拦截器实现文件类型与大小限制。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

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 中增加相应上传组件的类库。

步骤一：创建带上传表单域的页面

Html代码

<%@pagelanguage="java"contentType="text/html;charset=UTF-8"%>
<html>
<head>
<title>Struts2FileUpload</title>
</head>
<body>
<formaction="fileUpload.action"method="POST"enctype="multipart/form-data">
文件标题：<inputtype="text"name="title"size="50"/><br/>
选择文件：<inputtype="file"name="upload"size="50"/><br/>
<inputtype="submit"value="上传"/>
</form>
</body>
</html>

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

步骤二：创建处理上传请求的 Action 类

Java代码

packageorg.qiujy.web.struts2;
importjava.io.BufferedInputStream;
importjava.io.BufferedOutputStream;
importjava.io.File;
importjava.io.FileInputStream;
importjava.io.FileOutputStream;
importjava.io.InputStream;
importjava.io.OutputStream;
importorg.apache.struts2.ServletActionContext;
importcom.opensymphony.xwork2.ActionSupport;
/**
*处理文件上传的Action类
*@authorqiujy
*@version1.0
*/
publicclassFileUploadActionextendsActionSupport{
privatestaticfinalintBUFFER_SIZE=16*1024;
//文件标题
privateStringtitle;
//上传文件域对象
privateFileupload;
//上传文件名
privateStringuploadFileName;
//上传文件类型
privateStringuploadContentType;
//保存文件的目录路径(通过依赖注入)
privateStringsavePath;
//以下省略getter和setter......
//自己封装的一个把源文件对象复制成目标文件对象
privatestaticvoidcopy(Filesrc,Filedst){
InputStreamin=null;
OutputStreamout=null;
try{
in=newBufferedInputStream(newFileInputStream(src),BUFFER_SIZE);
out=newBufferedOutputStream(newFileOutputStream(dst),
BUFFER_SIZE);
byte[]buffer=newbyte[BUFFER_SIZE];
intlen=0;
while((len=in.read(buffer))>0){
out.write(buffer,0,len);
}
}catch(Exceptione){
e.printStackTrace();
}finally{
if(null!=in){
try{
in.close();
}catch(IOExceptione){
e.printStackTrace();
}
}
if(null!=out){
try{
out.close();
}catch(IOExceptione){
e.printStackTrace();
}
}
}
}
@Override
publicStringexecute()throwsException{
//根据服务器的文件保存地址和原文件名创建目录文件全路径
StringdstPath=ServletActionContext.getServletContext()
.getRealPath(this.getSavePath())
+"//"+this.getUploadFileName();
System.out.println("上传的文件的类型："+this.getUploadContentType());
FiledstFile=newFile(dstPath);
copy(this.upload,dstFile);
returnSUCCESS;
}
}

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);
 
        return SUCCESS;
    }
}

上面这个 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 设计中的一个依赖注入特性的使用。

步骤三：配置

struts.xml 文件：

Xml代码

<!DOCTYPEstrutsPUBLIC
"-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<packagename="fileUploadDemo"extends="struts-default">
<actionname="fileUpload"
class="org.qiujy.web.struts2.FileUploadAction">
<paramname="savePath">/upload</param>
<resultname="success">/showupload.jsp</result>
</action>
</package>
</struts>

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

文件类型及错误输出：

Struts2 提供了一个文件上传的拦截器 ( 名为 fileUpload ) ，通过配置这个拦截器能轻松地实现文件类型的过滤。

在上例中，若要配置上传的文件只能是一些普通的图片文件格式： image/bmp 、 image/png 、 image/gif 、 image/jpeg 、 image/jpg 等，则可在 struts.xml 文件中按如下方式配置：

Xml代码

<!DOCTYPEstrutsPUBLIC
"-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<constantname="struts.custom.i18n.resources"value="messages"/>
<packagename="fileUploadDemo"extends="struts-default">
<actionname="fileUpload"
class="org.qiujy.web.struts2.FileUploadAction">
<interceptor-refname="fileUpload">
<paramname="allowedTypes">
　　　　　　image/bmp,image/png,image/gif,image/jpeg,image/jpg
,image/x-png,image/pjpeg
</param>
<paramname="maximumSize">102400</param>
</interceptor-ref>
<interceptor-refname="defaultStack"/>
<paramname="savePath">/upload</param>
<resultname="input">/index.jsp</result>
<resultname="success">/showupload.jsp</result>
</action>
</package>
</struts>

<!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/> 来显示错误信息。

在国际化资源文件中添加如下三句：

Xml代码

#更改上传文件类型不允许的提示信息
struts.messages.error.content.type.not.allowed=文件上传失败：你要上传的文件类型不允许
#更改上传文件太大的提示信息
struts.messages.error.file.too.large=文件上传失败：你要上传的文件太大
#文件上传其它错误信息
struts.messages.error.uploading=文件上传失败：发生内部错误

#更改上传文件类型不允许的提示信息
struts.messages.error.content.type.not.allowed=文件上传失败：你要上传的文件类型不允许
#更改上传文件太大的提示信息
struts.messages.error.file.too.large=文件上传失败：你要上传的文件太大
#文件上传其它错误信息
struts.messages.error.uploading=文件上传失败：发生内部错误

别忘了要用 native2ascii.exe 进行编码转换哦.

找不以 struts.multipart.saveDir ，即没有指定临时文件夹，这个很好解决，只需指定一个 struts.multipart.saveDir 常量值为某个目录来解决。

引用自： http://bluelzx.javaeye.com/blog/195278