文件上传

文件上传前的准备

  1. 在表单中必须有一个上传的控件

    <input type="file" name="testImg"/>
  2. 因为 GET 方式有请求大小的限制,所以表单的提交方式必须是 POST

    <form action="/upload" method="post">
  3. 表单默认的编码方式为 application/x-www-form-urlencoded ,应该修改为 multipart/form-data以二进制的形式进行数据的传输

    <form action="/upload" method="post" enctype="multipart/form-data">
  • 注意:此时 Servlet 中就不能再使用 request对象.getParameter(String name) 来获取请求参数

上传组件

实现文件的上传,需要基于以下两种组件的一种:

  • Apache FileUpload 组件【操作比较复杂】
  • SmartUpload 组件【操作比较简单,但存在一些问题】

基于 FileUpload 组件

使用基于Apache FileUpload上传组件实现文件的上传,步骤:

  1. 必要的 jar 包导入到项目中

    commons-fileupload-1.2.2.jar

    commons-io-1.4.jar
  2. 简单写好 upload.jsp 上传页面:
<!DOCTYPE html>
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8" import="java.util.*" %>
<html>
<head>
<title>文件的上传和下载</title>
</head>
<body> 文件上传:
<form action="/upload" method="post" enctype="multipart/form-data">
<input type="file" name="testImg"/> <br>
<input type="submit"/>
</form> </body>
</html>

  1. 编写 UploadServlet 处理相关请求:
package servlet;

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileItemFactory;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload; 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 java.io.File;
import java.io.IOException;
import java.util.List; @WebServlet("/upload")
public class UploadServlet extends HttpServlet { protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 验证请求是否满足要求(post 请求 / enctype 是否以multipart打头
boolean isMultipart = ServletFileUpload.isMultipartContent(req);
// 如果不满足要求就立即结束对该请求的处理
if (!isMultipart) {
return;
} try {
// FileItem 是表单中的每一个元素的封装
// 创建一个 FileItem 的工厂类
FileItemFactory factory = new DiskFileItemFactory();
// 创建一个文件上传处理器(装饰设计模式)
ServletFileUpload upload = new ServletFileUpload(factory);
// 解析请求
List<FileItem> items = upload.parseRequest(req);
for (FileItem fileItem :
items) {
// 判断空间是否是普通控件
if (fileItem.isFormField()) {
// 普通控件
} else {
// 上传控件
// 将上传的文件保存到服务器
fileItem.write(new File("C:/", "testImg.jpg"));
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
}

文件上传的细节

上面已经能实现简单的文件上传功能了,但文件上传有很多需要注意的地方。

  • 缓存大小和临时目录

    在上传文件的时候,如果文件过大,而且是将文件放在缓存中,就可能造成内存溢出

    默认的缓存大小为 10 kb,临时目录的默认值为 tomcat/temp
  • 解决方案:将操作缓存大小的文件放在服务器的磁盘(临时目录)中,在文件的大小超过设定的缓存大小的时候就会使用到临时目录
// 设置缓存大小 500kb
factory.setSizeThreshold(1024*500);
// 设置临时目录
factory.setRepository(new File("C:/"));
  • 通常不需要设置

另一个问题是:如果用户 A 上传了一个文件名叫xxx,用户 B 也上传了一个文件名叫 xxx,那么此时用户 B 的文件会把用户 A 的文件给覆盖掉。

  • 文件名称的处理

    相同文件名称的文件,后面的文件会把前面的文件覆盖掉
  • 解决方案:使用UUID来生成一个随机的而且不重复字符串作为文件的名称,获取真实文件的后缀名需要用到 FilenameUtils 这个工具类
  • 语法:
String fileName = UUID.randomUUID().toString()+"."+FilenameUtils.getExtension(fileItem.getName());

文件类型的约束

上传文件的类型应该需要做一些约束的,比如在上传头像的时候就只允许上传图片,其他类型的文件都不应该允许上传,并且如果类型不正确的时候,应该给用户一个错误的提示。

  • jsp 文件增加显示错误提示信息:

    我们给我们的 jsp 开头增加一个 <span> 来显示错误信息
<!DOCTYPE html>
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8" import="java.util.*" %>
<html>
<head>
<title>文件的上传和下载</title>
</head>
<body> 文件上传:<span>${errorMsg}</span>
<form action="/upload" method="post" enctype="multipart/form-data">
<input type="file" name="testImg"/> <br>
<input type="submit"/>
</form> </body>
</html>
  • 判断上传文件类型:

    限制文件类型那么就需要对文件类型进行判断
  • 语法:String contentType = fileItem.getContentType();
  • Servlet 源码:
package servlet;

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileItemFactory;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import org.apache.commons.io.FilenameUtils; 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 java.io.File;
import java.io.IOException;
import java.util.List;
import java.util.UUID; @WebServlet("/upload")
public class UploadServlet extends HttpServlet { protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 验证请求是否满足要求(post 请求 / enctype 是否以multipart打头
boolean isMultipart = ServletFileUpload.isMultipartContent(req);
// 如果不满足要求就立即结束对该请求的处理
if (!isMultipart) {
return;
} try {
// FileItem 是表单中的每一个元素的封装
// 创建一个 FileItem 的工厂类
FileItemFactory factory = new DiskFileItemFactory();
// 创建一个文件上传处理器(装饰设计模式)
ServletFileUpload upload = new ServletFileUpload(factory);
// 解析请求
List<FileItem> items = upload.parseRequest(req);
for (FileItem fileItem :
items) {
// 判断空间是否是普通控件
if (fileItem.isFormField()) {
// 普通控件
} else {
// 上传控件
String contentType = fileItem.getContentType();
if (!contentType.startsWith("image/")) {
// 实现简单的错误提示
req.setAttribute("errorMsg", "亲,您上传的文件格式不正确,请重新上传!");
req.getRequestDispatcher("upload.jsp").forward(req, resp);
return; // 如果不是图片类型则不再对请求进行处理
}
// 随机命名文件名
String fileName = UUID.randomUUID().toString() + "." + FilenameUtils.getExtension(fileItem.getName());
// 将上传的文件保存到服务器
fileItem.write(new File("C:/", fileName));
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
}

解决中文乱码问题

  • 解决中文文件名乱码(事实上我在本地测试并没有出现乱码),得到解析器以后,就直接设置解析器的编码为UTF-8就行了
 fileUpload.setHeaderEncoding("UTF-8");
  • 解决表单数据乱码,在获取表单值的时候,按照UTF-8编码来获取
String value = fileItem.getString("UTF-8");

文件大小约束

  • 单个文件数据的大小约束

    即整个表单之中只有一个上传控件
  • 语法:upload.setFileSizeMax(1024 * 500); // 单个文件不能超过500 kb
  • 一次请求数据的大小约束

    限制整个请求之中的数据大小
  • 语法:upload.setSizeMax(1024 * 750); // 整个请求文件大小不能超过 750 kb

使用 Map 封装请求信息

上面提到,我们已经无法用 request对象正常获取到参数,那么我们究竟应该怎么办呢?

  • 使用 Map 封装一下就好了,等到要用的时候再从 Map 中取出


SmartUpload

上面已经基于 FileUpload 实现了文件的上传,事实上也没有想象中那么复杂,让我们来看看 SmartUpload

要使用SmartUpload组件,就需要导入smartupload.jar开发包

快速入门

//实例化组件
SmartUpload smartUpload = new SmartUpload(); //初始化上传操作
smartUpload.initialize(this.getServletConfig(), request, response); try { //上传准备
smartUpload.upload(); //对于普通数据,单纯到request对象是无法获取得到提交参数的。也是需要依赖smartUpload
String password = smartUpload.getRequest().getParameter("password");
System.out.println(password); //上传到uploadFile文件夹中
smartUpload.save("uploadFile"); } catch (SmartUploadException e) {
e.printStackTrace();
}
  • 摘自:这里
  • 上面链接提到 SmartUpload 组件在解决中文乱码中有一些小问题,我没有测试过,但我觉得自己写一个 FileUpload 工具类已经足够使用了

文件下载

  1. 写一个简单的 jsp 页面:

  1. 在 WEB-INF 下创建 download 文件夹,里面放入一个 test.zip
  2. 编写 Servlet 处理相关请求
package servlet;

import javax.servlet.ServletException;
import javax.servlet.ServletOutputStream;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.IOException;
import java.net.URLEncoder;
import java.nio.file.Files;
import java.nio.file.Paths; @WebServlet("/download")
public class DownloadServlet extends HttpServlet { protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { // 设置响应数据的 MIME 类型
resp.setContentType("application/x-msdownload");
// 获取文件名称
String fileName = req.getParameter("fileName");
// 判断浏览器是否是 IE
String userAgent = req.getHeader("User-Agent");
if (userAgent.contains("MSIE")) {
// IE
// 设置文件的名称
resp.setHeader("Content-Disposition", "attachment; fileName="
+ URLEncoder.encode(fileName, "UTF-8"));
} else {
// 非IE
resp.setHeader("Content-Disposition", "attachment; fileName="
+ new String(fileName.getBytes("UTF-8"), "ISO-8859-1"));
} // 获取文件所在的路径
String path = req.getServletContext().getRealPath("/WEB-INF/download"); // 获取指定的文件对象
File f = new File(path, fileName);
ServletOutputStream out = resp.getOutputStream();
// 将文件复制到输出流中,响应给浏览器
Files.copy(Paths.get(f.getAbsolutePath()), out);
}
}

欢迎转载,转载请注明出处!

简书ID:@我没有三颗心脏

github:wmyskxz

欢迎关注公众微信号:wmyskxz_javaweb

分享自己的Java Web学习之路以及各种Java学习资料

初学Java Web(7)——文件的上传和下载的更多相关文章

  1. Java web开发——文件的上传和下载

    一. 功能性需求与非功能性需求 要求操作便利,一次选择多个文件和文件夹进行上传:支持PC端全平台操作系统,Windows,Linux,Mac 支持文件和文件夹的批量下载,断点续传.刷新页面后继续传输. ...

  2. Java Web之文件的上传及下载

    一.文件的上传 1. 简介 > 将一个客户端的本地的文件发送到服务器中保存. > 上传文件是通过流的形式将文件发送给服务器. 2.表单的设置 1.向服务器上传一个文件时,表单要使用post ...

  3. java实现ftp文件的上传与下载

    最近在做ftp文件的上传与下载,基于此,整理了一下资料.本来想采用java自带的方法,可是看了一下jdk1.6与1.7的实现方法有点区别,于是采用了Apache下的框架实现的... 1.首先引用3个包 ...

  4. .net web开发——文件的上传和下载

    以ASP.NET Core WebAPI 作后端 API ,用 Vue 构建前端页面,用 Axios 从前端访问后端 API ,包括文件的上传和下载. 准备文件上传的API #region 文件上传  ...

  5. java web 实现文件夹上传(保留目录结构)

    今天我弄了一下文件夹上传(很简单的 首先,我们的html需要这样写 <form action="/file/upload" enctype="multipart/f ...

  6. web开发——文件的上传和下载

    众所皆知,web上传大文件,一直是一个痛.上传文件大小限制,页面响应时间超时.这些都是web开发所必须直面的. 本文给出的解决方案是:前端实现数据流分片长传,后面接收完毕后合并文件的思路. 实现文件夹 ...

  7. asp.net web开发——文件的上传和下载

    HTML部分 <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="index.a ...

  8. php web开发——文件的上传和下载

    PHP用超级全局变量数组$_FILES来记录文件上传相关信息的. 1.file_uploads=on/off 是否允许通过http方式上传文件 2.max_execution_time=30 允许脚本 ...

  9. java web(四):request、response一些用法和文件的上传和下载

    上一篇讲了ServletContent.ServletCOnfig.HTTPSession.request.response几个对象的生命周期.作用范围和一些用法.今天通过一个小项目运用这些知识.简单 ...

随机推荐

  1. 以太坊挖矿源码:ethash算法

    本文具体分析以太坊的共识算法之一:实现了POW的以太坊共识引擎ethash. 关键字:ethash,共识算法,pow,Dagger Hashimoto,ASIC,struct{},nonce,FNV ...

  2. SpringBoot更改HttpMessageConverters使用FastJson出现乱码问题

    1.出现问题的现象!如下截图,使用SpringBoot 进行开发,接口返回的内容出现中文乱码? 接口内容想要返回的内容: 页面返回内容: 惊喜不?意外不? 为什么出现这个情况?不例外的话,很多同事都是 ...

  3. 理解python的元类

    看了一篇文档,借鉴一下!写下自己对python元类的理解,欢迎各位大神给出意见. 我的理解就是 type用来创建元类,元类用来创建类,类用来创建实例 这样一想,是不是可以认为元类创建类的过程等同于类创 ...

  4. 源码实现 --> atoi函数实现

    atoi函数实现 atoi()函数的功能是将一个字符串转换为一个整型数值. 例如“12345”,转换之后的数值为12345,“-0123”转换之后为-123. #include <stdio.h ...

  5. 打印十字图 JAVA 递归实现

    这个是我自己想的,头疼了一个下午,不过还好.做出来了.在网上找这道题但没有找到用递归的做法. /*递归思想实现 * 标题:打印十字图 小明为某机构设计了一个十字型的徽标(并非红十字会啊),如下所示(可 ...

  6. 连接数据后,当执行查询语句报错:ORA-01219: 数据库未打开: 仅允许在固定表/视图中查询

    参考博客:http://blog.csdn.net/lanchengxiaoxiao/article/details/40982771 1.在cmd窗口通过sqlplus连接数据库 C:\Users\ ...

  7. VS2005 与虚拟机的那点事

      好不容易把VS2008装上了,每次F5编译的时候,程序自动退出,意外的是VS2005也是同样的结果.好在有像我一样的好心人,愿意把解决的方法与大家共享.     经过搜索找到了答案,原来是VMwa ...

  8. Java ftp 上传文件和下载文件

    今天同事问我一个ftp 上传文件和下载文件功能应该怎么做,当时有点懵逼,毕竟我也是第一次,然后装了个逼,在网上找了一段代码发给同事,叫他调试一下.结果悲剧了,运行不通过.(装逼失败) 我找的文章链接: ...

  9. poj 2142 The Balance

    The Balance http://poj.org/problem?id=2142 Time Limit: 5000MS   Memory Limit: 65536K       Descripti ...

  10. EVA 4400存储硬盘故障数据恢复方案和数据恢复过程

    EVA系列存储是一款以虚拟化存储为实现目的的HP中高端存储设备,平时数据会不断的迁移,加上任务通常较为繁重,所以磁盘的负载相对是较重的,也是很容易出现故障的.EVA是依靠大量磁盘的冗余空间,以及故障后 ...