java 文件上传 jar_JavaWeb 之 使用 commons-fileupload.jar 实现文件上传

一、文件上传

文件的上传和下载，是非常常见的功能，在很多的系统中，或软件中都经常使用文件的上传和下载

文件的上传主要分为下面几步：

1、前台页面需要一个 form 标签，里面的 method 为 post 请求；

2、在 form 标签必须添加 encType属性，且属性值必须是 multipart/form-data值；

3、在 form 标签中使用 input type=file 添加上传的文件；

4、在服务器编写代码(Servlet程序)接收，处理上传的数据。

注意点：

1. 请求必须是 post，因为 get 请求有长度限制；

2. encType=multipart/form-data 表示提交的数据，是以多段(每一个表单项一个数据段)的形式进行拼接，然后以二进制流的形式发送给服务器的；

3. 在服务器端必须以流的方式接收数据；

二、文件上传之 HTTP 协议的说明

三、Commons-fileupload.jar 常用 API

注意：commons-fileupload.jar 包需要依赖 commons-io.jar这个包，所以需要在项目中引入两个包。

1、常用API

FileItemFactory 表单项工厂接口

ServletFileUpload 文件上传类，用于解析上传的数据

FileItem 表单项类，表示每一个表单项

boolean ServletFileUpload.isMultipartContent(HttpServletRequest request) 判断当前上传的数据格式是否是多段的格式，只有是多段数据，才能使用该方式

public List parseRequest(HttpServletRequest request) 解析上传的数据，返回包含 表单项的 List 集合

boolean FileItem.isFormField() 　　　　　　判断当前这个表单项，是否是普通的表单项，还是上传的文件类型，true 表示普通类型的表单项；false 表示上传的文件类型

String FileItem.getFieldName() 　　　　　　获取表单项的 name 属性值

String FileItem.getString() 　　　　获取当前表单项的值；

String FileItem.getName()　　　　　　　　 获取上传的文件名

void FileItem.write( file )　　　　　　　　将上传的文件写到 参数 file 所指向存取的硬盘位置

2、流程图

四、案例

上传文件的表单：

1

2 　　用户名：

3 　　照片：

4 　　

5

解析上传的数据的 Servlet

1 importorg.apache.commons.fileupload.FileItem;2 importorg.apache.commons.fileupload.FileItemFactory;3 importorg.apache.commons.fileupload.disk.DiskFileItemFactory;4 importorg.apache.commons.fileupload.servlet.ServletFileUpload;5

6 importjavax.servlet.ServletException;7 importjavax.servlet.http.HttpServlet;8 importjavax.servlet.http.HttpServletRequest;9 importjavax.servlet.http.HttpServletResponse;10 importjava.io.File;11 importjava.io.IOException;12 importjava.util.List;13

14 public class UploadServlet extendsHttpServlet {15 protected void doPost(HttpServletRequest request, HttpServletResponse response) throwsServletException, IOException {16 //解决中文乱码

17 request.setCharacterEncoding("UTF-8");18

19 //1. 先判断上传的的数据是否多段数据(只有是多段的数据，才是文件上传的)

20 if( ServletFileUpload.isMultipartContent(request) ) {21

22 //创建 FileItemFactory 工厂实现类

23 FileItemFactory fileItemFactory = newDiskFileItemFactory();24 //2. 创建用于解析上传数据的工具类

25 ServletFileUpload servletFileUpload = newServletFileUpload(fileItemFactory);26

27 try{28 //3. 解析 上传的数据，得到每一个表单项 FiltItem

29 List list =servletFileUpload.parseRequest(request);30

31 //循环判断，每一个表单项，是普通类型，还是上传的文件

32 for(FileItem fileItem : list) {33

34 //是普通表单项

35 if( fileItem.isFormField() ) {36 String fieldName =fileItem.getFieldName();37 String value = fileItem.getString("UTF-8");38

39 System.out.println("表单项的name属性值 = " +fieldName);40 System.out.println("表单项的value属性值 = " +value);41 } else{42 //是上传的文件

43 String name =fileItem.getFieldName();44 String fieldName =fileItem.getName();45

46 System.out.println("表单项的name属性值 = " +name);47 System.out.println("上传的文件名 = " +fieldName);48

49 //将数据写到指定的位置

50 fileItem.write(new File( "F:\\" +fileItem.getName()));51 }52 }53

54 } catch(Exception e) {55 e.printStackTrace();56 }57

58 }59

60

61 }

注意：

这样的上传还有一个小问题，当上传多个同名同类型的文件时，后上传的文件会覆盖掉原来上传的文件，为了解决这一问题，可以在文件名前面加入当前时间的毫秒值即可。

防止文件覆盖，将数据存储可改成下面这种写法：

fileItem.write(new File( "F:\\" + System.currentTimeMillis() + fileItem.getName()));