(十五)struts2的文件上传和下载
文件上传的原理
我们以前学习上传的时候知道需要将表单的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>