Java 呼叫第三方介面，實戰來了！-有解無憂

在專案開發中經常會遇到呼叫第三方介面的情況，比如說呼叫第三方的天氣預報介面，

1、準備作業：

在專案的工具包下匯入HttpClientUtil這個工具類，或者也可以使用Spring框架的restTemplate來呼叫，上面有呼叫介面的方法【分為Get和Post方式的有參和無參呼叫】：

package com.njsc.credit.util;
 
import java.io.IOException;
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.entity.ContentType;
import org.apache.http.entity.StringEntity;
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;
 
public class HttpClientUtil {
 
 /**
  * 帶引數的get請求
  * @param url
  * @param param
  * @return String
  */
 public static String doGet(String url, Map<String, String> param) {
  // 創建Httpclient物件
  CloseableHttpClient httpclient = HttpClients.createDefault();
 
  String resultString = "";
  CloseableHttpResponse response = null;
  try {
   // 創建uri
   URIBuilder builder = new URIBuilder(url);
   if (param != null) {
    for (String key : param.keySet()) {
     builder.addParameter(key, param.get(key));
    }
   }
   URI uri = builder.build();
   // 創建http GET請求
   HttpGet httpGet = new HttpGet(uri);
   // 執行請求
   response = httpclient.execute(httpGet);
   // 判斷回傳狀態是否為200
   if (response.getStatusLine().getStatusCode() == 200) {
    resultString = EntityUtils.toString(response.getEntity(), "UTF-8");
   }
  } catch (Exception e) {
   e.printStackTrace();
  } finally {
   try {
    if (response != null) {
     response.close();
    }
    httpclient.close();
   } catch (IOException e) {
    e.printStackTrace();
   }
  }
  return resultString;
 }
 
 /**
  * 不帶引數的get請求
  * @param url
  * @return String
  */
 public static String doGet(String url) {
  return doGet(url, null);
 }
 
 /**
  * 帶引數的post請求
  * @param url
  * @param param
  * @return String
  */
 public static String doPost(String url, Map<String, String> param) {
  // 創建Httpclient物件
  CloseableHttpClient httpClient = HttpClients.createDefault();
  CloseableHttpResponse response = null;
  String resultString = "";
  try {
   // 創建Http Post請求
   HttpPost httpPost = new HttpPost(url);
   // 創建引數串列
   if (param != null) {
    List<NameValuePair> paramList = new ArrayList<>();
    for (String key : param.keySet()) {
     paramList.add(new BasicNameValuePair(key, param.get(key)));
    }
    // 模擬表單
    UrlEncodedFormEntity entity = new UrlEncodedFormEntity(paramList);
    httpPost.setEntity(entity);
   }
   // 執行http請求
   response = httpClient.execute(httpPost);
   resultString = EntityUtils.toString(response.getEntity(), "utf-8");
  } catch (Exception e) {
   e.printStackTrace();
  } finally {
   try {
    response.close();
   } catch (IOException e) {
    e.printStackTrace();
   }
  }
  return resultString;
 }
 
 /**
  * 不帶引數的post請求
  * @param url
  * @return String
  */
 public static String doPost(String url) {
  return doPost(url, null);
 }
 
 /**
  * 傳送json型別的post請求
  * @param url
  * @param json
  * @return String
  */
 public static String doPostJson(String url, String json) {
  // 創建Httpclient物件
  CloseableHttpClient httpClient = HttpClients.createDefault();
  CloseableHttpResponse response = null;
  String resultString = "";
  try {
   // 創建Http Post請求
   HttpPost httpPost = new HttpPost(url);
   // 創建請求內容
   StringEntity entity = new StringEntity(json, ContentType.APPLICATION_JSON);
   httpPost.setEntity(entity);
   // 執行http請求
   response = httpClient.execute(httpPost);
   resultString = EntityUtils.toString(response.getEntity(), "utf-8");
  } catch (Exception e) {
   e.printStackTrace();
  } finally {
   try {
    response.close();
   } catch (IOException e) {
    e.printStackTrace();
   }
  }
  return resultString;
 }
}

2、創建url和訪問key 以及引數等：

代碼如下：

/**
 * 聚合介面校驗身份證
 * @param idCard
 * @param realName
 * @return boolean
 */
public boolean identityCheck(String idCard, String realName){
 logger.info("-----------------呼叫聚合資料 身份證驗證API BEGIN--------------->");
 String key = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
 String url = "http://op.juhe.cn/idcard/query" + "?key=" + key + "&idcard=" + idCard + "&realname=" + realName;
 logger.info("請求url:" + url);
 boolean match = false; //是否匹配
 try {
  String result = HttpClientUtil.doGet(url);
  System.out.println("請求結果：" + result);
  IdentityCheckResult identityCheckResult = JsonUtils.parse(result, IdentityCheckResult.class);
  IdentityCheck identityCheck = JsonUtils.parse(result, "result", IdentityCheck.class);
  logger.info(identityCheckResult);
  logger.info(identityCheck.toString());
  if(identityCheckResult.correct() && identityCheck.getRes() == 1){
   match = true;
  }
 } catch (Exception e) {
  e.printStackTrace();
 }
 logger.info("<-----------------呼叫聚合資料 身份證驗證API END---------------");
 return match;
}

3、請求這個第三方介面：

使用HttpClientUtil工具類中的doGet方法來請求URL，得到結果，現在大多數是一個json字串，型別為String

4、根據介面回傳資料格式來決議資料：

可以看到，回傳引數有六個，所以在專案中新建一個bean，包含以上六個欄位，用來接住回傳資料，如下：

因為介面回傳的資料是一個json的字串，型別實際上是一個String字串，要決議資料，用工具類JsonUtils的parse方法將字串轉換為Java物件，JsonUtils的代碼如下：

package com.eqianxian.commons.utils.json;
 
import java.util.List;
import java.util.Map;
 
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.alibaba.fastjson.serializer.PropertyFilter;
import com.alibaba.fastjson.serializer.SerializerFeature;
 
/**
 * 在系統中統一使用這個，以方便將來切換不同的JSON生成工具
 * 
 * @author KelvinZ
 * 
 */
public class JsonUtils {
 public static final int TYPE_FASTJSON = 0;
 public static final int TYPE_GSON = 1;
 
 /**
  * <pre>
  * 物件轉化為json字串
  * 
  * @param obj 待轉化物件
  * @return 代表該物件的Json字串
  */
 public static final String toJson(final Object obj) {
  return JSON.toJSONString(obj);
  // return gson.toJson(obj);
 }
 
 /**
  * <pre>
  * 物件轉化為json字串
  * 
  * @param obj 待轉化物件
  * @return 代表該物件的Json字串
  */
 public static final String toJson(final Object obj, SerializerFeature... features) {
  return JSON.toJSONString(obj, features);
  // return gson.toJson(obj);
 }
 
 /**
  * 物件轉化為json字串并格式化
  * 
  * @param obj
  * @param format 是否要格式化
  * @return
  */
 public static final String toJson(final Object obj, final boolean format) {
  return JSON.toJSONString(obj, format);
 }
 
 /**
  * 物件對指定欄位進行過濾處理，生成json字串
  * 
  * @param obj
  * @param fields 過濾處理欄位
  * @param ignore true做忽略處理，false做包含處理
  * @param features json特征，為null忽略
  * @return
  */
 public static final String toJson(final Object obj, final String[] fields, final boolean ignore,
   SerializerFeature... features) {
  if (fields == null || fields.length < 1) {
   return toJson(obj);
  }
  if (features == null)
   features = new SerializerFeature[] { SerializerFeature.QuoteFieldNames };
  return JSON.toJSONString(obj, new PropertyFilter() {
   @Override
   public boolean apply(Object object, String name, Object value) {
    for (int i = 0; i < fields.length; i++) {
     if (name.equals(fields[i])) {
      return !ignore;
     }
    }
    return ignore;
   }
  }, features);
 }
 
 /**
  * <pre>
  * 決議json字串中某路徑的值
  * 
  * @param json
  * @param path
  * @return
  */
 @SuppressWarnings("unchecked")
 public static final <E> E parse(final String json, final String path) {
  String[] keys = path.split(",");
  JSONObject obj = JSON.parseObject(json);
  for (int i = 0; i < keys.length - 1; i++) {
   obj = obj.getJSONObject(keys[i]);
  }
  return (E) obj.get(keys[keys.length - 1]);
 }
 
 /**
  * <pre>
  * json字串決議為物件
  * 
  * @param json 代表一個物件的Json字串
  * @param clazz 指定目標物件的型別，即回傳物件的型別
  * @return 從json字串決議出來的物件
  */
 public static final <T> T parse(final String json, final Class<T> clazz) {
  return JSON.parseObject(json, clazz);
 }
 
 /**
  * <pre>
  * json字串決議為物件
  * 
  * @param json json字串
  * @param path 逗號分隔的json層次結構
  * @param clazz 目標類
  */
 public static final <T> T parse(final String json, final String path, final Class<T> clazz) {
  String[] keys = path.split(",");
  JSONObject obj = JSON.parseObject(json);
  for (int i = 0; i < keys.length - 1; i++) {
   obj = obj.getJSONObject(keys[i]);
  }
  String inner = obj.getString(keys[keys.length - 1]);
  return parse(inner, clazz);
 }
 
 /**
  * 將制定的物件經過欄位過濾處理后，決議成為json集合
  * 
  * @param obj
  * @param fields
  * @param ignore
  * @param clazz
  * @param features
  * @return
  */
 public static final <T> List<T> parseArray(final Object obj, final String[] fields, boolean ignore,
   final Class<T> clazz, final SerializerFeature... features) {
  String json = toJson(obj, fields, ignore, features);
  return parseArray(json, clazz);
 }
 
 /**
  * <pre>
  * 從json字串中決議出一個物件的集合，被決議字串要求是合法的集合型別
  * （形如:["k1":"v1","k2":"v2",..."kn":"vn"]）
  * 
  * @param json - [key-value-pair...]
  * @param clazz
  * @return
  */
 public static final <T> List<T> parseArray(final String json, final Class<T> clazz) {
  return JSON.parseArray(json, clazz);
 }
 
 /**
  * <pre>
  * 從json字串中按照路徑尋找，并決議出一個物件的集合，例如：
  * 類Person有一個屬性name，要從以下json中決議出其集合：
  * {
  *  "page_info":{
  *   "items":{
  *    "item":[{"name":"KelvinZ"},{"name":"Jobs"},...{"name":"Gates"}]
  *  }
  * }
  * 使用方法：parseArray(json, "page_info,items,item", Person.class)，
  * 將根據指定路徑，正確的決議出所需集合，排除外層干擾
  * 
  * @param json json字串
  * @param path 逗號分隔的json層次結構
  * @param clazz 目標類
  * @return
  */
 public static final <T> List<T> parseArray(final String json, final String path, final Class<T> clazz) {
  String[] keys = path.split(",");
  JSONObject obj = JSON.parseObject(json);
  for (int i = 0; i < keys.length - 1; i++) {
   obj = obj.getJSONObject(keys[i]);
  }
  String inner = obj.getString(keys[keys.length - 1]);
  List<T> ret = parseArray(inner, clazz);
  return ret;
 }
 
 /**
  * <pre>
  * 有些json的常見格式錯誤這里可以處理，以便給后續的方法處理
  * 常見錯誤：使用了\" 或者 "{ 或者 }"，騰訊的頁面中常見這種格式
  * 
  * @param invalidJson 包含非法格式的json字串
  * @return
  */
 public static final String correctJson(final String invalidJson) {
  String content = invalidJson.replace("\\\"", "\"").replace("\"{", "{").replace("}\"", "}");
  return content;
 }
 
 /**
  * 格式化Json
  * 
  * @param json
  * @return
  */
 public static final String formatJson(String json) {
  Map<?, ?> map = (Map<?, ?>) JSON.parse(json);
  return JSON.toJSONString(map, true);
 }
 
 /**
  * 獲取json串中的子json
  * 
  * @param json
  * @param path
  * @return
  */
 public static final String getSubJson(String json, String path) {
  String[] keys = path.split(",");
  JSONObject obj = JSON.parseObject(json);
  for (int i = 0; i < keys.length - 1; i++) {
   obj = obj.getJSONObject(keys[i]);
   System.out.println(obj.toJSONString());
  }
  return obj != null ? obj.getString(keys[keys.length - 1]) : null;
 }
 
}

來源：https://blog.csdn.net/qq_35860138/article/details/82967727

近期熱文推薦：

1.1,000+ 道 Java面試題及答案整理(2021最新版)

2.別在再滿屏的 if/ else 了，試試策略模式，真香！！

3.臥槽！Java 中的 xx ≠ null 是什么新語法？

4.Spring Boot 2.5 重磅發布，黑暗模式太炸了！

5.《Java開發手冊（嵩山版）》最新發布，速速下載！

覺得不錯，別忘了隨手點贊+轉發哦！

轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/300118.html

標籤：其他

上一篇：Tars | 第7篇 TarsJava Subset最終代碼的測驗方案設計

下一篇：Python游戲開發，pygame模塊，Python實作乒乓球小游戲