- jar包选择
- 文件上传的前提
- 程序代码
- 运行结果
- 文件上传大小的限制
- 解决方法
- 配置input视图
- 限制文件上传的类型
- 限制上传文件的扩展名
- 限制上传文件的MIME类型
- 出错后的中文信息提示
- 小提示
jar包选择
struts2的基础jar包,其实struts2的上传底层还是使用commons-fileupload和commons-io实现的。
文件上传的前提
- 表单method必须是post
- enctype取值必须是multipart/form-data(默认:application/x-www-form-urlencoded)
- 提供文件选择域
程序代码
使用了struts2的s标签
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@taglib uri="/struts-tags" prefix="s"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>上传页面</title>
<s:head/>
</head>
<body>
<s:form action="upload.action" method="post" enctype="multipart/form-data">
<s:textfield name="username" label="用户名"></s:textfield>
<s:file name="photo" label="照片"></s:file>
<s:submit label="上传"></s:submit>
</s:form>
</body>
</html>
动作类:
- 获取servletContext对象
- 首先使用realPath方法根据一个虚拟目录得到一个真实的目录,把上传的文件放在项目的/WEB-INF/upload文件夹里面。
- 判断/WEB-INF/upload文件夹是否存在,如果不存在,创建新的文件夹。
- 把上传的文件从临时文件(fileupload超过10KB使用磁盘临时文件使用缓存,不足10KB使用内存作为缓存)剪切到/WEB-INF/upload目录下,并重新命名。
public class UploadAction extends ActionSupport
//表单上提供的字段
private String username;
private File photo;
private String photoFileName;//上传的文件名。上传的字段名称+filename
private String photoContentType;//上传的文件MIME类型。上传字段名称+ContentType
public String upload(){
//1.获取servletContext对象
ServletContext application = ServletActionContext.getServletContext();
//2.调用realPath方法获取根据一个虚拟目录得到的真实目录
String filePath=application.getRealPath("/WEB-INF/upload");
File file=new File(filePath);
if(!file.exists()){
file.mkdir();
}
photo.renameTo(new File(file,photoFileName));
return null;
}
public File getPhoto() {
return photo;
}
public void setPhoto(File photo) {
this.photo = photo;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPhotoFileName() {
return photoFileName;
}
public void setPhotoFileName(String photoFileName) {
this.photoFileName = photoFileName;
}
public String getPhotoContentType() {
return photoContentType;
}
public void setPhotoContentType(String photoContentType) {
this.photoContentType = photoContentType;
}
}
struts.xml
仅仅配置了一个upload动作,没有返回结果
<struts>
<constant name="struts.devMode" value="true"/>
<package name="user" extends="struts-default">
<action name="upload" class="com.scx.web.action.UploadAction" method="upload">
</action>
</package>
</struts>
运行结果
我们上传了一个大小为616KB的图片,成功在/WEB-INF/upload文件夹中找到了。
我们能不能上传更大的呢?这次我们选择一个大小为2116KB的图片。
好像失败了。
为什么我们上传616KB的图片成功,上传2116KB的图片就报错呢?
文件上传大小的限制
如果上传文件超过了默认大小,upload拦截器会转向一个input的逻辑视图。
查看default.properties文件,在第71行我们会看到
struts限制了我们上传的文件大小为2097152字节(2MB=1024*1024*2)
解决方法
我们可以在struts.xml中改变default.properties文件中的常量。
设置默认的上传文件大小为3MB.
再次运行一次:
成功的上传了文件。
配置input视图
虽然我们修改了上传的大小范围,但是肯定还有别人上传更大的文件,
我们应该如何修改呢?
为upload动作配置input结果视图,当用户上传了大于限制的文件,再次跳转到上传页面
在upload.jsp页面中添加
<s:actionerror/>
标签。
限制文件上传的类型
有时候我们需要用户上传指定的类型,例如图片,音乐等。
这个时候我们可以为上传的拦截器(FileUploadInterceptor)注入相关参数来限制用户上传的文件类型。
在FileUploadInterceptor拦截器类中我们会看到这两个参数
其中
- allowedTypeSet是允许上传文件的MIME类型
-
allowedExtensionsSet是允许上传文件的扩展名。
使用其对应的set方法为其注入参数。
如果我们要限制用户上传的内容为图片
限制上传文件的扩展名
当上传非限定扩展名时:当我们上传了一个txt文档时,有如下错误提示
限制上传文件的MIME类型
当上传非限定的MIME类型:当我们上传了一个txt文档时,有如下错误提示
出错后的中文信息提示
上面上传文件后出错的信息有很多英文,对于用户来说都是很难读懂的,那么如何能够转变为用户能够读懂的信息呢。
解决办法:Struts2中的所有文本提示都是基于国际化的,用国际化消息资源包,把对应的key取值改为中文即可。默认信息提示在:struts2-core.jar\org.apache.struts2\struts-message.properties
配置步骤如下:
- 创建新的资源文件,例如fileupload_message.properties.放在src下,在该资源中添加如下信息
- 在struts.xml文件中加载该资源文件
<!-- 配置上传文件的出错信息的资源文件 -->
<constant name="struts.custom.i18n.resources" value="com.scx.web.action.fileupload_message"></constant>
运行结果:
小提示
- 保证服务器的安全要把上传的文件上传到客户端无法访问的地方。
- 用户没有上传的问题
- 避免文件被覆盖(文件重名问题),让文件名唯一即可
- 避免 同一个文件夹文件过多
- 按照日期进行打散存贮目录
- 用文件名的hashCode计算打散的存储目录:二级目录