Struts2文件上传下载
Struts2文件上传
Struts2提供 FileUpload拦截器，用于解析 multipart/form-data 编码格式请求，解析上传文件的内容,fileUpload拦截器 默认在defaultStack栈中， 默认会执行的
页面：<input type="file" name="upload" />
在Action需要对上传文件内容进行接收 ：
private File upload; // <input type="file" name="upload" />这里变量名 和 页面表单元素 name 属性一致 private String uploadContentType;//格式 ：上传表单项name属性 + ContentType 、 上传表单项name属性 + FileName private String uploadFileName; public void setUpload(File upload) {//为三个对象 提供 setter 方法 this.upload = upload; } public void setUploadContentType(String uploadContentType) { this.uploadContentType = uploadContentType; } public void setUploadFileName(String uploadFileName) { this.uploadFileName = uploadFileName; }
通过FileUtils 提供 copyFile 进行文件复制，将上传文件保存到服务器端
FileUtils.copyFile(upload, new File("d:/upload",uploadFileName));
关于struts2中文件上传细节:
1.关于控制文件上传大小
在default.properties文件中定义了文件上传大小：struts.multipart.maxSize=2097152 上传文件默认的总大小 2m
2.在struts2中默认使用的是commons-fileupload进行文件上传。
# struts.multipart.parser=cos
# struts.multipart.parser=pell
struts.multipart.parser=jakarta （如果使用pell,cos进行文件上传，必须导入其jar包）
3.如果出现问题，需要配置input视图，在页面上可以通过<s:actionerror>展示错误信息.在页面上展示的信息，全是英文，要想展示中文，国际化
struts-messages.properties 文件里预定义 上传错误信息，通过覆盖对应key 显示中文信息
struts.messages.error.uploading=Error uploading: {0}
struts.messages.error.file.too.large=The file is to large to be uploaded: {0} "{1}" "{2}" {3}
struts.messages.error.content.type.not.allowed=Content-Type not allowed: {0} "{1}" "{2}" {3}
struts.messages.error.file.extension.not.allowed=File extension not allowed: {0} "{1}" "{2}" {3}
修改为
struts.messages.error.uploading=上传错误: {0}
struts.messages.error.file.too.large=上传文件太大: {0} "{1}" "{2}" {3}
struts.messages.error.content.type.not.allowed=上传文件的类型不允许: {0} "{1}" "{2}" {3}
struts.messages.error.file.extension.not.allowed=上传文件的后缀名不允许: {0} "{1}" "{2}" {3}
{0}:<input type=“file” name=“uploadImage”>中name属性的值
{1}:上传文件的真实名称
{2}:上传文件保存到临时目录的名称
{3}:上传文件的类型(对struts.messages.error.file.too.large是上传文件的大小)
4.关于多文件上传时的每个上传文件大小控制以及上传文件类型控制.
1.多文件上传
只需要将action属性声明成List集合或数组就可以。
private List<File> upload; private List<String> uploadContentType; private List<String> uploadFileName;
2.怎样控制每一个上传文件的大小以及上传文件的类型
在fileupload拦截器中，通过其属性进行控制.
maximumSize---每一个上传文件大小
allowedTypes--允许上传文件的mimeType类型.
allowedExtensions--允许上传文件的后缀名.
<interceptor-ref name="defaultStack"> <param name="fileUpload.allowedExtensions">txt,mp3,doc</param> </interceptor-ref>
多文件上传案例：
import java.io.File; import java.util.List; import org.apache.commons.io.FileUtils; import com.opensymphony.xwork2.ActionSupport; public class UploadAction extends ActionSupport { // 在action类中需要声明三个属性 private List<File> upload; private List<String> uploadContentType; private List<String> uploadFileName; public List<File> getUpload() { return upload; } public void setUpload(List<File> upload) { this.upload = upload; } public List<String> getUploadContentType() { return uploadContentType; } public void setUploadContentType(List<String> uploadContentType) { this.uploadContentType = uploadContentType; } public List<String> getUploadFileName() { return uploadFileName; } public void setUploadFileName(List<String> uploadFileName) { this.uploadFileName = uploadFileName; } @Override public String execute() throws Exception { for (int i = 0; i < upload.size(); i++) { System.out.println("上传文件的类型:" + uploadContentType.get(i)); System.out.println("上传文件的名称:" + uploadFileName.get(i)); // 完成文件上传. FileUtils.copyFile(upload.get(i), new File("d:/upload", uploadFileName.get(i))); } return null; } }
<s:actionerror/> <form action="${pageContext.request.contextPath}/upload" method="post" enctype="multipart/form-data"> <input type="file" name="upload"><br> <input type="file" name="upload"><br> <input type="file" name="upload"><br> <input type="submit" value="上传"> </form>
<struts> <constant name="struts.custom.i18n.resources" value="message"></constant> <constant name="struts.multipart.maxSize" value="20971520"></constant> <package name="default" namespace="/" extends="struts-default"> <action name="upload" class="cn.itcast.action.UploadAction"> <result name="input">/upload.jsp</result> <interceptor-ref name="defaultStack"> <param name="maximumSize">2097152</param> <param name="fileUpload.allowedExtensions">txt,mp3,doc</param> </interceptor-ref> </action> </package> </struts>
struts2中文件下载
通过<result type="stream">完成
<result-type name="stream" class="org.apache.struts2.dispatcher.StreamResult"/>
在StreamResult类中有三个属性:
protected String contentType = "text/plain"; //用于设置下载文件的mimeType类型
protected String contentDisposition = "inline";//用于设置进行下载操作以及下载文件的名称
protected InputStream inputStream; //用于读取要下载的文件。
要在action类中定义三个方法用于在XML文件中通过ognl获取值
// 设置下载文件mimeType类型 public String getContentType() { String mimeType = ServletActionContext.getServletContext().getMimeType(filename); return mimeType; } // 获取下载文件名称 public String getDownloadFileName() throws UnsupportedEncodingException { return DownloadUtils.getDownloadFileName(ServletActionContext.getRequest().getHeader("user-agent"), filename); } public InputStream getInputStream() throws FileNotFoundException,UnsupportedEncodingException { filename = new String(filename.getBytes("iso8859-1"), "utf-8"); // 解决get请求中文名称乱码. FileInputStream fis = new FileInputStream("d:/upload/" + filename); return fis; }
要在配置文件中配置
<result type="stream"> <param name="contentType">${contentType}</param> <!-- 调用当前action中的getContentType()方法 --> <param name="contentDisposition">attachment;filename=${downloadFileName}</param> <param name="inputStream">${inputStream}</param><!-- 调用当前action中的getInputStream()方法 --> </result>
注：
1：在struts2中进行下载时，如果使用<result type="stream">它有缺陷，例如：下载点击后，取消下载，服务器端会产生异常。
在开发中的解决方案:可以下载一个struts2下载操作的插件，它解决了stream问题。
2：处理浏览器之间不同的编码的getDownloadFileName方法
import java.io.UnsupportedEncodingException; import java.net.URLEncoder; import sun.misc.BASE64Encoder; public class DownloadUtils { public static String getDownloadFileName(String agent, String filename) throws UnsupportedEncodingException { if (agent.contains("MSIE")) { // IE浏览器 filename = URLEncoder.encode(filename, "utf-8"); } else if (agent.contains("Firefox")) { // 火狐浏览器 BASE64Encoder base64Encoder = new BASE64Encoder(); filename = "=?utf-8?B?" + base64Encoder.encode(filename.getBytes("utf-8")) + "?="; } else { // 其它浏览器 filename = URLEncoder.encode(filename, "utf-8"); } return filename; } }
下载案例：
<body> <a href="${pageContext.request.contextPath}/download?filename=a.txt">a.txt</a><br> <a href="${pageContext.request.contextPath}/download?filename=捕获.png">捕获.png</a><br> </body>
import java.io.FileInputStream; import java.io.FileNotFoundException; import java.io.InputStream; import java.io.UnsupportedEncodingException; import org.apache.struts2.ServletActionContext; import cn.itcast.utils.DownloadUtils; import com.opensymphony.xwork2.ActionSupport; public class DownloadAction extends ActionSupport { private String filename; // 要下载文件的名称 public String getFilename() { return filename; } public void setFilename(String filename) { this.filename = filename; } // 设置下载文件mimeType类型 public String getContentType() { String mimeType = ServletActionContext.getServletContext().getMimeType( filename); return mimeType; } // 获取下载文件名称 public String getDownloadFileName() throws UnsupportedEncodingException { return DownloadUtils.getDownloadFileName(ServletActionContext .getRequest().getHeader("user-agent"), filename); } public InputStream getInputStream() throws FileNotFoundException, UnsupportedEncodingException { filename = new String(filename.getBytes("iso8859-1"), "utf-8"); // 解决中文名称乱码. FileInputStream fis = new FileInputStream("d:/upload/" + filename); return fis; } @Override public String execute() throws Exception { System.out.println("进行下载...."); return SUCCESS; } }
<action name="download" class="cn.itcast.action.DownloadAction"> <result type="stream"> <param name="contentType">${contentType}</param> <!-- 调用当前action中的getContentType()方法 --> <param name="contentDisposition">attachment;filename=${downloadFileName}</param> <param name="inputStream">${inputStream}</param><!-- 调用当前action中的getInputStream()方法 --> </result> </action>
