如何构建通用包装器以将域对象与特定的API分离？

Question

我正在为第三方Web服务（SOAP）api写包装器类。 我想以一种这样的方式来抽象代码与API的交互：如果业务关系发生变化，我可以删除对第三方API的引用。 考虑以下代码：

public Tapitype ConvertToAPIImplementation<Tapitype>(APIConverter domainToApiConverter){

  return domainToApiConverter.ConvertToAPIObject(this);

}

我想要做的是将我的函数ConvertToAPIImplementation放入一个转换器中，该转换器会将我的域对象转换为我们正在使用的期望API的类型。 我应该如何实施呢？

Answer 1

这是一个非常简单且常见的场景。 参考GoF模式适配器，抽象工厂和代理。

[编辑：添加了更多代码来帮助说明解决方案]

您需要定义自己的API（或抽象接口），以表示任何第三方API需要提供给您的应用程序的功能。

IPancakeMaker
{
    Pancake MakePancake(decimal radius);
}

然后编写一个实现该接口并取决于您当前的第三方API的提供程序...

WalmartPancakeMaker : IPancakeMaker
{

    Walmart3rdPartyAPI _w3paPancakeMaker = new Walmart3rdPartyAPI(string apiKey);

    // ... set 3rd party settings, defaults, etc

    // Implement IPancakeMaker
    public Pancake MakePankcake(decimal radius)
    {
        Walmart3rdPartyPancakeEntity thirdPartyPancake = _w3paPancakeMaker.BakeMeACakeJustAsFastAsYouCan(radius);

        return this.ConvertToPancakeInMyDomain(thirdPartyPancake);
    }
}

创建一个服务类（或其他一些业务流程）来控制与您的提供者的交互，并使用依赖注入来避免与提供者的紧密耦合。

public class MakePancakesService
{
    IPancakeMaker _pancakeMaker = null;

    // Constructor takes the concrete Provider of IPancakeMaker
    // Your calling code is not aware of the actual underlying API
    public MakePancakesService(IPancakeMaker pancakeMaker)
    {
        _pancakeMaker = pancakeMaker;
    }
}

使用流行的DI框架，例如Unity或StructureMap。

http://unity.codeplex.com/

http://structuremap.net/structuremap/