（十五）struts2的文件上传和下载-优快云博客

本文介绍文件上传原理，对比不同表单编码方式，并演示Struts2框架中的文件上传与下载实现，包括多文件上传及文件过滤。

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

文件上传的原理

我们以前学习上传的时候知道需要将表单的enctype属性设置为multipart/form-data. 表单的enctype属性指定的是表单数据的编码方式，有三个值： -application/x-www-form-urlencoded:这是默认的编码方式。只处理表单的value属性值。采用这种会将表单域的值处理为url编码方式。 -multipart/form-data：这种编码方式会以二进制流的方式来处理表单数据，会将文件域里指定文件内容也封装到请求参数里。 -text/plain：这种方式主要用于直接通过表单发送邮件的情况。

我们用一个简单的案例来说明一下application/x-www-form-urlencoded 和multipart/form-data的区别。

案例：上传表单

        <body>
            <form action="${pageContext.request.contextPath }/DemoServlet" enctype="application/x-www-form-urlencoded" method="post">
                上传文件:<input type="file" name="file"><br>
                请求参数:<input type="text" name="username"><br>
                <input type="submit" value="提交" name="dd">  
            </form>
        </body>

处理Servlet，这里的处理直接通过二进制流来处理http请求。这是底层的方式，当通过request的getParameter方法获取请求参数时，实际上是web服务器替我们处理了这种底层的二进制流，并转换成对应的请求参数值。

            public class DemoServlet extends HttpServlet {

                protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
                    InputStream is=request.getInputStream();
                    BufferedReader br=new BufferedReader(new InputStreamReader(is));
                    String buffer=null;
                    while((buffer=br.readLine())!=null)
                    {
                        System.out.println(buffer);
                    }
                }

            }

    然后我们访问页面，选中file.txt文件 输入框中输入张三 ，点击提交 
                输出 
                file=file.txt&username=%E5%BC%A0%E4%B8%89&dd=%E6%8F%90%E4%BA%A4 

                这个字符串包含了三个属性，file，username 和 dd 
                浏览器会将表单里所有具有name属性的表单项转换成请求参数，因为提交按钮也有name属性，因此也被转换成请求参数。 

                这里的编码都是使用url编码。可以通过java提供的URLDecoder解码。
                大部分时候，程序中通过getParameter方法即可获得参数，底层的二进制流处理，以及使用URLDecoder处理请求参数，都由web服务器帮我们完成了，。

显然，通过上面这种方式，只能获取到文件名，不能获取到文件的内容，所以为了实现文件上传，只能将enctype属性设置为multipart/form-data.
                一旦设置了表单的 enctype属性设置为multipart/form-data  getParameter方法就无法使用。 


                当我们设置完以后，再次点击提交，则输出

                        ------WebKitFormBoundary2lDSbdeEx3KW1Tup
                        Content-Disposition: form-data; name="file"; filename="file.txt"
                        Content-Type: text/plain

                        我是上传文件
                        ------WebKitFormBoundary2lDSbdeEx3KW1Tup
                        Content-Disposition: form-data; name="username"

                        zhangsan
                        ------WebKitFormBoundary2lDSbdeEx3KW1Tup-- 

                这时我们发现文件的内容也获取到，我们只需要通过io流的知识将其分割然后获取指定的参数即可。
                对于一个成熟的文件上传框架，需要完成的逻辑很简单，分析request请求的二进制流，解析出数据，然后允许开发者以简单的方式获取数据内容即可。

                Servlet3.0给我们所提供了提供了更加简单的文件上传方法，我们可以查阅API进行使用，这里不再细说。

Struts2的文件上传

struts2并未提供自己的上传组件。在struts.properties配置文件中，可以看到底层配置的是Common-fileupload组件。

但struts在原有的组件上进行了封装，因此底层的上传组件可以随意切换，代码不用变化

（1）编写我们的Action动作类

            public class UploadAction extends ActionSupport {
                private String username;
                private File upload; //封装了文件内容，无法获得文件名和文件类型
                private String uploadContentType;//封装了文件类型，xxxContentType
                private String uploadFileName; //用xxxFileName封装文件名字

                public String getUsername() {
                    return username;
                }

                public void setUsername(String username) {
                    this.username = username;
                }

                public File getUpload() {
                    return upload;
                }

                public void setUpload(File upload) {
                    this.upload = upload;
                }

                public String getUploadContentType() {
                    return uploadContentType;
                }

                public void setUploadContentType(String uploadContentType) {
                    this.uploadContentType = uploadContentType;
                }

                public String getUploadFileName() {
                    return uploadFileName;
                }

                public void setUploadFileName(String uploadFileName) {
                    this.uploadFileName = uploadFileName;
                }

                public String upload(){  
                    //获取真实路径
                    String savepath=ServletActionContext.getRequest().getRealPath("/WEB-INF/files");
                    File file=new File(savepath); 
                    //判断文件是否存在，不存在就创建相应的目录等
                    if(!file.exists()){
                        file.mkdirs();
                    } 
                    //将上传的临时文件重命名并且另存到指定地址
                    upload.renameTo(new File(file,uploadFileName));
                    return null;
                }

            }

　（2）配置Action

            <package name="p1" extends="struts-default">
                <action name="upload" class="com.cad.struts2.action.UploadAction" method="upload">
                </action>
            </package>

文件过滤

            我们可以自己手动判断文件大小，文件类型来进行文件过滤，但是比较繁琐。
            struts2为我们提供了一个fileUpload拦截器，来帮我们实现文件过滤。
            fileUpload拦截器也被配置在了默认的拦截器栈中

            fileUpload拦截器有两个参数
            -allowedTypes：该参数指定允许上传的文件类型，多个文件类型之间用逗号分割，
            -maximumSize：该属性指定允许上传的文件大小，单位是字节
            struts2默认的允许上传文件大小为2MB。

            设置最大允许上传文件大小为30M ，经过测试，这种方法行不通，不知道具体原因是什么。
            <action name="upload" class="com.cad.struts2.action.UploadAction" method="upload">
                <interceptor-ref name="defaultStack">
                    <param name="fileUpload.allowedTypes">image/jpg</param>
                    <param name="fileUpload.maximumSize">31457280</param>
                </interceptor-ref>
            </action> 

            所以我们只能通过配置常量来修改允许上传文件的大小 
            <constant name="struts.multipart.maxSize" value="31457280"></constant>

同时上传多个文件

        需要将文件表单项的name设置成相同的。

            表单页面
                <body>
                        <form action="${pageContext.request.contextPath }/upload.action" enctype="multipart/form-data" method="post">
                        上传文件1:<input type="file" name="upload"><br>
                        上传文件2:<input type="file" name="upload"><br>
                        上传文件3:<input type="file" name="upload"><br>
                        用户名:<input type="text" name="username"><br>
                        <input type="submit" value="提交">    
                    </form>
                </body>

            然后写Action类，需要将file，fileName，ContentType等用数组封装起来 
            然后遍历得到
            public class UploadAction extends ActionSupport {
                private String username;
                private File upload[]; 
                private String uploadContentType[];
                private String uploadFileName[]; 

                public String getUsername() {
                    return username;
                }

                public void setUsername(String username) {
                    this.username = username;
                }


                public File[] getUpload() {
                    return upload;
                }

                public void setUpload(File[] upload) {
                    this.upload = upload;
                }

                public String[] getUploadContentType() {
                    return uploadContentType;
                }

                public void setUploadContentType(String[] uploadContentType) {
                    this.uploadContentType = uploadContentType;
                }

                public String[] getUploadFileName() {
                    return uploadFileName;
                }

                public void setUploadFileName(String[] uploadFileName) {
                    this.uploadFileName = uploadFileName;
                }

                public String upload(){ 
                    String savepath=ServletActionContext.getRequest().getRealPath("/WEB-INF/files");
                    File file=new File(savepath);
                    if(!file.exists()){
                        file.mkdirs();
                    }
                    for(int i=0;i<upload.length;i++){
                        upload[i].renameTo(new File(file,uploadFileName[i]));
                    }
                    return null;
                }

            }

Struts2的文件下载

    创建下载的action类 

                public class DownloadAction extends ActionSupport {
                    private InputStream input;

                    public InputStream getInput() {
                        return input;
                    }

                    public void setInput(InputStream input) {
                        this.input = input;
                    }

                    public String download() throws Exception{
                        //获取文件路径
                        String path=ServletActionContext.getRequest().getRealPath("/WEB-INF/files/photo.jpg");
                        //读取文件
                        input=new FileInputStream(path);
                        return SUCCESS;
                    }
                }

    配置Action
                struts2指定了stream结果类型，专门用来处理下载。

                contentType：被下载文件的文件类型。
                contentDisposition：下载文件弹窗，文件名等 
                inputName：action类中流的名字 

                <action name="download" class="com.cad.struts2.action.DownloadAction" method="download">
                    <result name="success" type="stream">
                        <param name="contentType">application/octet-stream</param>
                        <param name="contentDisposition">attachment;filename=phpto.jpg</param>
                        <param name="inputName">input</param>
                    </result>
                </action>