Web阶段:第十五章:文件上传&下载

文件的上传介绍
文件的上传和下载功能是很多系统中非常常见的功能。非常的重要。

文件的上传
1、首先需要一个form表单
2、然后在表单内有input type=”file”
3、提交的方式必须是method=”POST”
4、enctype="multipart/form-data"编码类型必须是多段的表单数据

enctype属性有两种值:

当enctype属性值为application/x-www-form-urlencoded的时候,表单提交的时候,浏览器会把所有的表单以name=value&name=value的形式进行拼接,然后做URL编码操作。
URL编码操作,就是把非字母数字的字符,比如说中文,转换成为:%xx%xx的格式内容

javaScript客户端的URL编解码:

    

  1. <script type="text/javascript">
  2. var url = "key=中文";
  3. // 编码操作
  4. var encodedURL = encodeURI(url);
  5. // alert(encodedURL);
  6. // 解码操作
  7. var decodedURL = decodeURI(encodedURL);
  8. alert(decodedURL);
  9. </script>

java中的URL编解码操作

public class JavaEncodeAndDecode {
    public static void main(String[] args) throws Exception {
        String url = "key=中文";
        // URLEncoder.encode 编码操作
        String encodedUrl = URLEncoder.encode(url, "UTF-8");
        System.out.println(encodedUrl);
        // 解码操作
        String decodedUrl = URLDecoder.decode(encodedUrl, "UTF-8");
        System.out.println( decodedUrl );
    }
}

当enctype属性值为multipart/form-data的时候,表单提交,浏览器会把所有表单项的信息,
以多个段的形式拼接在一起,以二进制流的形式发送给服务器。每个表单项,都会以特定的格式封装成为一段的数据。

文件上传,HTTP协议的说明。
谷歌浏览器f12进行查看:

 


commons-fileupload.jar 常用API介绍说明
commons-fileupload.jar 需要依赖 commons-io.jar 这个包,所以两个包我们都要引入。
commons-fileupload-1.2.1.jar
commons-io-1.4.jar

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

boolean ServletFileUpload.isMultipartContent(HttpServletRequest request);
判断,你提交过来的数据,是否是多段的上传数据,如果是返回true,如果数据格式不合法,返回false

public List ServletFileUpload.parseRequest(HttpServletRequest request)
直接把上传的数据,都解析成为每一个表单项。
每一个表单项由FileItem类表示

boolean FileItem.isFormField()
判断,是不是普通的表单项。如果是返回true,如果不是返回false

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

String FileItem.getString()
获取表单项的值,多用于普通表单项。

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

void FileItem.write( file );
把上传的文件写到file所指向的位置。

fileupload类库的使用:

文件上传的表单:

  1. <body>
  2. <form action="http://192.168.10.100:8080/day10/upload" enctype="multipart/form-data" method="post">
  3. 用户名:<input type="text" name="username" /><br/>
  4. 头像:<input type="file" name="file"/><br/>
  5. <input type="submit" />
  6. </form>
  7. </body>

解决上传代码:

public class Upload extends HttpServlet {
    private static final long serialVersionUID = 1L;

    protected void doPost(HttpServletRequest request,
            HttpServletResponse response) throws ServletException, IOException {
        // 判断,到底接收到的数据,是不是文件上传的格式(多段的multipart/form-data)
        if (ServletFileUpload.isMultipartContent(request)) {
            FileItemFactory fileItemFactory = new DiskFileItemFactory();
            // 创建文件上传解决的对象
            ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
            try {
                // 解析上传的数据 ====>>>会得到每一个表单项
                // 每个FileItem表示一个表单项
                List<FileItem> fileItems = servletFileUpload.parseRequest(request);
                // 遍历操作每一个表单项
                for (FileItem fileItem : fileItems) {
                    if (fileItem.isFormField()) {
                        // 表示这是一个普通表单项
                        // 关心name属性值和value属性值
                        System.out.println("name的属性值:" + fileItem.getFieldName());
                        System.out.println("提交过来的值:" + fileItem.getString());
                    } else {
                        // 上传的文件项
                        // 关心name属性值,和上传的文件名,以及把上传的文件写到某个硬盘位置
                        System.out.println("name的属性值:" + fileItem.getFieldName());
                        System.out.println("上传的文件名:" + fileItem.getName());
                        fileItem.write(new File("E:\\" + fileItem.getName()));
                    }
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

文件下载

下载的常用API说明:

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

response.setHeader(“Content-Disposition”, “attachment; fileName=1.jpg”);
这个响应头告诉浏览器。这是需要下载的。Content-Disposition是内容-配置,而attachment表示附件,也就是下载的一个文件。fileName=后面,表示下载的文件名。

完成上面的两个步骤,下载文件是没问题了。但是如果我们要下载的文件是中文名的话。你会发现,下载无法正确显示出正确的中文名。
原因是在响应头中,不能包含有中文字符,只能包含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 :表示使用BASE64编码
xxxx :是base64编码后的内容
?= :表示编码的结束

BASE64编解码操作:

@Test
public void test() throws Exception {
    String url = "中文.jpg";
    // 创建一个base64编码器对象
    BASE64Encoder base64Encoder = new BASE64Encoder();
    // base64Encoder.encode执行base64编码操作
    String base64EncodedString = base64Encoder.encode(url.getBytes("UTF-8"));
    System.out.println(base64EncodedString);
    // 解码
    BASE64Decoder base64Decoder = new BASE64Decoder();
    // base64解码操作
    byte[] buffer = base64Decoder.decodeBuffer(base64EncodedString);
    System.out.println( new String(buffer, "UTF-8") );
}

因为火狐使用的是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);
}

案例代码:

public class Download extends HttpServlet {
    private static final long serialVersionUID = 1L;

    protected void doGet(HttpServletRequest request,
            HttpServletResponse response) throws ServletException, IOException {
        String path = "/imgs/d.jpg";
        ServletContext servletContext = getServletContext();
        // getMimeType 获取文件的数据类型
        String type = servletContext.getMimeType(path);
        System.out.println(type);
        // 要设置返回的数据类型
        response.setContentType(type);

        /**
         * 通过判断请求头User-Agent判断是不是火狐浏览器,还是其他浏览器
         */
        if (request.getHeader("User-Agent").contains("Firefox")) {
            // 火狐浏览器
            response.setHeader(
                    "Content-Disposition",
                    "attachment; filename==?UTF-8?B?"
                            + new BASE64Encoder().encode("中文.jpg"
                                    .getBytes("UTF-8")) + "?=");
        } else {
            // 如果是谷歌浏览器,或IE浏览器,需要使用URL编码处理
            // 设置响应头 告诉浏览器,你收到数据,要当成下载处理。
            // attachment 表示附件
            // fileName表示下载的文件名
            response.setHeader("Content-Disposition", "attachment; filename="
                    + URLEncoder.encode("中文.jpg", "UTF-8"));
        }

        // 1 想办法读取需要下载的文件
        // 斜杠打头,表示到http://ip:prot/工程名/ 映射到代码的webContent目录
        InputStream stream = servletContext.getResourceAsStream(path);
        // 2 通过字节的响应输出流,输出给客户端
        ServletOutputStream outputStream = response.getOutputStream();
        // copy方法 把输入流的内容都读取然后写到输出流中
        IOUtils.copy(stream, outputStream);
        // 关流释放 资源
        stream.close();
        outputStream.close();
    }
}

项目文本替换
页面内替换文本:Ctrl+F
项目中所有文本替换