文件上传与下载

2023-10-07 10:14:58

文件上传与下载

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

如：

QQ 头像，就使用了上传。

邮箱中也有附件的上传和下载功能。

OA 系统中审批有附件材料的上传。

文件的上传

要有一个 form 标签，method=post 请求
form 标签的 encType 属性值必须为 multipart/form-data 值
在 form 标签中使用 input type=file 添加上传的文件
编写服务器代码（Servlet 程序）接收，处理上传的数据。

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

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

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

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

ServletFileUpload 类，用于解析上传的数据。
FileItem 类，表示每一个表单项。
boolean ServletFileUpload.isMultipartContent(HttpServletRequest request);
判断当前上传的数据格式是否是多段的格式。
public 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 所指向抽硬盘位置。

fileupload 类库的使用

上传文件的表单：

<form action="http://localhost:8080/05_EL_JSTL/upload" method="post" enctype="multipart/form-data">
        用户名：<input type="text" name="username"><br>
        头像：<input type="file" name="phtot"><br>
        <input type="submit" value="上传">
  </form>

解析上传的数据的代码：

public class UploadServlet extends HttpServlet {

    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        //1.判断上传的数据是不是多段的，多段的数据才是文件上传的
        if(ServletFileUpload.isMultipartContent(request)){
            //2.创建FileItemFactory 工厂实现类
            FileItemFactory dfif = new DiskFileItemFactory();
            //3.创建用于解析上传数据的工具类ServletFileUpload类
            ServletFileUpload sfu = new ServletFileUpload(dfif);
            //4.解析上传数据，得到每一个表单项FileItem
            try {
                List<FileItem> list = sfu.parseRequest(request);
                //5.循环判断， 每一个表单项，是普通类型还是上传的文件
                for (FileItem fileItem : list) {
                    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());
                        try {
                            fileItem.write(new File("E:\\"+fileItem.getName()));
                        } catch (Exception e) {
                            e.printStackTrace();
                        }
                    }
                }
            } catch (FileUploadException e) {
                e.printStackTrace();
            }

        }

    }
}

文件下载

下载的常用 API 说明：

response.getOutputStream();
servletContext.getResourceAsStream();
servletContext.getMimeType();
response.setContentType();

response.setHeader("Content-Disposition", "attachment; fileName=1.jpg");

这个响应头告诉浏览器。这是需要下载的。而attachment 表示附件，也就是下载的一个文件。fileName=后面，表示下载的文件名。

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

显示出正确的中文名，原因是在响应头中，不能包含有中文字符，只能包含ASCII 码。

public class DownLoadServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        //1.获取要下载的文件名
        String downLoadFileName = "test.png";
        //2.读取要下载的内容，通过servletContext对象可以读取
        ServletContext servletContext = getServletContext();
        //3.获取要下载的文件类型
        String mimeType = servletContext.getMimeType("/file/"+downLoadFileName);
        System.out.println("类型:"+mimeType);
        //4.设置响应头告诉客户端返回的数据类型
        response.setContentType(mimeType);
        //5.告诉客户端收到的数据是用于下载使用（未设置则直接显示）
        //Content-Disposition相应头，表示收到的数据怎么处理
        //attachment 表示附件
        //fileName 表示指定下载的文件名
        response.setHeader("Content-Disposition","attachment; fileName=test.png");
            // /斜杠被服务器解析表示地址为http://ip:port/工程名/ 映射到代码的web目录
        InputStream resourceAsStream = servletContext.getResourceAsStream("/file/"+downLoadFileName);
        //6.获取相应的输出流
        OutputStream outputStream = response.getOutputStream();
        //7.读取输入流中的所有数据，复制给输出流，输出给客户端
        IOUtils.copy(resourceAsStream, outputStream);
    }
}

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

方案一

URLEncoder

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

方案二

这时候需要把请求头 Content-Disposition: attachment; filename=中文名

编码成为：Content-Disposition: attachment; filename==?charset?B?xxxxx?=

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

BASE64Encoder：

// 使用下面的格式进行 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);
}

码农公寓

文件上传与下载

文件的上传

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

fileupload 类库的使用

文件下载

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

方案一

方案二

根据浏览器不同选择不同编码

相关文章