一、文件的上传(**重点)

1. 使用场景

  • QQ头像上传
  • Email中附件
  • OA审批中材料的上传

    2. 要求

  • 客户端:jsp文件
    • 1、 要有一个 form 标签, method=post 请求
    • 2、 form 标签的 encType 属性值必须为 multipart/form-data 值
      • encType=multipart/form-data 表示提交的数据, 以多段(每一个表单项一个数据段) 的形式进行拼接, 然后以二进制流的形式发送给服务器
    • 3、 在 form 标签中使用 input type=file 添加上传的文件
  • 服务器端: servlet接收

    • 1、 编写服务器代码(Servlet 程序) 接收, 处理上传的数据。
  • 示例:upload.jsp:

    1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
    2. <html>
    3. <head>
    4. <title>Title</title>
    5. </head>
    6. <body>
    7. <form action="http://192.168.31.74:8080/09_EL_JSTL/uploadServlet" method="post" enctype="multipart/form-data">
    8. 用户名:<input type="text" name="username" /> <br>
    9. 头像:<input type="file" name="photo" > <br> // 就可以实现客户端的upload过程
    10. <input type="submit" value="上传">
    11. </form>
    12. </body>
    13. </html>
  • 在web.xml中 配置servlet

    <servlet>
          <servlet-name>UploadServlet</servlet-name>    // 代码中的类名
          <servlet-class>com.atguigu.servlet.UploadServlet</servlet-class>
      </servlet>
      <servlet-mapping>
          <servlet-name>UploadServlet</servlet-name>   // 服务器去查询的类名,以便进行反应,满足功能
          <url-pattern>/uploadServlet</url-pattern>  //客户端搜索的地址
      </servlet-mapping>
    
  • 服务器端: uploadServlet.java ```java package com.atguigu.servlet;

import javax.servlet.ServletException; import javax.servlet.ServletInputStream; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException;

public class UploadServlet extends HttpServlet { /**

 * 处理文件上传的数据
 *      客户端以流的形式发送上传数据,服务器也需要以流的形式读取文件
 * @param req
 * @param resp
 * @throws ServletException
 * @throws IOException
 */
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
    ServletInputStream inputStream = req.getInputStream();
    byte[] buffer = new byte[1024000];
    int read = inputStream.read(buffer);
    System.out.println(new String(buffer,0,read));
}

}


<a name="BN7aX"></a>
### 3. 文件上传时, 浏览器解析的HTTP 协议的说明
![image.png](https://cdn.nlark.com/yuque/0/2021/png/22435741/1629805306883-4215c752-34af-4f57-a02d-3d863b6613a9.png#crop=0&crop=0&crop=1&crop=1&height=539&id=fRZHt&margin=%5Bobject%20Object%5D&name=image.png&originHeight=539&originWidth=1199&originalType=binary&ratio=1&rotation=0&showTitle=false&size=446434&status=done&style=none&title=&width=1199)
<a name="o7OJA"></a>
### 4. 其他已经封装好了的上传文件的APIcommons-fileupload.jar 

- commons-fileupload.jar  (commons-fileupload.jar 需要依赖 commons-io.jar 这个包, 所以两个包我们都要引入)
- 常用的类:
   - ServletFileUpload 类, 用于解析上传的数据
   - FileItem 类, 表示每一个表单项
- 常用的API:
   - 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.getString()
   - String FileItem.getName();    // 获取上传的文件名
   - void FileItem.write( file );    // 将上传的文件写到 参数 file 所指向抽硬盘位置

- 实例展示 :UploadServlet.java
```java
package com.atguigu.servlet;

import com.sun.scenario.effect.impl.sw.sse.SSEBlend_SRC_OUTPeer;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileItemFactory;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

import javax.servlet.ServletException;
import javax.servlet.ServletInputStream;
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;

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)){
            // 1.1 创建FileItemFactory实现类
            FileItemFactory fileItemFactory = new DiskFileItemFactory();
            // 1.2 用于解析上传数据的工具类ServletFileUpload
            ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
            // 1.3 解析上传的数据,得到每一个表单项FileItem
            try {
                List<FileItem> list = servletFileUpload.parseRequest(req);
                // 2. 判断每个表单项是普通类型,还是上传了文件
                for (FileItem fileItem : list) {
                    // 2.1 普通表单项
                    if(fileItem.isFormField()){
                        // 2.1.1 upload.jsp表单项第一项: 用户名:<input type="text" name="username" /> <br>
                        System.out.println("表单项的name属性值:" + fileItem.getFieldName());   // 表单项的name属性值:username
                        // 2.1.2 参数UTF-8解决中文乱码问题
                        System.out.println("表单项的value属性值:" + fileItem.getString("UTF-8")); //表单项的value属性值:wzg168
                    }else{
                        // 2.2 上传的文件
                        System.out.println("表单项的name属性值:" + fileItem.getFieldName()); //表单项的name属性值:photo
                        System.out.println("上传的文件名:" + fileItem.getName()); //上传的文件名:a.jpg
                        // 3. 为检验是否上传文件成功,将其复制一份到本地磁盘
                        fileItem.write(new File("E:\\" + fileItem.getName()));
                    }
                }
            } catch (FileUploadException e) {
                e.printStackTrace();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

二、 文件下载

    1. 在web.xml中注册DownloadServlet
      <servlet>
         <servlet-name>DownloadServlet</servlet-name>
         <servlet-class>com.atguigu.servlet.DownLoadServlet</servlet-class>
      </servlet>
      <servlet-mapping>
         <servlet-name>DownloadServlet</servlet-name>
         <url-pattern>/downloadServlet</url-pattern>
      </servlet-mapping>
      
    1. DownloadServlet.java ```java package com.atguigu.servlet;

import org.apache.commons.io.IOUtils; import sun.misc.BASE64Encoder;

import javax.servlet.ServletContext; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.io.InputStream; import java.io.OutputStream; import java.net.URLEncoder; import java.nio.charset.StandardCharsets; import java.util.Base64;

public class DownLoadServlet extends HttpServlet { @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { // 1. 获取要下载的文件名 String downloadFilename = “2.jpg”;

    // 2. 读取要下载的内容(通过servletContext对象读取)
    ServletContext servletContext = getServletContext();
    InputStream resourceAsStream = servletContext.getResourceAsStream("/file/" + downloadFilename);// 放的文件的路径
    // 2.1 获取响应的输出流
    OutputStream outputStream = resp.getOutputStream();

    // 3. 把下载的文件内容传给客户端
    // 3.1 读取输入流中的全部数据,复制给输出流,输出给客户端
    IOUtils.copy(resourceAsStream,outputStream);

    // 4. 在回传前,通过响应头告诉客户端返回的数据类型
    // 4.1 获取要下载的文件类型
    String mimeType = servletContext.getMimeType("/file/" + downloadFilename);
    // 4.2 告诉客户端,返回的数据类型是什么
    resp.setContentType(mimeType);   // image/jpeg

    // 5. 告诉客户端,收到的数据是用于下载的,而不是现实在浏览器中
    // 5.1 Content-Disposition: 表示收到的数据怎么处理;
    // 5.2 attachment: 附件.表示下载使用
    // 5.3 filename: 文件名。 表示指定下载的文件名。下载的文件名是可以随便改的
    resp.setHeader("Content-Disposition","attachment;filename=" + downloadFilename);
    // 5.4 如果downloadFilename是中文名字,为防止所下载的文件名是乱码,需要进行URL编码
    // 5.5 如果是火狐浏览器,则需要用Base64编码
    String name2 = new BASE64Encoder().encode("中国.jpg".getBytes(StandardCharsets.UTF_8));
    String name = URLEncoder.encode("中国.jpg", "UTF-8");
    resp.setHeader("Content-Disposition","attachment;filename=" + name);
    // 5.6 判断用户用的是哪种浏览器
    if(req.getHeader("User-Agent").contains("firefox")){
        // 用火狐浏览器
    }else {
        // 用IE或者GOOGLE
    }

}

}

```