JAVA项目中通常会需要通过对接第三方API来扩展项目业务,如支付,风控,语音识别,图像处理等。但看似简单的发送/接收请求却包含了Http请求,数据加密/解密,签名加签/验签,数据处理等内容。这次通过对接某公司API,也踩了不少坑,跟大家分享一下。
一般来说,文档的易读程度和更新速度能说明被对接公司技术部门的水平。我见过比较好的公司例如 阿里云,连连支付,FaceId,白骑士等等。但是也有比较坑的,这一点大家就要注意了。
文档里一般有更新时间,最近更新时间距离当前日期越近越好。
如果真的遇到比较老的文档和demo,那就多和对方技术人员沟通,搞不定的地方尽快去问对方技术,不要钻牛角尖。
为了防止被抓包,一般都会使用加密算法来对请求参数进行加密,常见加密方式有,RSA,MD5,ITRUS,DES等等,如果不是有特殊要求,选择优先级 MD5>DES>RAS>ITRUS. 说白了就是怎么简单怎么来。
注意点:
MD5加密方式有好几种类型,一定要弄清楚要对接的接口是MD5 32位 还是 MD5 16位
JAVA开发的话 RAS加密 密钥记得进行 PKCS8转码
ITRUS加密注意替换JDK中的两个jar包:
用无限制扩展包替换 jdk 安装目录下的 local_policy.jar 和 US_export_policy.jar
例如:jdk 安装目录下: C:\Program Files\Java\ jdk1.8.0_31 替 换 文 件 所 在 的 目 录 : C:\Program Files\Java\ jdk1.8.0_31 \jre\lib\security
jdk8 替换包参考:《jdk 替换包.zip》中《jce_policy-8.zip》
jdk7 替换包参考:《jdk 替换包.zip》中《UnlimitedJCEPolicyJDK7.zip》
jdk6 替换包参考:《jdk 替换包.zip》中《jce_policy-6.zip》
jdk8 替换包下载地址: http://www.oracle.com/technetwork/java/javase/downloads/jce8-downlo ad-2133166.html
jdk7 替换包下载地址: http://www.oracle.com/technetwork/java/embedded/embedded-se/downloa ds/jce-7-download-432124.html
jdk6 替换包下载地址: http://www.oracle.com/technetwork/java/embedded/embedded-se/downloa ds/jce-6-download-429243.html
对参数进行加密签名,通常都需要过滤掉空参数以及字段signType和sign。 一般的demo中都会带的有过滤方法,也可以自己写,难度不大
private static Map<String, String> paraFilter(Map<String, String> oriMap) {
Map<String, String> result = new HashMap();
if (oriMap != null && oriMap.size() > 0) {
Iterator var2 = oriMap.entrySet().iterator();
while(var2.hasNext()) {
Entry<String, String> iterator = (Entry)var2.next();
String value = (String)iterator.getValue();
if (!StringUtils.isBlank(value) && !((String)iterator.getKey()).equalsIgnoreCase("sign") && !((String)iterator.getKey()).equalsIgnoreCase("sign_type")) {
result.put(iterator.getKey(), value);
}
}
return result;
} else {
return result;
}
}
加密前,注意检查参数名是否完全和文档中相同,一个空格都不能多,也不能少。否则对方验签失败,这种细节的错误有时候也很难找。
注意点:我喜欢用JSONObject对装载参数,但是这里有一个问题,fastJson工具在对jsonObject进行格式转换处理时,可能会打乱原json对象里的字段顺序,导致自己/对方签名校验败。这里有三个解决方案
1、解析时增加 Feature.OrderedField 参数固定顺序
Map<String, String> params = JSON.parseObject(jsonStr, new TypeReference<Map<String, String>>(){}, Feature.OrderedField);
2、初始化json对象为有序对象:
JSONObject retObj = new JSONObject(true);
这样生成的json对象就与放入数据时一致。
3、使用Gson解析
JsonObject returnData = new JsonParser().parse(replyString).getAsJsonObject();
一般来说第三方API主要使用POST/GET两种方法。按照demo或者文档中的示例能很快确定对方接口的数据格式以及请求方式,不要自己瞎猜乱写,这样效率太低。有的公司会直接提供SDK或者jar包供我们参考,这是极好的。
注意点:
不要轻易将sdk或者jar包引入自己项目,认真检查是否埋有恶意代码。 也可以直接将需要用的代码复制粘贴出来,新建工具类使用。ctrl+c/ctrl+v美滋滋
发送务必检查是否对请求前对参数进行urlencode编码,否则会数据被转义,参数校验失败。
注意点:
1.在需要回调(异步通知API结果)的时候,我方会使用亚瑟(雾)。。。会使用一个异步请求接口来接受异步通知,即使对方说明了是post或者get请求方法通知,也不要在@RequestMapping()注解中标明请求方式,这样能给对方没有什么限制,不会容易发生415(bad request)错误码的情况。
2.尽量不要使实力类在方法入参里直接接参数,参数出错了直接就是415(bad request),不容易debug,用request.getParameter()的方式写一个工具类。遍历处请求参数,set到对象里,这是我们项目的类,自己写也不难,百度你懂的
public static NoticeResp parseNotice(HttpServletRequest request) {
NoticeResp resp = new NoticeResp();
Field[] fields = NoticeResp.class.getDeclaredFields();
for (Field field : fields) {
ReflectionUtils.setFieldValue(resp, field.getName(), request.getParameter(field.getName()));
}
return resp;
}
如:
@RequestMapping("notify")
@ResponseBody
public Object notify(HttpServletRequest request, HttpServletResponse response){
}
下班了,也基本说完了,有什么疑问可以留言,欢迎多交流,指正
文章浏览阅读2.5w次,点赞6次,收藏50次。官方解释是,docker 容器是机器上的沙盒进程,它与主机上的所有其他进程隔离。所以容器只是操作系统中被隔离开来的一个进程,所谓的容器化,其实也只是对操作系统进行欺骗的一种语法糖。_docker菜鸟教程
文章浏览阅读5.7k次,点赞3次,收藏14次。该如何避免的,今天小编给大家推荐两个下载Windows系统官方软件的资源网站,可以杜绝软件捆绑等行为。该站提供了丰富的Windows官方技术资源,比较重要的有MSDN技术资源文档库、官方工具和资源、应用程序、开发人员工具(Visual Studio 、SQLServer等等)、系统镜像、设计人员工具等。总的来说,这两个都是非常优秀的Windows系统镜像资源站,提供了丰富的Windows系统镜像资源,并且保证了资源的纯净和安全性,有需要的朋友可以去了解一下。这个非常实用的资源网站的创建者是国内的一个网友。_msdn我告诉你
文章浏览阅读1.2k次。vue2封装对话框el-dialog组件_
文章浏览阅读4.7k次,点赞5次,收藏6次。MFC 文本框换行 标签: it mfc 文本框1.将Multiline属性设置为True2.换行是使用"\r\n" (宽字符串为L"\r\n")3.如果需要编辑并且按Enter键换行,还要将 Want Return 设置为 True4.如果需要垂直滚动条的话将Vertical Scroll属性设置为True,需要水平滚动条的话将Horizontal Scroll属性设_c++ mfc同一框内输入二行怎么换行
文章浏览阅读832次。检查Linux是否是否开启所需端口,默认为6379,若未打开,将其开启:以root用户执行iptables -I INPUT -p tcp --dport 6379 -j ACCEPT如果还是未能解决,修改redis.conf,修改主机地址:bind 192.168.85.**;然后使用该配置文件,重新启动Redis服务./redis-server redis.conf..._redis-server doesn't support auth command or ismisconfigured. try
文章浏览阅读4.9k次。济大数电实验报告_数据选择器及其应用
文章浏览阅读236次。1研究内容消费在生产中占据十分重要的地位,是生产的最终目的和动力,是保持省内经济稳定快速发展的核心要素。预测河南省社会消费品零售总额,是进行宏观经济调控和消费体制改变创新的基础,是河南省内人民对美好的全面和谐社会的追求的要求,保持河南省经济稳定和可持续发展具有重要意义。本文建立灰色预测模型,利用MATLAB软件,预测出2019年~2023年河南省社会消费品零售总额预测值分别为21881...._灰色预测模型用什么软件
文章浏览阅读1.2k次。12.4-在Qt中使用Log4Qt输出Log文件,看这一篇就足够了一、为啥要使用第三方Log库,而不用平台自带的Log库二、Log4j系列库的功能介绍与基本概念三、Log4Qt库的基本介绍四、将Log4qt组装成为一个单独模块五、使用配置文件的方式配置Log4Qt六、使用代码的方式配置Log4Qt七、在Qt工程中引入Log4Qt库模块的方法八、获取示例中的源代码一、为啥要使用第三方Log库,而不用平台自带的Log库首先要说明的是,在平时开发和调试中开发平台自带的“打印输出”已经足够了。但_log4qt
文章浏览阅读786次。全局观思维模型,一个教我们由点到线,由线到面,再由面到体,不断的放大格局去思考问题的思维模型。_计算机中对于全局观的
文章浏览阅读330次。一、CountDownLatch介绍CountDownLatch采用减法计算;是一个同步辅助工具类和CyclicBarrier类功能类似,允许一个或多个线程等待,直到在其他线程中执行的一组操作完成。二、CountDownLatch俩种应用场景: 场景一:所有线程在等待开始信号(startSignal.await()),主流程发出开始信号通知,既执行startSignal.countDown()方法后;所有线程才开始执行;每个线程执行完发出做完信号,既执行do..._countdownluach于cyclicbarrier的用法
文章浏览阅读508次。Prometheus 算是一个全能型选手,原生支持容器监控,当然监控传统应用也不是吃干饭的,所以就是容器和非容器他都支持,所有的监控系统都具备这个流程,_-自动化监控系统prometheus&grafana实战
文章浏览阅读4.7k次。输入关键字,可以通过键盘的搜索按钮完成搜索功能。_react search