commons-fileupload实现文件上传,带你领略不一样的世界

2024-02-14 13:32

本文主要是介绍commons-fileupload实现文件上传,带你领略不一样的世界,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

版权声明:本文为 小异常 原创文章,非商用自由转载-保持署名-注明出处,谢谢!
本文网址:https://blog.csdn.net/sun8112133/article/details/79968573

  文件上传在 WEB 开发中应用的十分广泛,是我们每个 web 开发者应知应会的技术!本篇以实例讲解如何使用 commons-fileupload 工具包实现文件上传,并带你领略 commons-fileupload 中神奇的一幕!  

  简单说一下什么是文件上传?所谓文件上传就是将我们本地的资源文件通过网络传输发送到服务器上。

  文件上传的原理其实是IO流实现的,通过二进制流的方式向服务器传输数据,服务器再通过流读取到数据,然后解析成文件,最终保存到服务器上。

  commons-fileupload 工具包主要是我们用来操作文件上传的小助手,里面封装了对流操作的全过程,大大简化了我们实现文件上传的代码复杂度,只需合理的运用类中的方法就可以达到文件上传的效果。

  下面我们通过一个简单的图片上传小例子带大家走进 commons-fileupload 世界,领略这个小助手给我们带来的神奇效果。
  
  点击这里获取 commons-fileupload源码和jar包。

  图片上传小实例三步走:

    一、热身环节
    二、精彩展示
    三、扩展延伸





一、热身环节

  在讲这个图片上传的小实例之前,得先准备两样东西:两个 jar 包、一个页面。

1、两个 jar 包

  commons-fileupload.jar:这是一个核心 jar包,实现文件上传的核心类及方法都在这里面。

  commons-io.jar:这是一个依赖 jar包,是为了辅助 commons-fileupload 包,此包主要是进行 IO操作的,是 commons-fileupload 的依赖包。

2、一个页面

  准备一个 jsp页面,此页面中要有一个 form表单,此表单的特征如下:

表单的 method 属性值必须是 post;
表单的 enctype 属性值必须是 multipart/form-data;
表单中必须提供至少一个 <input type="file"> 这样的文件上传项。


二、精彩展示

  我们需要建立一个 Servlet 用来处理 表单中的数据,在表单中将 type属性值为file 的数据在以下代码中称为“文件数据项”,其他的称为“普通数据项”。在此 Servlet 中需要涉及到三个类,分别是 DiskFileItemFactory类ServletFileUpload类FileItem类。(小伙伴们在导包操作时,注意要选择导入 commons-fileupload.jar 哦~

  DiskFileitemFactory类负责管理磁盘文件,ServletFileUpload类负责上传和解析文件,FileItem类负责保存每个表单数据项的信息。

1、Servlet 具体代码的实现:
@Override
protected void service(HttpServletRequest request, HttpServletResponse response)throws ServletException, IOException {// 判断是普通表单,还是文件上传表单if (!ServletFileUpload.isMultipartContent(request)) {throw new RuntimeException("不是文件上传表单!");}// 创建上传所需要的两个对象DiskFileItemFactory factory = new DiskFileItemFactory();  // 磁盘文件对象ServletFileUpload sfu = new ServletFileUpload(factory);   // 文件上传对象// 设置解析文件上传中的文件名的编码格式sfu.setHeaderEncoding("utf-8");// 创建 list容器用来保存 表单中的所有数据信息List<FileItem> items = new ArrayList<FileItem>();// 将表单中的所有数据信息放入 list容器中try {items = sfu.parseRequest(request);} catch (FileUploadException e) {e.printStackTrace();}// 遍历 list容器,处理 每个数据项 中的信息for (FileItem item : items) {// 判断是否是普通项if (item.isFormField()) {// 处理 普通数据项 信息handleFormField(item);} else {// 处理 文件数据项 信息handleFileField(item);}}
}
2、两个处理“数据项”信息的方法

  一个用来处理“普通数据项”信息的,另一个是用来处理“文件数据项”信息的。

  1)处理“普通数据项”信息的方法
/*** 处理 普通数据项* @param item*/
private void handleFormField(FileItem item) {// 获取 普通数据项中的 name值String fieldName = item.getFieldName();// 获取 普通数据项中的 value值String value = "";try {value = item.getString("utf-8");  // 以 utf-8的编码格式来解析 value值} catch (UnsupportedEncodingException e) {e.printStackTrace();}// 输出到控制台System.out.println("fieldName:" + fieldName + "--value:" + value);
}
  2)处理“文件数据项”信息的方法
/*** 处理 文件数据项* @param item*/
private void handleFileField(FileItem item) {// 获取 文件数据项中的 文件名String fileName = item.getName();// 判断 此文件的文件名是否合法if (fileName==null || "".equals(fileName)) {return;}// 控制只能上传图片if (!item.getContentType().startsWith("image")) {return;}// 将文件信息 输出到控制台System.out.println("fileName:" + fileName);         // 文件名System.out.println("fileSize:" + item.getSize());   // 文件大小// 获取 当前项目下的 /files 目录的绝对位置String path = this.getServletContext().getRealPath("/files");File file = new File(path);   // 创建 file对象// 创建 /files 目录if (!file.exists()) {file.mkdir();}// 将文件保存到服务器上(UUID是通用唯一标识码,不用担心会有重复的名字出现)try {item.write(new File(file.toString(), UUID.randomUUID()+"_"+fileName));} catch (Exception e) {e.printStackTrace();}
}


三、扩展延伸

1、文件上传的常见限制要求
  1)限制上传文件类别。如:只能上传图片
// 控制只能上传图片
if (!item.getContentType().startsWith("image")) {return;
}
  2)限制上传文件大小。如:单个文件大小不能超过 10KB,总文件大小不能超过 100KB
// 创建上传所需要的两个对象
DiskFileItemFactory factory = new DiskFileItemFactory();  // 磁盘文件对象
ServletFileUpload sfu = new ServletFileUpload(factory);   // 文件上传对象// 限制单个文件的大小
sfu.setFileSizeMax(1024*10);
// 限制上传的总文件大小
sfu.setSizeMax(1024*100);// 创建 list容器用来保存 表单中的所有数据信息
List<FileItem> items = new ArrayList<FileItem>();// 将表单中的所有数据信息放入 list容器中
try {items = sfu.parseRequest(req);
} catch (FileUploadException e) {System.out.println("单个文件大小不能超过10KB,总文件大小不能超过100KB");e.printStackTrace();
}
2、common-fileupload 包中三大核心类
  1)DiskFileItemFactory类

作用:磁盘文件工厂类,它还可以设置缓冲区大小以及设置临时保存位置。

setSizeThreshold( int sizeThreshold ) // 设置缓冲区大小,默认sizeThreshold的大小为:10240(10KB)。 
setRepository( File repository ); // 设置临时文件的保存位置,如果不设置,repository为系统的临时目录。 
DiskFileItemFactory(); // 构造方法,缓冲区大小为默认sizeThreshold和临时文件为目录为默认repository的磁盘文件工厂类。 
DiskFileItemFactory( int SizeThreshold , File repository ); // 构造方法,指定缓冲区大小和指定临时文件的磁盘文件工厂类。
  2)ServletFileUpload类

作用:文件上传类,实现上传的一些实用方法的集合。

public List<FileItem> parseRequest( HttpSevletRequest request ); // 解析request对象,获取表单中的所有数据信息,并返回一个List<FileItem>集合,// 其中每个FileItem就是一个表单数据项信息。
boolean isMultipartContext( HttpServletRequest request ); // 根据请求对象来判断是普通表单,还是文件上传表单,如果是文件上传表单,则返回true,否则false。
setFileSizeMax( long fileSizeMax ); // 设置单个文件的上传的大小上限。 
setSizeMax( long sizeMax ); // 设置总文件上传的大小上限。 
setHeaderEncoding( Charset charset); // 解决上传文件中的文件名中文乱码的问题。 
ServletFileUpload( DiskFileItemFactory factory ); // 构造方法,指定磁盘文件工厂类,并使用factory指定的缓冲区大小和临时文件。 
  3)FileItem类

作用:表单数据项类,保存了表单数据项的所有信息,以下是完整的 FileItem类对象信息。

普通数据项: name=null, StoreLocation=XXX.tmp, size=5 bytes, isFormField=true, FieldName=username

文件数据项: name=要要.jpg, StoreLocation=XXX.tmp, size=8739 bytes, isFormField=false, FieldName=file2

isFormField(); // 判断是否为普通数据项。 
String getFieldName(); // 获取该表单数据项的名称。即:<input>标签中的name属性。 
String getString( String encoding ); // 以指定的编码格式解析该表单数据项的值。即:<input>标签中的value属性。 
String getName();// 获取上传文件中的文件名。 
getInputStream(); // 获取上传文件的内容的输入流,使用文件复制就能完成文件的上传。 
delete();// 删除临时文件。
3、解决中文乱码问题
  1)上传的文件名乱码

  使用 ServletFileUpload类 中的 setHeaderEncoding( String encoding ) 方法。

  2)普通表单数据项的内容乱码

  使用 FileItem 中的 getString( String encoding ) 方法。




这篇关于commons-fileupload实现文件上传,带你领略不一样的世界的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/708633

相关文章

使用Python和OpenCV库实现实时颜色识别系统

《使用Python和OpenCV库实现实时颜色识别系统》:本文主要介绍使用Python和OpenCV库实现的实时颜色识别系统,这个系统能够通过摄像头捕捉视频流,并在视频中指定区域内识别主要颜色(红... 目录一、引言二、系统概述三、代码解析1. 导入库2. 颜色识别函数3. 主程序循环四、HSV色彩空间详解

PostgreSQL中MVCC 机制的实现

《PostgreSQL中MVCC机制的实现》本文主要介绍了PostgreSQL中MVCC机制的实现,通过多版本数据存储、快照隔离和事务ID管理实现高并发读写,具有一定的参考价值,感兴趣的可以了解一下... 目录一 MVCC 基本原理python1.1 MVCC 核心概念1.2 与传统锁机制对比二 Postg

SpringBoot整合Flowable实现工作流的详细流程

《SpringBoot整合Flowable实现工作流的详细流程》Flowable是一个使用Java编写的轻量级业务流程引擎,Flowable流程引擎可用于部署BPMN2.0流程定义,创建这些流程定义的... 目录1、流程引擎介绍2、创建项目3、画流程图4、开发接口4.1 Java 类梳理4.2 查看流程图4

C++中零拷贝的多种实现方式

《C++中零拷贝的多种实现方式》本文主要介绍了C++中零拷贝的实现示例,旨在在减少数据在内存中的不必要复制,从而提高程序性能、降低内存使用并减少CPU消耗,零拷贝技术通过多种方式实现,下面就来了解一下... 目录一、C++中零拷贝技术的核心概念二、std::string_view 简介三、std::stri

C++高效内存池实现减少动态分配开销的解决方案

《C++高效内存池实现减少动态分配开销的解决方案》C++动态内存分配存在系统调用开销、碎片化和锁竞争等性能问题,内存池通过预分配、分块管理和缓存复用解决这些问题,下面就来了解一下... 目录一、C++内存分配的性能挑战二、内存池技术的核心原理三、主流内存池实现:TCMalloc与Jemalloc1. TCM

OpenCV实现实时颜色检测的示例

《OpenCV实现实时颜色检测的示例》本文主要介绍了OpenCV实现实时颜色检测的示例,通过HSV色彩空间转换和色调范围判断实现红黄绿蓝颜色检测,包含视频捕捉、区域标记、颜色分析等功能,具有一定的参考... 目录一、引言二、系统概述三、代码解析1. 导入库2. 颜色识别函数3. 主程序循环四、HSV色彩空间

Python实现精准提取 PDF中的文本,表格与图片

《Python实现精准提取PDF中的文本,表格与图片》在实际的系统开发中,处理PDF文件不仅限于读取整页文本,还有提取文档中的表格数据,图片或特定区域的内容,下面我们来看看如何使用Python实... 目录安装 python 库提取 PDF 文本内容:获取整页文本与指定区域内容获取页面上的所有文本内容获取

基于Python实现一个Windows Tree命令工具

《基于Python实现一个WindowsTree命令工具》今天想要在Windows平台的CMD命令终端窗口中使用像Linux下的tree命令,打印一下目录结构层级树,然而还真有tree命令,但是发现... 目录引言实现代码使用说明可用选项示例用法功能特点添加到环境变量方法一:创建批处理文件并添加到PATH1

Java使用HttpClient实现图片下载与本地保存功能

《Java使用HttpClient实现图片下载与本地保存功能》在当今数字化时代,网络资源的获取与处理已成为软件开发中的常见需求,其中,图片作为网络上最常见的资源之一,其下载与保存功能在许多应用场景中都... 目录引言一、Apache HttpClient简介二、技术栈与环境准备三、实现图片下载与保存功能1.

canal实现mysql数据同步的详细过程

《canal实现mysql数据同步的详细过程》:本文主要介绍canal实现mysql数据同步的详细过程,本文通过实例图文相结合给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的... 目录1、canal下载2、mysql同步用户创建和授权3、canal admin安装和启动4、canal