apache的MultipartEntityBuilder文件上傳

本文講解多文件上傳方法，不比較上傳有幾種方法和效率，而是定向分析apache的httpmime包的MultipartEntityBuilder類，源碼包：httpmime-4.5.2.jar

一、常用用法

1.上傳文件

三個傳值方法，addPart、addBinaryBody、addTextBody如下圖：

MultipartEntityBuilder entityBuilder = MultipartEntityBuilder.create();
entityBuilder.addBinaryBody("file",new byte[]{},ContentType.DEFAULT_BINARY,"file.jpg");
entityBuilder.addPart("owner","111");
entityBuilder.addTextBody("paramter1", "aaa");

 

2.接收文件

//將當前上下文初始化給  CommonsMutipartResolver （多部分解析器）
CommonsMultipartResolver multipartResolver=new CommonsMultipartResolver(request.getSession().getServletContext());
 //判斷是否多文件上傳
 if(multipartResolver.isMultipart(request)){
     //將request變成多部分request
     MultipartHttpServletRequest multiRequest=(MultipartHttpServletRequest)request;
     Map<String,Object> map=multiRequest.getParameterMap();
     //獲取multiRequest 中所有的文件名
     Iterator<String> iter=multiRequest.getFileNames();
     //遍歷所有文件
     while(iter.hasNext()){
        MultipartFile file=multiRequest.getFile(iter.next().toString());
        //to do
     }
 }

二、注意點

注意點1，使用addBinaryBody的坑

首先看看源碼：

MultipartEntityBuilder 的 addBinaryBody 有6種不同用法，一般都是上傳File即可。着重看下圖2個紅色名字的方法。

源碼如下：

    public MultipartEntityBuilder addBinaryBody(
            final String name, final byte[] b, final ContentType contentType, final String filename) {
        return addPart(name, new ByteArrayBody(b, contentType, filename));
    }

    public MultipartEntityBuilder addBinaryBody(
            final String name, final byte[] b) {
        return addBinaryBody(name, b, ContentType.DEFAULT_BINARY, null);
    }

    public MultipartEntityBuilder addBinaryBody(
            final String name, final File file, final ContentType contentType, final String filename) {
        return addPart(name, new FileBody(file, contentType, filename));
    }

    public MultipartEntityBuilder addBinaryBody(
            final String name, final File file) {
        return addBinaryBody(name, file, ContentType.DEFAULT_BINARY, file != null ? file.getName() : null);
    }

    public MultipartEntityBuilder addBinaryBody(
            final String name, final InputStream stream, final ContentType contentType,
            final String filename) {
        return addPart(name, new InputStreamBody(stream, contentType, filename));
    }

    public MultipartEntityBuilder addBinaryBody(final String name, final InputStream stream) {
        return addBinaryBody(name, stream, ContentType.DEFAULT_BINARY, null);
    }

如上圖：需要特別注意 傳byte[]字節數組時，必須使用4參傳值,且第四參必須帶后綴名：

entityBuilder.addBinaryBody("file",new byte[]{},ContentType.DEFAULT_BINARY,"fileName.jpg");

如果使用上圖中兩參的，最后fileName不傳，默認為null,會導致接收文件時multiRequest.getFileNames()（見1.2接收方法代碼）為空！就會獲取不到文件！

注意點2 isMultipart：

multipartResolver.isMultipart(request)，這里判斷是否為多文件上傳，要求

1.方法為POST。

2.contentType以"mutipart/"開頭。源碼追蹤如下：