HttpClient模拟表单提交数据（File文件类型和普通表单）

Love The Way You Lie 2022-04-16 04:12 679阅读 0赞

# HttpClient模拟表单提交数据（File(文件)类型和普通类型） #

最近在工作中，因为对方要求使用表单进行上传，但是其中有一个字段是file类型，导致我弄了很久，都无法正确发出，在这里进行记录，希望能给大家一种解决思路。

import java.io.File;
    import java.io.IOException;
    import java.nio.charset.Charset;
    
    import org.apache.http.HttpHost;
    import org.apache.http.client.config.RequestConfig;
    import org.apache.http.client.methods.HttpPost;
    import org.apache.http.entity.ContentType;
    import org.apache.http.entity.mime.HttpMultipartMode;
    import org.apache.http.entity.mime.MultipartEntityBuilder;
    import org.apache.http.entity.mime.content.StringBody;
    import org.apache.http.impl.client.CloseableHttpClient;
    import org.apache.http.impl.client.HttpClientBuilder;
    import org.apache.http.util.EntityUtils;
    import org.junit.Test;
    
    public class test { 
    	@Test
    	public void uploadFormFile() { 
    		CloseableHttpClient httpClient = HttpClientBuilder.create().build();
    		int timeOut = 30000;
    		// 设置本地fiddler代理,方便排查问题
    		//因为是基于tomcat进行的请求转发，所以在代码中手动添加代理
    		HttpHost proxy = new HttpHost("127.0.0.1", 8080, "http");
    		RequestConfig requestConfig = RequestConfig.custom().setConnectionRequestTimeout(timeOut)
    				.setConnectTimeout(timeOut).setSocketTimeout(timeOut).setProxy(proxy).build();
    		//设置请求地址
    		HttpPost httpPost = new HttpPost("XXXX");
    		httpPost.setConfig(requestConfig);
    		
    		/* * 这里是一个很容易被疏忽的地方 * 关于表单提交，会有两种content-Type： * 1、application/x-www-form-urlencoded：不能进行文件的上传，我们一般form表单默认就是这个类型 * 2、multipart/form-data ，用于文件的上传，设置表单的MIME编码，二进制传输数据，参数会以boundary进行分割 * 很多人选择文件上传的话，就会直接设置这个地方为multipart/form-data， * 但是这里面有个boundary参数属性，假如我们手动设置为multipart/form-data，则会导致boundary无法生成。所以这里千万不要设置 */
    		//httpPost.setHeader("content-Type", "multipart/form-data");
    		
    		//构建参数
    		MultipartEntityBuilder multipartEntityBuilder = MultipartEntityBuilder.create();
    		/* * RFC6532=utf-8，STRICT=iso-8859-1 * 这里如果存在中文乱码，一定要用RFC6532 * 如果没有中文，这行可以不要 */
    		multipartEntityBuilder.setMode(HttpMultipartMode.RFC6532);
    		
    		/* * 这个设置并无卵用，害我纠结了半天是不是编码方式设置错了 */
    		//multipartEntityBuilder.setCharset(Charset.forName("UTF-8"));
    		
    		/* * 这个地方是个深渊巨坑！！！！ * 这里千万不要设置ContentType = multipart/form-data, 不然 boundary 这个参数就不会自动生成 */
    		//org.apache.http.entity.ContentType.create("multipart/form-data",Charset.forName("UTF-8"));
    		
    		/* * 这里也是个深渊巨坑！！！！ * 这里是设置需要传输的文件 * 第一个参数是key值，也就是对面拿什么来接收 * 第二个参数是文件 file * 第三个参数 一种类型，具体也也不太清楚 * 第四个参数 这个就是巨坑了！！看源码，当不填这个值的时候，会取file.getName; * 但是一定要记住，如果文件是远程地址的，这样再通过http传的时候会出现错误，所以需要取到最原始的文件后缀名！！！最好就是用字节流去读取这个文件 * * 这里的第三个参数和第四个参数必须要设置，不然后续服务读取不到这个文件流 */
    		File file = new File("http://aaa/bbb/cc/ddd.jpg");
    		multipartEntityBuilder.addBinaryBody("image", file, ContentType.DEFAULT_BINARY, file.getName());
    		
    		//这里是设置string类型的传输数据
    		
    		/* * 这里是设置字符编码 * 这个地方也是坑，但是网上很多文章都会设置，所以很少人出问题 * 根据我的理解，就是整体传输，需要给表单设置一个编码，然后文件传输，也需要设置编码，文字传输，也需要设置编码 * 很多小伙伴都会因为某个地方没有设置编码，导致传输失败。这个地方可能理解有误，欢迎大家来指导。 */
    		org.apache.http.entity.ContentType contentType = 
    				org.apache.http.entity.ContentType.create("text/plain",Charset.forName("UTF-8"));
    		multipartEntityBuilder.addPart("name", new StringBody("zhangsan", contentType));
    		multipartEntityBuilder.addPart("age", new StringBody("18", contentType));
    		
    		httpPost.setEntity(multipartEntityBuilder.build());
    		
    		try { 
    			org.apache.http.HttpResponse response = httpClient.execute(httpPost);
    			/* * int statusCode= response.getStatusLine().getStatusCode(); * 这里是返回状态码，真正在项目中，需要判断返回码是否为200，看是否发送成功 * 这里就不展开写了 */
    			System.out.println( EntityUtils.toString(response.getEntity(), "UTF-8"));
    		} catch (Exception e) { 
    		}finally { 
    			try { 
    				httpClient.close();
    			} catch (IOException e) { 
    			}
    		}
    		
    	}
    }

这里还再提供一种普通写法，比较简单，不涉及到文件上传。使用NameValuePair，content-Type为application/x-www-form-urlencoded。

@Test
    	public void testForm() { 
    		CloseableHttpClient httpClient = HttpClientBuilder.create().build();
    		int timeOut = 30000;
    		// 设置本地fiddler代理,方便排查问题
    		//因为是基于tomcat进行的请求转发，所以在代码中手动添加代理
    		HttpHost proxy = new HttpHost("127.0.0.1", 8080, "http");
    		RequestConfig requestConfig = RequestConfig.custom().setConnectionRequestTimeout(timeOut)
    				.setConnectTimeout(timeOut).setSocketTimeout(timeOut).setProxy(proxy).build();
    		//设置请求地址
    		HttpPost httpPost = new HttpPost("XXXX");
    		httpPost.setConfig(requestConfig);
    		httpPost.setHeader("content-Type", "application/x-www-form-urlencoded");
    		
    		List<NameValuePair> formParams = new ArrayList<>();
    		formParams.add(new BasicNameValuePair("isAllIndustry", "0"));
    		try { 
    			UrlEncodedFormEntity he=new UrlEncodedFormEntity(formParams,"UTF-8");
    			httpPost.setEntity(he); 
    			HttpResponse response=httpClient.execute(httpPost); 
    			System.out.println( EntityUtils.toString(response.getEntity(), "UTF-8"));
    		} catch (Exception e) { 
    			// TODO: handle exception
    		}

参考：  
[https://www.cnblogs.com/evasean/archive/2018/07/25/9368670.html][https_www.cnblogs.com_evasean_archive_2018_07_25_9368670.html]  
[http://www.cnblogs.com/iscys/p/9595358.html][http_www.cnblogs.com_iscys_p_9595358.html]  
[https://yq.aliyun.com/ziliao/286006][https_yq.aliyun.com_ziliao_286006]

[https_www.cnblogs.com_evasean_archive_2018_07_25_9368670.html]: https://www.cnblogs.com/evasean/archive/2018/07/25/9368670.html
[http_www.cnblogs.com_iscys_p_9595358.html]: http://www.cnblogs.com/iscys/p/9595358.html
[https_yq.aliyun.com_ziliao_286006]: https://yq.aliyun.com/ziliao/286006