1.Struts文件上传
在Web开发中,会经常涉及到文件的上传和下载,比如在注册账户的时候,我们需要上传自己的头像等。
我们可以利用Struts很方便地实现文件的上传。
1.1 开发步骤
现在,假设我们要在注册的时候上传自己的头像。新建项目名称为StrutsFileUpAndDown,并引入Struts1.3
(1)首先,写注册的JSP页面register.jsp
它的body内容如下:
<body>
<h1>注册用户</h1>
<% --如果表单有文件控件,则需要重新指定表单的编码方式 --%>
<form enctype="multipart/form-data" action="/StrutsFileUpAndDown/register.do" method="post">
名字:<input type="text" name="name" /><br>
头像:<input type="file" name="photo" /><br>
<input type="submit" value="注册" />
</form>
</body>
- 这里使用普通的HTML标签来写表单。一定要注意加上form的enctype属性,并且内容为”multipart/form-data”
- 这里必须使用post方法提交,get方法会出错
- action的地址刚开始的时候可以先空着,后面有了Action之后,再补上去。这里我的Action的path为”/register”
(2)添加对应的ActionForm,名字为UserForm
public class UserForm extends ActionForm {
private String name = null;
private FormFile photo = null;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public FormFile getPhoto() {
return photo;
}
public void setPhoto(FormFile photo) {
this.photo = photo;
}
}
- 要知道的是,JSP中的文件控件对应的是FormFile对象,该对象由Struts框架提供。
(2)添加对应的Action,名字为RegisterAction,并配置path为/register
最关键的地方就在于Action是怎么写的,我们点击注册之后,是由Action来处理这个逻辑的,文件也就是通过这个Action传上来的。
- 首先我们要得到UserForm中的内容:
UserForm userForm = (UserForm) form;
String username = userForm.getName();
FormFile formFile = userForm.getPhoto();
- 接着,我们保存文件,FormFile对象有getInputStream()方法可以得到文件的输入流。此时我们还需要一个输出流OutputStream,用于将输入流拿到的东西通过输出流保存到服务器的磁盘。但要注意输出流的输出路径是Tomcat下的绝对路径
// 文件名称
String fileName = formFile.getFileName();
// 获取输入流
InputStream is = formFile.getInputStream();
// 得到一个输出流
// 首先得到file文件夹上传到Tomcat服务器后的绝对路径
String path = request.getServletContext().getRealPath("file");
OutputStream os = new FileOutputStream(path + "\\" + fileName);
// 读取文件并写出到服务器file文件夹下
int len = 0;
// 做一个缓存
byte[] bytes = new byte[1024];
// 循环处理
while ((len = is.read(bytes)) > 0) {
// 读一点,写一点
os.write(bytes, 0, len);
}
当然,这整个过程要处理异常。如果不出错的话,我们就可以将文件上传给服务器了。
【注意,这里省略一些简单的配置步骤】
1.2 改进
(1)问题1:中文乱码的处理,如果用户上传的文件是中文名称会出现乱码
此时,过滤器可以很好地解决这个问题。只需要加上一个过滤器,将request的编码设置为utf-8即可。
public class EncodingFilter implements Filter {
@Override
public void destroy() {
}
@Override
public void doFilter(ServletRequest arg0, ServletResponse arg1,
FilterChain arg2) throws IOException, ServletException {
arg0.setCharacterEncoding("utf-8");
arg2.doFilter(arg0, arg1);
}
@Override
public void init(FilterConfig arg0) throws ServletException {
}
}
配置如下:
<filter>
<filter-name>EncodingFilter</filter-name>
<filter-class>com.gavin.filter.EncodingFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>EncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
(2)问题2:这里我们保存在服务器的文件名称是用户上传的名称,那么如果有两个用户上传的文件名称一样就会出现覆盖的情况,所以我们要在服务器端进行文件名的处理
这里,我们不再使用用户上传的文件的名称。那么又怎么样才能保证文件名的唯一呢?
- 1.一种方法是以当前的时间(年+月+日+时+分+秒+毫秒)作为文件的名称
- 2.另外,可以直接使用java.util.UUID类,UUID不会重复,这种方法最为简单。
String uuid = UUID.randomUUID().toString();
- 3.当然,使用UUID之后,还要加上原来文件的后缀才行,所以干脆写一个工具类:
public class MyTools {
/**
* 得到文件后缀
* @param fileName
* @return
*/
public static String getFileSuffix(String fileName) {
return fileName.substring(fileName.lastIndexOf("."));
}
/**
* 得到UUID
* @return
*/
public static String getUUID(){
String uuid = UUID.randomUUID().toString();
return uuid;
}
}
(3)问题3:如果用户上传的不是图片怎么办?如果用户上传的图片太大了怎么办?
所以这里我们要进行文件的限制,要进行文件的类型和大小的限制,如果不符合要求,则跳转至一个错误页面并给出提示:
这里我限制文件的大小上限为10MB,如下:
if (fileSize > 10 * 1024 * 1024) {
request.setAttribute("error", "文件大小不能超过10MB!");
return mapping.findForward("error");
}
if(!formFile.getContentType().startsWith("image/")){
request.setAttribute("error", "文件格式有错,请检查!");
return mapping.findForward("error");
}
【注意】文件的类型是不是图片,不是通过后缀名来判断的,要调用FormFile的方法,具体的文件类型你可以查看Tomcat安装目录下的conf文件夹下的web.xml文件中的配置。
所以,最后,一个完整的RegisterAction是这样的:
public class RegisterAction extends Action {
public ActionForward execute(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response) {
UserForm userForm = (UserForm) form;
String username = userForm.getName();
FormFile formFile = userForm.getPhoto();
// 通过FormFile我们可以获取关于用户上传文件的各种信息,比如大小,名字等
String fileName = formFile.getFileName();
int fileSize = formFile.getFileSize();
if (fileSize > 10 * 1024 * 1024) {
request.setAttribute("error", "文件大小不能超过10MB!");
return mapping.findForward("error");
}
if(!formFile.getContentType().startsWith("image/")){
request.setAttribute("error", "文件格式有错,请检查!");
return mapping.findForward("error");
}
InputStream is = null;
OutputStream os = null;
String uuid = MyTools.getUUID();
String suffix = MyTools.getFileSuffix(fileName);
String newFileName = uuid + suffix;
try {
is = formFile.getInputStream();
String path = request.getServletContext().getRealPath("file");
System.out.println(path);
os = new FileOutputStream(path + "\\" + newFileName);
int len = 0;
byte[] bytes = new byte[1024];
while ((len = is.read(bytes)) > 0) {
os.write(bytes, 0, len);
}
//这里省略保存数据库的操作
//逻辑上的正常跳转,这里也省略
} catch (Exception e) {
e.printStackTrace();
} finally {
try {
if (os != null) {
os.close();
}
if (is != null) {
is.close();
}
} catch (Exception e2) {
e2.printStackTrace();
}
}
request.setAttribute("error", "注册出错!");
return mapping.findForward("error");
}
}
2.Struts文件下载
文件下载,我们在介绍原生Servlet的时候已经介绍过,可以参考【Servlet——使用http响应头Content-Disposition下载文件的示例】。
当然,那时候我们是把下载的业务逻辑写在一个Servlet中,这里其实也没有什么不同,只不过我们要将业务逻辑写在一个Struts的Action中,并且该Action不需要配置相应的表单。
当我们点击下载的超链接时,让它请求这个Action即可。并且最后让该Action跳转至原来的页面:
return mapping.findForward("goback");