如何优雅的实现接口统一调用

来源：juejin.cn/post/7276261829726191676

👉 欢迎加入小哈的星球 ，你将获得: 专属的项目实战 / Java 学习路线 / 一对一提问 / 学习打卡 /  赠书福利

新项目:仿小红书(微服务架构)正在更新中... , 全栈前后端分离博客项目 2.0 版本完结啦， 演示链接：http://116.62.199.48/ 。全程手摸手，后端 + 前端全栈开发，从 0 到 1 讲解每个功能点开发步骤，1v1 答疑，直到项目上线。目前已更新了255小节，累计40w+字，讲解图：1716张，还在持续爆肝中.. 后续还会上新更多项目，目标是将Java领域典型的项目都整一波，如秒杀系统, 在线商城, IM即时通讯，Spring Cloud Alibaba 等等，戳我加入学习，已有1300+小伙伴加入(早鸟价超低)

• 一、耦合问题

• 二、如何解决

• 三、具体实现

• 四、总结

---

一、耦合问题

有些时候我们在进行接口调用的时候，比如说一个 push 推送接口，有可能会涉及到不同渠道的推送。以我目前业务场景为例，我做结算后端服务的，会与金蝶财务系统进行交互，那么我结算后端会涉及到多个结算单类型，如果每一个种类型的结算单都去暴露一个 contoller 接口给前端提供，而且其实对接第三方的接口，有些接口是共通的。

前端涉及到的问题

• 需要调用后端多个 controller，不同接口传不同的参数，如果遇到后端接口修改，会涉及到多个页面的修改，耦合度很高；

• 需要对多个按钮设置权限配置。

后端涉及到的问题

• 需要每个业务接口，都去写一个对接第三方接口的 push 推送方法，无形中增加很多重复的代码，耦合度也很高；

• 如果涉及到第三方服务接口改造，后端接口也需要进行更改，会修改大量代码。

二、如何解决

1. 创建对接第三方服务的微服务，暂定为 tps 服务，该服务只作为一个后端微服务，与第三方服务进行对接，并且合理封装调用参数，将公共参数提出进行封装；

2. 后端其余业务系统对接这个独立的微服务，比如订单、结算、供应商系统对接这个服务，由 tps 服务统一提供对接接口，其余服务实现这个 tps 提供的 feign 接口；

3. 业务系统只需要关注 service 层业务的实现，无需处理对接的业务逻辑。

大致的流程图就是这样的：

图片

三、具体实现

Tps 服务

Tps 服务暴露为 feign 接口，前端统一通过 Tps 提供的接口进行调用。

//对接第三方服务接口
public interface IKingdeeManagementService {
    Boolean push(KingdeePushCO.Request request);
}

Feign 接口实现类：

@Slf4j
@Service
public class KingdeeManagementServiceImpl implements IKingdeeManagementService {

    @Autowired
    private ApplicationContext applicationContext;
    @Autowired
    private KingdeeThirdSettingService kingdeeThirdSettingService;

    @Override
    public Boolean push(KingdeePushCO.Request request) {

        KingdeeBusinessPushServiceEnum kingdeePushServiceEnum = KingdeeBusinessPushServiceEnum.getKingdeePushServiceEnumByType(request.getBusinessType());

        IKingdeeBusinessPushService kingdeePushService = null;
        try {
            kingdeePushService = (IKingdeeBusinessPushService) applicationContext.getBean(kingdeePushServiceEnum.getClazz());
        } catch (BeansException e) {
            log.error("当前类型暂未实现,请联系开发");
            throw new ServiceException("当前类型暂未实现,请联系开发");
        }
            R<Boolean> result = null;
            result = kingdeePushService.pushKingdee(request);


        return true;
    }
}

枚举类定义：

public enum KingdeeBusinessPushServiceEnum {

    private Class clazz;

    private Integer type;

    private String interFaceName;

    KingdeeBusinessPushServiceEnum(Class clazz, Integer type, String interFaceName) {
        this.clazz = clazz;
        this.type = type;
        this.interFaceName = interFaceName;
    }
    RECEIPT_VOUCHER(IJaKingdeeBillClient.class, KingdeeBusinessTypeConstant.RECEIPT_VOUCHER, KingdeeSettingEnum.INTERFACE_TYPE_JA_RECEIPT_VOUCHER.getCode()), ;
}

分别有 clazz、type、interFaceName 属性，

• clazz 定义为 feign 接口，业务系统提供的服务接口；

• type 代表前端需要传的参数，不同的 Integer 值代表不同的 feign 接口映射；

• interFaceName 第三方接口枚举，表示需要具体调用哪个第三方接口。

业务系统

拿 bms 服务举例说明：继承 Tps 服务的 feign 接口，重写 push 方法；

图片

Feign 接口实现，通过 factory 工厂类初始化，不同的 service 实现类；

图片

JaKingdeeFactoryUtil 工厂工具类，获取工厂实例，这里其实也可以使用枚举映射，避免以后接口太多，需要写很多 case when。

图片

JaKingdeeServiceFactory 是个接口，提供方法：

图片

实现上面的接口，通过单例工厂的模式 double check 的模式实现，并且加悲观锁，避免一个工作线程多次创建工厂实例，SpringContextUtils/getBean/ 获取 servcie 实例，业务层只需要实现 service 接口，实现不同业务逻辑的 push 推送方法。

图片

四、总结

这是我之前设计的关于接口统一调用的流程，当然其实还是包括对接第三方重复调用的问题、调用结果缓存、调用超时解决、失败降级的一些策略，作为抛砖引玉。

👉 欢迎加入小哈的星球 ，你将获得: 专属的项目实战 / Java 学习路线 / 一对一提问 / 学习打卡 /  赠书福利

新项目:仿小红书(微服务架构)正在更新中... , 全栈前后端分离博客项目 2.0 版本完结啦， 演示链接：http://116.62.199.48/ 。全程手摸手，后端 + 前端全栈开发，从 0 到 1 讲解每个功能点开发步骤，1v1 答疑，直到项目上线。目前已更新了255小节，累计40w+字，讲解图：1716张，还在持续爆肝中.. 后续还会上新更多项目，目标是将Java领域典型的项目都整一波，如秒杀系统, 在线商城, IM即时通讯，Spring Cloud Alibaba 等等，戳我加入学习，已有1300+小伙伴加入(早鸟价超低)

1. 我的私密学习小圈子~
2. 分布式链路追踪：TraceIdFilter + MDC + Skywalking
3. 微服务架构中10个常用的设计模式
4. Hutool 中的这些工具类，太实用了！

最近面试BAT，整理一份面试资料《Java面试BATJ通关手册》，覆盖了Java核心技术、JVM、Java并发、SSM、微服务、数据库、数据结构等等。
获取方式：点“在看”，关注公众号并回复 Java 领取，更多内容陆续奉上。

PS：因公众号平台更改了推送规则，如果不想错过内容，记得读完点一下“在看”，加个“星标”，这样每次新文章推送才会第一时间出现在你的订阅列表里。
点“在看”支持小哈呀，谢谢啦