文件的上传和下载

最新推荐文章于 2022-10-05 12:15:46 发布

磊哥的小迷妹

最新推荐文章于 2022-10-05 12:15:46 发布

阅读量447

点赞数

分类专栏：笔记文章标签：服务器 java

本文链接：https://blog.csdn.net/qq_48496502/article/details/122067273

版权

笔记专栏收录该内容

112 篇文章 3 订阅

订阅专栏

文件的上传和下载

1、文件的上传介绍
2、文件下载

文件的上传和下载，是非常常见的功能，很多的系统中，或者软件中都经常使用文件的上传和下载

比如：
QQ 头像，就使用了上传
邮箱中也有附件的上传和下载功能
OA 系统中审批有附件材料的上传

1、文件的上传介绍

要有一个 form 标签，method=post 请求
因为 GET 请求方式有长度限制，所以使用 POST 请求
form 标签的 encType 属性值必须为 multipart/form-data 值
enctype="multipart/form-data"
在 form 标签中使用文件标签添加上传的文件
<input type="file">
编写服务器代码（Servlet 程序）接收，处理上传的数据

encType=multipart/form-data 表示提交的数据，以多段（每一个表单项一个数据段）的形式进行拼接，然后以二进制流的形式发送给服务器

1.1、文件上传，HTTP 协议的说明

在这里插入图片描述

在这里插入图片描述
因为提交的数据是以二进制流的形式发送给服务器，所以接收的话也只能以流的方式接收

public class TestServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        ServletInputStream inputStream = request.getInputStream();
        byte[] b = new byte[102400000];
        int len;
        while((len = inputStream.read(b)) != -1){
            String s = new String(b,0,len);
            System.out.println(s);
        }
    }
}

在这里插入图片描述

1.2、commons-fileupload.jar 常用 API 介绍说明

commons-fileupload.jar 需要依赖 commons-io.jar 这个包，所以两个包我们都要引入

第一步，就是需要导入两个 jar 包：
commons-fileupload-1.2.1.jar
commons-io-1.4.jar

commons-fileupload.jar 和 commons-io.jar 包中，我们常用的类有哪些？

ServletFileUpload 类，用于解析上传的数据。
FileItem 类，表示每一个表单项。

boolean ServletFileUpload.isMultipartContent(HttpServletRequest request);判断当前上传的数据格式是否是多段的格式（只有是多段的数据，才是文件上传的）

List<FileItem> parseRequest(HttpServletRequest request) 解析上传的数据，返回多个表单项组成的集合

boolean FileItem.isFormField()判断当前这个表单项，是普通的表单项，还是上传的文件类型
true 表示普通类型的表单项，false 表示上传的文件类型

String FileItem.getFieldName() 获取表单项的 name 属性值

String FileItem.getString() 获取当前表单项的值，用户输入的参数值

String FileItem.getName() 获取上传的文件名

void FileItem.write( file ) 将上传的文件写到参数 file 所指向的硬盘位置

1.3、fileupload 类库的使用

上传文件的表单：

<body>
<form action="http://localhost:8080/jsp/testServlet" method="post" enctype="multipart/form-data">
    用户名：<input type="text" name="username"><br/>
    头像：<input type="file" name="photo"><br/>
    <input type="submit">
</form>
</body>

解析上传的数据的代码：

以下代码实现输出表单项的部分属性，以及将上传的文件复制一份输出到指定硬盘位置

public class TestServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        //1、判断当前上传的数据格式是否是多段的格式（只有是多段的数据，才是文件上传的）
        try {
            if (ServletFileUpload.isMultipartContent(request)){
                //创建 FileItemFactory 工厂实现类
                FileItemFactory fileItemFactory = new DiskFileItemFactory();
                //2、 创建用于解析上传数据的工具类 ServletFileUpload 类
                //但是里面需要传入 FileItemFactory 的对象
                ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
                //3、 解析上传的数据，返回多个表单项组成的集合
                List<FileItem> list = servletFileUpload.parseRequest(request);
                //4、 循环判断，每一个表单项，是普通类型，还是上传的文件
                for (FileItem fileItem : list) {
                    //5、判断当前这个表单项，是普通的表单项，还是上传的文件类型
                    //true 表示普通类型的表单项 ，false 表示上传的文件类型
                    if (fileItem.isFormField()) {
                        // 普通表单项
                        System.out.println("表单项的 name 属性值：" + fileItem.getFieldName());
                        // 参数 UTF-8.解决乱码问题
                        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:\\afei\\"+fileItem.getName())); }
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

控制台输出：
在这里插入图片描述
文件复制一份放在指定硬盘位置：

2、文件下载

文件下载分析：
在这里插入图片描述
注意：

文件下载使用 GET 请求方式
要下载的文件存放在代码目录的 web 目录下
运行时候如果 IDEA 没有报错，但是浏览器运行没有预料的效果，可以 F12 打开开发者模式，查看控制台输出的异常信息

public class TestServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        //1、获取要下载的文件名
        String filename = "1.jpg";

        ServletContext servletContext = getServletContext();
        //4、在回传前，通过响应头告诉客户端返回的数据类型
            //4.1、 获取要下载的文件类型
        String type = servletContext.getMimeType("/" + filename);
            //4.2、 设置响应头，告诉客户端类型
        response.setContentType(type);
        //5、在回传前，通过响应头告诉客户端收到数据是用于下载，而不是浏览器显示
            // Content-Disposition 响应头，表示收到的数据怎么处理
            // attachment 表示附件，说明收到的数据下载使用
            // filename=  表示指定下载的文件名
        response.setHeader("Content-Disposition","attachment;filename="+filename);
        //2、读取要下载的文件内容，可以通过 ServletContext 对象读取
            //以流的方式读取文件内容，斜杠 / 表示地址为：http://ip:port/工程名/，映射到 IDEA 代码的 web 目录
        InputStream inputstream = servletContext.getResourceAsStream("/" + filename);
        //获取一个响应的输出流
        ServletOutputStream outputStream = response.getOutputStream();
        //3、将下载的文件内容回传给客户端
        //将读取到的流数据，全部复制给响应的输出流
        IOUtils.copy(inputstream,outputStream);
    }
}

执行结果：

有了第五步，进入网页就自动下载，如果没有第五步，就仅仅是在浏览器显示文件
在这里插入图片描述

下载的常用 API 说明：
response.getOutputStream();
servletContext.getResourceAsStream();
servletContext.getMimeType();
response.setContentType();

完成上面步骤，下载文件是没问题了，但是如果我们要下载的文件是中文名的话，你会发现，下载无法正确显示出正确的中文名

原因是在响应头中，不能包含有中文字符，只能包含 ASCII 码

附件中文名称乱码问题解决方案

2.1、URLEncoder 解决 IE 和谷歌浏览器的附件中文名问题

如果客户端浏览器是 IE 浏览器或者是谷歌浏览器，我们需要在第五步中使用 URLEncoder 类先对中文名进行 UTF-8 的编码操作

因为 IE 浏览器和谷歌浏览器收到含有编码后的字符串后会以 UTF-8 字符集进行解码显示

// 把中文名进行 UTF-8 编码操作
String str = "attachment;fileName=" + URLEncoder.encode("中文.jpg", "UTF-8"); 
// 然后把编码后的字符串设置到响应头中 
response.setHeader("Content-Disposition", str);

2.2、BASE64 编解码介绍

BASE64 编码

    public static void main(String[] args) throws Exception {
        String s = "这是需要 BASE64 编码的内容";
        //创建一个 BASE64 编码器
        BASE64Encoder encoder = new BASE64Encoder();
        //执行 BASE64 编码操作
        String s1 = encoder.encode(s.getBytes("UTF-8"));
        System.out.println(s1);    //6L+Z5piv6ZyA6KaBIEJBU0U2NCDnvJbnoIHnmoTlhoXlrrk=
    }

BASE64 解码

    public static void main(String[] args) throws Exception {
        //创建一个 BASE64 解码器
        BASE64Decoder decoder = new BASE64Decoder();
        //解码操作
        byte[] bytes = decoder.decodeBuffer(s1);
        String s2 = new String(bytes, "UTF-8");
        System.out.println(s2);    //这是需要 BASE64 编码的内容
    }

2.3、BASE64 编解码解决火狐浏览器的附件中文名问题

如果客户端浏览器是火狐浏览器。那么我们需要对中文名进行 BASE64 的编码操作

这时候需要把请求头
Content-Disposition: attachment; filename=中文名
编码成为：
Content-Disposition: attachment; filename==?charset?B?xxxxx?=

=?charset?B?xxxxx?= 现在我们对这段内容进行一下说明。
=? 表示编码内容的开始
charset 表示字符集
B 表示 BASE64 编码
xxxx 表示文件名经过 BASE64 编码之后的内容
?= 表示编码内容的结束

在第五步中使用就是如下效果

// 使用下面的格式进行 BASE64 编码后 
String str = "attachment; fileName==?utf-8?B?" 
	+ 
	new BASE64Encoder().encode("中文.jpg".getBytes("utf-8"))
	+ "?=";  
// 设置到响应头中 
response.setHeader("Content-Disposition", str);

动态处理不同浏览器的乱码问题

那么我们如何解决上面两种不同编解码方式呢？

我们只需要通过判断请求头中 User-Agent 这个请求头携带过来的浏览器信息即可 判断出是什么浏览器

如下：

String ua = request.getHeader("User-Agent"); 
// 判断是否是火狐浏览器 
if (ua.contains("Firefox")) { 
	// 使用下面的格式进行 BASE64 编码后 
	String str = "attachment; fileName=" + "=?utf-8?B?" + new BASE64Encoder().encode("中文.jpg".getBytes("utf-8")) + "?="; 
	// 设置到响应头中 
	response.setHeader("Content-Disposition", str); 
} else { 
	// 把中文名进行 UTF-8 编码操作
	String str = "attachment; fileName=" + URLEncoder.encode("中文.jpg", "UTF-8"); 
	// 然后把编码后的字符串设置到响应头中 
	response.setHeader("Content-Disposition", str); 
 }