文件的上传

Posted 2020-10-03 Actexpler

        曾经喜欢将自己的照片都喜欢上传自己的空间，这就涉及到了web开发中的文件上传功能，文件上传功能是web开发中常见的功能，那他是怎么上传的呢?

文件的上传

1. 简介

> 将一个客户端的本地的文件发送到服务器中保存。

> 上传文件是通过流的形式将文件发送给服务器。

2.前端表单的设置

　　　　

> 向服务器上传一个文件时，表单要使用post请求。

> 表单的默认属性enctype="application/x-www-form-urlencoded"-------------- 这个属性的意思是请求体中的内容将会使用URL编码

> 上传文件的表单enctype需要设置为 multipart/form-data

- multipart/form-data表示的是表单是一个多部件的表单

- 如果类型设置为它，则我们的每一个表单项都会作为一个单独的部件发送给服务器。

- 多个部件之间使用类似 -----------------------------7df2d08c0892 分割符来分开

存在问题： 当表单设置为multipart/form-data时，我们request.getParameter()将失效，我们不能再通过该方法获取请求参数。

解决办法：

一般选择采用apache的开源工具common-fileupload这个文件上传组件。这个common-fileupload上传组件的jar包可以去apache官网上面下载，也可以在struts的lib文件夹下面找到，struts上传的功能就是基于这个实现的。common-fileupload是依赖于common-io这个包的，所以还需要下载这个包。

前端代码：

   <form action="${pageContext.request.contextPath}/FileUpLoad" method="post" enctype="multipart/form-data">
             用户：<input type="text" name="username"><br>
             <input type="file" name="photo"><br>
             <input type="file" name="photo1"><br>
             <input type="file" name="photo2"><br>         
             <input type="submit" value="上传">
     </form>

 

前端：

3. FileUpload

> 我们一般情况下使用commons-fileupload-1.3.1.jar这个工具来解析多部件请求。

> fileupload 依赖 commons-io 所以我们要是Filtupload需要同时导入io包。

 

> 核心类：

DiskFileItemFactory---------------- 工厂类，用于构建一个解析器实例。

ServletFileUpload------------------- 解析器类，通过该类实例来解析request中的请求信息。

 

FileItem

- 工具会将我们请求中每一个部件，都封装为一个FileItem对象，处理文件上传时，只需要调用该对象的方法

- 方法：

boolean isFormField() --> 当前表单项是否是一个普通表单项，true是普通表单项， false是文件表单项

String getContentType() --> 返回的是文件的类型，是MIME值

String getFieldName() --> 获取表单项的name属性值

String getName() --> 获取上传的文件的名字

long getSize() --> 获取文件的大小

String getString(String encoding) --> 获取表单项的value属性值，需要接受一个编码作为参数。

void write(File file) --> 将表单项中的内容写入到磁盘中

 

> 使用步骤：

1.获取工厂类实例[DiskFileItemFactory]

2.获取解析器类实例[ServletFileUpload]

3.解析request获取FileItem[parseRequest()]

 

[4] 细节

第一个问题

> 部分浏览器会将文件的完整路径作为文件名发送。

C:\\Users\\lilichao\\Desktop\\day20\\图片\\蒙娜丽莎.jpg

> 像这类文件名我们需要截取一下字符串，只获取名字这部分，而不需要获取路径部分的信息。

通过如下代码对文件名进行截取字符串的操作：

if(name.contains("\\\\")){

//如果包含则截取字符串

name = name.substring(name.lastIndexOf("\\\\")+1);

}

 

第二个问题

> 上传的文件有可能出现重名，后上传的文件会将先上传的文件覆盖。

> 解决：给文件名加一个唯一的前缀。

唯一标识_fennu.jpg

UUID_fennu.jpg

 

第三个问题

> 有些情况需要限制上传文件的大小。

- 设置单个文件大小为50KB：

fileUpload.setFileSizeMax(1024*50);

- 设置完单个文件大小限制以后，一旦上传的文件超过限制，则会抛出如下异常：

FileSizeLimitExceededException

所有可以对该异常进行捕获，当出现该异常时则设置一个错误消息。

 

- 设置多个文件的总大小为150KB

fileUpload.setSizeMax(1024*150);

- 当多个文件的大小超出范围时，会抛出如下异常

SizeLimitExceededException

 

第四个问题

> 当用户上传一个空的文件，依然会将文件保存到硬盘上。

> 在保存文件应该先对文件的大小进行判断，如果size为0，则不处理。

 

 

 

Servlet实现代码：

package com.neuedu.servlet;
import java.io.File;
import java.io.IOException;
import java.util.List;
import java.util.UUID;
import javax.servlet.ServletContext;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
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.FileUploadBase.FileSizeLimitExceededException;
import org.apache.commons.fileupload.FileUploadBase.SizeLimitExceededException;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

@WebServlet("/FileUpLoad")
public class FileUpLoad extends HttpServlet {
	private static final long serialVersionUID = 1L;

	protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
	    //获取项目
		ServletContext servletContext = request.getServletContext();
		//获取项目路径及文件
		String realPath = servletContext.getRealPath("/upload");
	    File file = new File(realPath);
		//判断文件是否存在---不存在则创建出来
	    if (!file.exists()) {
			file.mkdir();
		}
		//创建一个工厂类
		DiskFileItemFactory factory=new DiskFileItemFactory();
	    //创建对象，完成上传
		ServletFileUpload fileUpload =new ServletFileUpload(factory);
		//单文件大小限制  1024b*50
		fileUpload.setFileSizeMax(1024*50);
		//上传所有文件限制大小
		fileUpload.setSizeMax(1024*150);
		//用这个对象解析request请求
		try {
			List<FileItem> fileList = fileUpload.parseRequest(request);
		    for(FileItem item:fileList){
		    	//isFormField()用于判断当前表单项是否是一个普通表单项，true是普通表单项， false是文件表单项
		        if (item.isFormField()) {
					//代表普通表单项----能获取普通表单的参数
		        	String fieldName = item.getFieldName(); //获取表单项的name属性值
		        	String value = item.getString("utf-8"); //获取表单项的value属性值，需要接受一个编码作为参数。
				   //输出参数
		        	System.out.println(fieldName+":"+value);
		        }else {
		        	
					//代表上传的文件----能获取普通表单的参数
					long size = item.getSize();       //获取文件的大小
				    if (size==0) {
						continue;
					}
					String contentType = item.getContentType();  // 返回的是文件的类型，是MIME值
				    String name2 = item.getName();        // 获取上传的文件的名字
				    String prName = UUID.randomUUID().toString();//利用时间戳，制作唯一标示
				    prName=prName.replaceAll("-", "");    //字符串操作，去掉时间戳的-
				    String reaName=prName+"_"+name2;       //对文件名进行拼串，创造出唯一文件名，防止文件名相同而覆盖
				    String fieldName = item.getFieldName();   //获取表单项的name属性值
				    //输出参数
				    System.out.println(size+":"+fieldName+":"+contentType+":"+name2);
				    //item.write(new File("C:/Users/000/Desktop/234.jpg"));  // 将表单项中的内容写入到磁盘中
				     item.write(new File(realPath+"\\\\"+reaName));// 将表单项中的内容写入到磁盘中
		        }
		    }
		} catch(FileSizeLimitExceededException e){
			System.out.println("文件过大");
		}catch (SizeLimitExceededException e) {
			System.out.println("超处上传文件最大限制");
		}catch ( Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
}

 

执行结果：

控制台：

文件夹：