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

耦合问题

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

前端涉及到的问题

需要调用后端多个controller，不同接口不同的传参数，如果遇到后端接口修改，会涉及到多个页面的修改，耦合度很高；
需要对多个按钮设置权限配置；

后端涉及到的问题

需要每个业务接口，都去写一个对接第三方接口的push推送方法，无形中增加很多重复的代码，耦合度也很高；
如果涉及到第三方服务接口改造，后端接口也需要进行更改，会修改大量代码；

如何解决

创建对接第三方服务的微服务，站定为tps服务，该服务只作为一个后端微服务，与第三方服务进行对接，并且合理封装调用参数，将公共参数提出进行封装；
后端其余业务系统对接这个独立的微服务，比如订单、结算、供应商系统对接这个服务，由tps服务统一提供对接接口，其余服务实现这个tps提供的feign接口；
业务系统只需要关注service层业务的实现，无需处理对接的业务逻辑；

大致的流程图就是这样的

具体实现

Tps服务

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

kotlin 复制代码

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

Feign接口实现类

typescript 复制代码

@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;
//    }
    }
}

枚举类定义

ini 复制代码

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推送方法；

总结

这是我之前设计的关于接口统一调用的流程，当然其实还是包括对接第三方重复调用的问题、调用结果缓存、调用超时解决、失败降级的一些策略，如果还有更好的接口统一调用方式欢迎大家评论区留言讨论；