struts2学习笔记（10）——使用fileupload进行文件上传

文件上传在web应用中很常见的，struts2提供了强大的文件上传功能，实际上文件上传是由commons-fileupload这个组件完成的。

在文件上传中，有2点非常重要：

1.表单提交方法为post

2.表单编码方式为multipart/form-data

如果不改编码方式，将使用默认的application/x-www-form-urlencoded

首先不使用任何组件，来看看在文件上传中常出现的问题。

为此，必须先停止使用struts2框架，在web.xml中将以下内容注释起来，

 

<filter> <filter-name>struts2</filter-name> <filter-class>org.apache.struts2.dispatcher.FilterDispatcher </filter-class> </filter> <filter-mapping> <filter-name>struts2</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>

 

在webroot下新建目录upload，新建upload.jsp

 

<form action="upload/result.jsp" method="post"> file1 : <input type="file" name="file1" /> <input type="submit" value=" submit " /> </form>
result.jsp文件内容

 

 

<% InputStream is = request.getInputStream(); BufferedReader br = new BufferedReader(new InputStreamReader(is)); String result = null; while((result = br.readLine()) != null){ out.print(result+"<br />"); } %>

注意在实际开发中并不会这么写jsp文件，在这里只是为了便于演示。

 

 

 

在某些浏览器中，上传文件后将显示路径+文件名（如IE），而有些仅仅只显示文件名（如opera）

使用fileupload来完成文件上传

新建upload2.jsp

 

 

 

<form action="FileUpload" method="post" enctype="multipart/form-data"> username : <input type="text" name="username"/> password : <input type="password" name="password"/> file1 : <input type="file" name="file1"/> file2 : <input type="file" name="file2"/> <input type="submit" value=" submit "/> </form>

表单中包含2个文本域和2个文件域。

 

表单提交到FileUpload这个servlet，因此接下来新建一个servlet。

在这个servlet中需要使用到fileupload这个组件。

使用fileupload，需要从DiskFileItemFactory这个类开始，在这个类中有两个方法：

setRepository（File repository）      

    Sets the directory used to temporarily store files that are larger than the configured size threshold.

    设置一个目录，临时地存储超过设置大小的文件

setSizeThreshold(int sizeThreshold)    

    Sets the size threshold beyond which files are written directly to disk.

    设置将低于某个大小的文件直接写到磁盘中

另外一个重要的类是ServletFileUpload，这个类完成了文件上传的最重要的操作。

parseRequest（）方法将返回一个List，该List的类型为FileItem，这里面包含了从客户端传过来的所有数据。

需要注意的是FileItem并不只是文件域，而包含了表单中所有的字段，即示例中username和password也包含在FileItem中。

在FileItem中包含一个方法isFormField（），该方法用来判断该字段是否为普通字段。

因此可以用它来区分普通字段和文件字段。

 

 

package cn.tshining.upload; import java.io.File; import java.io.FileOutputStream; import java.io.IOException; import java.io.InputStream; import java.io.OutputStream; import java.util.List; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.apache.commons.fileupload.FileItem; import org.apache.commons.fileupload.disk.DiskFileItemFactory; import org.apache.commons.fileupload.servlet.ServletFileUpload; public class FileUpload extends HttpServlet { private static final long serialVersionUID = 754442772763890174L; @SuppressWarnings( { "deprecation", "unchecked" }) public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { DiskFileItemFactory factory = new DiskFileItemFactory(); String path = request.getRealPath("/upload"); factory.setRepository(new File(path)); factory.setSizeThreshold(500); ServletFileUpload upload = new ServletFileUpload(factory); try { List<FileItem> list = upload.parseRequest(request); for (FileItem item : list) { if (item.isFormField()) { String name = item.getFieldName(); String value = item.getString(); request.setAttribute(name, value); } else { String name = item.getFieldName(); String value = item.getName(); int strat = 0; strat = value.lastIndexOf("//"); String fileName = value.substring(strat + 1); //注意，由于有浏览器的差别，因此需要提取出文件名才行 request.setAttribute(name, fileName); //IO操作，可以替换成其他方法完成 OutputStream os = new FileOutputStream(new File(path, fileName)); InputStream is = item.getInputStream(); int length = 0; byte[] buffer = new byte[400]; while ((length = is.read(buffer)) > 0) { os.write(buffer, 0, length); } os.close(); is.close(); //结束IO操作 } } } catch (Exception e) { e.printStackTrace(); } request.getRequestDispatcher("/upload/result2.jsp").forward(request, response); } }

 

 

在这里我们是使用的IO操作来完成的文件上传，在FileItem中包含一个方法

    write(java.io.File file)

        A convenience method to write an uploaded item to disk.

        一个方便的方法来写入一个上传的项目到磁盘中

因此我们可以将上面代码中被注释包括起来的代码替换成

 

    item.write(new File(path,fileName));

这样就完成了文件上传的基本示例。