

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

终码一生

2025-09-04

点击“终码一生”，关注，置顶公众号

每日技术干货，第一时间送达！

耦合问题

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

前端涉及到的问题

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

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

后端涉及到的问题

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

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

如何解决

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

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

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

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

具体实现

Tps 服务

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

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

Feign 接口实现类：

@Slf4j
@Service
publicclassKingdeeManagementServiceImplimplementsIKingdeeManagementService{

    @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("当前类型暂未实现,请联系开发");
            thrownew ServiceException("当前类型暂未实现,请联系开发");
        }
            R<Boolean> result = null;
            result = kingdeePushService.pushKingdee(request);


        returntrue;
    }
}

枚举类定义：

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()), ;
}