搜索

Java 调用第三方接口，实战来了！

Java后端编程

共 4770字，需浏览 10分钟

 ·

2022-05-21 14:11

在项目开发中经常会遇到调用第三方接口的情况，比如说调用第三方的天气预报接口。

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 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 param) {
  // 创建Httpclient对象
  CloseableHttpClient httpClient = HttpClients.createDefault();
  CloseableHttpResponse response = null;
  String resultString = "";
  try {
   // 创建Http Post请求
   HttpPost httpPost = new HttpPost(url);
   // 创建参数列表
   if (param != null) {
    List 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;
 
 /**
  * 

  * 对象转化为json字符串
  * 
  * @param obj 待转化对象
  * @return 代表该对象的Json字符串
  */
 public static final String toJson(final Object obj) {
  return JSON.toJSONString(obj);
  // return gson.toJson(obj);
 }
 
 /**
  * 

  * 对象转化为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);
 }
 
 /**
  * 

  * 解析json字符串中某路径的值
  * 
  * @param json
  * @param path
  * @return
  */
 @SuppressWarnings("unchecked")
 public static final  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]);
 }
 
 /**
  * 

  * json字符串解析为对象
  * 
  * @param json 代表一个对象的Json字符串
  * @param clazz 指定目标对象的类型，即返回对象的类型
  * @return 从json字符串解析出来的对象
  */
 public static final  T parse(final String json, final Class clazz) {
  return JSON.parseObject(json, clazz);
 }
 
 /**
  * 

  * json字符串解析为对象
  * 
  * @param json json字符串
  * @param path 逗号分隔的json层次结构
  * @param clazz 目标类
  */
 public static final  T parse(final String json, final String path, final Class 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  List parseArray(final Object obj, final String[] fields, boolean ignore,
   final Class clazz, final SerializerFeature... features) {
  String json = toJson(obj, fields, ignore, features);
  return parseArray(json, clazz);
 }
 
 /**
  * 

  * 从json字符串中解析出一个对象的集合，被解析字符串要求是合法的集合类型
  * （形如:["k1":"v1","k2":"v2",..."kn":"vn"]）
  * 
  * @param json - [key-value-pair...]
  * @param clazz
  * @return
  */
 public static final  List parseArray(final String json, final Class clazz) {
  return JSON.parseArray(json, clazz);
 }
 
 /**
  * 

  * 从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  List parseArray(final String json, final String path, final Class 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 ret = parseArray(inner, clazz);
  return ret;
 }
 
 /**
  * 

  * 有些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
ps：如果您觉文章有用，动动小手点个在看，点个赞再走吧
-END-

PS：如果觉得我的分享不错，欢迎大家随手点赞、在看。
 关注公众号：Java后端编程，回复下面关键字 

要Java学习完整路线，回复  路线 
缺Java入门视频，回复： 视频 
要Java面试经验，回复  面试 
缺Java项目，回复： 项目 
进Java粉丝群： 加群 

PS：如果觉得我的分享不错，欢迎大家随手点赞、在看。
（完）




加我"微信" 获取一份 最新Java面试题资料
请备注：666，不然不通过～

最近好文

1、必须推荐的一个后台管理系统
2、无意中发现了一位清华妹子的资料库！
3、Java后端编程读者群正式成立了！
4、一套简单通用的Java后台管理系统，拿来即用
5、36 张图梳理 Intellij IDEA 常用设置


最近面试BAT，整理一份面试资料《Java面试BAT通关手册》，覆盖了Java核心技术、JVM、Java并发、SSM、微服务、数据库、数据结构等等。
获取方式：关注公众号并回复 java 领取，更多内容陆续奉上。
明天见(｡･ω･｡)ﾉ♡
浏览 34
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
Java 调用第三方接口示范
泥瓦匠BYSocket
0
Java调用第三方接口示范
Java技术江湖
0
调用第三方接口示范
编程帮
0
如何优雅的调用第三方接口
互联网架构师
0
Java 异步调用原理与实战经验总结
后端技术漫谈
0
Taip调用腾讯 AI 接口的 Java 客户端
TAIP是调用腾讯AI接口的Java客户端，为调用腾讯AI功能的开发人员提供了一系列的交互方法。目前已经接入【face人脸识别】人脸检测与分析、多人脸检测、人脸对比、跨年龄人脸识别、五官定位、人脸识别
Java——接口
不止Java
0
Taip调用腾讯 AI 接口的 Java 客户端
TAIP 是调用腾讯 AI 接口的 Java 客户端，为调用腾讯 AI 功能的开发人员提供了一系列的
JavaGPT调用 ChatGPT API 接口的 Java GUI
JavaGPT 是一个调用 ChatGPT API 接口的 Java GUI。特性：聊天流就像网站一
http-toolsHttp接口调用工具
HttpTools是一个用于方便做POST, GET请求的客户端工具，可以方便自定义GET和POST
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报