首页 > 代码库 > 笔记：Struts2 文件上传和下载
笔记：Struts2 文件上传和下载
为了上传文件必须将表单的method设置为POST，将 enctype 设置为 muiltipart/form-data，只有设置为这种情况下，浏览器才会把用户选择文件的二进制数据发送给服务器。
- 上传解析器配置
- Struts2 没有提供自己的请求解析器，struts2 需要调用其他上传框架来解析二进制数据，struts2 默认使用 jakarta 的 Common-FileUpload 的文件上传框架，需要在 Web 应用的 lib 中增加 commons-io-2.2.jar 和 commons-fileupload-1.3.2.jar。
- 通过 struts2 的 常量配置 struts.multipart.parser 来设置文件上传解析器，默认值 jakarta
- Struts.multipart.saveDir：上传文件的临时文件保存路径，默认值 javax.servlet.context.tempdir 配置的路径，该路径是Tomcat的安装路径下的 work\Catalina\localhost
- Struts.multipart.maxSize：整个表单请求内容的最大字节数，默认值 2097152
- 上传Action 解析
- 创建 java.io.File 类型的字段来接收上传的文件流；创建 xxxFileName 和 xxxContentType 来读取原始上传的文件名称和文件类型，其中 xxx 表示的是 java.io.File 类型的字段名称，比如示例是名为 upload 字段接收上传的文件流，因此需要有 uploadFileName 和 uploadContentType 来接收该文件流的原始文件名称和文件类型，示例代码如下：
??
public class UploadAction extends ActionSupport {
??
/**
*
*/
private static final long serialVersionUID = 283051583917637792L;
??
private File upload;
private String uploadFileName;
private String uploadContentType;
private String uploadPath;
??
public UploadAction() {
uploadPath = "upload";
}
??
@Override
public String execute() throws Exception {
??
if (upload == null) {
addActionError("没有选择上传文件");
return INPUT;
}
??
String filePath = ServletActionContext.getServletContext().getRealPath(uploadPath);
??
java.io.File dir = new java.io.File(filePath);
if (dir.exists() == false) {
if (dir.mkdirs() == false) {
addActionError("创建目录失败，目录路径=" + filePath);
return INPUT;
}
}
??
System.out.println("Upload FileName =" + uploadFileName);
System.out.println("Upload ContentType =" + uploadContentType);
??
FileOutputStream fileOutputStream = new FileOutputStream(filePath + File.pathSeparator + uploadFileName);
FileInputStream fileInputStream = new FileInputStream(upload);
byte[] buffer = new byte[4096];
int len = 0;
do {
len = fileInputStream.read(buffer, 0, buffer.length);
if (len > 0) {
fileOutputStream.write(buffer, 0, len);
}
} while (len > 0);
??
addActionMessage("上传完成，保存路径=" + filePath + File.pathSeparator + uploadFileName);
??
return SUCCESS;
}
??
public File getUpload() {
return upload;
}
??
public void setUpload(File upload) {
this.upload = upload;
}
??
public String getUploadFileName() {
return uploadFileName;
}
??
public void setUploadFileName(String uploadFileName) {
this.uploadFileName = uploadFileName;
}
??
public String getUploadContentType() {
return uploadContentType;
}
??
public void setUploadContentType(String uploadContentType) {
this.uploadContentType = uploadContentType;
}
}
- fileUpload 拦截器
- fileUpload 拦截器是struts2 提供的一个文件上传拦截器，用于拦截不允许的上传文件类型和文件大小，需要配置二个参数来处理：
- 参数 allowedTypes：该参数指定允许上传的文件类型（contentType），多个文件类型以英文逗号隔开
- 参数 maximumSize：该参数指定允许上传的文件大小，单位字节
- 如果上传文件类型或者文件大小错误，fileUpload 拦截器将会读取全局国际化资源文件来进行提示，读取的Key如下：
- struts.messages.error.file.too.large：该key表示上传的文件太大的提示
- {0} 表示 ActionName
- {1} 表示上传原始文件名称
- {2} 表示服务器临时文件名称
- {3} 上传文件的 ContentType
- struts.messages.error.content.type.not.allowed：该key表示上传文件类型错误的提示
- {0} 表示 ActionName
- {1} 表示上传原始文件名称
- {2} 表示服务器临时文件名称
- {3} 上传文件的字节大小
- {4} 允许的上传文件字节大小
- struts.messages.error.uploading：该key表示上传文件出现一个未知错误的提示
- 配置示例代码
<action name="upload" class="org.drsoft.actions.file.UploadAction">
<interceptor-ref name="fileUpload">
<param name="allowedTypes">image/png</param>
<param name="maximumSize">102400</param>
</interceptor-ref>
<!--必须增加该项，如果不增加其他的拦截器会默认增加该拦截器-->
<interceptor-ref name="defaultStack"/>
??
<result name="success">/WEB-INF/content/file/upload.jsp</result>
<result name="input">/WEB-INF/content/file/upload.jsp</result>
</action>
- 下载文件 Action
- 下载文件的Action需要使用 stream 的结果类型，stream结果类型需要指定一个 inputName 参数，该参数指定了一个输入流，这个输入流是被下载文件的入口，详细参数如下：
- 参数 inputName：表示其Action类的返回 InputStream 的下载方法名称，示例，设置为 downloadFile 则会调用 Action类的 getDownloadFile 方法
- 参数 contentType：设置 httpResponse 的 mime-type ,设置 response 的 contentType 头，默认值 text/plain，通用值 application/octet-stream
- 参数 contentDisposition：设置响应报文头的 content disposition 值，用于指定浏览器的处理方式和下载文件名称，默认类型为 inline（内联），浏览器将会打开文件，可以设置 attachment（附件），浏览器将提示保存文件，参数示例：Inline;filename="downloadfile.zip"，如果文件名称为中文，则需要使用 java.net.URLEncoder.encode(fileName, "UTF-8")
- 参数 contentLength：设置流的字节长度，用于浏览器的下载进度显示
- 参数 bufferSize：输入流和输出流的缓冲区字节大小
- 参数 allowCaching：如果设置为 false，会将 response 报文头的 Cache-Control设置为no-cache，默认值 true
- 参数 contentCharSet：设置内容编码，如果设置了值将会增加到x响应报文的 contentType 后面附加 ";charset=value"
??
??
??
笔记：Struts2 文件上传和下载