[Java | Web] JavaWeb——文件上传与下载

已于 2023-09-24 18:03:04 修改
阅读量573 收藏 2
点赞数
分类专栏： Web 文章标签： servlet
于 2023-09-12 17:38:14 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/joyride_run/article/details/132814877
版权

目录

一、文件上传简介

1、文件上传的步骤

2、一个简单的上传 Demo

3、上传的 http 协议内容

4、commons-fileupload.jar 常用 API 介绍

二、文件下载简介

1、文件下载的步骤

2、一个简单的下载 Demo

3、文件名包含中文的解决方法

4、不同浏览器的编码方式

三、示例

1、uploadFile.jsp：

2、downloadFile.jsp：

3、uploadFileServlet 类：

4、downloadFileServlet 类：

5、index.jsp：

6、说明

一、文件上传简介

1、文件上传的步骤

（1）要有一个 form 表单，请求方式为 post 请求（因为上传的文件一般都超出长度限制）。

（2）form 标签的 encType 属性值必须为 multipart/form-data。

表示提交的数据，以多段的形式进行拼接，然后以二进制流的形式发送给服务器。

多段：一个表单项代表一个数据段

（3）在 form 标签中使用 input-type = file 添加上传的文件。

（4）编写服务器代码（Servlet 程序），接收并处理上传的数据。

2、一个简单的上传 Demo

（1）uploadFile.jsp：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
    <base href = "http://localhost:8080/file_war_exploded/"/>
</head>
<body>
    <form action = "./start_uploadFileServlet" method = "POST" enctype = "multipart/form-data">
        用户名：<input type = "text" name = "username"/> <br/>
        头像：<input type = "file" name = "photo"/> <br/>
        <input type = "submit" value = "上传"/>
    </form>
</body>
</html>

（2）uploadFileServlet 类：

package com.servlet;

import javax.servlet.ServletException;
import javax.servlet.http.*;
import java.io.IOException;

public class uploadFileServlet extends HttpServlet {
    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        System.out.println("文件上传成功");
    }
}

3、上传的 http 协议内容

（1）请求体【负载】-【查看源代码】

（2）分析协议内容

（3）服务器如何接收

因为客户端是以流的形式发送的数据，所以服务器也以流的形式接收

package com.servlet;

import javax.servlet.*;
import javax.servlet.http.*;
import java.io.IOException;

public class uploadFileServlet extends HttpServlet {
    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        System.out.println("文件上传成功");
        // 获取流
        ServletInputStream servletIS = req.getInputStream();
        // 缓冲区
        byte[] buffer = new byte[1024000];
        int read = servletIS.read(buffer);
        // 以字符串形式输出
        System.out.println(new String(buffer, 0, read));
    }
}

4、commons-fileupload.jar 常用 API 介绍

在使用之前需要导入两个 jar 包（版本自定）：

  • commons-fileupload-1.2.1.jar
  • commons-io-1.4.jar

（1）常用的类和方法：

  • ServletFileUpload 类：用于解析上传的数据
  • FileItem 类：表示每一个表单项
  • Boolean isMultipartContent( request ) 方法：判断当前上传的数据格式是否为多段的格式（一般文件的格式才是多段的）
  • List<FileItem> parseRequest( request ) 方法：解析上传的数据
  • Boolean isFormField() 方法：判断当前这个表单项，是普通表单项（true），还是上传文件的表单项（false）
  • String getFieldName() 方法：获取表单项的 name 属性值
  • String getString() 方法：获取当前表单项的值（对普通表单项而言就是 value 属性值；对文件而言就是文件）
  • String getName() 方法：获取上传的文件名
  • void write( file ) 方法：将上传的文件写到 file 对象指向的磁盘路径

（2）示例：

package com.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.*;
import javax.servlet.http.*;
import java.io.File;
import java.io.IOException;
import java.util.*;

public class uploadFileServlet extends HttpServlet {
    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        System.out.println("文件上传成功");
        // 先判断上传的数据是否为多段，只有多段的数据才是文件上传的
        if (ServletFileUpload.isMultipartContent(req)) {
            // 创建 FileItemFactory 实现类
            FileItemFactory fileItemFactory = new DiskFileItemFactory();
            // 创建用于解析上传数据的工具类 ServletFileUpload 类
            ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
            try {
                // 解析上传的数据，获得表单项列表 List<FileItem>
                List<FileItem> fileItemList = servletFileUpload.parseRequest(req);
                // 遍历表单项，判断是否为文件
                for (FileItem fileItem : fileItemList) {
                    if (fileItem.isFormField()) { // 普通
                        System.out.println("表单项的name属性值：" + fileItem.getFieldName());
                        System.out.println("表单项的value属性值：" + fileItem.getString("utf-8"));
                    } else { // 文件
                        System.out.println("表单项的name属性值：" + fileItem.getFieldName());
                        System.out.println("上传的文件名：" + fileItem.getName());
                        // 绝对路径保存到本地（服务器）
                        fileItem.write(new File("D:/Programming Project/JavaProject/WebDemoProject/Demo/file/web/src/upload/" + fileItem.getName()));
                    }
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

二、文件下载简介

1、文件下载的步骤

（1）客户端请求下载

（2）服务器获取要下载的文件名，在服务器硬盘读取要下载的文件内容

（3）获取文件数据类型，通过响应头告诉客户端，服务器即将返回此数据类型

（4）通过响应头告诉客户端，返回的文件用于下载，而非显示到浏览器页面上

（5）将资源作为输入流，返回给（输出到）客户端

2、一个简单的下载 Demo

注意：相对路径不要写错了，在浏览器上是不会有报错的。

package com.servlet;

import org.apache.commons.io.IOUtils;

import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;

public class downloadFileServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        // 1.获取要下载的文件名
        String downloadFileName = "R-C.jpg";
        // 2.读取要下载的文件内容（使用ServletContext对象可以读取）
        ServletContext servletContext = getServletContext();
        // 3.获取文件数据类型，并通过响应头告诉客户端，服务器即将返回此数据类型
        String mime = servletContext.getMimeType("./src/upload/" + downloadFileName); // 暂时将 upload 的文件作为可下载的文件
        resp.setContentType(mime);
        // 4.通过响应头告诉客户端，返回的文件用于下载，而非显示到浏览器页面上
        /*
            content-Disposition：表示如何处理数据
            attachment：表示附件
            filename：表示下载的文件名
         */
        resp.setHeader("content-Disposition", "attachment;filename=" + downloadFileName);
        // 5.将资源作为输入流，返回给（输出到）客户端
        InputStream inputStream = servletContext.getResourceAsStream("./src/upload/" + downloadFileName);
        OutputStream outputStream = resp.getOutputStream();
        IOUtils.copy(inputStream, outputStream);
    }
}

3、文件名包含中文的解决方法

这是个非常常见的问题，可以通过 URL 编码以及 Base64 编码这些操作解决。

这两种 encode 都没有进行 decode，解码工作交给了浏览器完成（可以发现下面的示例中，都没有 decode 相关的操作）。

（1）URL 编码

（1-1）使用 URLEncoder 类的 encode 函数，传入文件名和编码格式即可：

String filename = URLEncoder.encode(downloadFileName, "UTF-8");
resp.setHeader("content-Disposition", "attachment;filename=" + filename);

URL 编码会将文件名转化为 %xx%xx 的格式，其中 xx 是十六进制。

（2）Base64 编码

（注意 Base64 有一个老版本是 Base64Encoder，jdk1.9 之后就不再使用了，需要将其更换为 Base64）

（2-1）另外需要注意的是，使用 Base64 编码，对请求头也有一定的编码格式要求：

content-Disposition: attachment; filename == ?charset?B?fileName?=
  • =?        表示编码内容的开始
  • charset        表示字符集
  • B        表示 Base64 编码
  • fileName        表示文件名编码后的内容
  • ?=        表示编码内容的结束

（2-2）示例： 

Base64.Encoder base64Encoder = Base64.getEncoder();
String encode = base64Encoder.encodeToString(downloadFileName.getBytes("UTF-8"));
// 注意 filename==?，== 两端不能有空格
resp.setHeader("content-Disposition", "attachment; filename==?UTF-8?B?" + encode + "?=");

4、不同浏览器的编码方式

上面介绍了两种解决中文编码的方法，但并不是所有浏览器都能兼容某一种方法。因此需要额外判断浏览器是哪一种浏览器。

具体方法就是：用域对象获取请求头中的 User-Agent 的值，然后查看是否包含某种浏览器的关键字。

if (req.getHeader("User-Agent").contains("Chrome")) {
    String filename = URLEncoder.encode(downloadFileName, "UTF-8");
    resp.setHeader("content-Disposition", "attachment; filename=" + filename);
} else {
    // 其他编码方式
}

三、示例

编写简单的上传和下载页面，并作相应操作。

1、uploadFile.jsp：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
    <base href = "http://localhost:8080/file_war_exploded/"/>
</head>
<body>
    <form action = "./start_uploadFileServlet" method = "POST" enctype = "multipart/form-data">
        用户名：<input type = "text" name = "username"/> <br/>
        头像：<input type = "file" name = "uploadPhoto"/> <br/>
        <input type = "submit" value = "上传"/>
    </form>
</body>
</html>

2、downloadFile.jsp：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
    <base href = "http://localhost:8080/file_war_exploded/"/>
</head>
<body>
    <form action = "./start_downloadFileServlet" method = "POST" enctype = "application/x-www-form-urlencoded">
        文件名：<input type = "text" name = "filename"/>
        <input type = "submit" value = "下载"/>
    </form>
</body>
</html>

3、uploadFileServlet 类：

package com.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.*;
import javax.servlet.http.*;
import java.io.File;
import java.io.IOException;
import java.util.*;

public class uploadFileServlet extends HttpServlet {
    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        System.out.println("文件上传成功");
        // 先判断上传的数据是否为多段，只有多段的数据才是文件上传的
        if (ServletFileUpload.isMultipartContent(req)) {
            // 创建 FileItemFactory 实现类
            FileItemFactory fileItemFactory = new DiskFileItemFactory();
            // 创建用于解析上传数据的工具类 ServletFileUpload 类
            ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
            try {
                // 解析上传的数据，获得表单项列表 List<FileItem>
                List<FileItem> fileItemList = servletFileUpload.parseRequest(req);
                // 遍历表单项，判断是否为文件
                for (FileItem fileItem : fileItemList) {
                    if (fileItem.isFormField()) { // 普通
                        System.out.println("表单项的name属性值：" + fileItem.getFieldName());
                        System.out.println("表单项的value属性值：" + fileItem.getString("utf-8"));
                    } else { // 文件
                        System.out.println("表单项的name属性值：" + fileItem.getFieldName());
                        System.out.println("上传的文件名：" + fileItem.getName());
                        // 绝对路径保存到本地（服务器），不是服务器去解析地址，因此不能用 / 映射至工程
                        fileItem.write(new File("D:/Programming Project/JavaProject/WebDemoProject/Demo/file/web/src/upload/" + fileItem.getName()));
                    }
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

4、downloadFileServlet 类：

package com.servlet;

import org.apache.commons.io.IOUtils;

import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
import java.net.URLEncoder;

public class downloadFileServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        // 1.获取要下载的文件名
        String downloadFileName = req.getParameter("filename");
        // 2.读取要下载的文件内容（使用ServletContext对象可以读取）
        ServletContext servletContext = getServletContext();
        // 3.获取文件数据类型，并通过响应头告诉客户端，服务器即将返回此数据类型
        String mime = servletContext.getMimeType("./src/upload/" + downloadFileName); // 暂时将 upload 的文件作为可下载的文件
        resp.setContentType(mime);
        // 4.通过响应头告诉客户端，返回的文件用于下载，而非显示到浏览器页面上
        /*
            content-Disposition：表示如何处理数据
            attachment：表示附件
            filename：表示下载的文件名
         */
        if (req.getHeader("User-Agent").contains("Chrome")) {
            String filename = URLEncoder.encode(downloadFileName, "UTF-8");
            resp.setHeader("content-Disposition", "attachment; filename=" + filename);
        } else {
            // 其他编码方式
        }
        // 5.将资源作为输入流，返回给（输出到）客户端
        InputStream inputStream = servletContext.getResourceAsStream("./src/upload/" + downloadFileName);
        OutputStream outputStream = resp.getOutputStream();
        IOUtils.copy(inputStream, outputStream);
    }
}

5、index.jsp：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>$Title$</title>
    <base href = "http://localhost:8080/file_war_exploded/"/>
</head>
<body>
    <a href = "./jsp/uploadFile.jsp">上传</a> <br/>
    <a href = "./jsp/downloadFile.jsp">下载</a> <br/>
</body>
</html>

6、说明

（1）上传/下载容量较小的文件，使用 GET/POST 都可以（POST 请求更安全）

  • multipart/form-data 是最常用的表单上传属性值

（2）下载时 GET/POST 的区别

  • 使用 GET 请求，那么 form 表单的 enctype 属性值是什么都可以
  • 使用 POST 请求，那么 form 表单的 enctype 属性值必须是 application/x-www-form-urlencoded（默认值）

（3）第（2）点很重要

（4）第（3）点很重要

Varitall
关注
  • 0
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
java文件上传下载工具类
06-28
Java是一门面向对象编程语言，不仅吸收了C++语言的各种优点，还摒弃了C++里难以理解的多继承、指针等概念，因此Java语言具有功能强大和简单易用两个特征。
javaweb文件上传与下载模块源代码
09-29
javaweb文件上传与下载模块源代码 详见内部说明书 适合于初学者，JAVA程序员收藏
JavaWeb中文件的上传和下载
ZHOUJIAN_TANK的博客
04-11 6201
文件上传 文件上传指的是 通过 浏览器 向服务器 上传 某个文件，服务器 接收 到该文件 后 会 将 该文件 存储在 服务器的 硬盘中，通常 不会存在 数据库，这样可以 减轻数据库 的压力并且在文件的 操作上 更加灵活，常见的功能是上传头像图片。 文件上传的原理 所谓的 文件上传 就是服务器端通过 request对象 获取输入流，将浏览器 端上传的 数据读取 出来，保存到 服务器端。 文件上传的...
JavaWeb 文件上传和下载
Cyan_RA9的博客
09-02 2206
JavaWeb——文件上传与下载 内容分享。
java常用的上传下载工具类
最新发布
huangli的博客
03-06 1003
java 上传下载功能
JavaWeb 文件上传下载
ako881010的博客
11-12 694
1.文件上传下载概述 1.1.什么是文件上传下载 所谓文件上传下载就是将本地文件上传到服务器端，从服务器端下载文件到本地的过程。例如目前网站需要上传头像、上传下载图片或网盘等功能都是利用文件上传下载功能实现的。 文件上传下载实际上是两步操作，第一是文件上传，就是将本地文件上传到服务器端，实现文件多用户之间的共享，第二是文件下载，就是将服务器端的文件下载到本地磁盘。 1.2....
JavaWeb实现文件上传和下载功能
哈哈
04-09 7910
通过注解的方式实现文件上传 maxFileSize：单个文件最大的大小 maxRequestSize：在一次请求中，多个文件一共可以多大 在这里插入代码片
java实现文件下载功能
Java小菜鸟
07-26 9695
文件下载功能已经成为现代Web应用程序不可或缺的一部分
Java如何实现下载文件的几种方式
热门推荐
Boy_Martin的博客
07-29 3万+
Java 文件下载
Java下载文件的四种方式详细代码
Super_Xiaoma的博客
11-24 1万+
java下载文件
Javaweb——疫情出入信息管理系统
06-23
疫情出入信息管理系统（其他修改版本） 项目开发工具 1. IDEA 2020.1 2. Navicat Premium 15 项目开发环境 1.java version“1.8.0....有源代码包，数据库文件和说明文件 详细信息分布内容参考 此项目仅供学习使用
java web项目——51商城
04-23
java web项目——51商城，数据库sqlsever，项目详细代码，另附文档说明，步骤不懂可以单独发视频讲解。
java web项目——企业门户网
04-23
java web项目——企业门户网，数据库mysql，全部项目代码，另附文档说明，步骤可以单独提供视频讲解。
java web项目——BBS论坛（程序源论坛）
04-23
java web项目——BBS论坛，数据库mysql，项目详细代码，另附文档说明，步骤不懂可以单独发视频讲解。
java 下载文件
kimi
11-28 918
java 下载文件
java实现文件下载
weixin_70280523的博客
07-31 2134
666
Java实现文件上传和下载的方法详解
weixin_52041354的博客
09-27 5105
参考文章：http://blog.ncmem.com/wordpress/2023/09/27/java%e5%ae%9e%e7%8e%b0%e6%96%87%e4%bb%b6%e4%b8%8a%e4%bc%a0%e5%92%8c%e4%b8%8b%e8%bd%bd%e7%9a%84%e6%96%b9%e6%b3%95%e8%af%a6%e8%a7%a3/编写文件上传的方法, 通过MultipartFile类型的参数即可接收上传的文件, 方法形参的名称需要与页面的file域的name属性一致。
【JavaWeb】之文件上传与下载
小新要变强的博客
10-25 4887
JavaWeb基础文件上传与下载相关知识详细介绍~
在java web中 如何实现浏览次数显示
03-09
可以通过在数据库中创建一个字段来存储浏览次数，每次用户访问该页面时，就将该字段的值加1。在页面中显示浏览次数时，只需要从数据库中读取该字段的值即可。可以使用JSP、Servlet或者框架如Spring MVC来实现。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值