基于表单的文件上传

 

 

 

1. 基于表单的文件上传
    如果在表单中使用表单元素 <input type=“file” />，浏览器在解析表单时，会自动生成一个输入框和一个按钮，输入框可供用户填写本地文件的文件名和路径名，按钮可

以让浏览器打开一个文件选择框供用户选择文件：
下面是表单的示例：
 <tr>
  <td>请选择要上传的文件：</td>
  <td><input type="file" name="myfile" size="40" /></td>
 </tr>
 <tr>
  <td>请输入文件的描述：</td>
  <td><input type="text" name="mydesc" size="40" /></td>
 </tr>
--------------------------------------------------------------------------------

2. Commons-fileupload 组件上传的基本原理：
    FileUpload 组件将页面提交的所有元素(普通 form 表单域，如 text 和文件域 file )都看作一样的

FileItem ，这样上传页面提交的 request 请求也就是一个 FileItem 的有序组合，FileUpload 组件可以解析该 request ，并返回一个一个的 FileItem 。而对每一个 FileItem

，FileUpload 组件可以判断出它是普通 form 表单域还是文件 file 域，从而根据不同的类型，采取不同的操作－－如果是表单域，就读出其值，如果是文件域，就保存文件到服

务器硬盘上或者内存中。

 

 

 

 

--------------------------------------------------------------------------------

 

3. Commons-fileupload 组件API：
在 Commons-fileupload 组件中，主要用到以下三个接口和类：
<1> ServletFileUpload 负责处理上传的文件数据，并将每部分的数据封装成一到 FileItem 对象中。
<2> DiskFileItemFactory 是创建 FileItem 对象的工厂，在这个工厂类中可以配置内存缓冲区大小和存放临时文件的目录。 

相关方法：setSizeThreshold(int sizeThreshold)//以byte为单位设定文件使用多少内存量后，将文件存入临时存储。   setRepository(java.io.File repository) //设定临时文件的存储路径  
<3>ServletFileUpload 在接收上传文件数据时，会将内容保存到内存缓存区中，如果文件内容超过了DiskFileItemFactory 指定的缓冲区的大小，那么文件将被保存到磁盘上，存储为 DiskFileItemFactory 指定目录中的临时文件。等文件数据都接收完毕后，ServletUpload 在从

文件中将数据写入到上传文件目录下的文件中。

相关方法：isMultipartContent(javax.servlet.http.HttpServletRequest request)//判断客户端请求是否为POST，并且enctype属性是否是“multipart/form-data"

parseRequest(javax.servlet.http.HttpServletRequest request)

//读入“multipart/form-data"数据流

，并得到表单项列表。   

setSizeMax(long sizeMax)  //设置允许上传文件的最大大小

 

--------------------------------------------------------------------------------

4. FileItem类，是一个接口，根据名字翻译就是文件项，代表所提交表单中的一个控件，ServletFileUpload中的parseRequest()文件返回整个表单的所有FileItem项的列表。

boolean isFormField()  //判断该表单项是否是文件项，还是普通表单项。

String getFieldName() //如果不是文件项，返回对应表单项的表单名称。

String getString() //如果不是文件项，以默认编码返回该项的内容。

String getString(String encoding) //以指定编码返回该项内容。

long getSize() //以byte为单位返回该项大小

String getName() //如果是文件项，该方法返回文件名，文件名取决于客户端浏览器

void write(java.io.File file) //如果是文件项，将该文件写入对应的文件中

java.io.InputStream getInputStream()

java.io.OutputStream getOutputStream()

 

--------------------------------------------------------------------------------

5. 使用 FileUpload 组件进行实现文件上传的步骤:
<1> 表单的 method=“POST”, enctype=“multipart/form-data”
<2> 创建 FileItemFactory 实例： DiskFileItemFactory factory = new DiskFileItemFactory();
setSizeThreshold 和 setRepository
<3> 创建 ServletFileUplad 实例:  ServletFileUpload upload = new ServletFileUpload(factory);
setSizeMax 和 setFileSizeMax
<4> 使用 ServletFileUpload 实例解析请求，获取FileItem 的 List:                           List  items = upload.parseRequest(request);
<5> 遍历 4 得到的集合, 判断是否为表单域或为文件域。
<6> 表单域相关方法： item.getFieldName()获得表单的名字, item.getString()获得表单中的值。
<7> 文件域相关方法:    item.getName(), getContentType(), getSize()。
<8> 注意1： 在 Servlet 中不能使用 request.getParameter() 方法获取请求参数； 在 JSP 页面上也不能使用 ${param.xxx} 进行数据回显。
<9> 注意2： 关于表单的字符乱码问题。
servletFileUplaod.setHeaderEncoding(“UTF-8”); 可以解决文件域的字符编码问题。
通过 new String(value.getString(“iso-8859-1”), “UTF-8”); 解决表单域的字符编码问题。

 

--------------------------------------------------------------------------------

 

 

 

6. 下面是服务器端 Servlet 代码示例：

 

//文件上传示例程序   
//判断表单是否是 enctype="multipart/form-data"   
if(ServletFileUpload.isMultipartContent(request)){   
                   
                DiskFileItemFactory dfif = new DiskFileItemFactory();   
                dfif.setSizeThreshold(5 * 1024 * 1024); //设定使用内存超过5M时，将产生临时文件并存储于临时目录中。   
                dfif.setRepository(new File("d:\\temp")); //设定存储临时文件的目录。   
                   
                ServletFileUpload fileupload = new ServletFileUpload(dfif);   
                fileupload.setSizeMax(50 * 1024 * 1024); //设定最大允许上传50M的文件。   
                   
                List<FileItem> files = fileupload.parseRequest(request);   
                for(FileItem f:files){   
                    if(f.isFormField()){ //如果该项是表单项，不是文件上传项   
                        out.print(f.getFieldName());   
                        out.print(f.getString("UTF-8")); //因为Web使用是的UTF-8编码，所以客户端返回的也是UTF-8的编码。   
                    }else{   
                       //当判断 item 不为 Form 域时，创建目录和文件的名字
                       String filename = item.getName();
                       String videoFileEnd = filename.substring(
                                   filename.lastIndexOf("."),
                                   filename.length());
                          try {
                                        endname = videoFileEnd.toLowerCase();
                              } catch (Exception e) {
                        }
 
                            File file = new File(path);
                             if(!file.exists()){
                                               file.mkdir();
                              }
    //3. 上传图片
                   File photoFile = new File(path + "/" + name + endname);
                                      item.write(photoFile);
                    }   
                }   
}else{   
                out.print("你所提交的表单有错误！");   
}