Struts2文件上传简介

文件上传是指将本地文件上传到服务器的指定目录下。使用 Struts2 框架进行文件上传时,首先需要对 form 表单进行设置,将其 enctype 属性设置为 multipart/form-data,method 属性设置为 post,并在 <s:form> 标签中使用 <s:file> 标签作为文件选择框上传文件。

文件上传页面的示例代码如下所示:

<s:form action ="xxx" method ="post" enctype = "Multipart/form-data">
    <s:file name ="xxx" label = "xxx" />
    <s:submit value ="上传"/>
</s:form>

在上述代码中,<s:form> 标签的 action 属性用于指定表单提交时对应的 action 方法,method 属性用于指定表单的提交方式(包括 GET 和 POST 两种提交方式,默认提交方式是 GET),而 enctype 属性的取值决定了表单数据的编码方式。通常 enctype 属性有三个属性值,具体如下。

1)application/x-www-form-urlencoded

该值为默认的编码方式,它只处理表单域中的 value 属性,采用这种编码方式的表单会将表单域的值处理成 URL 编码方式。这种编码方式按 ISO-8859-1 的编码方式将表单上传到服务器,只是此种编码方式上传不了文件。

2)multipart/form-data

这种编码方式会以二进制流的方式处理表单数据,并且它会把文件域指定文件的内容也封装到请求参数中。在进行文件上传时,采用的就是此种方式。

3)text/plain

主要作用是直接通过表单发送邮件,目前已不再采用。

设置完 form 表单后,还需要在 Action 类中编写相应的代码。文件上传 Action 类的示例代码如下所示:
public class FileUploadAction extends ActionSupport{
    private File xxx; // 用户上传的文件
    private String xxxContentType; //上传文件的类型
    private String xxxFileName; //上传文件的名称
    //此处省略三个属性的getter和setter方法
    public String execute() throws Exception{
        //此处省略具体执行的方法
        return SUCCESS;  
    }
}
在上述代码中,包括三个类型的属性,具体如下。
  • File 类型的属性 xxx:该属性用于指定上传文件的内容。这里将该属性假设指定为 xxx。
  • String 类型的属性 xxxFileName:该属性名称必须为 xxxFileName,其中 xxx 表示 File 类型的属性名称,该属性用于指定上传文件名。
  • String 类型的属性 xxxContentType:该属性名称必须为 xxxContentType,其中 xxx 表示 File 类型的属性名称,该属性用于指定上传文件的文件类型。

需要注意的是,上述代码中的 xxx 指 JSP 页面中 file 标签的名字。

最后,在 struts.xml 中需要对 Action 进行配置,其配置方式与其他 Action 的配置相似,只是一般要在 Action 的配置中加入文件过滤拦截器 fileUpload。fileUpload 拦截器在 struts-default 中已经配置,使用时需要重新配置。struts.xml 配置信息的示例代码如下所示:
<package name="struts2" extends="struts-default" namespace="/" >
    <action name="xxx" class="com.mengma.xxx">
        <result name="success">/result.jsp</result><!--返回结果-->
        <interceptor-ref name="defaultStack"><!--引用拦截器-->
            <param name="maximumSize">4194304</param><!-- 设置每一个action允许的上传文件的大小 -->
            <param name="allowedExtensions">bmp,txt</param><!-- 设置上传文件允许的后缀名,多个使用逗号分开 -->
            <param name="fileUpload.allowedTypes">
                    text/plain,application/msword,image/jpeg
            </param><!--设置上传允许的文件的mimeType类型,多个使用逗号分开-->
        </interceptor-ref>
    </action>
</package>
在上述配置代码中,使用了 fileUpload 的 maximumSize、allowedExtension 和 allowedTypes 三个参数,分别对上传文件进行了限制。

其中 maximumSize 用于指定允许上传文件的文件大小,单位是字节;allowedExtension 用于指定上传文件的扩展名;allowedTypes 用于指定允许上传文件的类型,当有多个文件类型时,用逗号隔开即可。