初学Java Web(7)——文件的上传和下载

文件上传

文件上传前的准备

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

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

<form action="/upload" method="post">
表单默认的编码方式为 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上传组件实现文件的上传，步骤：

将必要的 jar 包导入到项目中

commons-fileupload-1.2.2.jar

commons-io-1.4.jar
简单写好 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>

编写 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 工具类已经足够使用了

文件下载

写一个简单的 jsp 页面：

在 WEB-INF 下创建 download 文件夹，里面放入一个 test.zip
编写 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)——文件的上传和下载的更多相关文章

Java web开发——文件的上传和下载
一. 功能性需求与非功能性需求要求操作便利,一次选择多个文件和文件夹进行上传:支持PC端全平台操作系统,Windows,Linux,Mac 支持文件和文件夹的批量下载,断点续传.刷新页面后继续传输. ...
Java Web之文件的上传及下载
一.文件的上传 1. 简介 > 将一个客户端的本地的文件发送到服务器中保存. > 上传文件是通过流的形式将文件发送给服务器. 2.表单的设置 1.向服务器上传一个文件时,表单要使用post ...
java实现ftp文件的上传与下载
最近在做ftp文件的上传与下载,基于此,整理了一下资料.本来想采用java自带的方法,可是看了一下jdk1.6与1.7的实现方法有点区别,于是采用了Apache下的框架实现的... 1.首先引用3个包 ...
.net web开发——文件的上传和下载
以ASP.NET Core WebAPI 作后端 API ,用 Vue 构建前端页面,用 Axios 从前端访问后端 API ,包括文件的上传和下载. 准备文件上传的API #region 文件上传 ...
java web 实现文件夹上传(保留目录结构)
今天我弄了一下文件夹上传(很简单的首先,我们的html需要这样写 <form action="/file/upload" enctype="multipart/f ...
web开发——文件的上传和下载
众所皆知,web上传大文件,一直是一个痛.上传文件大小限制,页面响应时间超时.这些都是web开发所必须直面的. 本文给出的解决方案是:前端实现数据流分片长传,后面接收完毕后合并文件的思路. 实现文件夹 ...
asp.net web开发——文件的上传和下载
HTML部分 <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="index.a ...
php web开发——文件的上传和下载
PHP用超级全局变量数组$_FILES来记录文件上传相关信息的. 1.file_uploads=on/off 是否允许通过http方式上传文件 2.max_execution_time=30 允许脚本 ...
java web(四):request、response一些用法和文件的上传和下载
上一篇讲了ServletContent.ServletCOnfig.HTTPSession.request.response几个对象的生命周期.作用范围和一些用法.今天通过一个小项目运用这些知识.简单 ...

随机推荐

Linux find用法
Linux中find常见用法示例 ----摘抄哪里忘记了 ·find path -option [ -print ] [ -exec -ok command ] {} ...
Mycat 分片规则详解--单月小时分片
实现方式:单月内按照小时拆分,最小粒度是小时,一天最多可以有24个分片,最少1个分片,下个月从头开始循环优点:使数据按照小时来进行分时存储,颗粒度比日期(天)分片要小,适用于数据采集类存储分片缺点 ...
Maven-07: 插件的自定义绑定
除了内置绑定以外,用户还能够自己选择将某个插件目标绑定到生命周期的某个阶段上,这种自定义绑定方式能让Maven项目在构建过程中执行更多更富特色的任务. 一个常见的例子是创建项目的源码jar包.内置的插 ...
Android 使用shape定义不同控件的的颜色、背景色、边框色
Android 使用shape定义不同控件的的颜色.背景色.边框色设置按钮的右边框和底边框颜色为红色,边框大小为3dp: 在drawable新建一个 buttonstyle.xml的文件,内容如下: ...
JVM学习七：JVM之类加载器之类的卸载
类加载的过程和原理,以及双亲委派机制都已经讲解完成,那么我们今天讲解类加载的最后一节,那么就是类的卸载. 我们知道,当一个类被加载.连接和初始化之后,他的生命周期就开始了,当该类的class对象不再被 ...
分析 webpack 打包后的代码
写在前面的:使用的 webpack 版本 3.0.0 一.开始 1. 准备当前只创建一个文件 index.js,该文件作为入口文件,代码如下. console.log('hello, world') ...
Oracle查询优化改写--------------------操作多个表
一.union all与空字符串二.组合相关行三.in .exists.inter join .left join .right join .full join 之间的区别 'inner joi ...
云计算--网络原理与应用--20171123--网络地址转换NAT
NAT的概述 NAT的配置实验一. NAT的概述 NAT(Network address translation,网络地址转换)通过将内部网络的的私有地址翻译成全球唯一的共有网络IP地址,是内部网 ...
Beta 集合
Beta冲刺序列: Beta凡事预则立 :Beta No.0 Beta冲刺Day1:Beta No.1 Beta冲刺Day2:Beta No.2 Beta冲刺Day3:Beta No.3 Beta冲刺 ...
1013团队alpha冲刺日志集合帖
alpha冲刺day1 alpha冲刺day2 alpha冲刺day3 alpha冲刺day4 alpha冲刺day5 alpha冲刺day6 alpha冲刺day7 alpha冲刺day8 alph ...