为了上传文件必须将表单的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"
-