HttpClient快速入门第2讲——封装一下HttpClient，以方便别人调用

深碍√TFBOYSˉ_ 2022-12-19 06:18 82阅读 0赞

# 前言 #

入门HttpClient之后，我们再来思考这样一个问题，如果手机客户端要向服务端发送一个http请求，那么它直接通过HttpClient来进行发送url就可以了，但是万一手机客户端那边开发安卓的程序员不会使用HttpClient这门技术，咋办？要是他会用，好说，我们Java后端开发人员只需要开发一个Controller（给使用者返回一个JSON数据），他来调用这玩意，自己写业务逻辑就可以了，这样一来，他就可以直接通过http来发送请求了。我们Java后端开发人员所做的事情就是开发Controller这个玩意，也就是通常所说的开发一个接口，然后供给手机客户端或者PC端调用。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70_pic_center]  
你开发接口，你开发啥接口啊？上面这个就是你开发的接口，你这个接口给谁用啊？给手机app用，当然了，别人也可以用。

假设现在手机客户端那边开发安卓的程序员不会用HttpClient，怎么办啊？我们Java后端开发人员会嘛，这个时候，我们就可以给他提供一个类（该类对外提供一些比较简单的方法），该类会封装一下HttpClient，封装完了之后，把这个类提供给开发安卓的哥们。他拿到这个类，一看就会用就可以了。当然了，该类也不一定是给手机客户端那边开发安卓的程序员调用哟，还可以是给其他项目组的人调用，如果他们也不会HttpClient的话。

下面，我们就来封装一下HttpClient。

# 封装HttpClient #

首先，编写一个类封装一下返回的响应，如下所示。

package com.itheima.httpclient;
    
    /** * 返回的响应的实体类，封装一下响应 * @author liayun * */
    public class HttpResult { 
    	
    	private Integer code; // 响应的状态码，例如200、201
    	private String body; // 响应体，其实就是响应的内容
    	
    	public Integer getCode() { 
    		return code;
    	}
    	public void setCode(Integer code) { 
    		this.code = code;
    	}
    	public String getBody() { 
    		return body;
    	}
    	public void setBody(String body) { 
    		this.body = body;
    	}
    	public HttpResult(Integer code, String body) { 
    		super();
    		this.code = code;
    		this.body = body;
    	}
    	public HttpResult() { 
    		
    	}
    	@Override
    	public String toString() { 
    		return "HttpResult [code=" + code + ", body=" + body + "]";
    	}
    	
    }

然后，编写一个类封装一下HttpClient，对外提供如下方法。

package com.itheima.httpclient;
    
    import java.net.URI;
    import java.util.ArrayList;
    import java.util.List;
    import java.util.Map;
    
    import org.apache.http.NameValuePair;
    import org.apache.http.client.entity.UrlEncodedFormEntity;
    import org.apache.http.client.methods.CloseableHttpResponse;
    import org.apache.http.client.methods.HttpGet;
    import org.apache.http.client.methods.HttpPost;
    import org.apache.http.client.utils.URIBuilder;
    import org.apache.http.impl.client.CloseableHttpClient;
    import org.apache.http.impl.client.HttpClients;
    import org.apache.http.message.BasicNameValuePair;
    import org.apache.http.util.EntityUtils;
    
    /** * * @author liayun * */
    public class APIService { 
    	
    	// 1. 不带参数的get请求的方法
    	/** * * @param url：请求的url * @return * @throws Exception */
    	public HttpResult doGet(String url) throws Exception { 
    		return doGet(url, null);
    	}
    	
    	// 2. 带参数的get请求的方法
    	/** * * @param url：请求的url * @param map：请求传递的参数 * @return * @throws Exception */
    	public HttpResult doGet(String url, Map<String, Object> map) throws Exception { 
    		// 1）创建HttpClient对象
    		CloseableHttpClient client = HttpClients.createDefault();
    		// 2）创建HttpGet请求对象
    		URIBuilder builder = new URIBuilder(url); // 别忘了设置url哟！
    		// 遍历Map集合，设置参数的值
    		if (map != null) {  // 注意，如果说Map集合不为null，那么就依次设置参数
    			for (Map.Entry<String, Object> entry : map.entrySet()) { 
    				builder.setParameter(entry.getKey(), entry.getValue().toString());
    			}
    		}
    		URI uri = builder.build(); // 如果说Map集合就为null，那么就不设置参数
    		HttpGet httpGet = new HttpGet(uri);
    		// 3）执行请求
    		CloseableHttpResponse response = client.execute(httpGet);
    		// 4）获取响应的结果，并封装到HttpResult对象中
    		Integer code = response.getStatusLine().getStatusCode(); // 获取响应状态码
    		// 实体response.getEntity()其实封装的就是我们的内容，但是要注意response.getEntity()得到是一个null的话，那么就会报错，所以最好得判断一下
    		String body = null;
    		if (response.getEntity() != null) { 
    			body = EntityUtils.toString(response.getEntity(), "utf-8"); // 将实体（内容）转换成一个字符串
    		}
    		HttpResult result = new HttpResult(code, body);
    		return result;
    	}
    	
    	// 3. 不带参数的post请求的方法
    	public HttpResult doPost(String url) throws Exception { 
    		return doPost(url, null);
    	}
    	
    	// 4. 带参数的post请求的方法
    	public HttpResult doPost(String url, Map<String, Object> map) throws Exception { 
    		// 1）创建HttpClient对象
    		CloseableHttpClient client = HttpClients.createDefault();
    		// 2）创建HttpPost请求对象
    		HttpPost httpPost = new HttpPost(url);
    		if (map != null) { 
    			// 遍历参数的Map集合，设置请求参数列表
    			List<NameValuePair> parameters = new ArrayList<NameValuePair>();
    			for (Map.Entry<String, Object> entry : map.entrySet()) { 
    				parameters.add(new BasicNameValuePair(entry.getKey(), entry.getValue().toString()));
    			}
    			// 创建表单实体对象，将请求参数设置到表单实体当中
    			UrlEncodedFormEntity encodedFormEntity = new UrlEncodedFormEntity(parameters);
    			
    			// 设置表单实体到HttpPost请求对象当中
    			httpPost.setEntity(encodedFormEntity);
    		}
    		
    		// 3）执行请求
    		CloseableHttpResponse response = client.execute(httpPost);
    		// 4）获取响应结果，并封装到HttpResult对象中
    		Integer code = response.getStatusLine().getStatusCode();
    		String body = null;
    		if (response.getEntity() != null) { 
    			body = EntityUtils.toString(response.getEntity(), "utf-8");
    		}
    		
    		HttpResult result = new HttpResult(code, body);
    		return result; // 返回HttpResult对象
    	}
    	
    }

最后，编写一个单元测试类测试一下以上APIService类对外提供的4个方法。

package com.itheima.httpclient;
    
    import java.util.ArrayList;
    import java.util.HashMap;
    import java.util.List;
    import java.util.Map;
    
    import org.apache.http.NameValuePair;
    import org.apache.http.message.BasicNameValuePair;
    import org.junit.Test;
    
    public class TestAPIService { 
    
    	@Test
    	public void test() throws Exception { 
    		APIService service = new APIService();
    		
    // HttpResult doGet = service.doGet("http://www.baidu.com");
    // System.out.println(doGet.getBody());
    // System.out.println(doGet.getCode());
    
    // Map<String, Object> map = new HashMap<String, Object>();
    // map.put("page", 1);
    // map.put("rows", 60);
    // HttpResult doGet = service.doGet("http://localhost:8081/item/list", map);
    // System.out.println(doGet);
    
    // HttpResult doPost = service.doPost("http://www.baidu.com");
    // System.out.println(doPost);
    
    		Map<String, Object> map = new HashMap<String, Object>();
    		map.put("cid", "560");
    		map.put("title", "httpclient2");
    		map.put("sellPoint", "hi, httpclient2");
    		map.put("price", "1200");
    		map.put("num", "213");
    		HttpResult doPost = service.doPost("http://localhost:8081/item/save", map);
    		System.out.println(doPost);
    	}
    
    }

这样，如果手机客户端需要搜索，那么我们只需要提供给它这个APIService类，再告诉它调用的URL以及各参数的含义就可以了。手机客户端调用这些方法后，返回的JSON数据自己做处理便可以了，这样就实现了系统之间的通信。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70_pic_center]: /images/20221120/986173b870194c93b671e56c60b0a0cc.png