美文网首页知识库
JavaWeb实现文件上传与下载

JavaWeb实现文件上传与下载

作者: Java_Evan | 来源:发表于2024-01-16 00:02 被阅读0次

    文件的上传和下载,是非常常见的功能。

    很多的系统中,或者软件中都经常使用文件的上传和下载。

    比如:QQ 头像,就使用了上传。 邮箱中也有附件的上传和下载功能。

    文件的上传

    简单的文件上传测试

    1、创建一个jsp页面,写一个 form 标签,method=post 请求
    2、form 标签的 encType 属性值必须为 multipart/form-data 值
    3、在 form 标签中使用 input type=file 添加上传的文件
    4、编写服务器代码(Servlet 程序)接收,处理上传的数据。
    encType=multipart/form-data 表示提交的数据,以多段(每一个表单项一个数据段)的形式进行拼接,然后以二进制流的形式发送给服务器。

    创建jsp,编写一个form表单的文件上传功能

    <form action="http://localhost:8080/day02-fileupload/upload" method="post" enctype="multipart/form-data">
        文件上传:<input type="file" name="photo"/> <br/>
        <input type="submit" value="上传"/>
      </form>
    

    Servlet读取上传文件内容到控制台

    public class Servlet1 extends HttpServlet {
        @Override
        protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
            System.out.println("文件上传解析...");
            var is = req.getInputStream();
            var buff = new byte[1024];
            int len;
            while ((len = is.read(buff)) != -1) {
                System.out.println(new String(buff, 0, len));
            }
        }
    }
    

    web.xml

    <servlet>
            <servlet-name>servlet1</servlet-name>
            <servlet-class>com.evan.java.Servlet1</servlet-class>
            <load-on-startup>1</load-on-startup>
        </servlet>
        <servlet-mapping>
            <servlet-name>servlet1</servlet-name>
            <url-pattern>/upload</url-pattern>
        </servlet-mapping>
    

    使用第三方jar实现文件上传

    使用apache下的commons-fileupload 对文件上传进行解析。
    文件上传需要的jar包:
    commons-fileupload.jar 需要依赖 commons-io.jar 这个包,所以两个包我们都要引入。
    下载jar地址:https://www.alipan.com/s/fExCJNUx6kh
    提取码: 9x3y
    commons-fileupload.jar 和 commons-io.jar 包中,常用的类:

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

    boolean ServletFileUpload.isMultipartContent(HttpServletRequest request); 判断当前上传的数据格式是否是多段的格式。

    public List 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/day04_listener/upload" method="post" enctype="multipart/form-data">
        用户名:<input type="text" name="username"/> <br/>
        头像:<input type="file" name="photo"/> <br/>
        <input type="submit" value="上传"/>
      </form>
    

    解析文件上传数据的方法

    public class UploadServlet extends HttpServlet {
    
        /**
         * 处理文件上传的数据
         * @param req
         * @param resp
         * @throws ServletException
         * @throws IOException
         */
        @Override
        protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
            //1.判断上传的数据是否是多段(使用多段数据,才是文件上传)
            if (ServletFileUpload.isMultipartContent(req)) {
                //2. 创建FileItemFactory工厂实现类
                FileItemFactory fif = new DiskFileItemFactory();
                //3. 创建用于解析上传数据的工具类ServletFileUpload类
                ServletFileUpload sfu = new ServletFileUpload(fif);
                try {
                    //4. 解析上传的数据,得到每一个表单项FileItem
                    List<FileItem> list = sfu.parseRequest(req);
                    //5. 遍历判断,每一个表单项是普通类型,还是文件上传类型
                    for (FileItem fi : list) {
                        if (fi.isFormField()) {
                            // 普通类型表单项
                            System.out.println("表单项的name属性值:" + fi.getFieldName());
                            //参数UTF-8 解决乱码
                            System.out.println("表单项的value属性值:" + fi.getString("UTF-8"));
                        } else {
                            //上传文件类型表单项
                            System.out.println("表单项的name属性值:" + fi.getFieldName());
                            System.out.println("上传的文件名:" + fi.getName());
                            fi.write(new File("F:\\" + fi.getName()));
                        }
                    }
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
        }
    }
    

    配置web.xml

    <servlet>
        <servlet-name>uploadServlet</servlet-name>
        <servlet-class>com.evan.java.servlet.UploadServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>uploadServlet</servlet-name>
        <url-pattern>/upload</url-pattern>
    </servlet-mapping>
    

    文件下载

    public class DownloadServlet extends HttpServlet {
        /**
         * 文件下载
         * @param req
         * @param resp
         * @throws ServletException
         * @throws IOException
         */
        @Override
        protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
            //1. 获取要下载的文件
            File file = new File("a.jpg");
            //2. 获取要下载的文件内容
            ServletContext servletContext = getServletContext();
            //4. 在响应之前,通过响应头告诉客户端返回的数据类型
            //获取下载文件类型
            String mimeType = servletContext.getMimeType(File.separatorChar
                    + "imgs" + File.separatorChar + file.getName());
            System.out.println("下载的文件类型:" + mimeType);
            resp.setContentType(mimeType);
            //5. 通知客户端收到的数据是用于下载使用(使用响应头)
            /*
            这个响应头告诉浏览器。这是需要下载的。
            而attachment 表示附件,也就是下载的一个文件。
            fileName=后面,表示下载的文件名。
             */
            resp.setHeader("Content-Disposition","attachment; fileName=a.jpg");
            /*
                "/" 斜线被服务器解析的地址是http://ip:port/工程名/  映射到 工程模块的web目录
             */
            //读取文件内容
            InputStream rs = servletContext.getResourceAsStream(File.separatorChar
                    + "imgs" + File.separatorChar + file.getName());
            //获取响应的输出流
            ServletOutputStream os = resp.getOutputStream();
            //3. 将下载的文件内容响应给客户端
            //将读取的文件内容,复制给输出流并响应给客户端
            IOUtils.copy(rs,os);
        }
    }
    

    说明:
    此时虽然可以正常下载,但当下载的文件名为中文时会出现乱码。
    原因是在响应头中,不能包含有中文字符,只能包含 ASCII 码。

    解决文件下载时文件名中文乱码

    方案一: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);
    

    方案二:BASE64 编解码解决火狐浏览器的附件中文名问题
    如果客户端浏览器是火狐浏览器。 那么我们需要对中文名进行 BASE64 的编码操作。
    这时候需要把请求头 Content-Disposition: attachment; filename=中文名
    编码成为:
    Content-Disposition: attachment;filename==?charset?B?xxxxx?=
    =?charset?B?xxxxx?= 现在我们对这段内容进行一下说明。
    =?
    charset
    B
    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);
    }
    

    相关文章

      网友评论

        本文标题:JavaWeb实现文件上传与下载

        本文链接:https://www.haomeiwen.com/subject/lyucodtx.html